This is the mail archive of the libstdc++@gcc.gnu.org mailing list for the libstdc++ project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[libstdc++,doc] Link maintenance for doc/xml/manual/documentation_hacking.xml


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>


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]