1146515Sru$Id: README.dev,v 1.7 2003/11/24 15:11:06 karl Exp $
2146515SruREADME.dev - Texinfo developer information.
3146515Sru
4146515Sru  Copyright (C) 2002, 2003 Free Software Foundation, Inc.
5146515Sru
6146515Sru  Copying and distribution of this file, with or without modification,
7146515Sru  are permitted in any medium without royalty provided the copyright
8146515Sru  notice and this notice are preserved.
9146515Sru
10146515SruThe development sources for Texinfo is available through anonymous cvs
11146515Sruat Savannah, see
12146515Sru  http://savannah.gnu.org/cvs/?group=texinfo
13146515Sru
14146515SruThis distribution uses whatever versions of automake, autoconf, and
15146515Srugettext are listed in NEWS; usually the latest ones released.  If you
16146515Sruare getting the Texinfo sources from cvs, or change the Texinfo
17146515Sruconfigure.ac, you'll need to have these tools installed to (re)build.
18146515SruYou'll also need help2man.  (All of these are available from
19146515Sruftp://ftp.gnu.org/gnu.)
20146515Sru
21146515SruHere's the order in which to run the tools for a fresh build:
22146515Sru
23146515Sru  autoheader    # creates config.in, not necessarily needed every time
24146515Sru  aclocal -I m4 # for a new version of automake
25146515Sru  automake
26146515Sru  autoconf
27146515Sru  configure CFLAGS=-g --enable-maintainer-mode
28146515Sru  make
29146515Sru
30146515Sru(with arguments to taste, of course.)  Or you can run
31146515Sru
32146515Sru  ./bootstrap
33146515Sru
34146515Sruinstead of the various auto* tools.
35146515Sru
36146515Sru
37146515SruOne final note: If you would like to contribute to the GNU project by
38146515Sruimplementing additional documentation output formats for Texinfo, that
39146515Sruwould be great.  But please do not write a separate translator texi2foo
40146515Srufor your favorite format foo!  That is the hard way to do the job, and
41146515Srumakes extra work in subsequent maintenance, since the Texinfo language
42146515Sruis continually being enhanced and updated.  Instead, the best approach
43146515Sruis modify Makeinfo to generate the new format, as it does now for Info,
44146515SruHTML, XML, and DocBook.
45