texinfo ChangeLog README-hacking NEWS util/srcl...

[karl]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     karl <karl>     13/01/19 15:54:05

Modified files:
        .              : ChangeLog README-hacking NEWS 
        util           : srclist.txt 
        doc            : Makefile.am texinfo.txi version.texi 
Added files:
        util           : srclist-txi 

Log message:
        pretest 4.13.94

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1523&r2=1.1524
http://cvs.savannah.gnu.org/viewcvs/texinfo/README-hacking?cvsroot=texinfo&r1=1.1&r2=1.2
http://cvs.savannah.gnu.org/viewcvs/texinfo/NEWS?cvsroot=texinfo&r1=1.224&r2=1.225
http://cvs.savannah.gnu.org/viewcvs/texinfo/util/srclist.txt?cvsroot=texinfo&r1=1.31&r2=1.32
http://cvs.savannah.gnu.org/viewcvs/texinfo/util/srclist-txi?cvsroot=texinfo&rev=1.1
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/Makefile.am?cvsroot=texinfo&r1=1.53&r2=1.54
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.529&r2=1.530
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/version.texi?cvsroot=texinfo&r1=1.131&r2=1.132

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1523
retrieving revision 1.1524
diff -u -b -r1.1523 -r1.1524
--- ChangeLog   18 Jan 2013 23:57:59 -0000      1.1523
+++ ChangeLog   19 Jan 2013 15:54:03 -0000      1.1524
@@ -1,3 +1,9 @@
+2013-01-19  Karl Berry  <address@hidden>
+
+       * pretest 4.13.94.
+       
+       * README-hacking: tersely describe release steps.
+
 2013-01-18  Karl Berry  <address@hidden>
 
        * doc/texinfo.txi (Customization Variables for Program Behavior)
@@ -128,7 +134,7 @@
 
 2013-01-01  Karl Berry  <address@hidden>
 
-       * pretest 4.13.92.
+       * pretest 4.13.93.
 
        * util/Makefile.am (texinfo.cat): remove rule and references;
        not aware of anything using it, current rule fails distcheck.

Index: README-hacking
===================================================================
RCS file: /sources/texinfo/texinfo/README-hacking,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- README-hacking      23 Apr 2012 00:01:07 -0000      1.1
+++ README-hacking      19 Jan 2013 15:54:04 -0000      1.2
@@ -1,7 +1,7 @@
-$Id: README-hacking,v 1.1 2012/04/23 00:01:07 karl Exp $
-This README.dev file describes the development environment.
+$Id: README-hacking,v 1.2 2013/01/19 15:54:04 karl Exp $
+This file describes the development environment for Texinfo.
 
-  Copyright 2002, 2003, 2005, 2006, 2007, 2008, 2010, 2011, 2012
+  Copyright 2002, 2003, 2005, 2006, 2007, 2008, 2010, 2011, 2012, 2013
   Free Software Foundation, Inc.
 
   Copying and distribution of this file, with or without modification,
@@ -13,35 +13,38 @@
   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
+Gettext are listed in NEWS; usually the latest official releases.  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.
+All of these programs are available from http://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, for example,
+ ./configure -C 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.
+The -C tells configure to cache test results, which usually speeds
+things up a bit.
+
+That particular -W is useful because a) intermixing declarations with
+statements is an easy thing to do accidentally, b) gcc doesn't warn
+about it by default, and c) other compilers that don't support it are
+still widespread.  If you're not using gcc, of course you shouldn't
+specify that option.
 
 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
+to share common files.  Gnulib files used in Texinfo are 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, say,
   ../gnulib/gnulib-tool --add-import
 in your top-level Texinfo directory.  (gnulib-tool is in the gnulib CVS tree.)
 
@@ -50,7 +53,9 @@
 gnulib, you can update the files with gnulib-tool --add-import.
 
 
-About running the programs from development sources:
+
+About running the Texinfo programs from a development source tree:
+
 - 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.
@@ -69,3 +74,74 @@
 a trivial script:
 #!/bin/sh
 exec /YOUR/TEXINFO/DIR/tp/texi2any.pl "$@"
+
+
+
+Steps for making a release (pretest or official):
+
+- First checks:
+ensure texinfo.tex, texi2dvi, and htmlxref.cnf are updated on ftp.gnu.org.
+ensure TXI_XLATE in doc/Makefile.am matches actual file list.
+ensure *.po same as http://translationproject.org/latest/texinfo.
+
+- Official releases only:
+version number in texi2dvi, texi2pdf, txirefcard.tex.
+sync texi2html/test/ results with tp/.
+make dvi and fix underfull/overfull boxes.
+specially plead with bug-texinfo / beebe / compile farms to try.
+try groff.texinfo from groff source repo.
+
+- Changes to sources:
+update version in configure.ac, ChangeLog, NEWS with date if official.
+gnulib-tool --add-import
+util/srclist-txi
+make
+make po-check             # update po/POTFILES.in as needed
+make -C po update-po      # but don't commit yet, dist updates po_document
+(export MALLOC_CHECK_=2; make distcheck)  # repeat until clean
+make -C doc wwwdoc-build  # and eventually -install, for official.
+cvs commit                # when clean, then distcheck to be sure.
+make diff                 # for official
+rwtar *.tar.*             # consistent permissions in tarball?
+
+- To do the actual upload:
+pkg=texinfo
+ver=4.13.94
+
+then do one of:
+gnupload --to alpha.gnu.org:$pkg $pkg-$ver.tar.xz                #pretest
+gnupload --to ftp.gnu.org:$pkg   $pkg-$ver.tar.{gz,xz} *.diff.gz #official
+
+and the corresponding, to save in local archives:
+mv -v $pkg-$ver.tar.xz* $misc/archive/$pkg/alpha/           #pretest
+mv -v $pkg-$ver.tar.{gz,xz}* *.diff.gz $misc/archive/$pkg/  #official
+
+For pretest release, send announcement to bug-texinfo.
+
+- When official release is out there ...
+  ... update DTD and web pages:
+cd $HOME/gnu/www/texinfo/dtd # or wherever webpages checkout is
+mkdir $ver; cvs add $ver
+cp $tutil/texinfo.dtd $ver
+cvs add $ver/texinfo.dtd
+cvs com -m$ver $ver
+
+update texinfo.html and commit as needed.
+
+  ... tag source tree:
+cvs tag -b texinfo_`echo $ver | tr . _`
+
+  ... update texinfo at tug.org (contact address@hidden); from last time:
+prev=4.12
+ver=4.13
+cd ~ftp/tex
+rm -rf texinfo-$prev*
+cp ~/src/texinfo/texinfo-$ver.tar.{gz,lzma} .
+tar xzf texinfo-$ver.tar.gz
+ln -s texinfo-$ver.tar.gz texinfo.tar.gz
+!!:gs/gz/lzma
+relink texinfo $ver
+
+  ... announcements:
+news item at savannah.
+send announcement to info-gnu.

Index: NEWS
===================================================================
RCS file: /sources/texinfo/texinfo/NEWS,v
retrieving revision 1.224
retrieving revision 1.225
diff -u -b -r1.224 -r1.225
--- NEWS        7 Jan 2013 22:18:26 -0000       1.224
+++ NEWS        19 Jan 2013 15:54:04 -0000      1.225
@@ -1,4 +1,4 @@
-$Id: NEWS,v 1.224 2013/01/07 22:18:26 karl Exp $
+$Id: NEWS,v 1.225 2013/01/19 15:54:04 karl Exp $
 This NEWS file records noteworthy changes, very tersely.
 See the manual for detailed information.
 
@@ -58,13 +58,16 @@
   on the program name.
 
   The new implementation is in Perl (based on the texi2html program, but
-  with a vast array of subsequent changes).  It both replaces and is
-  intended to be (for all practical purposes) upward-compatible with the
-  C makeinfo.  It has many new features not in the C makeinfo.  For
-  example, cross-manual references are now fully supported, and
-  extensive customization of the HTML output is possible.  See the
-  `Generic Translator texi2any' chapter in the manual (among other places)
-  for more about this reimplementation.
+  with a vast array of subsequent changes).  It requires Perl 5.7.3
+  (released in March 2002) and the standard Encode module.
+  
+  The Perl texi2any/makeinfo both replaces and is intended to be (for
+  all practical purposes) upward-compatible with the C makeinfo.  It has
+  many new features not in the C makeinfo.  For example, cross-manual
+  references are now fully supported, and extensive customization of the
+  HTML output is possible.  See the `Generic Translator texi2any'
+  chapter in the manual (among other places) for more about this
+  reimplementation.
   
   The new program is, unfortunately, noticeably slower at present than
   the C program was.  We hope all the many improvements make the new

Index: util/srclist.txt
===================================================================
RCS file: /sources/texinfo/texinfo/util/srclist.txt,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -b -r1.31 -r1.32
--- util/srclist.txt    2 Jan 2013 01:00:38 -0000       1.31
+++ util/srclist.txt    19 Jan 2013 15:54:04 -0000      1.32
@@ -1,7 +1,10 @@
-# $Id: srclist.txt,v 1.31 2013/01/02 01:00:38 karl Exp $
+# $Id: srclist.txt,v 1.32 2013/01/19 15:54:04 karl Exp $
 # Files which we keep in sync from other places.
 # This is input for the script config/srclist-update in the gnulib
-# project on savannah.
+# project on savannah, and the wrapper srclist-txi in this directory.
+# 
+# Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2011, 2012, 2013
+# Free Software Foundation, Inc.
 # 
 # This file is free software; as a special exception the author gives
 # unlimited permission to copy and/or distribute it, with or without

Index: doc/Makefile.am
===================================================================
RCS file: /sources/texinfo/texinfo/doc/Makefile.am,v
retrieving revision 1.53
retrieving revision 1.54
diff -u -b -r1.53 -r1.54
--- doc/Makefile.am     14 Nov 2012 00:32:57 -0000      1.53
+++ doc/Makefile.am     19 Jan 2013 15:54:04 -0000      1.54
@@ -1,8 +1,8 @@
-# $Id: Makefile.am,v 1.53 2012/11/14 00:32:57 karl Exp $
+# $Id: Makefile.am,v 1.54 2013/01/19 15:54:04 karl Exp $
 # Makefile.am for texinfo/doc.
 #
-# Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012
-# Free Software Foundation, Inc.
+# Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012,
+# 2013 Free Software Foundation, Inc.
 #
 # This file is free software; as a special exception the author gives
 # unlimited permission to copy and/or distribute it, with or without
@@ -103,6 +103,9 @@
        && $(gendocs_invoke) -o $(manual2) $(manual2) $(manual2_title) \
        && $(gendocs_invoke) -o $(manual3) $(manual3) $(manual3_title)
        @echo "Manuals for web distribution under: $(doctemp)/"
+#
+# At official release, we need to update:
+# http://www.gnu.org/software/texinfo/manual/
 wwwdoc-install:
        cp -arf $(doctemp)/$(manual1) $(doctemp)/$(manual2) \
          $(doctemp)/$(manual3) $(www_target)

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.529
retrieving revision 1.530
diff -u -b -r1.529 -r1.530
--- doc/texinfo.txi     18 Jan 2013 23:23:41 -0000      1.529
+++ doc/texinfo.txi     19 Jan 2013 15:54:04 -0000      1.530
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.529 2013/01/18 23:23:41 karl Exp $
address@hidden $Id: texinfo.txi,v 1.530 2013/01/19 15:54:04 karl Exp $
 @c Ordinarily, Texinfo files have the extension .texi.  But texinfo.texi
 @c clashes with texinfo.tex on 8.3 filesystems, so we use texinfo.txi.
 
@@ -18531,7 +18531,7 @@
 @c Writing these three cross references using xref results in
 @c three references to the same named manual, which looks strange.
 @iftex
-For more information, see @address@hidden options}, as well as
+For more information, see @address@hidden Options}, as well as
 ``Easy Customization Interface,'' ``Examining and Setting Variables,''
 and ``Init File'' in @cite{The GNU Emacs Manual}.
 @end iftex
@@ -22007,7 +22007,7 @@
 as:
 
 @example
-$Id: texinfo.txi,v 1.529 2013/01/18 23:23:41 karl Exp $
+$Id: texinfo.txi,v 1.530 2013/01/19 15:54:04 karl Exp $
 @end example
 
 (This is potentially useful in all sources that use version control,

Index: doc/version.texi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/version.texi,v
retrieving revision 1.131
retrieving revision 1.132
diff -u -b -r1.131 -r1.132
--- doc/version.texi    19 Jan 2013 00:13:11 -0000      1.131
+++ doc/version.texi    19 Jan 2013 15:54:05 -0000      1.132
@@ -1,4 +1,4 @@
address@hidden UPDATED 18 January 2013
address@hidden UPDATED 19 January 2013
 @set UPDATED-MONTH January 2013
 @set EDITION 4.13.94
 @set VERSION 4.13.94

Index: util/srclist-txi
===================================================================
RCS file: util/srclist-txi
diff -N util/srclist-txi
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ util/srclist-txi    19 Jan 2013 15:54:04 -0000      1.1
@@ -0,0 +1,29 @@
+#!/bin/sh
+# $Id: srclist-txi,v 1.1 2013/01/19 15:54:04 karl Exp $
+# Texinfo's wrapper for the Gnulib script config/srclist-update,
+# to define particular variables our srclist.txt uses.
+# 
+# Copyright 2013 Free Software Foundation, Inc.
+#
+# This file is free software; as a special exception the author gives
+# unlimited permission to copy and/or distribute it, with or without
+# modifications, as long as this notice is preserved.
+#
+# This program is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
+# implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+
+# per-user overrides.
+case $LOGNAME in
+karl)
+  : ${EMACSSRC=/usr/local/gnu/src/emacs-24.2};      export EMACSSRC
+  : ${GETTEXT=/usr/local/gnu/src/gettext-0.18.2};   export GETTEXT
+  : ${AUTOMAKE=/usr/local/gnu/share/automake-1.13}; export AUTOMAKE
+  : ${GSASL=$HOME/gnu/src/gsasl};                   export GSASL
+  : ${GNULIB=$HOME/gnu/src/gnulib};                 export GNULIB
+  ;;
+esac
+
+mydir=`dirname $0`
+(cd "$mydir/.." && $GNULIB/config/srclist-update <util/srclist.txt) \
+| sed 's/^## /cp /'