[5237] perl 5.16.3 manual

[karl]

Revision: 5237
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=5237
Author:   karl
Date:     2013-03-14 16:05:37 +0000 (Thu, 14 Mar 2013)
Log Message:
-----------
perl 5.16.3 manual

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/NEWS
    trunk/README-hacking
    trunk/contrib/perldoc-all/GNUmakefile
    trunk/contrib/perldoc-all/README
    trunk/contrib/perldoc-all/perldoc-all.texi
    trunk/doc/texinfo.tex
    trunk/doc/texinfo.txi
    trunk/doc/version.texi

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2013-03-14 02:01:39 UTC (rev 5236)
+++ trunk/ChangeLog     2013-03-14 16:05:37 UTC (rev 5237)
@@ -1,3 +1,19 @@
+2013-03-14  Karl Berry  <address@hidden>
+
+       * NEWS: mention switch from cvs to svn.
+       * doc/texinfo.txi (Invoking @t{pod2texi}): svn url instead of cvs
+       for Perl manual in Texinfo.
+       * contrib/perldoc-all/perldoc-all.texi: likewise, and turn off
+       all underfull/overfull messages since we can't do anything about them.
+       * contrib/perldoc-all/README: 5.16.3.
+       * contrib/perldoc-all/GNUmakefile (all): set save_size in
+       environment to avoid TeX overflow.
+       (install): new target.
+       * doc/texinfo.tex (\nonfillstart): only reset to \hfuzz=12pt
+       if it's less than that.
+
+       * README-hacking: tweaks to release wording.
+
 2013-03-12  Karl Berry  <address@hidden>
 
        * Version 5.1.

Modified: trunk/NEWS
===================================================================
--- trunk/NEWS  2013-03-14 02:01:39 UTC (rev 5236)
+++ trunk/NEWS  2013-03-14 16:05:37 UTC (rev 5237)
@@ -34,6 +34,9 @@
 * install-info:
   . lzip (.lz) compression supported.
 
+* Development: switch from CVS to Subversion.
+  https://savannah.gnu.org/svn/?group=texinfo
+
 
 5.0 (16 February 2013)
 * Language:

Modified: trunk/README-hacking
===================================================================
--- trunk/README-hacking        2013-03-14 02:01:39 UTC (rev 5236)
+++ trunk/README-hacking        2013-03-14 16:05:37 UTC (rev 5237)
@@ -109,9 +109,9 @@
 make
 make po-check             # update po/POTFILES.in as needed
 make -C po update-po      # but don't commit yet, dist updates po_document
-make -C doc wwwdoc-build  # and eventually -install, for official.
+make -C doc wwwdoc-build  # and -install for official (and eventual commit)
 (export MALLOC_CHECK_=2; make distcheck)  # repeat until clean
-svn commit                # when clean, then distcheck to be sure.
+svn commit                # when clean, then distcheck to be sure
 #create diff  for official, see below 
 
 - To do the actual upload:
@@ -120,11 +120,12 @@
 
 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
+gnupload --to ftp.gnu.org:$pkg   $pkg-$ver.tar.{gz,xz} *.diff.xz #official
+  (also gnupload texi2dvi at each official release.)
 
 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
+mv -v $pkg-$ver.tar.{gz,xz}* *.diff.xz $misc/archive/$pkg/  #official
 
 For pretest release, send announcement to bug-texinfo.
 
@@ -144,8 +145,8 @@
 cvs tag -b texinfo_`echo $ver | tr . _`
 
   ... update texinfo at tug.org (contact address@hidden); from last time:
-prev=4.13
-ver=5.0
+prev=5.0
+ver=5.1
 cd ~ftp/tex
 rm -rf texinfo-$prev*
 cp ~/src/texinfo/texinfo-$ver.tar.{gz,xz} .
@@ -159,12 +160,13 @@
 send announcement to info-gnu, cc bug-texinfo.
 
   ... make diffs at official release:
-  prev=4.13
-  ver=5.0
+  prev=5.0
+  ver=5.1
   cd $xarchive/../prod
-  tar xf texinfo-$ver.tar.gz
+  tar xf $txi/texinfo-$ver.tar.gz
   tar xf texinfo-$prev.tar.gz
   diff -Nrc2 texinfo-$prev texinfo-$ver | xz >texinfo-$prev-$ver.diff.xz
+  ls -l !$
   gnupload --to ftp.gnu.org:texinfo !$
   rm -rf texinfo-$ver texinfo-$prev
   ro texinfo-*$ver*

Modified: trunk/contrib/perldoc-all/GNUmakefile
===================================================================
--- trunk/contrib/perldoc-all/GNUmakefile       2013-03-14 02:01:39 UTC (rev 
5236)
+++ trunk/contrib/perldoc-all/GNUmakefile       2013-03-14 16:05:37 UTC (rev 
5237)
@@ -34,7 +34,9 @@
 
 all: $(texi_pod_doc_incl)
        rm -rf manual *.aux *.toc *.??
-       gendocs.sh $(gendocs_args) $(texi_pod_doc) $(gendocs_title)
+# turns out the combined docs overflow one of TeX's arrays; increase it.
+       env save_size=100000 \
+         gendocs.sh $(gendocs_args) $(texi_pod_doc) $(gendocs_title)
 
 $(texi_pod_doc_incl): $(perl_pod_subdir)/*.pod
        rm -rf $(texi_pod_subdir)
@@ -45,10 +47,14 @@
          `ls *.pod | fgrep -v delta` \
        && mv $(texi_pod_subdir) $@ ../..
 
-force:
+www_target = $(HOME)/gnu/www/www/software/perl/manual
+install:
+       cp -arf manual/. $(www_target)/.
+       ls -ltu $(www_target)/html_chapter | tail  # cvs rm -f obsolete files
+                                                   # and cvs add new.
 
 # when running make dist, ensure we have none of the build files.
 # (Since the whole contrib/ directory is included in its entirety.)
 distclean:
-       rm -rf manual perl-5.16.2 $(texi_pod_doc) $(texi_pod_doc_incl)
+       rm -rf manual perl-5.*.* $(texi_pod_doc) $(texi_pod_doc_incl)
        rm -rf *.?? *.??? *.info *~ \#*

Modified: trunk/contrib/perldoc-all/README
===================================================================
--- trunk/contrib/perldoc-all/README    2013-03-14 02:01:39 UTC (rev 5236)
+++ trunk/contrib/perldoc-all/README    2013-03-14 16:05:37 UTC (rev 5237)
@@ -11,7 +11,8 @@
 The results are at http://www.gnu.org/software/perl/manual.
 
 The idea is to download the perl distribution here, as in,
-  wget http://www.cpan.org/src/5.0/perl-5.16.2.tar.gz
+  wget http://www.cpan.org/src/5.0/perl-5.16.3.tar.gz
 and run (GNU) make.  Aside from the result hopefully being useful in
-itself, it also serves as a nontrivial example of using pod2texi.
+itself (just copy the .info file to an Info directory), it also serves
+as a nontrivial example of using pod2texi.
 

Modified: trunk/contrib/perldoc-all/perldoc-all.texi
===================================================================
--- trunk/contrib/perldoc-all/perldoc-all.texi  2013-03-14 02:01:39 UTC (rev 
5236)
+++ trunk/contrib/perldoc-all/perldoc-all.texi  2013-03-14 16:05:37 UTC (rev 
5237)
@@ -2,6 +2,11 @@
 @c This top-level file is so trivial, it has to be public domain.
 @setfilename perldoc-all.info
 @settitle Perl pod documentation
address@hidden
address@hidden
+\global\hfuzz=\maxdimen
+\global\hbadness=10000
address@hidden tex
 
 @shortcontents
 @contents
@@ -18,7 +23,7 @@
 formats, and thought they would share the results.  Suggestions welcome.
 
 This is created entirely by the Texinfo tools; see the
address@hidden://cvs.savannah.gnu.org/viewvc/texinfo/contrib/perldoc-all/?root=texinfo,
address@hidden://svn.savannah.gnu.org/viewvc/trunk/contrib/perldoc-all/?root=texinfo,
 @file{contrib/perldoc-all}} directory in the Texinfo sources for the
 procedure used.  The output is available at
 @url{http://www.gnu.org/software/perl/manual}.

Modified: trunk/doc/texinfo.tex
===================================================================
--- trunk/doc/texinfo.tex       2013-03-14 02:01:39 UTC (rev 5236)
+++ trunk/doc/texinfo.tex       2013-03-14 16:05:37 UTC (rev 5237)
@@ -3,7 +3,7 @@
 % Load plain if necessary, i.e., if running under initex.
 \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi
 %
-\def\texinfoversion{2013-02-01.11}
+\def\texinfoversion{2013-03-14.08}
 %
 % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995,
 % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
@@ -6402,7 +6402,7 @@
 \newdimen\nonfillparindent
 \def\nonfillstart{%
   \aboveenvbreak
-  \hfuzz = 12pt % Don't be fussy
+  \ifdim\hfuzz < 12pt \hfuzz = 12pt \fi % Don't be fussy
   \sepspaces % Make spaces be word-separators rather than space tokens.
   \let\par = \lisppar % don't ignore blank lines
   \obeylines % each line of input is a line of output

Modified: trunk/doc/texinfo.txi
===================================================================
--- trunk/doc/texinfo.txi       2013-03-14 02:01:39 UTC (rev 5236)
+++ trunk/doc/texinfo.txi       2013-03-14 16:05:37 UTC (rev 5237)
@@ -18455,7 +18455,7 @@
 
 For an example of using @code{pod2texi} to make Texinfo out of the
 Perl documentation itself, see
address@hidden://cvs.savannah.gnu.org/viewvc/texinfo/contrib/perldoc-all/?root=texinfo,
address@hidden://svn.savannah.gnu.org/viewvc/trunk/contrib/perldoc-all/?root=texinfo,
 @file{contrib/perldoc-all}} in the Texinfo source distribution (the
 output is available at @url{http://www.gnu.org/software/perl/manual}).
 

Modified: trunk/doc/version.texi
===================================================================
--- trunk/doc/version.texi      2013-03-14 02:01:39 UTC (rev 5236)
+++ trunk/doc/version.texi      2013-03-14 16:05:37 UTC (rev 5237)
@@ -1,4 +1,4 @@
address@hidden UPDATED 11 March 2013
address@hidden UPDATED 14 March 2013
 @set UPDATED-MONTH March 2013
 @set EDITION 5.1
 @set VERSION 5.1