Re: [PATCH] fix tool list for FreeBSD - Mailing list pgsql-docs

From Peter Eisentraut
Subject Re: [PATCH] fix tool list for FreeBSD
Date
Msg-id 54454D83.6000407@gmx.net
Whole thread Raw
In response to [PATCH] fix tool list for FreeBSD  (Dag-Erling Smørgrav <des@des.no>)
Responses Re: [PATCH] fix tool list for FreeBSD  (Dag-Erling Smørgrav <des@des.no>)
List pgsql-docs
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.



pgsql-docs by date:

Previous
From: Dag-Erling Smørgrav
Date:
Subject: [PATCH] fix tool list for FreeBSD
Next
From: Peter Eisentraut
Date:
Subject: 9.4 recommendations for archive_command vs. replication slots