Re: [DOCS] Documentation and explanatory diagrams

2012-07-12 Thread Bruce Momjian
On Sun, Jun 12, 2011 at 10:08:05PM +0100, Thom Brown wrote: > On 27 September 2010 15:29, Thom Brown wrote: > > On 18 July 2010 11:58, Rafael Martinez wrote: > >> -BEGIN PGP SIGNED MESSAGE- > >> Hash: SHA1 > >> > >> Thom Brown wrote: > >> > >>> Okay, I just edited an existing dia file: pg

Re: [DOCS] Documentation and explanatory diagrams

2011-06-14 Thread Ross J. Reedstrom
On Tue, Jun 14, 2011 at 08:59:41AM -0400, Bruce Momjian wrote: > Robert Haas wrote: > > On Mon, Jun 13, 2011 at 8:46 PM, Tom Lane wrote: > > > > > > Or at least, somebody passes it through the "proper editor" before > > > committing. ?As long as said editor can read SVG output from a > > > reasona

Re: [DOCS] Documentation and explanatory diagrams

2011-06-14 Thread Bruce Momjian
Robert Haas wrote: > On Mon, Jun 13, 2011 at 8:46 PM, Tom Lane wrote: > > Bruce Momjian writes: > >> Tom Lane wrote: > >>> Bruce Momjian writes: > Perhaps we should allow any SVG file to be imported, but only allow > modifications by a single SVG editor. > > > >>> How is that sensible?

Re: [DOCS] Documentation and explanatory diagrams

2011-06-14 Thread Robert Haas
On Mon, Jun 13, 2011 at 8:46 PM, Tom Lane wrote: > Bruce Momjian writes: >> Tom Lane wrote: >>> Bruce Momjian writes: Perhaps we should allow any SVG file to be imported, but only allow modifications by a single SVG editor. > >>> How is that sensible?  The first change to the file will

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Tom Lane
Bruce Momjian writes: > Tom Lane wrote: >> Bruce Momjian writes: >>> Perhaps we should allow any SVG file to be imported, but only allow >>> modifications by a single SVG editor. >> How is that sensible? The first change to the file will result in >> exactly the mass of cosmetic diffs that we w

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Bruce Momjian
Tom Lane wrote: > Bruce Momjian writes: > > I think the big question is whether we can afford to allow multiple SVG > > editor file formats to be checked in, and hence support git diff churn > > as we switch SVG editors for commits. This doesn't seem likely to > > improve anytime soon so we shoul

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Tom Lane
Bruce Momjian writes: > I think the big question is whether we can afford to allow multiple SVG > editor file formats to be checked in, and hence support git diff churn > as we switch SVG editors for commits. This doesn't seem likely to > improve anytime soon so we should just decide and move for

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Bruce Momjian
Ross J. Reedstrom wrote: > On Mon, Jun 13, 2011 at 09:17:04PM +, Thom Brown wrote: > > > > > > xmllint --format for_test_here.svg | wc -l > > > > That restores some of the newlines, but inkscape seems to place tag > > attributes on their own separate lines for readability, so the outputs > > s

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Ross J. Reedstrom
On Mon, Jun 13, 2011 at 09:17:04PM +, Thom Brown wrote: > > > > xmllint --format for_test_here.svg | wc -l > > That restores some of the newlines, but inkscape seems to place tag > attributes on their own separate lines for readability, so the outputs > still differ, unless you pass both throu

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Thom Brown
On 13 June 2011 20:59, Ross J. Reedstrom wrote: > On Mon, Jun 13, 2011 at 06:36:12PM +, Thom Brown wrote: >> On 13 June 2011 14:35, Greg Smith wrote: >> > I just created a drawing, saved it, then >> > modified it a bit.  The spurious diff from the GUI was quite small:  three >> > lines of jun

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Greg Smith
On 06/13/2011 04:59 PM, Ross J. Reedstrom wrote: However, my copy of OpenOffice.org (3.2.1.4) does evil things to a pencil squiggle drawn in Inkscape. That's why I referred to the lists of open issues in this area. It's possible to get various levels of SVG support working in OpenOffice/Libr

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Ross J. Reedstrom
On Mon, Jun 13, 2011 at 06:36:12PM +, Thom Brown wrote: > On 13 June 2011 14:35, Greg Smith wrote: > > I just created a drawing, saved it, then > > modified it a bit.  The spurious diff from the GUI was quite small:  three > > lines of junk with the filename change and some windowing metadata.

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Joshua D. Drake
On 06/13/2011 07:35 AM, Greg Smith wrote: On 06/13/2011 09:36 AM, Rafael Martinez wrote: It refers among other things to Inkscape [2]. This program generates SVG diagrams and is not so difficult to use. One of the good things with Inkscape is that it works with a standard format so we are not bo

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Thom Brown
On 13 June 2011 14:35, Greg Smith wrote: > I just created a drawing, saved it, then > modified it a bit.  The spurious diff from the GUI was quite small:  three > lines of junk with the filename change and some windowing metadata.  And the > new material added showed in a pretty readable diff as I

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Ross J. Reedstrom
On Mon, Jun 13, 2011 at 10:35:41AM -0400, Greg Smith wrote: > On 06/13/2011 09:36 AM, Rafael Martinez wrote: > >It refers among other things to Inkscape [2]. This program generates SVG > >diagrams and is not so difficult to use. One of the good things with > >Inkscape is that it works with a standa

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Greg Smith
On 06/13/2011 09:36 AM, Rafael Martinez wrote: It refers among other things to Inkscape [2]. This program generates SVG diagrams and is not so difficult to use. One of the good things with Inkscape is that it works with a standard format so we are not bound to a specific program or non standard f

Re: [DOCS] Documentation and explanatory diagrams

2011-06-13 Thread Rafael Martinez
On Sun, 2011-06-12 at 17:44 -0400, Bruce Momjian wrote: > Thom Brown wrote: > > > > Obviously nothing for this happened in time to make it for 9.1. So > > are diagrams still something we plan to have? > > Agreed, we need to move forward with something, and I am afraid we got > into bike-sheeting

Re: [DOCS] Documentation and explanatory diagrams

2011-06-12 Thread Bruce Momjian
Thom Brown wrote: > On 27 September 2010 15:29, Thom Brown wrote: > > On 18 July 2010 11:58, Rafael Martinez wrote: > >> -BEGIN PGP SIGNED MESSAGE- > >> Hash: SHA1 > >> > >> Thom Brown wrote: > >> > >>> Okay, I just edited an existing dia file: pgclient_server.dia. ?All I > >>> did was ch

Re: [DOCS] Documentation and explanatory diagrams

2011-06-12 Thread Thom Brown
On 27 September 2010 15:29, Thom Brown wrote: > On 18 July 2010 11:58, Rafael Martinez wrote: >> -BEGIN PGP SIGNED MESSAGE- >> Hash: SHA1 >> >> Thom Brown wrote: >> >>> Okay, I just edited an existing dia file: pgclient_server.dia.  All I >>> did was change the font size of the text "clie

Re: [DOCS] Documentation and explanatory diagrams

2010-09-27 Thread Thom Brown
On 18 July 2010 11:58, Rafael Martinez wrote: > -BEGIN PGP SIGNED MESSAGE- > Hash: SHA1 > > Thom Brown wrote: > >> Okay, I just edited an existing dia file: pgclient_server.dia.  All I >> did was change the font size of the text "client application" at the >> top of the diagram, and change

Re: [DOCS] Documentation and explanatory diagrams

2010-07-18 Thread Rafael Martinez
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Thom Brown wrote: > Okay, I just edited an existing dia file: pgclient_server.dia. All I > did was change the font size of the text "client application" at the > top of the diagram, and changed the properties of a line so the > arrowhead was no longe

Re: [DOCS] Documentation and explanatory diagrams

2010-07-18 Thread Rafael Martinez
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Rafael Martinez wrote: > > All this means that xml files generated by DIA er VCS friendliness, they > only change the attributes/objects changed between versions of the > diagram. It can be used without problems to diff the contents and create > patc

Re: [DOCS] Documentation and explanatory diagrams

2010-07-18 Thread Rafael Martinez
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Steve Atkins wrote: > But choosing a > proprietary format that's only supported by a single tool, and > that renders to horrible quality PNGs is something we'll regret, > I think. I think we should keep to the facts and you are not doing it here. Can

Re: [DOCS] Documentation and explanatory diagrams

2010-07-18 Thread Rafael Martinez
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Tom Lane wrote: > But we need to do some experimentation with specific > tools and see what the output really looks like and how it changes > given small changes in the diagram, before we choose anything. > I did some tests sometime ago for my propo

Re: [DOCS] Documentation and explanatory diagrams

2010-07-18 Thread Thom Brown
On 18 July 2010 09:36, Peter Eisentraut wrote: > On sön, 2010-07-18 at 00:46 -0400, Bruce Momjian wrote: >> Well, if we want _any_ images for the 9.0 docs, we had better decide >> soon. > > I'd be very much against putting any images into 9.0 at this time.  I > was working under the assumption tha

Re: [DOCS] Documentation and explanatory diagrams

2010-07-18 Thread Peter Eisentraut
On sön, 2010-07-18 at 00:46 -0400, Bruce Momjian wrote: > Well, if we want _any_ images for the 9.0 docs, we had better decide > soon. I'd be very much against putting any images into 9.0 at this time. I was working under the assumption that this discussion would be targeting 9.1. -- Sent via

Re: [DOCS] Documentation and explanatory diagrams

2010-07-17 Thread Bruce Momjian
Tom Lane wrote: > Steve Atkins writes: > > On Jul 16, 2010, at 7:20 PM, Robert Haas wrote: > >> Unless I'm misunderstanding what you're talking about here, this is a > >> really, really bad idea. > > > You're misunderstanding. > > Yeah, I think that in the main you guys are in violent agreement.

Re: [DOCS] Documentation and explanatory diagrams

2010-07-17 Thread Tom Lane
Steve Atkins writes: > On Jul 16, 2010, at 7:20 PM, Robert Haas wrote: >> Unless I'm misunderstanding what you're talking about here, this is a >> really, really bad idea. > You're misunderstanding. Yeah, I think that in the main you guys are in violent agreement. > My feeling is that SVG is a

Re: [DOCS] Documentation and explanatory diagrams

2010-07-16 Thread Steve Atkins
On Jul 16, 2010, at 7:20 PM, Robert Haas wrote: > On Sun, Jul 11, 2010 at 11:32 AM, Steve Atkins wrote: >> I have no dog in this fight, and I'd be overjoyed to see diagrams of >> any sort. I do think that requiring use of a single, fairly clunky, graphics >> package rather than allowing people w

Re: [DOCS] Documentation and explanatory diagrams

2010-07-16 Thread Robert Haas
On Sun, Jul 11, 2010 at 11:32 AM, Steve Atkins wrote: > I have no dog in this fight, and I'd be overjoyed to see diagrams of > any sort. I do think that requiring use of a single, fairly clunky, graphics > package rather than allowing people who get the urge to create a > diagram to use whichever

Re: [DOCS] Documentation and explanatory diagrams

2010-07-11 Thread Steve Atkins
On Jul 11, 2010, at 9:26 AM, Tom Lane wrote: > Steve Atkins writes: >> On Jul 11, 2010, at 12:33 AM, Rafael Martinez wrote: >> [ assorted arguments for and against DIA ] > >>> 2) dia-format is too verbose and it uses too much space when it is not >>> compressed. [vs] >>> 2) When compressed with

Re: [DOCS] Documentation and explanatory diagrams

2010-07-11 Thread Tom Lane
Steve Atkins writes: > On Jul 11, 2010, at 12:33 AM, Rafael Martinez wrote: > [ assorted arguments for and against DIA ] >> 2) dia-format is too verbose and it uses too much space when it is not >> compressed. [vs] >> 2) When compressed with gzip, we can get over 90% reduction in size. >> 3) You

Re: [DOCS] Documentation and explanatory diagrams

2010-07-11 Thread Steve Atkins
On Jul 11, 2010, at 12:33 AM, Rafael Martinez wrote: > -BEGIN PGP SIGNED MESSAGE- > Hash: SHA1 > > Bruce Momjian wrote: > >> >> Where are we on this? Application? dia? xfig? Number of colors? Once >> we decide these items, we can start adding diagrams. >> > > This is an attempt t

Re: [DOCS] Documentation and explanatory diagrams

2010-07-11 Thread Rafael Martinez
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Bruce Momjian wrote: > > Where are we on this? Application? dia? xfig? Number of colors? Once > we decide these items, we can start adding diagrams. > This is an attempt to summarize the current status and what have been said/done about the sub

Re: [DOCS] Documentation and explanatory diagrams

2010-07-10 Thread Peter Eisentraut
On fre, 2010-07-09 at 22:29 -0400, Alvaro Herrera wrote: > Maybe we could have diagrams generated by different tools; e.g. we > could use GraphViz for some things. I have found that graphviz doesn't work very well for creating diagrams of software systems or the like. -- Sent via pgsql-docs mai

Re: [DOCS] Documentation and explanatory diagrams

2010-07-10 Thread Peter Eisentraut
On fre, 2010-07-09 at 22:29 -0400, Alvaro Herrera wrote: > I think the first step is defining the source format. The proposed > patch uses the dia XML source format, but this is said to have some > drawbacks (namely: the source is too verbose, the generated png is too > bloated, and only one tool

Re: [DOCS] Documentation and explanatory diagrams

2010-07-09 Thread Steve Atkins
On Jul 9, 2010, at 8:35 PM, Robert Haas wrote: > On Fri, Jul 9, 2010 at 10:46 PM, Bruce Momjian wrote: >> PNG image attached. > > Is it just me, or does that look pretty pixellated and awful? As a comparison I did an SVG version using OmniGraffle and a conversion to PNG. I suspect Inkscape (w

Re: [DOCS] Documentation and explanatory diagrams

2010-07-09 Thread Robert Haas
On Fri, Jul 9, 2010 at 10:46 PM, Bruce Momjian wrote: > PNG image attached. Is it just me, or does that look pretty pixellated and awful? -- Robert Haas EnterpriseDB: http://www.enterprisedb.com The Enterprise Postgres Company -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To

Re: [DOCS] Documentation and explanatory diagrams

2010-07-09 Thread Bruce Momjian
Alvaro Herrera wrote: > Excerpts from Bruce Momjian's message of vie jul 09 20:01:55 -0400 2010: > > > Where are we on this? Application? dia? xfig? Number of colors? Once > > we decide these items, we can start adding diagrams. > > I think the first step is defining the source format. The p

Re: [DOCS] Documentation and explanatory diagrams

2010-07-09 Thread Alvaro Herrera
Excerpts from Bruce Momjian's message of vie jul 09 20:01:55 -0400 2010: > Where are we on this? Application? dia? xfig? Number of colors? Once > we decide these items, we can start adding diagrams. I think the first step is defining the source format. The proposed patch uses the dia XML sou

Re: [DOCS] Documentation and explanatory diagrams

2010-07-09 Thread Bruce Momjian
Rafael Martinez wrote: > -BEGIN PGP SIGNED MESSAGE- > Hash: SHA1 > > On 07/03/2010 01:02 AM, Robert Haas wrote: > > > > > Also, I think we need to review these images carefully before adding > > any of them into our docs. > > I agree with this. I didn't want to use a lot time with the

Re: [DOCS] Documentation and explanatory diagrams

2010-07-08 Thread Chris Browne
br...@momjian.us (Bruce Momjian) writes: > Marc G. Fournier wrote: >> On Fri, 2 Jul 2010, Tom Lane wrote: >> >> > Alvaro Herrera writes: >> >> Excerpts from Peter Eisentraut's message of jue jul 01 21:52:00 -0400 >> >> 2010: >> >>> Is there something that makes installing dia more challenging th

Re: [DOCS] Documentation and explanatory diagrams

2010-07-08 Thread Marc G. Fournier
On Sat, 3 Jul 2010, Robert Haas wrote: On Sat, Jul 3, 2010 at 6:48 PM, Thom Brown wrote: ..just an idea anyway. Seems like a good one. But I'd still like to know the answer to the question I asked upthread - how is anyone supposed to generate images this way? One would think that configur

Re: [DOCS] Documentation and explanatory diagrams

2010-07-08 Thread Marc G. Fournier
On Fri, 2 Jul 2010, Bruce Momjian wrote: I am afraid if we don't enable dia by default then we will end up with production documentation without images. I think we have to default dia to on, and give a reasonable error when it doesn't exist, and mention how to turn it off. Okay, I have no p

Re: [DOCS] Documentation and explanatory diagrams

2010-07-08 Thread Marc G. Fournier
On Fri, 2 Jul 2010, Bruce Momjian wrote: Marc G. Fournier wrote: On Fri, 2 Jul 2010, Robert Haas wrote: On Fri, Jul 2, 2010 at 5:28 PM, Bruce Momjian wrote: OK, everyone seems to like requiring dia. I don't like it a bit. It's hard enough for people to build the docs as it is. Why shou

Re: [DOCS] Documentation and explanatory diagrams

2010-07-08 Thread Marc G. Fournier
On Fri, 2 Jul 2010, Robert Haas wrote: On Fri, Jul 2, 2010 at 5:28 PM, Bruce Momjian wrote: OK, everyone seems to like requiring dia. I don't like it a bit. It's hard enough for people to build the docs as it is. Why should anyone build the docs? Its part of the tarball process, so the

Re: [DOCS] Documentation and explanatory diagrams

2010-07-08 Thread Marc G. Fournier
On Fri, 2 Jul 2010, Bruce Momjian wrote: Tom Lane wrote: Alvaro Herrera writes: Excerpts from Peter Eisentraut's message of jue jul 01 21:52:00 -0400 2010: Is there something that makes installing dia more challenging than the other documentation build tools? Err, I dunno -- it's just an

Re: [DOCS] Documentation and explanatory diagrams

2010-07-08 Thread Chris Browne
t...@sss.pgh.pa.us (Tom Lane) writes: > Alvaro Herrera writes: >> Excerpts from Peter Eisentraut's message of jue jul 01 21:52:00 -0400 2010: >>> Is there something that makes installing dia more challenging than the >>> other documentation build tools? > >> Err, I dunno -- it's just an apt-get aw

Re: [DOCS] Documentation and explanatory diagrams

2010-07-08 Thread Marc G. Fournier
On Fri, 2 Jul 2010, Tom Lane wrote: Alvaro Herrera writes: Excerpts from Peter Eisentraut's message of jue jul 01 21:52:00 -0400 2010: Is there something that makes installing dia more challenging than the other documentation build tools? Err, I dunno -- it's just an apt-get away for me, b

Re: [DOCS] Documentation and explanatory diagrams

2010-07-05 Thread Robert Haas
On Mon, Jul 5, 2010 at 4:23 AM, Rafael Martinez wrote: >> For example, I'd dispute the picture of the >> world shown on the file_based_log_shipping.png image; that's certainly >> not the only way to set it up (the archive needn't be on the primary >> node, right?). > > It is not the only way of sh

Re: [DOCS] Documentation and explanatory diagrams

2010-07-05 Thread Rafael Martinez
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 07/03/2010 01:02 AM, Robert Haas wrote: > > Also, I think we need to review these images carefully before adding > any of them into our docs. I agree with this. I didn't want to use a lot time with the diagrams until everything is decided and we

Re: [DOCS] Documentation and explanatory diagrams

2010-07-04 Thread Rafael Martinez
Robert Haas wrote: > On Sat, Jul 3, 2010 at 7:14 PM, Tom Lane wrote: >> Robert Haas writes: >>> Seems like a good one.  But I'd still like to know the answer to the >>> question I asked upthread - how is anyone supposed to generate images >>> this way? >> >> Hmm, judging from >> http://live.gnom

Re: [DOCS] Documentation and explanatory diagrams

2010-07-04 Thread Tom Lane
Bruce Momjian writes: > Thom Brown wrote: >> It looks like it does support SVG output: >> >> http://en.wikipedia.org/wiki/Xfig >> http://epb.lbl.gov/xfig/printing.html#export >> http://www.xfig.org/art11.html > Yes, I have xfig 3.2 and it has SVG export, though it is labeled as > beta. Why shou

Re: [DOCS] Documentation and explanatory diagrams

2010-07-04 Thread Bruce Momjian
Thom Brown wrote: > On 4 July 2010 04:49, Bruce Momjian wrote: > > Peter Eisentraut wrote: > >> On l?r, 2010-07-03 at 19:17 -0400, Tom Lane wrote: > >> > I hesitate to suggest xfig, but at least it's got a well-specified > >> > file format ... > >> > >> Looks a little old. ?It doesn't appear to su

Re: [DOCS] Documentation and explanatory diagrams

2010-07-04 Thread Thom Brown
On 4 July 2010 04:49, Bruce Momjian wrote: > Peter Eisentraut wrote: >> On l?r, 2010-07-03 at 19:17 -0400, Tom Lane wrote: >> > I hesitate to suggest xfig, but at least it's got a well-specified >> > file format ... >> >> Looks a little old.  It doesn't appear to support SVG output, for >> example

Re: [DOCS] Documentation and explanatory diagrams

2010-07-03 Thread Bruce Momjian
Peter Eisentraut wrote: > On l?r, 2010-07-03 at 19:17 -0400, Tom Lane wrote: > > I hesitate to suggest xfig, but at least it's got a well-specified > > file format ... > > Looks a little old. It doesn't appear to support SVG output, for > example. It supports EPS output which I believe can be co

Re: [DOCS] Documentation and explanatory diagrams

2010-07-03 Thread Peter Eisentraut
On lör, 2010-07-03 at 19:17 -0400, Tom Lane wrote: > I hesitate to suggest xfig, but at least it's got a well-specified > file format ... Looks a little old. It doesn't appear to support SVG output, for example. -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to

Re: [DOCS] Documentation and explanatory diagrams

2010-07-03 Thread Peter Eisentraut
On lör, 2010-07-03 at 19:14 -0400, Tom Lane wrote: > (I'd bet a nickel that any small change results in > massive changes in the file contents, too, which will be un-fun for > keeping them in a VCS.) I asked about this in the original thread and was told that this wouldn't be a problem. -- Sent

Re: [DOCS] Documentation and explanatory diagrams

2010-07-03 Thread Bruce Momjian
Tom Lane wrote: > Robert Haas writes: > > Anyone know of any other alternatives we could investigate? > > I hesitate to suggest xfig, but at least it's got a well-specified file > format ... xfig is what I use and I have edited those by hand in the past. -- Bruce Momjian http://momj

Re: [DOCS] Documentation and explanatory diagrams

2010-07-03 Thread Steve Atkins
On Jul 3, 2010, at 4:16 PM, Robert Haas wrote: > On Sat, Jul 3, 2010 at 7:14 PM, Tom Lane wrote: >> Robert Haas writes: >>> Seems like a good one. But I'd still like to know the answer to the >>> question I asked upthread - how is anyone supposed to generate images >>> this way? >> >> Hmm, ju

Re: [DOCS] Documentation and explanatory diagrams

2010-07-03 Thread Tom Lane
Robert Haas writes: > Anyone know of any other alternatives we could investigate? I hesitate to suggest xfig, but at least it's got a well-specified file format ... regards, tom lane -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your

Re: [DOCS] Documentation and explanatory diagrams

2010-07-03 Thread Robert Haas
On Sat, Jul 3, 2010 at 7:14 PM, Tom Lane wrote: > Robert Haas writes: >> Seems like a good one.  But I'd still like to know the answer to the >> question I asked upthread - how is anyone supposed to generate images >> this way? > > Hmm, judging from > http://live.gnome.org/Dia > > the answer is t

Re: [DOCS] Documentation and explanatory diagrams

2010-07-03 Thread Tom Lane
Robert Haas writes: > Seems like a good one. But I'd still like to know the answer to the > question I asked upthread - how is anyone supposed to generate images > this way? Hmm, judging from http://live.gnome.org/Dia the answer is that .dia files aren't meant to be human readable but only to b

Re: [DOCS] Documentation and explanatory diagrams

2010-07-03 Thread Robert Haas
On Sat, Jul 3, 2010 at 6:48 PM, Thom Brown wrote: > ..just an idea anyway. Seems like a good one. But I'd still like to know the answer to the question I asked upthread - how is anyone supposed to generate images this way? -- Robert Haas EnterpriseDB: http://www.enterprisedb.com The Enterprise

Re: [DOCS] Documentation and explanatory diagrams

2010-07-03 Thread Thom Brown
On 3 July 2010 13:59, Thom Brown wrote: > On 3 July 2010 03:41, Bruce Momjian wrote: >> Peter Eisentraut wrote: >>> On fre, 2010-07-02 at 22:15 -0400, Bruce Momjian wrote: >>> > > 500k of source for just half a dozen simple images?  There's >>> > something >>> > > seriously wrong there.  I suspec

Re: [DOCS] Documentation and explanatory diagrams

2010-07-03 Thread Thom Brown
On 3 July 2010 03:41, Bruce Momjian wrote: > Peter Eisentraut wrote: >> On fre, 2010-07-02 at 22:15 -0400, Bruce Momjian wrote: >> > > 500k of source for just half a dozen simple images?  There's >> > something >> > > seriously wrong there.  I suspect the PNGs could be compressed a lot >> > > more

Re: [DOCS] Documentation and explanatory diagrams

2010-07-03 Thread Heikki Linnakangas
On 03/07/10 02:02, Robert Haas wrote: The page_layout image is kinda confusing - I can tell what the purple and brown arrows are supposed to represent, but only because I already know what they're supposed to mean. I realize that these are just sample images, but I'd like to enact a strict rul

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Bruce Momjian
Peter Eisentraut wrote: > On fre, 2010-07-02 at 22:15 -0400, Bruce Momjian wrote: > > > 500k of source for just half a dozen simple images? There's > > something > > > seriously wrong there. I suspect the PNGs could be compressed a lot > > > more, but right now I'm wondering exactly how verbose t

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Robert Haas
On Fri, Jul 2, 2010 at 10:15 PM, Bruce Momjian wrote: > Tom Lane wrote: >> Bruce Momjian writes: >> > One more issue is that the dia and png files are going to impact our >> > download sizes: >> >> >     526k     ./dia >> >     483k     ./png >> >> 500k of source for just half a dozen simple imag

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Peter Eisentraut
On fre, 2010-07-02 at 22:15 -0400, Bruce Momjian wrote: > > 500k of source for just half a dozen simple images? There's > something > > seriously wrong there. I suspect the PNGs could be compressed a lot > > more, but right now I'm wondering exactly how verbose the dia > "source" > > representati

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Bruce Momjian
Peter Eisentraut wrote: > On fre, 2010-07-02 at 18:07 -0400, Bruce Momjian wrote: > > The point is you will have to explicitly turn off dia/images to build > > without images. That should make anyone building production docs > > always > > generate images, unless they override the default. > > W

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Tom Lane
Robert Haas writes: > Is it at all practical to ship the PNGs as well as the DIA files in > CVS, and make rebuilding the PNGs from the DIAs a separate step? Other than the bulky file sizes I see nothing wrong with that approach. We have traditionally not required developers to have autoconf insta

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Bruce Momjian
Tom Lane wrote: > Bruce Momjian writes: > > One more issue is that the dia and png files are going to impact our > > download sizes: > > > 526k ./dia > > 483k ./png > > 500k of source for just half a dozen simple images? There's something > seriously wrong there. I suspect the

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Tom Lane
Robert Haas writes: > On Fri, Jul 2, 2010 at 5:43 PM, Bruce Momjian wrote: >> People often built them to verify the SGML markup and to view the >> content/markup before submitting a doc patch. > Actually, they often DON'T, which is a problem, and adding more > requirements is only going to make

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Peter Eisentraut
On fre, 2010-07-02 at 19:02 -0400, Robert Haas wrote: > Is it at all practical to ship the PNGs as well as the DIA files in > CVS, and make rebuilding the PNGs from the DIAs a separate step? Well, that's what we're arguing about here. > Also, I think we need to review these images carefully befor

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Peter Eisentraut
On fre, 2010-07-02 at 18:07 -0400, Bruce Momjian wrote: > The point is you will have to explicitly turn off dia/images to build > without images. That should make anyone building production docs > always > generate images, unless they override the default. We have the "make draft" target. That

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Peter Eisentraut
On fre, 2010-07-02 at 17:59 -0400, Robert Haas wrote: > Adding dia will > also create knock-on work for packagers The documentation is shipped prebuilt in the source tarball, so packagers wouldn't need to do anything. -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make chang

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Tom Lane
Bruce Momjian writes: > One more issue is that the dia and png files are going to impact our > download sizes: > 526k ./dia > 483k ./png 500k of source for just half a dozen simple images? There's something seriously wrong there. I suspect the PNGs could be compressed a lot

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Robert Haas
On Fri, Jul 2, 2010 at 6:07 PM, Bruce Momjian wrote: > Marc G. Fournier wrote: >> On Fri, 2 Jul 2010, Bruce Momjian wrote: >> >> > I am afraid if we don't enable dia by default then we will end up with >> > production documentation without images.  I think we have to default dia >> > to on, and gi

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Bruce Momjian
Marc G. Fournier wrote: > On Fri, 2 Jul 2010, Bruce Momjian wrote: > > > I am afraid if we don't enable dia by default then we will end up with > > production documentation without images. I think we have to default dia > > to on, and give a reasonable error when it doesn't exist, and mention

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Bruce Momjian
Marc G. Fournier wrote: > On Fri, 2 Jul 2010, Bruce Momjian wrote: > > > Marc G. Fournier wrote: > >> On Fri, 2 Jul 2010, Robert Haas wrote: > >> > >>> On Fri, Jul 2, 2010 at 5:28 PM, Bruce Momjian wrote: > OK, everyone seems to like requiring dia. > >>> > >>> I don't like it a bit. It's ha

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Robert Haas
On Fri, Jul 2, 2010 at 5:43 PM, Bruce Momjian wrote: > Marc G. Fournier wrote: >> On Fri, 2 Jul 2010, Robert Haas wrote: >> >> > On Fri, Jul 2, 2010 at 5:28 PM, Bruce Momjian wrote: >> >> OK, everyone seems to like requiring dia. >> > >> > I don't like it a bit.  It's hard enough for people to bu

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Bruce Momjian
Marc G. Fournier wrote: > On Fri, 2 Jul 2010, Robert Haas wrote: > > > On Fri, Jul 2, 2010 at 5:28 PM, Bruce Momjian wrote: > >> OK, everyone seems to like requiring dia. > > > > I don't like it a bit. It's hard enough for people to build the docs as > > it is. > > Why should anyone build the

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Bruce Momjian
Robert Haas wrote: > On Fri, Jul 2, 2010 at 5:28 PM, Bruce Momjian wrote: > > OK, everyone seems to like requiring dia. > > I don't like it a bit. It's hard enough for people to build the docs as it > is. That was my reaction too, but I am only one person. Yeah, I know that is hard to be beli

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Robert Haas
On Fri, Jul 2, 2010 at 5:28 PM, Bruce Momjian wrote: > OK, everyone seems to like requiring dia. I don't like it a bit. It's hard enough for people to build the docs as it is. -- Robert Haas EnterpriseDB: http://www.enterprisedb.com The Enterprise Postgres Company -- Sent via pgsql-docs mail

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Bruce Momjian
Marc G. Fournier wrote: > On Fri, 2 Jul 2010, Tom Lane wrote: > > > Alvaro Herrera writes: > >> Excerpts from Peter Eisentraut's message of jue jul 01 21:52:00 -0400 2010: > >>> Is there something that makes installing dia more challenging than the > >>> other documentation build tools? > > > >>

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Bruce Momjian
Tom Lane wrote: > Alvaro Herrera writes: > > Excerpts from Peter Eisentraut's message of jue jul 01 21:52:00 -0400 2010: > >> Is there something that makes installing dia more challenging than the > >> other documentation build tools? > > > Err, I dunno -- it's just an apt-get away for me, but wh

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Tom Lane
Alvaro Herrera writes: > Excerpts from Peter Eisentraut's message of jue jul 01 21:52:00 -0400 2010: >> Is there something that makes installing dia more challenging than the >> other documentation build tools? > Err, I dunno -- it's just an apt-get away for me, but what will Tom say > when it do

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Alvaro Herrera
Excerpts from Peter Eisentraut's message of jue jul 01 21:52:00 -0400 2010: > On tor, 2010-07-01 at 19:10 -0400, Alvaro Herrera wrote: > > I'm not sure if this means that we don't want to have the PNG files in > > our SCM though, because it'd make the doc unbuildable for those > > without access to

Re: [DOCS] Documentation and explanatory diagrams

2010-07-02 Thread Peter Eisentraut
On tor, 2010-07-01 at 22:08 -0400, Bruce Momjian wrote: > Peter Eisentraut wrote: > > On tor, 2010-07-01 at 19:10 -0400, Alvaro Herrera wrote: > > > I'm not sure if this means that we don't want to have the PNG files in > > > our SCM though, because it'd make the doc unbuildable for those > > > wit

Re: [DOCS] Documentation and explanatory diagrams

2010-07-01 Thread Bruce Momjian
Peter Eisentraut wrote: > On tor, 2010-07-01 at 19:10 -0400, Alvaro Herrera wrote: > > I'm not sure if this means that we don't want to have the PNG files in > > our SCM though, because it'd make the doc unbuildable for those > > without access to dia. > > Is there something that makes installing

Re: [DOCS] Documentation and explanatory diagrams

2010-07-01 Thread Peter Eisentraut
On tor, 2010-07-01 at 19:10 -0400, Alvaro Herrera wrote: > I'm not sure if this means that we don't want to have the PNG files in > our SCM though, because it'd make the doc unbuildable for those > without access to dia. Is there something that makes installing dia more challenging than the other

Re: [DOCS] Documentation and explanatory diagrams

2010-07-01 Thread Bruce Momjian
Alvaro Herrera wrote: > Excerpts from Rafael Martinez's message of jue jul 01 15:11:31 -0400 2010: > > > If we go ahead with having explanatory diagrams, how do you want me to > > send you new/updated diagrams (src&png)? Last time I try to send a large > > attachment to the list, the e-mail was no

Re: [DOCS] Documentation and explanatory diagrams

2010-07-01 Thread Bruce Momjian
Rafael Martinez wrote: > -BEGIN PGP SIGNED MESSAGE- > Hash: SHA1 > > Bruce Momjian wrote: > > Rafael Martinez wrote: > [] > >> > >> Well, I will await for your feedback before spending more time on this > >> just in case I am in the wrong path. > > > > I did adjust the file paths

Re: [DOCS] Documentation and explanatory diagrams

2010-07-01 Thread Alvaro Herrera
Excerpts from Rafael Martinez's message of jue jul 01 15:11:31 -0400 2010: > If we go ahead with having explanatory diagrams, how do you want me to > send you new/updated diagrams (src&png)? Last time I try to send a large > attachment to the list, the e-mail was not deliver to the list. Maybe I >

Re: [DOCS] Documentation and explanatory diagrams

2010-07-01 Thread Rafael Martinez
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Tom Lane wrote: > > One minor comment is that the page_layout diagram should say BLCKSZ not > 8K, and the different-colored arrows in it don't really convey much --- > they need on-image labeling I think. > ack. I will update this image with these

Re: [DOCS] Documentation and explanatory diagrams

2010-07-01 Thread Rafael Martinez
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Bruce Momjian wrote: > Rafael Martinez wrote: [] >> >> Well, I will await for your feedback before spending more time on this >> just in case I am in the wrong path. > > I did adjust the file paths sightly and modified the makefile; new > pat

Re: [DOCS] Documentation and explanatory diagrams

2010-06-30 Thread Bruce Momjian
Tom Lane wrote: > Bruce Momjian writes: > > Rafael Martinez wrote: > >> I am sending you a proposal with 13 diagrams to include in the manual so > >> we can get an idea of how it will be. If it gets approved I will spend > >> more time creating and including other diagrams and improving the build

Re: [DOCS] Documentation and explanatory diagrams

2010-06-30 Thread Tom Lane
Bruce Momjian writes: > Rafael Martinez wrote: >> I am sending you a proposal with 13 diagrams to include in the manual so >> we can get an idea of how it will be. If it gets approved I will spend >> more time creating and including other diagrams and improving the build >> process for including f

Re: [DOCS] Documentation and explanatory diagrams

2010-06-30 Thread Bruce Momjian
Rafael Martinez wrote: > Sorry for the delay, I got finally some extra time to work on this. > > I am sending you a proposal with 13 diagrams to include in the manual so > we can get an idea of how it will be. If it gets approved I will spend > more time creating and including other diagrams and i

  1   2   >