[libstdc++,doc] Link maintenance for doc/xml/manual/documentation_hacking.xml
Gerald Pfeifer
gerald@pfeifer.com
Mon Feb 6 10:28:00 GMT 2017
Before GCC 7 branches, I am trying to get as many links in our
(non-wwwdocs) documentation fixed as possible. Turns out libstdc++
has a fair number that need attention.
In documentation_hacking.xml I could not find a replacement document
for DocBook Publishing Tools. The other two changes were more straight-
forward.
(In particular, also note that "here" or "online" as names for links
should be avoided, and this patch also improves one such case.)
Applied (revision 245205).
Gerald
2017-02-06 Gerald Pfeifer <gerald@pfeifer.com>
* doc/xml/manual/documentation_hacking.xml: Remove obsolete link
to DocBook Publishing Tools.
epubcheck has moved to GitHub.
Update URL of the DocBook Element Reference; use that term as
link description instead of "online".
Index: doc/xml/manual/documentation_hacking.xml
===================================================================
--- doc/xml/manual/documentation_hacking.xml (revision 245203)
+++ doc/xml/manual/documentation_hacking.xml (working copy)
@@ -765,9 +765,8 @@
For PDF output, something that transforms valid Docbook XML to PDF is
required. Possible solutions include <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://dblatex.sourceforge.net">dblatex</link>,
<command>xmlto</command>, or <command>prince</command>. Of
- these, <command>dblatex</command> is the default. Other
- options are listed on the DocBook web <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://wiki.docbook.org/topic/DocBookPublishingTools">pages</link>. Please
- consult the <email>libstdc++@gcc.gnu.org</email> list when
+ these, <command>dblatex</command> is the default.
+ Please consult the <email>libstdc++@gcc.gnu.org</email> list when
preparing printed manuals for current best practice and
suggestions.
</para>
@@ -778,7 +777,7 @@
</para>
<para>
- For epub output, the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://sourceforge.net/projects/docbook/files/epub3/">stylesheets</link> for EPUB3 are required. These stylesheets are still in development. To validate the created file, <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://code.google.com/p/epubcheck/">epubcheck</link> is necessary.
+ For epub output, the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://sourceforge.net/projects/docbook/files/epub3/">stylesheets</link> for EPUB3 are required. These stylesheets are still in development. To validate the created file, <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://github.com/IDPF/epubcheck">epubcheck</link> is necessary.
</para>
</section>
@@ -1022,9 +1021,8 @@
<para>
- Complete details on Docbook markup can be found in the DocBook
- Element Reference,
- <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.docbook.org/tdg/en/html/part2.html">online</link>.
+ Complete details on Docbook markup can be found in the
+ <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://tdg.docbook.org/tdg/5.0/ref-elements.html">DocBook Element Reference</link>.
An incomplete reference for HTML to Docbook conversion is
detailed in the table below.
</para>
More information about the Libstdc++
mailing list