| 1 | $Id: README.dev,v 1.7 2003/11/24 15:11:06 karl Exp $ | 
|---|
| 2 | README.dev - Texinfo developer information. | 
|---|
| 3 |  | 
|---|
| 4 | Copyright (C) 2002, 2003 Free Software Foundation, Inc. | 
|---|
| 5 |  | 
|---|
| 6 | Copying and distribution of this file, with or without modification, | 
|---|
| 7 | are permitted in any medium without royalty provided the copyright | 
|---|
| 8 | notice and this notice are preserved. | 
|---|
| 9 |  | 
|---|
| 10 | The development sources for Texinfo is available through anonymous cvs | 
|---|
| 11 | at Savannah, see | 
|---|
| 12 | http://savannah.gnu.org/cvs/?group=texinfo | 
|---|
| 13 |  | 
|---|
| 14 | This distribution uses whatever versions of automake, autoconf, and | 
|---|
| 15 | gettext are listed in NEWS; usually the latest ones released.  If you | 
|---|
| 16 | are getting the Texinfo sources from cvs, or change the Texinfo | 
|---|
| 17 | configure.ac, you'll need to have these tools installed to (re)build. | 
|---|
| 18 | You'll also need help2man.  (All of these are available from | 
|---|
| 19 | ftp://ftp.gnu.org/gnu.) | 
|---|
| 20 |  | 
|---|
| 21 | Here's the order in which to run the tools for a fresh build: | 
|---|
| 22 |  | 
|---|
| 23 | autoheader    # creates config.in, not necessarily needed every time | 
|---|
| 24 | aclocal -I m4 # for a new version of automake | 
|---|
| 25 | automake | 
|---|
| 26 | autoconf | 
|---|
| 27 | configure CFLAGS=-g --enable-maintainer-mode | 
|---|
| 28 | make | 
|---|
| 29 |  | 
|---|
| 30 | (with arguments to taste, of course.)  Or you can run | 
|---|
| 31 |  | 
|---|
| 32 | ./bootstrap | 
|---|
| 33 |  | 
|---|
| 34 | instead of the various auto* tools. | 
|---|
| 35 |  | 
|---|
| 36 |  | 
|---|
| 37 | One final note: If you would like to contribute to the GNU project by | 
|---|
| 38 | implementing additional documentation output formats for Texinfo, that | 
|---|
| 39 | would be great.  But please do not write a separate translator texi2foo | 
|---|
| 40 | for your favorite format foo!  That is the hard way to do the job, and | 
|---|
| 41 | makes extra work in subsequent maintenance, since the Texinfo language | 
|---|
| 42 | is continually being enhanced and updated.  Instead, the best approach | 
|---|
| 43 | is modify Makeinfo to generate the new format, as it does now for Info, | 
|---|
| 44 | HTML, XML, and DocBook. | 
|---|