[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[6200] perl-5.20.2 doc must omit new perlunicook, unfortunately
From: |
karl |
Subject: |
[6200] perl-5.20.2 doc must omit new perlunicook, unfortunately |
Date: |
Sat, 04 Apr 2015 16:15:26 +0000 |
Revision: 6200
http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6200
Author: karl
Date: 2015-04-04 16:15:24 +0000 (Sat, 04 Apr 2015)
Log Message:
-----------
perl-5.20.2 doc must omit new perlunicook, unfortunately
Modified Paths:
--------------
trunk/contrib/perldoc-all/GNUmakefile
trunk/util/htmlxref.cnf
Modified: trunk/contrib/perldoc-all/GNUmakefile
===================================================================
--- trunk/contrib/perldoc-all/GNUmakefile 2015-04-03 16:02:28 UTC (rev
6199)
+++ trunk/contrib/perldoc-all/GNUmakefile 2015-04-04 16:15:24 UTC (rev
6200)
@@ -1,8 +1,8 @@
# $Id$
-# Sample Makefile to build Texinfo from the Perl POD documentation,
+# Makefile to build Texinfo from the Perl POD documentation,
# using pod2texi.
#
-# Copyright 2013, 2014 Free Software Foundation, Inc.
+# Copyright 2013, 2014, 2015 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
@@ -30,6 +30,7 @@
gendocs_args += --split chapter
gendocs_args += --no-ascii
gendocs_args += --source $(texi_pod_subdir)
+gendocs_args += --tex "--batch -t @finalout"
gendocs_title = "Perl documentation in Texinfo"
all: $(texi_pod_doc_incl)
@@ -40,27 +41,38 @@
$(texi_pod_doc_incl): $(perl_pod_subdir)/*.pod
rm -rf $(texi_pod_subdir)
+#
# 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).
+#
+# We omit the numerous delta pods, which are uninteresting when
+# searching (and take tons of time and space to process).
+#
+# We also omit perlunicook, since it necessarily has many binary Unicode
+# characters, and processing the whole thing in UTF-8 makes it less useful.
+#
cd $(perl_pod_subdir) \
&& perl -p -i.bak -e 's,X<.*?>>?,,g' *.pod \
&& $(pod2texi) -o $@ $(pod2texi_args) \
- `ls *.pod | fgrep -v delta` \
+ `ls *.pod | egrep -v "(delta|unicook)"` \
&& mv $(texi_pod_subdir) $@ ../..
-# updating on www.gnu.org.
+# updating on www.gnu.org. We do not install the split HTML files
+# because the long file names cause trouble for some GNU webmasters,
+# who use encryption software that reduces the maximum file name length
+# by about half. Sigh.
www_target = $(HOME)/gnu/www/www/software/perl/manual
install:
cp -arf manual/. $(www_target)/.
- ls -lt $(www_target)/html_chapter | tail # cvs rm -f obsolete files
- # and cvs add new (status ?).
- cd $(www_target) && cvs update | grep -v '^M '
+ rm -rf $(www_target)/html_chapter
+ cd $(www_target) && cvs update -P | grep -v '^M '
-# when running make dist, ensure we have none of the build files.
-# (Since the whole contrib/ directory is included in its entirety.)
+mostlyclean:
+ rm -rf manual $(texi_pod_doc_incl)
+
+# 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.*.* $(texi_pod_doc) $(texi_pod_doc_incl)
rm -rf *.?? *.??? *.info *~ \#*
Modified: trunk/util/htmlxref.cnf
===================================================================
--- trunk/util/htmlxref.cnf 2015-04-03 16:02:28 UTC (rev 6199)
+++ trunk/util/htmlxref.cnf 2015-04-04 16:15:24 UTC (rev 6200)
@@ -1,6 +1,6 @@
# htmlxref.cnf - reference file for free Texinfo manuals on the web.
-htmlxrefversion=2015-02-03.18; # UTC
+htmlxrefversion=2015-04-04.16; # UTC
# Copyright 2010, 2011, 2012, 2013, 2014, 2015 Free Software Foundation, Inc.
#
@@ -500,6 +500,8 @@
# can't use pcb since url's contain dates --30nov10
+perl mono ${GS}/perl/manual/perldoc-all.html
+
PIES = http://www.gnu.org.ua/software/pies/manual
pies mono ${PIES}/pies.html
pies chapter ${PIES}/html_chapter/
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [6200] perl-5.20.2 doc must omit new perlunicook, unfortunately,
karl <=