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.