Re: [DOCS] ECPG Documentation Improvement

2010-07-08 Thread Satoshi Nagayasu
Hi all, As I mentioned, I have been working to improve the ECPG official manual, trying to understand details, and adding more descriptions and examples in a past few weeks. I think now is the time to introduce this work again, and hope some of you to look inside the new documents. And also I wan

[DOCS] MD5 passwords

2010-07-08 Thread Andre Majorel
The doc says « if you are at all concerned about password "sniffing" attacks then md5 is preferred. » but does not say why. It would seem that an MD5 hash can be sniffed and replayed just as well as a clear-text password. Maybe the doc needs to explain why "md5" is more secure than "password". Or,

Re: [DOCS] MD5 passwords

2010-07-08 Thread Thom Brown
On 8 July 2010 11:46, Andre Majorel wrote: > The doc says « if you are at all concerned about password > "sniffing" attacks then md5 is preferred. » but does not say why. > It would seem that an MD5 hash can be sniffed and replayed just as > well as a clear-text password. > > Maybe the doc needs t

Re: [DOCS] MD5 passwords

2010-07-08 Thread Thom Brown
On 8 July 2010 14:05, Thom Brown wrote: > On 8 July 2010 11:46, Andre Majorel wrote: >> The doc says « if you are at all concerned about password >> "sniffing" attacks then md5 is preferred. » but does not say why. >> It would seem that an MD5 hash can be sniffed and replayed just as >> well as a

[DOCS] CREATE OPERATOR and precedence

2010-07-08 Thread Marc Cousin
Hi, I just got caught by a precedence problem with CREATE OPERATOR. Obviously, it was mostly my fault (I didn't think of the precedence of my operator at all), but I didn't find anything in the CREATE OPERATOR documentation about it either. From looking at the code, I think I understood that i

Re: [DOCS] CREATE OPERATOR and precedence

2010-07-08 Thread Tom Lane
Marc Cousin writes: > I just got caught by a precedence problem with CREATE OPERATOR. > Obviously, it was mostly my fault (I didn't think of the precedence of my > operator at all), but I didn't find anything in the CREATE OPERATOR > documentation about it either. CREATE OPERATOR has nothing t

[DOCS] Please provide stable target anchors

2010-07-08 Thread Daniele Varrazzo
Hello, In psycopg documentation I've often referenced specific parts of PostgreSQL docs, e.g. libpq functions, using the anchors found in the html docs (see [1] for example). Unfortunately these anchors are not stable and the ones I've linked to have changed, leaving half-broken links referring to

Re: [DOCS] CREATE OPERATOR and precedence

2010-07-08 Thread Marc Cousin
The Thursday 08 July 2010 16:31:41, Tom Lane wrote : > Marc Cousin writes: > > I just got caught by a precedence problem with CREATE OPERATOR. > > > > Obviously, it was mostly my fault (I didn't think of the precedence of my > > operator at all), but I didn't find anything in the CREATE OPERATOR

Re: [DOCS] CREATE OPERATOR and precedence

2010-07-08 Thread Tom Lane
Marc Cousin writes: > From a technical point of view, I obviously totally agree, operators > have no control over precedence, but I was only reporting this because > I thought that it might be helpful to put something like a pointer to > this table in the CREATE OPERATOR doc. Oh, that's a reasona

Re: [DOCS] Please provide stable target anchors

2010-07-08 Thread Peter Eisentraut
On tor, 2010-07-08 at 15:54 +0100, Daniele Varrazzo wrote: > In psycopg documentation I've often referenced specific parts of > PostgreSQL docs, e.g. libpq functions, using the anchors found in the > html docs (see [1] for example). Unfortunately these anchors are not > stable and the ones I've lin

[DOCS] plperl.sgml touches

2010-07-08 Thread Erik Rijkers
Some small changes for plperl.sgml: - wrapped long code-lines, for pdf - typo Thanks Erik Rijkers plperl.sgml.diff Description: Binary data -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-do

Re: [DOCS] Please provide stable target anchors

2010-07-08 Thread Daniele Varrazzo
On Thu, Jul 8, 2010 at 7:09 PM, Peter Eisentraut wrote: > On tor, 2010-07-08 at 15:54 +0100, Daniele Varrazzo wrote: >> In psycopg documentation I've often referenced specific parts of >> PostgreSQL docs, e.g. libpq functions, using the anchors found in the >> html docs (see [1] for example). Unfo

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-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, 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 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: 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, 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 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 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] plperl.sgml touches

2010-07-08 Thread Peter Eisentraut
On tor, 2010-07-08 at 20:49 +0200, Erik Rijkers wrote: > Some small changes for plperl.sgml: >- wrapped long code-lines, for pdf >- typo committed -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgs

Re: [DOCS] Please provide stable target anchors

2010-07-08 Thread Peter Eisentraut
On tor, 2010-07-08 at 20:01 +0100, Daniele Varrazzo wrote: > I can surely provide you a list, there are just a dozen of them (I'll > tell you which ones later, now I can't). But then I should bother you > every time I need a new link, or write a patch for it and wait for it > to be applied and then