[publican-list] [PATCH] Add an early reference and link to the DocBook 5 standard.

[Jeff Fearn]

Hi Robert, I'd prefer not to do this since, AIUI, there are enough
changes in DocBook 5 that it's going to take a fair effort to confirm
the things we override in Publican actually work on DocBook 5.

It will take a full audit of the style sheets and will probably lead to
a different approach to how we override stuff. This will be the next
major effort after the website merge is complete.

Cheers, Jeff.

On Wed, 2010-06-02 at 14:10 -0400, Robert P. J. Day wrote:
> Signed-off-by: Robert P. J. Day <rpjday at crashcourse.ca>
> 
> ---
> 
> Index: publican/Users_Guide/en-US/Introduction.xml
> ===================================================================
> --- publican/Users_Guide/en-US/Introduction.xml	(revision 1296)
> +++ publican/Users_Guide/en-US/Introduction.xml	(working copy)
> @@ -6,7 +6,7 @@
>  <preface id="pref-Users_Guide-Introduction">
>  	<title>Introduction</title>
>  	<para><indexterm><primary>Introduction</primary></indexterm>
> -		<application>Publican</application> is a tool for publishing material authored in DocBook XML. This guide explains how to create and build books and articles using <application>Publican</application>. It is not a general DocBook XML tutorial; refer to <citetitle>DocBook: The Definitive Guide</citetitle> by Norman Walsh and Leonard Muellner, available at <ulink url="http://www.docbook.org/tdg/en/html/docbook.html" /> for more general help with DocBook XML.
> +		<application>Publican</application> is a tool for publishing material authored in DocBook XML. This guide explains how to create and build books and articles using <application>Publican</application>. It is not a general DocBook XML tutorial; refer to <citetitle>DocBook: The Definitive Guide</citetitle> by Norman Walsh and Leonard Muellner for more general help with DocBook XML.  The 4.x version of that book can be found at <ulink url="http://www.docbook.org/tdg/en/html/docbook.html" /> , while the more recently-released DocBook 5 standard can be found at <ulink url="http://www.docbook.org/tdg5/en/html/docbook.html" />.
>  	</para>
>  	<para>
>  		<application>Publican</application> began life as an internal tool used by Red Hat's Documentation Group (now known as Engineering Content Services). On occasion, this legacy is visible.
> 
> 
> rday
> 

-- 
Jeff Fearn <jfearn at redhat.com>
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY

Sure our competitors can rebuild the source but can they engage the customer the same way? -wmealing