public inbox for [email protected]
help / color / mirror / Atom feedPDF docs
6+ messages / 5 participants
[nested] [flat]
* PDF docs
@ 2002-12-02 10:56 Vince Vielhaber <[email protected]>
2002-12-02 14:52 ` Re: PDF docs Tom Lane <[email protected]>
2002-12-02 19:29 ` Re: PDF docs Peter Eisentraut <[email protected]>
0 siblings, 2 replies; 6+ messages in thread
From: Vince Vielhaber @ 2002-12-02 10:56 UTC (permalink / raw)
To: pgsql-docs
Who generated the PDF docs for 7.2? Remember how it was done? Is
there a script somewhere for it?
Vince.
--
http://www.meanstreamradio.com http://www.unknown-artists.com
Internet radio: It's not file sharing, it's just radio.
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: PDF docs
2002-12-02 10:56 PDF docs Vince Vielhaber <[email protected]>
@ 2002-12-02 14:52 ` Tom Lane <[email protected]>
2002-12-02 15:01 ` Re: PDF docs Peter Mount <[email protected]>
1 sibling, 1 reply; 6+ messages in thread
From: Tom Lane @ 2002-12-02 14:52 UTC (permalink / raw)
To: Vince Vielhaber <[email protected]>; +Cc: pgsql-docs
Vince Vielhaber <[email protected]> writes:
> Who generated the PDF docs for 7.2? Remember how it was done? Is
> there a script somewhere for it?
Thomas has always done that in the past. There is some basic info
about it in the docs:
http://www.ca.postgresql.org/users-lounge/docs/7.3/postgres/doc-build.html
(see B.3.3), but I got the impression that he always did a great deal
of manual tweaking in the process.
regards, tom lane
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: PDF docs
2002-12-02 10:56 PDF docs Vince Vielhaber <[email protected]>
2002-12-02 14:52 ` Re: PDF docs Tom Lane <[email protected]>
@ 2002-12-02 15:01 ` Peter Mount <[email protected]>
2002-12-02 15:33 ` Re: PDF docs Thomas Lockhart <[email protected]>
0 siblings, 1 reply; 6+ messages in thread
From: Peter Mount @ 2002-12-02 15:01 UTC (permalink / raw)
To: Tom Lane <[email protected]>; +Cc: Vince Vielhaber <[email protected]>; pgsql-docs
On Mon, 2 Dec 2002, Tom Lane wrote:
> Vince Vielhaber <[email protected]> writes:
> > Who generated the PDF docs for 7.2? Remember how it was done? Is
> > there a script somewhere for it?
>
> Thomas has always done that in the past. There is some basic info
> about it in the docs:
> http://www.ca.postgresql.org/users-lounge/docs/7.3/postgres/doc-build.html
> (see B.3.3), but I got the impression that he always did a great deal
> of manual tweaking in the process.
IIRC tables didn't format correctly (occasionally split over pages).
Also (not sure if previous post made it), the docbook->PDF generated badly
implemented files (~30% bigger than need be) [caused by pdftex].
Peter
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: PDF docs
2002-12-02 10:56 PDF docs Vince Vielhaber <[email protected]>
2002-12-02 14:52 ` Re: PDF docs Tom Lane <[email protected]>
2002-12-02 15:01 ` Re: PDF docs Peter Mount <[email protected]>
@ 2002-12-02 15:33 ` Thomas Lockhart <[email protected]>
0 siblings, 0 replies; 6+ messages in thread
From: Thomas Lockhart @ 2002-12-02 15:33 UTC (permalink / raw)
To: Peter Mount <[email protected]>; +Cc: Tom Lane <[email protected]>; Vince Vielhaber <[email protected]>; pgsql-docs
>>>Who generated the PDF docs for 7.2? Remember how it was done? Is
>>>there a script somewhere for it?
>>Thomas has always done that in the past. There is some basic info
>>about it in the docs:
>>http://www.ca.postgresql.org/users-lounge/docs/7.3/postgres/doc-build.html
>>(see B.3.3), but I got the impression that he always did a great deal
>>of manual tweaking in the process.
The amount of tweaking went way down in the last couple of releases
since I identified the misformed but easily fixed rtf (in the opinion of
ApplixWare) generated by OpenJade. Look at doc/src/sgml/fixrtf for a
little utility to do that. OpenOffice seems to be happy with the rtf,
though I can't remember if I applied "fixrtf" first.
However, I did not generate documents for 7.2. Folks seemed to have
concluded that it was not a useful feature and were not willing to
accomodate it in the release process, so I stopped doing that.
Peter E. generated documents automatically for 7.2 (using tex rather
than rtf->word processor->ps) and it has the deficiencies noted below as
one would expect since they are well known issues to the OpenJade community.
The "manual tweaking" is a requirement for high-quality docs no matter
what path you choose; hopefully someone will realize that and decide to
put in some work.
> IIRC tables didn't format correctly (occasionally split over pages).
> Also (not sure if previous post made it), the docbook->PDF generated badly
> implemented files (~30% bigger than need be) [caused by pdftex].
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: PDF docs
2002-12-02 10:56 PDF docs Vince Vielhaber <[email protected]>
@ 2002-12-02 19:29 ` Peter Eisentraut <[email protected]>
2002-12-03 00:20 ` Re: PDF docs Vince Vielhaber <[email protected]>
1 sibling, 1 reply; 6+ messages in thread
From: Peter Eisentraut @ 2002-12-02 19:29 UTC (permalink / raw)
To: Vince Vielhaber <[email protected]>; +Cc: pgsql-docs
Vince Vielhaber writes:
> Who generated the PDF docs for 7.2? Remember how it was done? Is
> there a script somewhere for it?
I created the ones for 7.2. I just used 'gmake admin.pdf' etc. after some
heavy stylesheet hacking, but I hope that that won't be necessary again.
I'll look into it this week.
--
Peter Eisentraut [email protected]
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: PDF docs
2002-12-02 10:56 PDF docs Vince Vielhaber <[email protected]>
2002-12-02 19:29 ` Re: PDF docs Peter Eisentraut <[email protected]>
@ 2002-12-03 00:20 ` Vince Vielhaber <[email protected]>
0 siblings, 0 replies; 6+ messages in thread
From: Vince Vielhaber @ 2002-12-03 00:20 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: pgsql-docs
On Mon, 2 Dec 2002, Peter Eisentraut wrote:
> Vince Vielhaber writes:
>
> > Who generated the PDF docs for 7.2? Remember how it was done? Is
> > there a script somewhere for it?
>
> I created the ones for 7.2. I just used 'gmake admin.pdf' etc. after some
> heavy stylesheet hacking, but I hope that that won't be necessary again.
> I'll look into it this week.
Great! Thanks!
Vince.
--
http://www.meanstreamradio.com http://www.unknown-artists.com
Internet radio: It's not file sharing, it's just radio.
^ permalink raw reply [nested|flat] 6+ messages in thread
end of thread, other threads:[~2002-12-03 00:20 UTC | newest]
Thread overview: 6+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2002-12-02 10:56 PDF docs Vince Vielhaber <[email protected]>
2002-12-02 14:52 ` Tom Lane <[email protected]>
2002-12-02 15:01 ` Peter Mount <[email protected]>
2002-12-02 15:33 ` Thomas Lockhart <[email protected]>
2002-12-02 19:29 ` Peter Eisentraut <[email protected]>
2002-12-03 00:20 ` Vince Vielhaber <[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