gnu/dist/texinfo/README.dev

   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.