Обсуждение: 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@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@gunduz.org wrote: > > [devrim@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@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@oryx.com> writes:
> At 2008-09-02 15:10:23 +0300, devrim@gunduz.org wrote:
>>
>> [devrim@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@oryx.com> writes: >> At 2008-09-02 15:10:23 +0300, devrim@gunduz.org wrote: >>> [devrim@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 --sectionl --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 --sectionl --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 --sectionl --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 --sectionl --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-]*\]}{inthe 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 itto 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@oryx.com> writes: >> At 2008-09-02 15:10:23 +0300, devrim@gunduz.org wrote: >>> [devrim@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.