Re: [PATCH] fix tool list for FreeBSD

On 10/16/14 3:12 PM, Dag-Erling Smørgrav wrote:
> The list of tools required to build the documentation on FreeBSD is
> outdated.  The following patch fixes it:
>
> diff --git a/doc/src/sgml/docguide.sgml b/doc/src/sgml/docguide.sgml
> index 3cc1d60..9626592 100644
> --- a/doc/src/sgml/docguide.sgml
> +++ b/doc/src/sgml/docguide.sgml
> @@ -219,10 +219,7 @@
>      documentation on FreeBSD.
>      <itemizedlist>
>       <listitem>
> -      <para><filename>textproc/sp</filename></para>
> -     </listitem>
> -     <listitem>
> -      <para><filename>textproc/openjade</filename></para>
> +      <para><filename>textproc/jade</filename></para>
>       </listitem>
>       <listitem>
>        <para><filename>textproc/iso8879</filename></para>

This replaces openjade by jade.  Why?  (Arguably, we should recommend
opensp if we're going to suggest openjade.)

> @@ -231,7 +228,7 @@
>        <para><filename>textproc/dsssl-docbook-modular</filename></para>
>       </listitem>
>       <listitem>
> -      <para><filename>textproc/docbook-420</filename></para>
> +      <para><filename>textproc/docbook-sgml</filename></para>
>       </listitem>
>      </itemizedlist>
>     </para>

That looks correct.  We should also remove iso8879, since it's pulled in
by docbook-sgml.

And we should add docbook-xml, docbook-xsl, and libxslt.

Also, the piece about the catalog file not being updated is surely outdated?

Ironically, following the link to the FreeBSD Handbook shows the same
problem:  They are linking to textproc/docbook-xml-450, which no longer
exists.