texinfo Makefile.am NEWS README README-hacking ...

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       12/04/23 00:01:34

Modified files:
        .              : Makefile.am NEWS README 
Added files:
        .              : README-hacking 
Removed files:
        .              : README.dev 

Log message:
        rename README.dev to README-hacking, for more consistency

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/Makefile.am?cvsroot=texinfo&r1=1.34&r2=1.35
http://cvs.savannah.gnu.org/viewcvs/texinfo/NEWS?cvsroot=texinfo&r1=1.211&r2=1.212
http://cvs.savannah.gnu.org/viewcvs/texinfo/README?cvsroot=texinfo&r1=1.20&r2=1.21
http://cvs.savannah.gnu.org/viewcvs/texinfo/README-hacking?cvsroot=texinfo&rev=1.1
http://cvs.savannah.gnu.org/viewcvs/texinfo/README.dev?cvsroot=texinfo&r1=1.22&r2=0

Patches:
Index: Makefile.am
===================================================================
RCS file: /sources/texinfo/texinfo/Makefile.am,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -b -r1.34 -r1.35
--- Makefile.am 19 Jan 2012 20:38:10 -0000      1.34
+++ Makefile.am 23 Apr 2012 00:00:13 -0000      1.35
@@ -1,8 +1,8 @@
-# $Id: Makefile.am,v 1.34 2012/01/19 20:38:10 pertusus Exp $
+# $Id: Makefile.am,v 1.35 2012/04/23 00:00:13 karl Exp $
 # Makefile.am for texinfo.
 # Process this file with automake to produce Makefile.in in all directories.
 #
-# Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012
 # Free Software Foundation, Inc.
 #
 # This file is free software; as a special exception the author gives
@@ -17,7 +17,8 @@
 ACLOCAL_AMFLAGS = -I gnulib/m4
 
 # Additional files to distribute.
-EXTRA_DIST = ChangeLog.46 INSTALL.generic INTRODUCTION README.dev system.h \
+EXTRA_DIST = ChangeLog.46 INSTALL.generic INTRODUCTION README-hacking \
+  system.h \
   djgpp/README djgpp/config.bat djgpp/config.sed djgpp/config.site \
   gnulib/m4/gnulib-cache.m4
 

Index: NEWS
===================================================================
RCS file: /sources/texinfo/texinfo/NEWS,v
retrieving revision 1.211
retrieving revision 1.212
diff -u -b -r1.211 -r1.212
--- NEWS        20 Feb 2012 16:41:31 -0000      1.211
+++ NEWS        23 Apr 2012 00:00:21 -0000      1.212
@@ -1,4 +1,4 @@
-$Id: NEWS,v 1.211 2012/02/20 16:41:31 karl Exp $
+$Id: NEWS,v 1.212 2012/04/23 00:00:21 karl Exp $
 This NEWS file records noteworthy changes, very tersely.
 See the manual for detailed information.
 
@@ -40,7 +40,7 @@
     @atchar{} @lbracechar{} @rbracechar{} @backslashchar{} @hashchar{}.
   . new command @errormsg to report an error.
   . five-argument xrefs can refer to a whole manual, by omitting the
-      section name and specifying Top for the node name, or omitting it.
+      section name and either omitting the node name or using "Top".
   . #line directives are recognized.
   . DEL (0x7f = 0177 = 127) is a true comment character (catcode 14 in TeX).
 

Index: README
===================================================================
RCS file: /sources/texinfo/texinfo/README,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -b -r1.20 -r1.21
--- README      16 Oct 2011 23:14:08 -0000      1.20
+++ README      23 Apr 2012 00:00:47 -0000      1.21
@@ -1,4 +1,4 @@
-$Id: README,v 1.20 2011/10/16 23:14:08 karl Exp $
+$Id: README,v 1.21 2012/04/23 00:00:47 karl Exp $
 This is the README file for the GNU Texinfo distribution.  Texinfo is
 the preferred documentation format for GNU software.
 
@@ -39,7 +39,7 @@
 Patches are most welcome; if possible, please make them with diff -c and
 include ChangeLog entries.
 
-See README.dev for information on the Texinfo development environment --
+See README-dev for information on the Texinfo development environment --
 any interested parties are welcome.  If you're a programmer and wish to
 contribute, this should get you started.  If you're not a programmer,
 you can still make significant contributions by writing test cases,
@@ -47,7 +47,7 @@
 
 This distribution includes the following files, among others:
     README                 This file.
-    README.dev             Texinfo developer information.
+    README-hacking         Texinfo developer information.
 
     INSTALL                Texinfo-specific installation notes.
     NEWS                   Summary of new features by release.

Index: README-hacking
===================================================================
RCS file: README-hacking
diff -N README-hacking
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ README-hacking      23 Apr 2012 00:01:07 -0000      1.1
@@ -0,0 +1,71 @@
+$Id: README-hacking,v 1.1 2012/04/23 00:01:07 karl Exp $
+This README.dev file describes the development environment.
+
+  Copyright 2002, 2003, 2005, 2006, 2007, 2008, 2010, 2011, 2012
+  Free Software Foundation, Inc.
+
+  Copying and distribution of this file, with or without modification,
+  are permitted in any medium without royalty provided the copyright
+  notice and this notice are preserved.
+
+The development sources for GNU Texinfo are available through anonymous
+CVS at Savannah:
+  http://savannah.gnu.org/cvs/?group=texinfo
+
+This distribution uses whatever versions of Automake, Autoconf, and
+Gettext are listed in NEWS; usually the latest ones released.  If you
+are getting the sources from CVS (or change configure.ac), you'll need
+to have these tools installed to (re)build.  You'll also need help2man.
+All of these programs are available from ftp://ftp.gnu.org/gnu.
+
+After getting the CVS sources, and installing the tools above, you can run
+ ./autogen.sh
+and then
+ ./configure CFLAGS='-g -Wdeclaration-after-statement'
+and then
+ make
+
+After the initial autogen && configure, simply running make should suffice.
+
+The reason for that particular -W is that intermixing declarations with
+statements is an easy thing to do accidentally, gcc doesn't warn about
+it by default, and other compilers that don't support it are still
+widespread.  If you're not using gcc, of course you shouldn't specify it
+at all.
+
+Other -W options can be useful too, and patches are welcome to resolve
+diagnostics; however, removing all possible warning messages, or
+warnings with nonfree compilers, is explicitly not a goal.
+
+This distribution also uses Gnulib (http://www.gnu.org/software/gnulib)
+to share common files, with the files being checked in to CVS.  If you
+get automake/conf/etc. errors from ./autogen.sh, please try doing a CVS
+checkout of gnulib (in a separate directory from the texinfo checkout),
+and then run
+  ../gnulib/gnulib-tool --add-import
+in your top-level Texinfo directory.  (gnulib-tool is in the gnulib CVS tree.)
+
+The currently-used gnulib modules and other gnulib information are
+recorded in gnulib/m4/gnulib-cache.m4.  Given a source checkout of
+gnulib, you can update the files with gnulib-tool --add-import.
+
+
+About running the programs from development sources:
+- Once the distribution is built, you can run the compiled programs
+(info, texindex, install-info) out of the build tree without special
+settings; they don't try to read any installed data files.
+
+- The texi2dvi script and texinfo.tex can be run as-is, since they 
+are standalone and don't require compilation.  For the same reasons,
+they are officially updated between full Texinfo releases, at
+http://ftpmirror.gnu.org/texinfo.
+
+- Regarding texi2any (aka makeinfo), you can run tp/texi2any.pl
+directly.  This is the original source file for the program, so it's
+convenient to be able to make changes and then run it.
+
+To run it under a name that doesn't end in .pl, e.g., "makeinfo", you
+can set the environment variable TEXINFO_DEV_SOURCE to 1, or symlink to
+a trivial script:
+#!/bin/sh
+exec /YOUR/TEXINFO/DIR/tp/texi2any.pl "$@"

Index: README.dev
===================================================================
RCS file: README.dev
diff -N README.dev
--- README.dev  1 Apr 2012 00:33:38 -0000       1.22
+++ /dev/null   1 Jan 1970 00:00:00 -0000
@@ -1,71 +0,0 @@
-$Id: README.dev,v 1.22 2012/04/01 00:33:38 karl Exp $
-This README.dev file describes the development environment.
-
-  Copyright 2002, 2003, 2005, 2006, 2007, 2008, 2010, 2011, 2012
-  Free Software Foundation, Inc.
-
-  Copying and distribution of this file, with or without modification,
-  are permitted in any medium without royalty provided the copyright
-  notice and this notice are preserved.
-
-The development sources for GNU Texinfo are available through anonymous
-CVS at Savannah:
-  http://savannah.gnu.org/cvs/?group=texinfo
-
-This distribution uses whatever versions of Automake, Autoconf, and
-Gettext are listed in NEWS; usually the latest ones released.  If you
-are getting the sources from CVS (or change configure.ac), you'll need
-to have these tools installed to (re)build.  You'll also need help2man.
-All of these programs are available from ftp://ftp.gnu.org/gnu.
-
-After getting the CVS sources, and installing the tools above, you can run
- ./autogen.sh
-and then
- ./configure CFLAGS='-g -Wdeclaration-after-statement'
-and then
- make
-
-After the initial autogen && configure, simply running make should suffice.
-
-The reason for that particular -W is that intermixing declarations with
-statements is an easy thing to do accidentally, gcc doesn't warn about
-it by default, and other compilers that don't support it are still
-widespread.  If you're not using gcc, of course you shouldn't specify it
-at all.
-
-Other -W options can be useful too, and patches are welcome to resolve
-diagnostics; however, removing all possible warning messages, or
-warnings with nonfree compilers, is explicitly not a goal.
-
-This distribution also uses Gnulib (http://www.gnu.org/software/gnulib)
-to share common files, with the files being checked in to CVS.  If you
-get automake/conf/etc. errors from ./autogen.sh, please try doing a CVS
-checkout of gnulib (in a separate directory from the texinfo checkout),
-and then run
-  ../gnulib/gnulib-tool --add-import
-in your top-level Texinfo directory.  (gnulib-tool is in the gnulib CVS tree.)
-
-The currently-used gnulib modules and other gnulib information are
-recorded in gnulib/m4/gnulib-cache.m4.  Given a source checkout of
-gnulib, you can update the files with gnulib-tool --add-import.
-
-
-About running the programs from development sources:
-- Once the distribution is built, you can run the compiled programs
-(info, texindex, install-info) out of the build tree without special
-settings; they don't try to read any installed data files.
-
-- The texi2dvi script and texinfo.tex can be run as-is, since they 
-are standalone and don't require compilation.  For the same reasons,
-they are officially updated between full Texinfo releases, at
-http://ftpmirror.gnu.org/texinfo.
-
-- Regarding texi2any (aka makeinfo), you can run tp/texi2any.pl
-directly.  This is the original source file for the program, so it's
-convenient to be able to make changes and then run it.
-
-To run it under a name that doesn't end in .pl, e.g., "makeinfo", you
-can set the environment variable TEXINFO_DEV_SOURCE to 1, or symlink to
-a trivial script:
-#!/bin/sh
-exec /YOUR/TEXINFO/DIR/tp/texi2any.pl "$@"