public inbox for [email protected]
help / color / mirror / Atom feedprocess hangs when converting sgml documentation to PDF
11+ messages / 9 participants
[nested] [flat]
* process hangs when converting sgml documentation to PDF
@ 2005-06-07 07:08 Saquib Farooq Malik <[email protected]>
0 siblings, 2 replies; 11+ messages in thread
From: Saquib Farooq Malik @ 2005-06-07 07:08 UTC (permalink / raw)
To: pgsql-docs
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 "<!entity version \"8.0.3\">"; \
echo "<!entity majorversion \"`expr 8.0.3 :
'\([0-9][0-9]*\.[0-9][0-9]*\)'`\">"; \
} >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
^ permalink raw reply [nested|flat] 11+ messages in thread
* Re: process hangs when converting sgml documentation to PDF
@ 2005-06-07 07:18 Neil Conway <[email protected]>
parent: Saquib Farooq Malik <[email protected]>
1 sibling, 0 replies; 11+ messages in thread
From: Neil Conway @ 2005-06-07 07:18 UTC (permalink / raw)
To: Saquib Farooq Malik <[email protected]>; +Cc: pgsql-docs
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
^ permalink raw reply [nested|flat] 11+ messages in thread
* Re: process hangs when converting sgml documentation to PDF
@ 2005-06-07 07:37 Volkan YAZICI <[email protected]>
parent: Saquib Farooq Malik <[email protected]>
1 sibling, 1 reply; 11+ messages in thread
From: Volkan YAZICI @ 2005-06-07 07:37 UTC (permalink / raw)
To: Saquib Farooq Malik <[email protected]>; +Cc: pgsql-docs
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.
^ permalink raw reply [nested|flat] 11+ messages in thread
* Re: process hangs when converting sgml documentation to PDF
@ 2005-06-07 14:48 Bruce Momjian <[email protected]>
parent: Volkan YAZICI <[email protected]>
0 siblings, 1 reply; 11+ messages in thread
From: Bruce Momjian @ 2005-06-07 14:48 UTC (permalink / raw)
To: Volkan YAZICI <[email protected]>; +Cc: Saquib Farooq Malik <[email protected]>; pgsql-docs
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
^ permalink raw reply [nested|flat] 11+ messages in thread
* Re: process hangs when converting sgml documentation to PDF
@ 2005-06-07 15:59 Peter Eisentraut <[email protected]>
parent: Bruce Momjian <[email protected]>
0 siblings, 2 replies; 11+ messages in thread
From: Peter Eisentraut @ 2005-06-07 15:59 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; +Cc: Volkan YAZICI <[email protected]>; Saquib Farooq Malik <[email protected]>; pgsql-docs
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/
^ permalink raw reply [nested|flat] 11+ messages in thread
* Re: process hangs when converting sgml documentation to PDF
@ 2005-06-07 16:14 Bruce Momjian <[email protected]>
parent: Peter Eisentraut <[email protected]>
1 sibling, 0 replies; 11+ messages in thread
From: Bruce Momjian @ 2005-06-07 16:14 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: Volkan YAZICI <[email protected]>; Saquib Farooq Malik <[email protected]>; pgsql-docs
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
^ permalink raw reply [nested|flat] 11+ messages in thread
* Re: process hangs when converting sgml documentation to PDF
@ 2005-06-07 16:39 Alvaro Herrera <[email protected]>
parent: Peter Eisentraut <[email protected]>
1 sibling, 2 replies; 11+ messages in thread
From: Alvaro Herrera @ 2005-06-07 16:39 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: Bruce Momjian <[email protected]>; Volkan YAZICI <[email protected]>; Saquib Farooq Malik <[email protected]>; pgsql-docs
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 (<alvherre[a]surnet.cl>)
Voy a acabar con todos los humanos / con los humanos yo acabaré
voy a acabar con todos / con todos los humanos acabaré (Bender)
^ permalink raw reply [nested|flat] 11+ messages in thread
* Re: process hangs when converting sgml documentation to PDF
@ 2005-06-07 17:57 Peter Eisentraut <[email protected]>
parent: Alvaro Herrera <[email protected]>
1 sibling, 1 reply; 11+ messages in thread
From: Peter Eisentraut @ 2005-06-07 17:57 UTC (permalink / raw)
To: Alvaro Herrera <[email protected]>; +Cc: pgsql-docs
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/
^ permalink raw reply [nested|flat] 11+ messages in thread
* Re: process hangs when converting sgml documentation to PDF
@ 2005-06-07 18:03 Joshua D. Drake <[email protected]>
parent: Peter Eisentraut <[email protected]>
0 siblings, 0 replies; 11+ messages in thread
From: Joshua D. Drake @ 2005-06-07 18:03 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: Alvaro Herrera <[email protected]>; pgsql-docs
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/
^ permalink raw reply [nested|flat] 11+ messages in thread
* Re: process hangs when converting sgml documentation to PDF
@ 2005-06-08 05:11 Tom Lane <[email protected]>
parent: Alvaro Herrera <[email protected]>
1 sibling, 0 replies; 11+ messages in thread
From: Tom Lane @ 2005-06-08 05:11 UTC (permalink / raw)
To: Alvaro Herrera <[email protected]>; +Cc: Peter Eisentraut <[email protected]>; Bruce Momjian <[email protected]>; Volkan YAZICI <[email protected]>; Saquib Farooq Malik <[email protected]>; pgsql-docs
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
^ permalink raw reply [nested|flat] 11+ messages in thread
* Re: process hangs when converting sgml documentation to PDF
@ 2005-06-10 14:22 Halley Pacheco de Oliveira <[email protected]>
0 siblings, 0 replies; 11+ messages in thread
From: Halley Pacheco de Oliveira @ 2005-06-10 14:22 UTC (permalink / raw)
To: pgsql-docs
I have a Red Hat Linux 9.0 installed just to convert SGML to RTF, once it hangs in Fedora Core 3.
Halley
__________________________________________________
Converse com seus amigos em tempo real com o Yahoo! Messenger
http://br.download.yahoo.com/messenger/
^ permalink raw reply [nested|flat] 11+ messages in thread
end of thread, other threads:[~2005-06-10 14:22 UTC | newest]
Thread overview: 11+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2005-06-07 07:08 process hangs when converting sgml documentation to PDF Saquib Farooq Malik <[email protected]>
2005-06-07 07:18 ` Neil Conway <[email protected]>
2005-06-07 07:37 ` Volkan YAZICI <[email protected]>
2005-06-07 14:48 ` Bruce Momjian <[email protected]>
2005-06-07 15:59 ` Peter Eisentraut <[email protected]>
2005-06-07 16:14 ` Bruce Momjian <[email protected]>
2005-06-07 16:39 ` Alvaro Herrera <[email protected]>
2005-06-07 17:57 ` Peter Eisentraut <[email protected]>
2005-06-07 18:03 ` Joshua D. Drake <[email protected]>
2005-06-08 05:11 ` Tom Lane <[email protected]>
2005-06-10 14:22 Re: process hangs when converting sgml documentation to PDF Halley Pacheco de Oliveira <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox