[5269] perl 5.18.0; give up and preprocess away the X<...> constructs

[karl]

Revision: 5269
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=5269
Author:   karl
Date:     2013-06-29 16:11:15 +0000 (Sat, 29 Jun 2013)
Log Message:
-----------
perl 5.18.0; give up and preprocess away the X<...> constructs

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/contrib/perldoc-all/GNUmakefile
    trunk/contrib/perldoc-all/README

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2013-06-27 17:15:40 UTC (rev 5268)
+++ trunk/ChangeLog     2013-06-29 16:11:15 UTC (rev 5269)
@@ -1,3 +1,8 @@
+2013-06-28  Karl Berry  <address@hidden>
+
+       * contrib/perldoc-all/GNUmakefile (texi_pod_doc_incl): remove X<...>
+       pod constructs, so we get good filenames.  For perl-5.18.0.
+
 2013-06-25  Patrice Dumas  <address@hidden>
 
        * tp/Texinfo/Convert/HTML.pm: use "prev" for rel attribute and not 

Modified: trunk/contrib/perldoc-all/GNUmakefile
===================================================================
--- trunk/contrib/perldoc-all/GNUmakefile       2013-06-27 17:15:40 UTC (rev 
5268)
+++ trunk/contrib/perldoc-all/GNUmakefile       2013-06-29 16:11:15 UTC (rev 
5269)
@@ -40,9 +40,13 @@
 
 $(texi_pod_doc_incl): $(perl_pod_subdir)/*.pod
        rm -rf $(texi_pod_subdir)
-# we omit the numerous delta pods, which are uninteresting when searching
-# (and take tons of time and space).
+# We remove all X<...> cross-reference constructs from the pods
+# before processing, since they are not parsed properly, resulting
+# in many chapters called simply "NAME", e.g., perldebug and perlsyn.
+# And we omit the numerous delta pods, which are uninteresting when
+# searching (and take tons of time and space to process).  
        cd $(perl_pod_subdir) \
+       && perl -p -i.bak -e 's,X<.*?>,,g' *.pod \
        && $(pod2texi) -o $@ $(pod2texi_args) \
          `ls *.pod | fgrep -v delta` \
        && mv $(texi_pod_subdir) $@ ../..
@@ -50,8 +54,8 @@
 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.
+       ls -lt $(www_target)/html_chapter | tail  # cvs rm -f obsolete files
+                                                  # and cvs add new (status ?).
 
 # when running make dist, ensure we have none of the build files.
 # (Since the whole contrib/ directory is included in its entirety.)

Modified: trunk/contrib/perldoc-all/README
===================================================================
--- trunk/contrib/perldoc-all/README    2013-06-27 17:15:40 UTC (rev 5268)
+++ trunk/contrib/perldoc-all/README    2013-06-29 16:11:15 UTC (rev 5269)
@@ -10,8 +10,9 @@
 This stuff is about making Texinfo out of the standard Perl *.pod files.
 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.3.tar.gz
+The idea is to unpack the perl distribution here, as in,
+  wget http://www.cpan.org/src/5.0/perl-5.NN.M.tar.gz  # with right NN.M
+  tar xf perl-*.tar.gz
 and run (GNU) make.  Aside from the result hopefully being useful in
 itself (just copy the .info file to an Info directory), it also serves
 as a nontrivial example of using pod2texi.