Received: from localhost (mx1.hub.org [200.46.208.251])
	by postgresql.org (Postfix) with ESMTP id C4C159FA219
	for <pgsql-docs-postgresql.org@postgresql.org>;
	Wed, 11 Oct 2006 23:20:44 -0300 (ADT)
Received: from postgresql.org ([200.46.204.71])
	by localhost (mx1.hub.org [200.46.208.251]) (amavisd-new, port 10024)
	with ESMTP id 80205-10 for <pgsql-docs-postgresql.org@postgresql.org>;
	Wed, 11 Oct 2006 23:20:30 -0300 (ADT)
X-Greylist: from auto-whitelisted by SQLgrey-
Received: from linda-1.paradise.net.nz (linda-1.paradise.net.nz
	[203.96.152.180])
	by postgresql.org (Postfix) with ESMTP id BFE039FB259
	for <pgsql-docs@postgresql.org>; Wed, 11 Oct 2006 23:20:29 -0300 (ADT)
Received: from smtp-3.paradise.net.nz
	(tclsnelb1-src-1.paradise.net.nz [203.96.152.172]) by
	linda-1.paradise.net.nz (Paradise.net.nz) with ESMTP id
	<0J7000LAT3U0HG@linda-1.paradise.net.nz> for
	pgsql-docs@postgresql.org; Thu, 12 Oct 2006 15:20:27 +1300 (NZDT)
Received: from [192.168.1.11]
	(218-101-28-242.dsl.clear.net.nz [218.101.28.242])	by
	smtp-3.paradise.net.nz (Postfix) with ESMTP id 9955D54B5F8;
	Thu, 12 Oct 2006 15:13:19 +1300 (NZDT)
Date: Thu, 12 Oct 2006 15:12:55 +1300
From: Mark Kirkwood <markir@paradise.net.nz>
Subject: Re: Build man pages: unkown SDATA
In-reply-to: <452D96F7.8030903@paradise.net.nz>
To: Mark Kirkwood <markir@paradise.net.nz>
Cc: Peter Eisentraut <peter_e@gmx.net>, pgsql-docs@postgresql.org
Message-id: <452DA4A7.6070003@paradise.net.nz>
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7bit
User-Agent: Thunderbird 1.5.0.7 (X11/20061003)
References: <452D842E.6050909@paradise.net.nz>
	<200610120247.31145.peter_e@gmx.net> <452D96F7.8030903@paradise.net.nz>
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=0.037 tagged_above=0 required=5 tests=AWL
X-Spam-Level: 
X-Archive-Number: 200610/20
X-Sequence-Number: 3741

Mark Kirkwood wrote:
> Peter Eisentraut wrote:
>> Mark Kirkwood wrote:
>>> $ make man
>>> ...
>>> onsgmls  postgres.sgml | sgmlspl
>>> /usr/share/sgml/docbook/utils-0.6.14/helpers/docbook2man-spec.pl
>>> --lowercase --section l --date "`date '+%Y-%m-%d'`"
>>> Unknown SDATA: [mdash ] at
>>> /usr/share/sgml/docbook/utils-0.6.14/helpers/docbook2man-spec.pl line
>>> 1239, <STDIN> line 10730.
>>> make: *** [man] Error 9
>>
>> You need a more recent version of docbook2man-spec.pl.
>>
> Thanks Peter, I'll hunt one up - incidentally, both FreeBSD 6 and Gentoo 
> 2006.1 use this same version of docbook-utils :-(, so it means going 
> outside the ports/portage structures (pity).
> 

Actually it doesn't (well not on Gentoo anyway). The docbook2X package 
has Thomas Lockhart's version of docbook2man-spec.pl, which works. 
Unfortunately there does not appear to be a port of this for Freebsd 
that I could find (I guess it is not that vital - can probably just copy 
the single file from the Gentoo package).

So - bottom line is that docbook2X *not* docbook-utils (or 
docbook-sgml-utils) is the package required. The Pg documentation does 
actually say this (requires docbook2X for Linux), but I was confused by 
the lack of any such package on Freebsd (oops).

One other point for those who wish to struggle with this - ./configure 
does not detect the -spec file, you need to set D2MDIR to where it lives 
(/usr/bin on this Gentoo dist) before trying to build the man pages.

Cheers

Mark