Re: [DOCS] PDF build issue with 9.0 Alpha5

On Sat, 2010-04-03 at 15:53 -0400, Tom Lane wrote: > > There turns out to be a very easy way to inject the code change, which > is to create a file "jadetex.cfg" in the doc/src/sgml directory, > containing the modified version of the relevant TeX macro. > (Note: in the vpath case we'd probably nee

[DOCS] Documentation and explanatory diagrams

-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Hello I am wondering if we have ever evaluated the use of explanatory diagrams in the PostgreSQL documentation. I have always thought that a good diagram is worth a thousand words. I think the PostgreSQL manual would improve its quality if we get som

Re: [DOCS] Documentation and explanatory diagrams

That would be very nice to have ! Oleg On Mon, 5 Apr 2010, Rafael Martinez wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Hello I am wondering if we have ever evaluated the use of explanatory diagrams in the PostgreSQL documentation. I have always thought that a good diagram is worth a

Re: [DOCS] Documentation and explanatory diagrams

Rafael Martinez writes: > I am wondering if we have ever evaluated the use of explanatory diagrams > in the PostgreSQL documentation. There actually used to be some. We've moved away from them, I believe, because of the difficulty of maintenance; which stems mainly from the lack of any universal

Re: [DOCS] Documentation and explanatory diagrams

-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Tom Lane wrote: > Rafael Martinez writes: >> I am wondering if we have ever evaluated the use of explanatory diagrams >> in the PostgreSQL documentation. > > There actually used to be some. We've moved away from them, I believe, > because of the dif

[DOCS] code example wrapping

The manual has quite a few cases in the code-examples where, in the pdf version, there isn't enough width to show the whole line. Unfortunately, the rest of the line is then simply cut off, making the example 'invalid' (while reading, but also for copy-paste). I would like to reformat (only) th

Re: [DOCS] code example wrapping

"Erik Rijkers" writes: > The manual has quite a few cases in the code-examples where, in the pdf > version, there isn't > enough width to show the whole line. Unfortunately, the rest of the line is > then simply cut off, > making the example 'invalid' (while reading, but also for copy-paste).

Re: [DOCS] code example wrapping

On Mon, April 5, 2010 18:18, Tom Lane wrote: > "Erik Rijkers" writes: >> The manual has quite a few cases in the code-examples where, in the pdf >> version, there isn't >> enough width to show the whole line. Unfortunately, the rest of the line is >> then simply cut >> off, >> making the exampl

Re: [DOCS] Documentation and explanatory diagrams

On mån, 2010-04-05 at 16:52 +0200, Rafael Martinez wrote: > Tom Lane wrote: > > Rafael Martinez writes: > >> I am wondering if we have ever evaluated the use of explanatory diagrams > >> in the PostgreSQL documentation. > > > > There actually used to be some. We've moved away from them, I believ

Re: [DOCS] code example wrapping

On mån, 2010-04-05 at 18:30 +0200, Erik Rijkers wrote: > On Mon, April 5, 2010 18:18, Tom Lane wrote: > > "Erik Rijkers" writes: > >> The manual has quite a few cases in the code-examples where, in the pdf > >> version, there isn't > >> enough width to show the whole line. Unfortunately, the res

Re: [DOCS] Documentation and explanatory diagrams

Rafael Martinez wrote: Well, I was thinking about DIA [1]. It runs on Unix, Windows and Mac. It loads and saves diagrams to a custom XML format and it can export diagrams to a number of formats, including EPS, SVG, XFIG, WMF and PNG. I keep a copy of Windows around to run exactly four progra

Re: [DOCS] Documentation and explanatory diagrams

Peter Eisentraut wrote: > Preferably, any tool that we would use would save a reasonably plain > text source file that we could check into VCS and would provide a tool > for automatically converting to a variety of target formats. For > example, graphviz could work well. (Not saying that graphvi

Re: [DOCS] Documentation and explanatory diagrams

-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Peter Eisentraut wrote: > On mån, 2010-04-05 at 16:52 +0200, Rafael Martinez wrote: >> Well, I was thinking about DIA [1]. It runs on Unix, Windows and Mac. >> It loads and saves diagrams to a custom XML format and it can export >> diagrams to a numbe

Re: [DOCS] Documentation and explanatory diagrams

-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Greg Smith wrote: [...] > > Given that's how the work is being done by community members right now, > I think you'd make better progress asking how to index the material in > those slides better and provide a hotlist of good slides on the Wiki. I

Re: [DOCS] code example wrapping

On Mon, April 5, 2010 19:29, Peter Eisentraut wrote: > On mån, 2010-04-05 at 18:30 +0200, Erik Rijkers wrote: >> On Mon, April 5, 2010 18:18, Tom Lane wrote: >> > "Erik Rijkers" writes: >> > >> >> I would like to reformat (only) those cases so that the text is >> >> completely readable on the H

[DOCS] typo 'anyways'

'anyways' is not correct english, I think... --- doc/src/sgml/xtypes.sgml.orig 2010-04-06 02:48:33.0 +0200 +++ doc/src/sgml/xtypes.sgml2010-04-06 02:49:22.0 +0200 @@ -265,7 +265,7 @@ If the alignment is unimportant (either just for a specific function or - beca