texinfo-commits
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

branch master updated: Update contrib/perldoc-all related information.


From: Patrice Dumas
Subject: branch master updated: Update contrib/perldoc-all related information.
Date: Tue, 25 Oct 2022 17:16:00 -0400

This is an automated email from the git hooks/post-receive script.

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new 31a1097fe5 Update contrib/perldoc-all related information.
31a1097fe5 is described below

commit 31a1097fe544d9893f4a7700df6144e4836f170b
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Tue Oct 25 23:15:17 2022 +0200

    Update contrib/perldoc-all related information.
---
 contrib/README                  | 3 +--
 contrib/perldoc-all/GNUmakefile | 6 +++---
 contrib/perldoc-all/README      | 9 ++++-----
 3 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/contrib/README b/contrib/README
index 90d3c7827b..1c86a2c770 100644
--- a/contrib/README
+++ b/contrib/README
@@ -25,5 +25,4 @@ simpler (which is not to say simple) than finalizing 
texifont/, though
 of course much less featureful.
 
 The perldoc-all subdirectory is about making Texinfo out of the standard
-Perl *.pod files.  The results are at
-http://www.gnu.org/software/perl/manual.
+Perl *.pod files.
diff --git a/contrib/perldoc-all/GNUmakefile b/contrib/perldoc-all/GNUmakefile
index 2b056b963e..5f34b8ba39 100644
--- a/contrib/perldoc-all/GNUmakefile
+++ b/contrib/perldoc-all/GNUmakefile
@@ -25,9 +25,9 @@ pod2texi_args += --subdir=$(texi_pod_subdir)
 gendocs_args  = --email bug-texinfo@gnu.org
 # Unfortunately have to use --no-validate since not all the names and
 # L<references> match up.  The main issue with missing links is because
-# Pod::Simple::Role::XHTML::WithLinkMappings which formats the Perldoc Browser
-# does not follow the Pod specification and adds anchors:
-#   "a link will be generated using the first word of the target."
+# of the Pod::Simple::Role::XHTML::WithExtraTargets role of the
+# MetaCPAN::Pod::XHTML class, which adds anchors:
+#   "Link targets based on the first word of headings will be added to make 
linking easier."
 gendocs_args += --common "--no-warn --no-validate"
 # Split HTML by chapter is the natural thing here.
 gendocs_args += --split chapter
diff --git a/contrib/perldoc-all/README b/contrib/perldoc-all/README
index 32adc6d167..63251e713a 100644
--- a/contrib/perldoc-all/README
+++ b/contrib/perldoc-all/README
@@ -7,7 +7,7 @@ texinfo/contrib/perldoc-all/README
   notice and this notice are preserved.
 
 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 results used to be at http://www.gnu.org/software/perl/manual.
 
 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
@@ -17,8 +17,7 @@ itself (just copy the .info file to an Info directory), it 
also serves
 as a nontrivial example of using pod2texi.
 
 Note that a main issue with the generated files is that many internal
-links are missing because the links do not follow the Pod specification
-as Pod::Simple::Role::XHTML::WithLinkMappings which formats the Perldoc
-Browser adds anchors:
-  "a link will be generated using the first word of the target."
+links are missing because of the Pod::Simple::Role::XHTML::WithExtraTargets
+role of the MetaCPAN::Pod::XHTML class, which adds anchors:
+   "Link targets based on the first word of headings will be added to make 
linking easier."
 



reply via email to

[Prev in Thread] Current Thread [Next in Thread]