| 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.
 | 
|---|