[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."
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- branch master updated: Update contrib/perldoc-all related information.,
Patrice Dumas <=