[DOCS] process hangs when converting sgml documentation to PDF
Hi,
I tried to get a PDF version of the pgsql
documentation. the process i used is as follows
$ cd $PGSQL_ROOT
$ ./configure
$ cd $PG_ROOT/doc/src/sgml
$ gmake postgres.pdf
the outpout i get is as follows :
LC_ALL=C "/usr/bin/perl" /usr/bin/collateindex.pl -f
-g -o bookindex.sgml -N
{ \
echo ""; \
echo ""; \
} >version.sgml
"/usr/bin/perl" ./mk_feature_tables.pl YES
../../../src/backend/catalog/sql_feature_packages.txt
../../../src/backend/catalog/sql_features.txt >
features-supported.sgml
"/usr/bin/perl" ./mk_feature_tables.pl NO
../../../src/backend/catalog/sql_feature_packages.txt
../../../src/backend/catalog/sql_features.txt >
features-unsupported.sgml
openjade -D . -c
/usr/share/sgml/docbook/dsssl-stylesheets/catalog -d
stylesheet.dsl -t tex -V tex-backend -i output-print
-V texpdf-output -o postgres.tex-pdf postgres.sgml
and that's it, the prompt never comes back.
Can anybody please tell me why the process hangs up,
how can I get the PDf version from the sgml
documentations, using gmake.
thank you
Saquib
__
Discover Yahoo!
Get on-the-go sports scores, stock quotes, news and more. Check it out!
http://discover.yahoo.com/mobile.html
---(end of broadcast)---
TIP 9: the planner will ignore your desire to choose an index scan if your
joining column's datatypes do not match
Re: [DOCS] process hangs when converting sgml documentation to PDF
Saquib Farooq Malik wrote: openjade -D . -c /usr/share/sgml/docbook/dsssl-stylesheets/catalog -d stylesheet.dsl -t tex -V tex-backend -i output-print -V texpdf-output -o postgres.tex-pdf postgres.sgml and that's it, the prompt never comes back. Some people have reported extremely long build times for the SGML docs (e.g. on the order of a week of CPU time, in some cases). As far as I know, this is a problem with the SGML toolchain, not the Postgres documentation itself. Can anybody please tell me why the process hangs up, how can I get the PDf version from the sgml documentations, using gmake. You can get the prebuilt PDFs from: http://www.postgresql.org/docs/manuals/ If you need to build them yourself, be prepared for it to take quite some time... -Neil ---(end of broadcast)--- TIP 6: Have you searched our list archives? http://archives.postgresql.org
Re: [DOCS] process hangs when converting sgml documentation to PDF
Hi, On 6/7/05, Saquib Farooq Malik <[EMAIL PROTECTED]> wrote: > Can anybody please tell me why the process hangs up IMHO, you can try using strace (or any similar variant) to see if it's working in the background. (There could also be a verbose param. for jade too.) HTH. Regards. ---(end of broadcast)--- TIP 7: don't forget to increase your free space map settings
Re: [DOCS] process hangs when converting sgml documentation to PDF
Volkan YAZICI wrote: > Hi, > > On 6/7/05, Saquib Farooq Malik <[EMAIL PROTECTED]> wrote: > > Can anybody please tell me why the process hangs up > > IMHO, you can try using strace (or any similar variant) to see if it's > working in the background. (There could also be a verbose param. for > jade too.) HTH. Would someone report this to the SGML guys and get them to fix it? -- Bruce Momjian| http://candle.pha.pa.us [email protected] | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup.| Newtown Square, Pennsylvania 19073 ---(end of broadcast)--- TIP 6: Have you searched our list archives? http://archives.postgresql.org
Re: [DOCS] process hangs when converting sgml documentation to PDF
Bruce Momjian wrote: > Would someone report this to the SGML guys and get them to fix it? There are no SGML guys anymore. The toolchain is abandoned. -- Peter Eisentraut http://developer.postgresql.org/~petere/ ---(end of broadcast)--- TIP 4: Don't 'kill -9' the postmaster
Re: [DOCS] process hangs when converting sgml documentation to PDF
Peter Eisentraut wrote: > Bruce Momjian wrote: > > Would someone report this to the SGML guys and get them to fix it? > > There are no SGML guys anymore. The toolchain is abandoned. Oh, you mean we are using tools from an abandoned project? What replace it and should we be using that? -- Bruce Momjian| http://candle.pha.pa.us [email protected] | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup.| Newtown Square, Pennsylvania 19073 ---(end of broadcast)--- TIP 5: Have you checked our extensive FAQ? http://www.postgresql.org/docs/faq
Re: [DOCS] process hangs when converting sgml documentation to PDF
On Tue, Jun 07, 2005 at 05:59:19PM +0200, Peter Eisentraut wrote: > Bruce Momjian wrote: > > Would someone report this to the SGML guys and get them to fix it? > > There are no SGML guys anymore. The toolchain is abandoned. Excellent :-( How about we discuss again whether to move to XML? I assume there is a newer toolchain for that. I do have issues building the docs here on a Debian unstable machine (not that i have researched the problem a lot really.) AFAIR the problem was that there wasn't a way to include certain parts of the documentation depending on whether some symbol was defined or not. Is that still true? Furthermore, do we use that feature and how, and is there a way to work around the problem? I think it is the standalone-include and standalone-ignore definitions, isn't it? -- Alvaro Herrera () Voy a acabar con todos los humanos / con los humanos yo acabaré voy a acabar con todos / con todos los humanos acabaré (Bender) ---(end of broadcast)--- TIP 1: subscribe and unsubscribe commands go to [EMAIL PROTECTED]
Re: [DOCS] process hangs when converting sgml documentation to PDF
Alvaro Herrera wrote: > Excellent :-( How about we discuss again whether to move to XML? You can already use "XML" today. Go to doc/src/sgml and type "make testxml" and you'll get HTML documentation built using XSLT stylesheets. The bad news, however, is that using the XSLT toolchain the state of the print-output-generating tools is even worse. FOP crashes left and right, PassiveTeX is unmaintained and incredibly hard to set up, and the rest costs big cash. In fact, the only reason the DSSSL toolchain is still barely maintained is to generate print output. > AFAIR the problem was that there wasn't a way to include certain > parts of the documentation depending on whether some symbol was > defined or not. Is that still true? Furthermore, do we use that > feature and how, and is there a way to work around the problem? The way around that would be to use the profiling feature of the XSLT stylesheets. But the way it's set up right now, storing the files in SGML and converting them to XML on the fly, works out just as well. -- Peter Eisentraut http://developer.postgresql.org/~petere/ ---(end of broadcast)--- TIP 9: the planner will ignore your desire to choose an index scan if your joining column's datatypes do not match
Re: [DOCS] process hangs when converting sgml documentation to PDF
Peter Eisentraut wrote: Alvaro Herrera wrote: Excellent :-( How about we discuss again whether to move to XML? You can already use "XML" today. Go to doc/src/sgml and type "make testxml" and you'll get HTML documentation built using XSLT stylesheets. One way to do it, is to make an RTF and then print the RTF to a file and convert to PDF. Sincerely, Joshua D. Drake -- Your PostgreSQL solutions company - Command Prompt, Inc. 1.800.492.2240 PostgreSQL Replication, Consulting, Custom Programming, 24x7 support Managed Services, Shared and Dedicated Hosting Co-Authors: plPHP, plPerlNG - http://www.commandprompt.com/ ---(end of broadcast)--- TIP 9: the planner will ignore your desire to choose an index scan if your joining column's datatypes do not match
Re: [DOCS] process hangs when converting sgml documentation to PDF
Alvaro Herrera <[EMAIL PROTECTED]> writes: > On Tue, Jun 07, 2005 at 05:59:19PM +0200, Peter Eisentraut wrote: >> There are no SGML guys anymore. The toolchain is abandoned. > Excellent :-( How about we discuss again whether to move to XML? I > assume there is a newer toolchain for that. As far as I can tell, Red Hat is still depending on DocBook, so I think that this format is not quite so dead as all that. Maybe we need to take another look at exactly which tools we're using though ... regards, tom lane ---(end of broadcast)--- TIP 1: subscribe and unsubscribe commands go to [EMAIL PROTECTED]
