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