[6990] README-hacking release instructions

[Gavin D. Smith]

Revision: 6990
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6990
Author:   gavin
Date:     2016-02-06 10:53:11 +0000 (Sat, 06 Feb 2016)
Log Message:
-----------
README-hacking release instructions

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/README-hacking

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2016-02-06 10:38:22 UTC (rev 6989)
+++ trunk/ChangeLog     2016-02-06 10:53:11 UTC (rev 6990)
@@ -1,5 +1,16 @@
 2016-02-06  Gavin Smith  <address@hidden>
 
+       * README-hacking: Update notes about making a release.  Move 
+       "make po-check" line.  Remove "rm ti.texi" for updating texindex 
+       version.  Move gnulib-tool --add-import and util/srclist-txi, 
+       and say what the latter is for.  Move "official releases only" 
+       section only so that the "make distcheck" line above can be the 
+       final command to produce the release tarball.  Move upload 
+       instructions after this command.  Move instructions about 
+       tagging source tree.  Combine instructions about checking DTD.
+
+2016-02-06  Gavin Smith  <address@hidden>
+
        * doc/texinfo-tex-test.texi,
        * doc/Makefile.am,
        * doc/info-stnd.texi,

Modified: trunk/README-hacking
===================================================================
--- trunk/README-hacking        2016-02-06 10:38:22 UTC (rev 6989)
+++ trunk/README-hacking        2016-02-06 10:53:11 UTC (rev 6990)
@@ -153,44 +153,57 @@
 Ensure TXI_XLATE in doc/Makefile.am matches actual file list.
 Check that TEXINFO_DTD_VERSION has been updated to the next version in
   configure.ac if the DTD has been modified since the last release.
+  See comments in configure.ac, and run (at the top level) make dtd-check.
 Check "make ccheck" and "make vcheck" work in "doc/refcard".
 Check "dist-xz" is in the option list in configure.ac (often removed
 for speed when testing).
+make po-check             # update po/POTFILES.in as needed
+gnulib-tool --add-import  # for pretest
+util/srclist-txi          # for pretest, to sync files with other sources
 
+- Official releases only:
+version number in texi2dvi, texi2pdf, txirefcard.tex.
+version and date in NEWS.
+(cd tp && ./maintain/change_perl_modules_version.sh auto)
+  -- this updates all the version numbers in the Perl modules
+sync texi2html/test/ results with tp/.
+
+ensure building standalone modules for CPAN still works.
+make V=1 pdf and fix underfull/overfull boxes.
+
 - Changes to sources:
 update version in configure.ac, notice in ChangeLog.
 check that texindex version is updated properly
-  (rm ti.texi texindex.awk ; make)
-gnulib-tool --add-import  # for pretest
+  (rm texindex.awk ; make)
 Check that translations have been updated, e.g.:
   rsync  -Lrtzv  translationproject.org::tp/latest/texinfo/  texinfo
   rsync  -Lrtzv  translationproject.org::tp/latest/texinfo_document/ \
                  texinfo_document
-followed by copying updated translation files to po/ and po_document/.
-util/srclist-txi          # for pretest 
+    followed by copying updated translation files to po/ and po_document/.
 pod2man Pod-Simple-Texinfo/pod2texi.pl >man/pod2texi.1 # until we fix deps
 make
-make po-check             # update po/POTFILES.in as needed
 make update-po            # both po and po_document needed, build a dist first
 make -C doc wwwdoc-build  # and -install for official (and eventual commit)
 make long-checks          # distcheck does not do this
 (export MALLOC_CHECK_=2; make distcheck)  # repeat until clean
 svn commit                # when clean, then distcheck to be sure
 
-- Official releases only:
-version number in texi2dvi, texi2pdf, txirefcard.tex.
-version and date in NEWS.
-(cd tp && ./maintain/change_perl_modules_version.sh auto)
-  -- this updates all the version numbers in the Perl modules
-sync texi2html/test/ results with tp/.
+- To do the actual upload:
+pkg=texinfo
+ver=6.0
 
-ensure building standalone modules for CPAN still works.
-make V=1 pdf and fix underfull/overfull boxes.
+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.xz #official
+   Use --user option if not using default key
+   texinfo.tex and texi2dvi should already be up to date, but check.  Use
+gnupload --replace --to ftp.gnu.org:texinfo texi2dvi
 
-#  ... dtd version check:
-TEXINFO_DTD_VERSION should already have been updated to $ver in
-configure.ac if it was needed, but check again.  See comments in
-configure.ac, and run (at the top level) make dtd-check.
+#  Official releases only: tag source tree (use your own username before @):
+svn copy -r 6363 -m'texinfo_6_0 tag based on r6363' \
+  svn+ssh://address@hidden/texinfo/trunk \
+  svn+ssh://address@hidden/texinfo/tags/texinfo_6_0
+[for karl: /srv/svn/texinfo]  
 
 #  ... set up dtd directory on web pages:
 cd $HOME/gnu/www/texinfo/dtd # or wherever webpages checkout is
@@ -217,18 +230,10 @@
 rm -rf texinfo-$ver texinfo-$prev
 ro texinfo-*$ver*
 
-- To do the actual upload:
+- To save in local archives:
 pkg=texinfo
 ver=6.0
 
-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.xz #official
-   Use --user option if not using default key
-   texinfo.tex and texi2dvi should already be up to date, but check.  Use
-gnupload --replace --to ftp.gnu.org:texinfo texi2dvi
-
-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.xz $misc/archive/$pkg/prod/  #official
 
@@ -244,12 +249,6 @@
 followed by cvs rm -f.  Likewise, check for added files with
 cvs -qn update, followed by cvs add.  When done, run cvs commit.
 
-#  Official releases only: tag source tree (use your own username before @):
-svn copy -r 6363 -m'texinfo_6_0 tag based on r6363' \
-  svn+ssh://address@hidden/texinfo/trunk \
-  svn+ssh://address@hidden/texinfo/tags/texinfo_6_0
-[for karl: /srv/svn/texinfo]  
-
 #  Official releases only: ... update texinfo at tug.org
 #  (contact address@hidden):
 prev=5.2