Re: What is d2mdir?

$ grep -i D2MDIR * -R
doc/src/sgml/Makefile:D2MSCRIPT= $(D2MDIR)/docbook2man-spec.pl

I could not find anything in the code related to this. I am trying to
create man pages in -HEAD, and getting an error:

[devrim(at)laptop sgml]$ make man
onsgmls -D . postgres.sgml | sgmlspl /docbook2man-spec.pl --lowercase
--section l --date "`date '+%Y-%m-%d'`"
FATAL: /docbook2man-spec.pl does not exist.
make: *** [man] Error 2

Ok, but I need to specify a path for that script.

How should I fix this?

Regards,
--
Devrim GÜNDÜZ, RHCE
devrim~gunduz.org, devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr
http://www.gunduz.org

At 2008-09-02 15:10:23 +0300, devrim(at)gunduz(dot)org wrote:
>
> [devrim(at)laptop sgml]$ make man

As Alvaro noted recently, you need to use "make man D2MDIR=/some/path".

-- ams

On Tue, 2008-09-02 at 19:47 +0530, Abhijit Menon-Sen wrote:
> > [devrim(at)laptop sgml]$ make man
>
> As Alvaro noted recently,

I probably missed that.

> you need to use "make man D2MDIR=/some/path".

Thanks :)

Cheers.
--
Devrim GÜNDÜZ, RHCE
devrim~gunduz.org, devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr
http://www.gunduz.org

Abhijit Menon-Sen <ams(at)oryx(dot)com> writes:
> At 2008-09-02 15:10:23 +0300, devrim(at)gunduz(dot)org wrote:
>>
>> [devrim(at)laptop sgml]$ make man

> As Alvaro noted recently, you need to use "make man D2MDIR=/some/path".

I see it's been like that for quite some time, but still it seems pretty
bogus. Why isn't configure handling this? If there's some good reason
not to automate it, why isn't it documented in the "Building The
Documentation" appendix?

regards, tom lane

Tom Lane wrote:
> Abhijit Menon-Sen <ams(at)oryx(dot)com> writes:
>> At 2008-09-02 15:10:23 +0300, devrim(at)gunduz(dot)org wrote:
>>> [devrim(at)laptop sgml]$ make man
>
>> As Alvaro noted recently, you need to use "make man D2MDIR=/some/path".
>
> I see it's been like that for quite some time, but still it seems pretty
> bogus. Why isn't configure handling this? If there's some good reason
> not to automate it, why isn't it documented in the "Building The
> Documentation" appendix?
>
> regards, tom lane
>

The documentation says that

"""
To generate quality man pages, it might be necessary to use a hacked
version of the conversion utility or do some manual postprocessing.
""""

which is why no standard path exists.

Something about that needs to be cleaned up, I admit. I'll make a note
about it.

On Tue, 2008-09-02 at 18:40 +0300, Peter Eisentraut wrote:
> The documentation says that

Even though I could not find it, here is an error:

$ make man.tar.gz D2MDIR=/usr/share/sgml/docbook/utils-0.6.14/helpers/
make -C sgml man
make[1]: Entering directory `/home/devrim/PostgreSQL/pgsql/doc/src/sgml'
onsgmls -D . 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 1241, <STDIN> line 11975.
make[1]: *** [man] Error 9
make[1]: Leaving directory `/home/devrim/PostgreSQL/pgsql/doc/src/sgml'
make: *** [man.tar] Error 2

Google pointed me to your e-mail that you sent at 2006:

http://archives.postgresql.org/pgsql-docs/2006-10/msg00017.php

I believe I'm using a recent version:

docbook-utils-0.6.14 @ Fedora-9.

Any comments?

--
Devrim GÜNDÜZ, RHCE
devrim~gunduz.org, devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr
http://www.gunduz.org

On Tue, 2008-09-02 at 19:07 +0300, Devrim GÜNDÜZ wrote:
>
> On Tue, 2008-09-02 at 18:40 +0300, Peter Eisentraut wrote:
> > The documentation says that

Oh, sorry -- I had missed the remaining part of your e-mail.
--
Devrim GÜNDÜZ, RHCE
devrim~gunduz.org, devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr
http://www.gunduz.org

Devrim GÜNDÜZ wrote:

> $ make man.tar.gz D2MDIR=/usr/share/sgml/docbook/utils-0.6.14/helpers/
> make -C sgml man
> make[1]: Entering directory `/home/devrim/PostgreSQL/pgsql/doc/src/sgml'
> onsgmls -D . 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 1241, <STDIN> line 11975.

Please see here:

http://archives.postgresql.org/message-id/20080821130203.GN4169%40alvh.no-ip.org

--
Alvaro Herrera http://www.CommandPrompt.com/
The PostgreSQL Company - Command Prompt, Inc.

On Tue, 2008-09-02 at 12:47 -0400, Alvaro Herrera wrote:
> > Unknown SDATA: [mdash ]
> at /usr/share/sgml/docbook/utils-0.6.14/helpers//docbook2man-spec.pl
> line 1241, <STDIN> line 11975.
>
> Please see here:
>
> http://archives.postgresql.org/message-id/20080821130203.GN4169%
> 40alvh.no-ip.org

Thanks, it fixed some part of the problem (and I'm now submitting it as
a patch to Fedora)

Now:

make man.tar.gz D2MDIR=/usr/share/sgml/docbook/utils-0.6.14/helpers/
make -C sgml man
make[1]: Entering directory `/home/devrim/PostgreSQL/pgsql/doc/src/sgml'
onsgmls -D . postgres.sgml | sgmlspl /usr/share/sgml/docbook/utils-0.6.14/helpers//docbook2man-spec.pl --lowercase --section l --date "`date '+%Y-%m-%d'`"
Warning: output contains unresolved XRefs
onsgmls -D . postgres.sgml | sgmlspl /usr/share/sgml/docbook/utils-0.6.14/helpers//docbook2man-spec.pl --lowercase --section l --date "`date '+%Y-%m-%d'`"
Warning: output contains unresolved XRefs
"/usr/bin/perl" -npi -e 's{\[XRef to GUC-([A-Z0-9-]*)\]}{($l = $1) =~ tr/A-Z-/a-z_/, $l}ge || s{\[XRef to [A-Z0-9-]*\]}{in the documentation}g' *.1 *.l
Can't open *.l: No such file or directory, <> line 6943.
/bin/sh ../../../config/mkinstalldirs man1 manl
mkdir -p -- man1 manl
mv *.1 man1/
mv *.l manl/
mv: cannot stat `*.l': No such file or directory
make[1]: *** [man] Error 1
make[1]: Leaving directory `/home/devrim/PostgreSQL/pgsql/doc/src/sgml'
make: *** [man.tar] Error 2

Marc, do you use a patched version of this script? If so, could you please put it somewhere public so that we can push it to upstream?

Thanks.

--
Devrim GÜNDÜZ, RHCE
devrim~gunduz.org, devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr
http://www.gunduz.org

On Tue, 2008-09-02 at 12:47 -0400, Alvaro Herrera wrote:
> Unknown SDATA: [mdash ]
> at /usr/share/sgml/docbook/utils-0.6.14/helpers//docbook2man-spec.pl
> line 1241, <STDIN> line 11975.
>
> Please see here:
>
> http://archives.postgresql.org/message-id/20080821130203.GN4169%
> 40alvh.no-ip.org

FWIW, Fedora folks fixed it in Fedora-9, and updated to latest version
as of Fedora 10.

Regards,
--
Devrim GÜNDÜZ, RHCE
devrim~gunduz.org, devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr
http://www.gunduz.org

Tom Lane wrote:
> Abhijit Menon-Sen <ams(at)oryx(dot)com> writes:
>> At 2008-09-02 15:10:23 +0300, devrim(at)gunduz(dot)org wrote:
>>> [devrim(at)laptop sgml]$ make man
>
>> As Alvaro noted recently, you need to use "make man D2MDIR=/some/path".
>
> I see it's been like that for quite some time, but still it seems pretty
> bogus. Why isn't configure handling this? If there's some good reason
> not to automate it, why isn't it documented in the "Building The
> Documentation" appendix?

I have updated the documentation accordingly.