Build man pages: unkown SDATA

Started by Mark Kirkwoodover 19 years ago4 messagesdocs
Jump to latest
#1Mark Kirkwood
mark.kirkwood@catalyst.net.nz

I've been trying to build the man pages in 8.2, unfortunately I am seeing:

$ 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

Doing a bit more hacking I find that the following will also cause this
error:

mdash, pi, uuml, ouml, egrave, quot, scaron, oslash

Do I need to specifically point docbook2man-spec.pl at a certain
stylesheet? Any ideas appreciated.

Cheers

Mark

#2Peter Eisentraut
peter_e@gmx.net
In reply to: Mark Kirkwood (#1)
Re: Build man pages: unkown SDATA

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.

--
Peter Eisentraut
http://developer.postgresql.org/~petere/

#3Mark Kirkwood
mark.kirkwood@catalyst.net.nz
In reply to: Peter Eisentraut (#2)
Re: Build man pages: unkown SDATA

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).

Cheers

Mark

#4Mark Kirkwood
mark.kirkwood@catalyst.net.nz
In reply to: Mark Kirkwood (#3)
Re: Build man pages: unkown SDATA

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