public inbox for [email protected]
help / color / mirror / Atom feed8.1 PDF Documentation.
18+ messages / 9 participants
[nested] [flat]
* 8.1 PDF Documentation.
@ 2005-11-07 21:35 Kris Jurka <[email protected]>
0 siblings, 1 reply; 18+ messages in thread
From: Kris Jurka @ 2005-11-07 21:35 UTC (permalink / raw)
To: pgsql-www; +Cc: [email protected]
I've built the PDF docs for the past two releases, but my recent attempts
to build the 8.1 docs have failed. I previously used Jade 1.2.1, SP
1.3.4, and docbook-dsssl 1.76, but trying that now results in:
! pdfTeX error (ext4): \pdfendlink ended up in different nesting level
than \pdfstartlink.
when running pdfjadetex. I've not been able to find out much about this
error. Newer versions of the tools either crash or take days to run.
I've begun the days long processing, so it will be sometime (if at all)
before I can generate pdfs for the 8.1 release.
Kris Jurka
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: 8.1 PDF Documentation.
@ 2005-11-10 23:01 Kris Jurka <[email protected]>
parent: Kris Jurka <[email protected]>
0 siblings, 1 reply; 18+ messages in thread
From: Kris Jurka @ 2005-11-10 23:01 UTC (permalink / raw)
To: pgsql-www; +Cc: [email protected]
8.1 pdfs are finished. These versions actually got the correct pdf
bookmarks and table of contents. I can probably rebuild the 7.4 and 8.0
versions in this format if there is sufficient interest.
http://www.ejurka.com/pgsql/docs/
Also the website isn't listing the 8.0 US version here:
http://www.postgresql.org/docs/manuals/
But it is in the cvs repository here:
http://gborg.postgresql.org/cgi-bin/cvsweb.cgi/portal/files/documentation/pdf/8.0/?cvsroot=pgweb
Kris Jurka
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: 8.1 PDF Documentation.
@ 2005-11-11 06:59 David Fetter <[email protected]>
parent: Kris Jurka <[email protected]>
0 siblings, 1 reply; 18+ messages in thread
From: David Fetter @ 2005-11-11 06:59 UTC (permalink / raw)
To: Kris Jurka <[email protected]>; +Cc: pgsql-www; [email protected]
On Thu, Nov 10, 2005 at 06:01:42PM -0500, Kris Jurka wrote:
>
> 8.1 pdfs are finished. These versions actually got the correct pdf
> bookmarks and table of contents. I can probably rebuild the 7.4 and
> 8.0 versions in this format if there is sufficient interest.
Way cool. Is producing these PDFs something that could be
distributed? What tools actually work for this?
Cheers,
D
--
David Fetter [email protected] http://fetter.org/
phone: +1 510 893 6100 mobile: +1 415 235 3778
Remember to vote!
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: 8.1 PDF Documentation.
@ 2005-11-11 07:57 Kris Jurka <[email protected]>
parent: David Fetter <[email protected]>
0 siblings, 1 reply; 18+ messages in thread
From: Kris Jurka @ 2005-11-11 07:57 UTC (permalink / raw)
To: David Fetter <[email protected]>; +Cc: pgsql-www; [email protected]
On Thu, 10 Nov 2005, David Fetter wrote:
> On Thu, Nov 10, 2005 at 06:01:42PM -0500, Kris Jurka wrote:
>>
>> 8.1 pdfs are finished. These versions actually got the correct pdf
>> bookmarks and table of contents. I can probably rebuild the 7.4 and
>> 8.0 versions in this format if there is sufficient interest.
>
> Way cool. Is producing these PDFs something that could be
> distributed? What tools actually work for this?
>
Distributed? Not really. It can't be done in parts, and there's only two
sizes (US and A4). It also really only needs to be done once per release
(although I suppose it would be nice to do for point releases.)
It took about two days each (run serially) on a 2xOpteron 246 using debian
unstable's:
openjade: 1.3.2-8
opensp: 1.5.1/0-4
docbook-dsssl: 1.79-3
Kris Jurka
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: [DOCS] 8.1 PDF Documentation.
@ 2005-11-11 08:58 Magnus Hagander <[email protected]>
0 siblings, 0 replies; 18+ messages in thread
From: Magnus Hagander @ 2005-11-11 08:58 UTC (permalink / raw)
To: Kris Jurka <[email protected]>; pgsql-www; +Cc: [email protected]
> 8.1 pdfs are finished. These versions actually got the
> correct pdf bookmarks and table of contents. I can probably
> rebuild the 7.4 and 8.0 versions in this format if there is
> sufficient interest.
>
> http://www.ejurka.com/pgsql/docs/
Thanks, uploaded to the website.
> Also the website isn't listing the 8.0 US version here:
> http://www.postgresql.org/docs/manuals/
Fixed. Thanks for the pointer.
//Magnus
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: 8.1 PDF Documentation.
@ 2005-11-11 14:43 Tom Lane <[email protected]>
parent: Kris Jurka <[email protected]>
0 siblings, 2 replies; 18+ messages in thread
From: Tom Lane @ 2005-11-11 14:43 UTC (permalink / raw)
To: Kris Jurka <[email protected]>; +Cc: David Fetter <[email protected]>; pgsql-www; [email protected]
Kris Jurka <[email protected]> writes:
> It took about two days each (run serially) on a 2xOpteron 246 using debian
> unstable's:
> openjade: 1.3.2-8
> opensp: 1.5.1/0-4
> docbook-dsssl: 1.79-3
BTW, the -US file sends my (rather old) copy of acroread into what may
be an infinite loop ... I gave up waiting for it to redisplay after
trying to scroll down the bookmarks window. Even just displaying
successive pages is painfully slow.
I suspect there's something wrong with the toolset you're using.
regards, tom lane
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: [pgsql-www] 8.1 PDF Documentation.
@ 2005-11-11 17:07 Peter Eisentraut <[email protected]>
parent: Tom Lane <[email protected]>
1 sibling, 0 replies; 18+ messages in thread
From: Peter Eisentraut @ 2005-11-11 17:07 UTC (permalink / raw)
To: Tom Lane <[email protected]>; [email protected]; +Cc: Kris Jurka <[email protected]>
Tom Lane wrote:
> BTW, the -US file sends my (rather old) copy of acroread into what
> may be an infinite loop ... I gave up waiting for it to redisplay
> after trying to scroll down the bookmarks window. Even just
> displaying successive pages is painfully slow.
Works like a charm with a more recent acroread. I suggest yours is
indeed too old.
--
Peter Eisentraut
http://developer.postgresql.org/~petere/
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: 8.1 PDF Documentation.
@ 2005-11-15 05:13 Bruce Momjian <[email protected]>
parent: Tom Lane <[email protected]>
1 sibling, 3 replies; 18+ messages in thread
From: Bruce Momjian @ 2005-11-15 05:13 UTC (permalink / raw)
To: Tom Lane <[email protected]>; +Cc: Kris Jurka <[email protected]>; David Fetter <[email protected]>; pgsql-www; [email protected]
Tom Lane wrote:
> Kris Jurka <[email protected]> writes:
> > It took about two days each (run serially) on a 2xOpteron 246 using debian
> > unstable's:
> > openjade: 1.3.2-8
> > opensp: 1.5.1/0-4
> > docbook-dsssl: 1.79-3
>
> BTW, the -US file sends my (rather old) copy of acroread into what may
> be an infinite loop ... I gave up waiting for it to redisplay after
> trying to scroll down the bookmarks window. Even just displaying
> successive pages is painfully slow.
>
> I suspect there's something wrong with the toolset you're using.
I am using Acrobat 5.0 on XP and BSD/OS and it worked fine for me,
including bookmarks. It was very fast.
I am still unclear why there is no more reliable SGML toolchain for PDF
output after all these years. Seems things have improved because we now
have bookmarks, but still, why is this functionality not more mainstream.
--
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] 18+ messages in thread
* Re: 8.1 PDF Documentation.
@ 2005-11-15 05:20 David Fetter <[email protected]>
parent: Bruce Momjian <[email protected]>
2 siblings, 0 replies; 18+ messages in thread
From: David Fetter @ 2005-11-15 05:20 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; +Cc: Tom Lane <[email protected]>; Kris Jurka <[email protected]>; pgsql-www; [email protected]
On Tue, Nov 15, 2005 at 12:13:01AM -0500, Bruce Momjian wrote:
> Tom Lane wrote:
> > Kris Jurka <[email protected]> writes:
> > > It took about two days each (run serially) on a 2xOpteron 246 using debian
> > > unstable's:
> > > openjade: 1.3.2-8
> > > opensp: 1.5.1/0-4
> > > docbook-dsssl: 1.79-3
> >
> > BTW, the -US file sends my (rather old) copy of acroread into what
> > may be an infinite loop ... I gave up waiting for it to redisplay
> > after trying to scroll down the bookmarks window. Even just
> > displaying successive pages is painfully slow.
> >
> > I suspect there's something wrong with the toolset you're using.
>
> I am using Acrobat 5.0 on XP and BSD/OS and it worked fine for me,
> including bookmarks. It was very fast.
Acrobat works beautifully for me, too. :)
> I am still unclear why there is no more reliable SGML toolchain for
> PDF output after all these years. Seems things have improved
> because we now have bookmarks, but still, why is this functionality
> not more mainstream.
See, there are these tuits, and they're round, and they're a precious
resource usually spent on writing and testing C code rather than on
improving (and helping transition adoption of) the SGML toolchain.
Maybe we can get some kind soul(s) to donate some tuits and/or pay
somebody a wage for awhile to fix the toolchain etc. :)
Cheers,
D
--
David Fetter [email protected] http://fetter.org/
phone: +1 510 893 6100 mobile: +1 415 235 3778
Remember to vote!
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: [DOCS] 8.1 PDF Documentation.
@ 2005-11-15 11:23 Alvaro Herrera <[email protected]>
parent: Bruce Momjian <[email protected]>
2 siblings, 3 replies; 18+ messages in thread
From: Alvaro Herrera @ 2005-11-15 11:23 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; +Cc: Tom Lane <[email protected]>; Kris Jurka <[email protected]>; David Fetter <[email protected]>; pgsql-www; [email protected]
Bruce Momjian wrote:
> I am still unclear why there is no more reliable SGML toolchain for PDF
> output after all these years. Seems things have improved because we now
> have bookmarks, but still, why is this functionality not more mainstream.
There is no SGML toolchain because SGML has been abandoned as the
DocBook markup language. The toolchain that everybody else uses is
based on XML DocBook. It has been proposed that we abandon SGML and
jump to XML, but the idea has been shot down. And it's possible to
convert our SGML to XML automatically and process it with the newer
toolchain.
--
Alvaro Herrera http://www.CommandPrompt.com/
PostgreSQL Replication, Consulting, Custom Development, 24x7 support
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: [DOCS] 8.1 PDF Documentation.
@ 2005-11-15 11:42 Michael Glaesemann <[email protected]>
parent: Alvaro Herrera <[email protected]>
2 siblings, 0 replies; 18+ messages in thread
From: Michael Glaesemann @ 2005-11-15 11:42 UTC (permalink / raw)
To: Alvaro Herrera <[email protected]>; +Cc: Bruce Momjian <[email protected]>; Tom Lane <[email protected]>; Kris Jurka <[email protected]>; David Fetter <[email protected]>; pgsql-www; [email protected]
On Nov 15, 2005, at 20:23 , Alvaro Herrera wrote:
> Bruce Momjian wrote:
>
>> I am still unclear why there is no more reliable SGML toolchain
>> for PDF
>> output after all these years. Seems things have improved because
>> we now
>> have bookmarks, but still, why is this functionality not more
>> mainstream.
>
> There is no SGML toolchain because SGML has been abandoned as the
> DocBook markup language. The toolchain that everybody else uses is
> based on XML DocBook. It has been proposed that we abandon SGML and
> jump to XML, but the idea has been shot down. And it's possible to
> convert our SGML to XML automatically and process it with the newer
> toolchain.
It's my understanding that it hasn't been shot down as much as no one
has shown that it will serve our needs. IIRC, there are two issues:
> Marked sections: SGML DocBook (which is currently used) supports
> parameter entities to be used to include or exclude certain
> sections of material depending on the desired output. Profiling in
> XML DocBook may be able to accomplish the same task.
>
> XML DocBook toolchain: making sure the tools to produce the
> documentation in its myriad forms (e.g., html, manpages, PDF) works.
(Just for history repeating itself, this was brought up Aug 2004 as
well :) )
I don't think anyone's standing in the way. It's just that no one's
shown that the XML toolchain can do the work for us.
Michael Glaesemann
grzm myrealbox com
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: [pgsql-www] 8.1 PDF Documentation.
@ 2005-11-15 11:53 Peter Eisentraut <[email protected]>
parent: Alvaro Herrera <[email protected]>
2 siblings, 1 reply; 18+ messages in thread
From: Peter Eisentraut @ 2005-11-15 11:53 UTC (permalink / raw)
To: Alvaro Herrera <[email protected]>; +Cc: [email protected]; Bruce Momjian <[email protected]>
Am Dienstag, 15. November 2005 12:23 schrieb Alvaro Herrera:
> There is no SGML toolchain because SGML has been abandoned as the
> DocBook markup language. The toolchain that everybody else uses is
> based on XML DocBook. It has been proposed that we abandon SGML and
> jump to XML, but the idea has been shot down. And it's possible to
> convert our SGML to XML automatically and process it with the newer
> toolchain.
Oh, what is this stable and mature DocBook XML to print output conversion tool
that you seem to be referring to?
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: 8.1 PDF Documentation.
@ 2005-11-15 11:54 Peter Eisentraut <[email protected]>
parent: Bruce Momjian <[email protected]>
2 siblings, 1 reply; 18+ messages in thread
From: Peter Eisentraut @ 2005-11-15 11:54 UTC (permalink / raw)
To: pgsql-www; +Cc: Bruce Momjian <[email protected]>; Tom Lane <[email protected]>; Kris Jurka <[email protected]>; David Fetter <[email protected]>; [email protected]
Am Dienstag, 15. November 2005 06:13 schrieb Bruce Momjian:
> I am still unclear why there is no more reliable SGML toolchain for PDF
> output after all these years. Seems things have improved because we now
> have bookmarks, but still, why is this functionality not more mainstream.
I don't understand how you get from "ancient Acrobat can't display large PDF
file" to "SGML toolchain is unreliable".
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: [DOCS] 8.1 PDF Documentation.
@ 2005-11-15 14:04 Bruce Momjian <[email protected]>
parent: Alvaro Herrera <[email protected]>
2 siblings, 1 reply; 18+ messages in thread
From: Bruce Momjian @ 2005-11-15 14:04 UTC (permalink / raw)
To: Alvaro Herrera <[email protected]>; +Cc: Tom Lane <[email protected]>; Kris Jurka <[email protected]>; David Fetter <[email protected]>; pgsql-www; [email protected]
Alvaro Herrera wrote:
> Bruce Momjian wrote:
>
> > I am still unclear why there is no more reliable SGML toolchain for PDF
> > output after all these years. Seems things have improved because we now
> > have bookmarks, but still, why is this functionality not more mainstream.
>
> There is no SGML toolchain because SGML has been abandoned as the
> DocBook markup language. The toolchain that everybody else uses is
> based on XML DocBook. It has been proposed that we abandon SGML and
> jump to XML, but the idea has been shot down. And it's possible to
> convert our SGML to XML automatically and process it with the newer
> toolchain.
OK, that makes sense. We went from LaTeX to SGML long ago with the idea
that we could easily generate any output format, but that promise has
never been fully realized.
Could the SGML be automatically converted to XML during the print
process and then converted to PDF?
--
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] 18+ messages in thread
* Re: [DOCS] 8.1 PDF Documentation.
@ 2005-11-15 14:11 Dave Page <[email protected]>
0 siblings, 0 replies; 18+ messages in thread
From: Dave Page @ 2005-11-15 14:11 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; Alvaro Herrera <[email protected]>; +Cc: Tom Lane <[email protected]>; Kris Jurka <[email protected]>; David Fetter <[email protected]>; pgsql-www; [email protected]
> -----Original Message-----
> From: [email protected]
> [mailto:[email protected]] On Behalf Of Bruce Momjian
> Sent: 15 November 2005 14:04
> To: Alvaro Herrera
> Cc: Tom Lane; Kris Jurka; David Fetter;
> [email protected]; [email protected]
> Subject: Re: [DOCS] [pgsql-www] 8.1 PDF Documentation.
>
> Could the SGML be automatically converted to XML during the print
> process and then converted to PDF?
Should be possible - it's converted to XML by the htmlhelp target.
Processing that causes me problems on various platforms mind you, but it
does it.
Regards, Dave.
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: 8.1 PDF Documentation.
@ 2005-11-15 14:43 Bruce Momjian <[email protected]>
parent: Peter Eisentraut <[email protected]>
0 siblings, 0 replies; 18+ messages in thread
From: Bruce Momjian @ 2005-11-15 14:43 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: pgsql-www; Tom Lane <[email protected]>; Kris Jurka <[email protected]>; David Fetter <[email protected]>; [email protected]
Peter Eisentraut wrote:
> Am Dienstag, 15. November 2005 06:13 schrieb Bruce Momjian:
> > I am still unclear why there is no more reliable SGML toolchain for PDF
> > output after all these years. Seems things have improved because we now
> > have bookmarks, but still, why is this functionality not more mainstream.
>
> I don't understand how you get from "ancient Acrobat can't display large PDF
> file" to "SGML toolchain is unreliable".
Well, historically we have had trouble generating PDF (particuarly
bookmarks), and it took _days_ to generate the output, which certainly
seems strange.
In fact, this is the first verion that has bookmarks, and that is 1/2
the value of a PDF file for me, so I see this release as a great leap
forward for us. What I do not understand is why it has taken >5 years
for this to happen.
--
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] 18+ messages in thread
* Re: [pgsql-www] 8.1 PDF Documentation.
@ 2005-11-15 15:08 Peter Eisentraut <[email protected]>
parent: Bruce Momjian <[email protected]>
0 siblings, 0 replies; 18+ messages in thread
From: Peter Eisentraut @ 2005-11-15 15:08 UTC (permalink / raw)
To: ; +Cc: Bruce Momjian <[email protected]>; Alvaro Herrera <[email protected]>; [email protected]
Am Dienstag, 15. November 2005 15:04 schrieb Bruce Momjian:
> Could the SGML be automatically converted to XML during the print
> process and then converted to PDF?
Certainly.
^ permalink raw reply [nested|flat] 18+ messages in thread
* Re: [pgsql-www] 8.1 PDF Documentation.
@ 2005-11-15 15:30 Alvaro Herrera <[email protected]>
parent: Peter Eisentraut <[email protected]>
0 siblings, 0 replies; 18+ messages in thread
From: Alvaro Herrera @ 2005-11-15 15:30 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: [email protected]; Bruce Momjian <[email protected]>
Peter Eisentraut wrote:
> Am Dienstag, 15. November 2005 12:23 schrieb Alvaro Herrera:
> > There is no SGML toolchain because SGML has been abandoned as the
> > DocBook markup language. The toolchain that everybody else uses is
> > based on XML DocBook. It has been proposed that we abandon SGML and
> > jump to XML, but the idea has been shot down. And it's possible to
> > convert our SGML to XML automatically and process it with the newer
> > toolchain.
>
> Oh, what is this stable and mature DocBook XML to print output conversion tool
> that you seem to be referring to?
I'm not saying there's any -- I'm just saying nobody else uses SGML.
That said, I just looked at a Gnome book that is published as PDF and
written using XML DocBook, and they seem to use "docbook2pdf" which in
turns appears to be this:
http://sourceware.org/docbook-tools/
One drawback that I can see in that book is that the HTML pages do not
have the nice names our current docs have. Not sure if that's an
inherent property of the XML tools.
That said, I don't have much interest in messing with all this.
Personally I'm pretty happy using the HTML docs (I even read the SGML
directly at times.)
--
Alvaro Herrera http://www.CommandPrompt.com/
The PostgreSQL Company - Command Prompt, Inc.
^ permalink raw reply [nested|flat] 18+ messages in thread
end of thread, other threads:[~2005-11-15 15:30 UTC | newest]
Thread overview: 18+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2005-11-07 21:35 8.1 PDF Documentation. Kris Jurka <[email protected]>
2005-11-10 23:01 ` Kris Jurka <[email protected]>
2005-11-11 06:59 ` David Fetter <[email protected]>
2005-11-11 07:57 ` Kris Jurka <[email protected]>
2005-11-11 14:43 ` Tom Lane <[email protected]>
2005-11-11 17:07 ` Peter Eisentraut <[email protected]>
2005-11-15 05:13 ` Bruce Momjian <[email protected]>
2005-11-15 05:20 ` David Fetter <[email protected]>
2005-11-15 11:23 ` Alvaro Herrera <[email protected]>
2005-11-15 11:42 ` Michael Glaesemann <[email protected]>
2005-11-15 11:53 ` Peter Eisentraut <[email protected]>
2005-11-15 15:30 ` Alvaro Herrera <[email protected]>
2005-11-15 14:04 ` Bruce Momjian <[email protected]>
2005-11-15 15:08 ` Peter Eisentraut <[email protected]>
2005-11-15 11:54 ` Peter Eisentraut <[email protected]>
2005-11-15 14:43 ` Bruce Momjian <[email protected]>
2005-11-11 08:58 Re: [DOCS] 8.1 PDF Documentation. Magnus Hagander <[email protected]>
2005-11-15 14:11 Re: [DOCS] 8.1 PDF Documentation. Dave Page <[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