texinfo ChangeLog README.dev

[Karl Berry]

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

Modified files:
        .              : ChangeLog README.dev 

Log message:
        a little more about running texi2any.pl from development

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1339&r2=1.1340
http://cvs.savannah.gnu.org/viewcvs/texinfo/README.dev?cvsroot=texinfo&r1=1.21&r2=1.22

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1339
retrieving revision 1.1340
diff -u -b -r1.1339 -r1.1340
--- ChangeLog   30 Mar 2012 18:10:39 -0000      1.1339
+++ ChangeLog   1 Apr 2012 00:33:38 -0000       1.1340
@@ -1,8 +1,12 @@
+2012-03-31  Karl Berry  <address@hidden>
+
+       * README.dev: more about running texi2any.pl from development.
+
 2012-03-30  Karl Berry  <address@hidden>
 
        * doc/texinfo.txi (\indexnofonts): sort keys for @lbracechar
        and @rbracechar.
-       (\commondummies): handle \lbracechar, \rbracechar, \abbr, \image.
+       (\commondummies): handle @lbracechar @rbracechar @abbr @image.
        All found by Patrice, tests 5, 6, 22, 24, 26.
 
 2012-03-11  Samuel Bronson  <address@hidden>  (tiny change)

Index: README.dev
===================================================================
RCS file: /sources/texinfo/texinfo/README.dev,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -b -r1.21 -r1.22
--- README.dev  28 Oct 2011 23:39:09 -0000      1.21
+++ README.dev  1 Apr 2012 00:33:38 -0000       1.22
@@ -1,7 +1,7 @@
-$Id: README.dev,v 1.21 2011/10/28 23:39:09 karl Exp $
+$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
+  Copyright 2002, 2003, 2005, 2006, 2007, 2008, 2010, 2011, 2012
   Free Software Foundation, Inc.
 
   Copying and distribution of this file, with or without modification,
@@ -28,11 +28,14 @@
 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 won't warn about it
-by default, and other compilers that don't support it are still
-widespread.  Other -W options can be useful too, and patches are welcome
-to resolve the diagnostics.  If you're not using gcc, of course you
-shouldn't include it at all.
+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
@@ -45,3 +48,24 @@
 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 "$@"