Re: [DOCS] pdf/ps docs for 7.4?
Can we add some kind of regression test, or at least a note in the
release process somewhere, to ensure that *someone* can build html/pdf
copies of the docs. I'm not even too concerned if it requires a narrow
toolset, but it's something we ought to have ready for 7.5 when it goes
out the door.
Robert Treat
On Tue, 2003-11-18 at 17:17, Bruce Momjian wrote:
> Oliver Elphick wrote:
> > On Tue, 2003-11-18 at 02:54, Christopher Browne wrote:
> > ...
> > > > cd doc/src/sgml
> > > > make postgres.pdf
> > > >
> > > > but openjade falls over:
> > ...
> > > > I've asked Debian's openjade maintainer for assistance, so I'll let you
> > > > know if I get any.
> > >
> > > If it can wait 'til next week, I can take a look at it, as I'm fairly
> > > familiar with the tools. Sadly, a week today's the earliest I can
> > > conceivably touch it.
> >
> > The Debian maintainer is looking.
> >
> > Bruce said he managed to build it by building postgres.html first, but
> > that didn't work for me.
>
> It built much farther, but failed with unreferenced sections errors.
>
> --
> 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 8: explain analyze is your friend
--
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL
---(end of broadcast)---
TIP 2: you can get off all lists at once with the unregister command
(send "unregister YourEmailAddressHere" to [EMAIL PROTECTED])
Re: [DOCS] pdf/ps docs for 7.4?
Robert Treat wrote: > Can we add some kind of regression test, or at least a note in the > release process somewhere, to ensure that *someone* can build html/pdf > copies of the docs. I'm not even too concerned if it requires a narrow > toolset, but it's something we ought to have ready for 7.5 when it goes > out the door. Agreed. I think I have the toolset working, but the build is failing and I can't figure out why. -- 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 8: explain analyze is your friend
Re: [DOCS] 7.4 official docs : Fonts?
People, > of varied sizes. The usage for different types > of objects seems to be fairly consistent, > however, the varied sizes of the different fonts > make things very hard to read. Elein is correct, our variety of styles does look odd and can cause issues with readability.See, for example, http://www.postgresql.org/docs/current/static/functions-string.html Can we experiment with different SGML-to-HMTL font styles to find one that's a little easier on the eyes? What I find particularly difficult are the function parameter columns; the mix of "normal" italics with "bold" italics. Comments? Responses? -- -Josh Berkus Aglio Database Solutions San Francisco ---(end of broadcast)--- TIP 3: if posting/reading through Usenet, please send an appropriate subscribe-nomail command to [EMAIL PROTECTED] so that your message can get through to the mailing list cleanly
Re: [DOCS] 7.4 official docs : Fonts?
On Wed, 2003-11-19 at 15:10, Josh Berkus wrote:
> People,
>
> > of varied sizes. The usage for different types
> > of objects seems to be fairly consistent,
> > however, the varied sizes of the different fonts
> > make things very hard to read.
>
> Elein is correct, our variety of styles does look odd and can cause issues
> with readability.See, for example,
> http://www.postgresql.org/docs/current/static/functions-string.html
>
> Can we experiment with different SGML-to-HMTL font styles to find one that's a
> little easier on the eyes? What I find particularly difficult are the
> function parameter columns; the mix of "normal" italics with "bold" italics.
>
> Comments? Responses?
>
Whatever we had in 7.3 we should switch back to:
http://www.postgresql.org/docs/7.3/static/functions-string.html
Robert Treat
--
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL
---(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] 7.4 official docs : Fonts?
Josh Berkus writes: > Elein is correct, our variety of styles does look odd and can cause issues > with readability.See, for example, > http://www.postgresql.org/docs/current/static/functions-string.html > > Can we experiment with different SGML-to-HMTL font styles to find one that's a > little easier on the eyes? What I find particularly difficult are the > function parameter columns; the mix of "normal" italics with "bold" italics. Compare with the "original" version: http://developer.postgresql.org/docs/postgres/functions-string.html That looks fairly reasonable to me. So the problem appears to be in the CSS stylesheets. -- Peter Eisentraut [EMAIL PROTECTED] ---(end of broadcast)--- TIP 1: subscribe and unsubscribe commands go to [EMAIL PROTECTED]
Re: [DOCS] 7.4 official docs : Fonts?
Peter Eisentraut writes: > > Elein is correct, our variety of styles does look odd and can cause issues > > with readability.See, for example, > > http://www.postgresql.org/docs/current/static/functions-string.html > Compare with the "original" version: > > http://developer.postgresql.org/docs/postgres/functions-string.html > > That looks fairly reasonable to me. So the problem appears to be in the > CSS stylesheets. This page puts the discrepancies in words: http://www.postgresql.org/docs/current/static/notation.html -- Peter Eisentraut [EMAIL PROTECTED] ---(end of broadcast)--- TIP 3: if posting/reading through Usenet, please send an appropriate subscribe-nomail command to [EMAIL PROTECTED] so that your message can get through to the mailing list cleanly
Re: [DOCS] 7.4 official docs : Fonts?
On Thursday, November 20, 2003, at 05:10 AM, Josh Berkus wrote: Can we experiment with different SGML-to-HMTL font styles to find one that's a little easier on the eyes? What I find particularly difficult are the function parameter columns; the mix of "normal" italics with "bold" italics. Comments? Responses? As Peter has pointed out, the CSS can handle a lot of it. It doesn't have to be hardcoded into the SGML-to-HTML transformation. One option would be to use colors as well (I'm not talking a rainbow of fruit flavors here :). In particular, I find italics often difficult to read on the web. I'll try to get a few styles worked up by tomorrow that could just be added to the css file—we can change the actual structure of the HTML later. Michael ---(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] 7.4 official docs : Fonts?
Michael Glaesemann wrote: > > On Thursday, November 20, 2003, at 05:10 AM, Josh Berkus wrote: > > Can we experiment with different SGML-to-HMTL font styles to find one > > that's a > > little easier on the eyes? What I find particularly difficult are the > > function parameter columns; the mix of "normal" italics with "bold" > > italics. > > > > Comments? Responses? > > As Peter has pointed out, the CSS can handle a lot of it. It doesn't > have to be hardcoded into the SGML-to-HTML transformation. One option > would be to use colors as well (I'm not talking a rainbow of fruit > flavors here :). In particular, I find italics often difficult to read > on the web. I'll try to get a few styles worked up by tomorrow that I think it is the monospace italics that really look bad. -- 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 8: explain analyze is your friend
Re: [DOCS] 7.4 official docs : Fonts?
On Thursday, November 20, 2003, at 12:56 PM, Bruce Momjian wrote: Michael Glaesemann wrote: On Thursday, November 20, 2003, at 05:10 AM, Josh Berkus wrote: Can we experiment with different SGML-to-HMTL font styles to find one that's a little easier on the eyes? What I find particularly difficult are the function parameter columns; the mix of "normal" italics with "bold" italics. Comments? Responses? As Peter has pointed out, the CSS can handle a lot of it. It doesn't have to be hardcoded into the SGML-to-HTML transformation. One option would be to use colors as well (I'm not talking a rainbow of fruit flavors here :). In particular, I find italics often difficult to read on the web. I'll try to get a few styles worked up by tomorrow that I think it is the monospace italics that really look bad. I'd have to agree with you. Making them a color other than the text (black) or the links (blue/purple depending on your eyes) would set them off quite well. Serif fonts at small sizes can also be pretty nasty, though this isn't an issue with the PostgreSQL docs. Michael ---(end of broadcast)--- TIP 2: you can get off all lists at once with the unregister command (send "unregister YourEmailAddressHere" to [EMAIL PROTECTED])
