Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-14 Thread Robert Haas
On Tue, Apr 5, 2011 at 6:55 PM, Josh Kupershmidt schmi...@gmail.com wrote: On Mon, Apr 4, 2011 at 3:02 PM, Robert Haas robertmh...@gmail.com wrote:  In theory, we have documentation that explains this: http://www.postgresql.org/docs/current/static/docguide-toolsets.html While we're on the

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-05 Thread Peter Eisentraut
On mån, 2011-04-04 at 15:02 -0400, Robert Haas wrote: AFAICT, the biggest problem with our existing toolchain is that it's hard for some people to get it working. In theory, we have documentation that explains this: http://www.postgresql.org/docs/current/static/docguide-toolsets.html

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-05 Thread Peter Eisentraut
On mån, 2011-04-04 at 15:08 -0400, Tom Lane wrote: One thing I'd like to know is whether docbook v5 is any more portable/easier to install. I don't see why. It's just a newer version of the same thing. If you change the sources to XML and switch to the XSL toolchain, you don't have to install

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-05 Thread Alvaro Herrera
Excerpts from Gabriele Bartolini's message of lun abr 04 16:47:26 -0400 2011: Il 04/04/11 22:26, Robert Haas ha scritto: I think you still need to update Solution.pm to match. Here it is, including change of 3 'Id' attributes (I made them lowercase). Pushed this one also. -- Álvaro

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-05 Thread Peter Eisentraut
On mån, 2011-04-04 at 19:26 +0200, Susanne Ebrecht wrote: Honestly, for German I don't mind yet if it is XML or SGML. XML might be better in future for maintenance tools. Anyway, I figured out there is another argument for XML: My information is that DocBook 5.0 won't support SGML anymore.

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-05 Thread Robert Haas
On Tue, Apr 5, 2011 at 2:18 PM, Peter Eisentraut pete...@gmx.net wrote: On mån, 2011-04-04 at 15:02 -0400, Robert Haas wrote: AFAICT, the biggest problem with our existing toolchain is that it's hard for some people to get it working.  In theory, we have documentation that explains this:

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-05 Thread Dave Page
On Tue, Apr 5, 2011 at 7:55 PM, Robert Haas robertmh...@gmail.com wrote: I've also had failures, I believe, from not being connected to the Internet, which is surprising because it's not at all obvious that building the docs should require an Internet connection. Oh, I've run into that and

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-05 Thread Peter Eisentraut
On tis, 2011-04-05 at 14:55 -0400, Robert Haas wrote: and I've also had failures, I believe, from not being connected to the Internet, which is surprising because it's not at all obvious that building the docs should require an Internet connection. I understand this problem, but just to

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-05 Thread Robert Haas
On Tue, Apr 5, 2011 at 4:59 PM, Peter Eisentraut pete...@gmx.net wrote: On tis, 2011-04-05 at 14:55 -0400, Robert Haas wrote: and I've also had failures, I believe, from not being connected to the Internet, which is surprising because it's not at all obvious that building the docs should

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-05 Thread Josh Kupershmidt
On Mon, Apr 4, 2011 at 3:02 PM, Robert Haas robertmh...@gmail.com wrote:  In theory, we have documentation that explains this: http://www.postgresql.org/docs/current/static/docguide-toolsets.html While we're on the subject.. Attached is a patch against that page suggesting using openjade 1.3,

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Tom Lane
Gabriele Bartolini gabriele.bartol...@2ndquadrant.it writes: My intention was to start and change some simple documentation files in order to make our conversion process from SGML to XML smoother, while keeping the SGML compatibility of the original documentation intact. AFAIK, the main

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Gabriele Bartolini
Il 04/04/11 18:37, Tom Lane ha scritto: AFAIK, the main stumbling block for that is that XML doesn't allow abbreviated close tags (ie,foowhatever/). Which is something that we are not likely to give up. So I'm not sure of the point of changing something as trivial as entity declaration casing.

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Susanne Ebrecht
On 04.04.2011 18:37, Tom Lane wrote: AFAIK, the main stumbling block for that is that XML doesn't allow abbreviated close tags (ie,foowhatever/). Which is something that we are not likely to give up. So I'm not sure of the point of changing something as trivial as entity declaration casing.

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Robert Haas
On Mon, Apr 4, 2011 at 1:26 PM, Susanne Ebrecht susa...@2ndquadrant.com wrote: My information is that DocBook 5.0 won't support SGML anymore. Which means - sooner or later a reaction is needed. Ouch. Even if that doesn't turn out to be the case, this is pretty harmless, so maybe we should

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Tom Lane
Robert Haas robertmh...@gmail.com writes: Even if that doesn't turn out to be the case, this is pretty harmless, so maybe we should just apply it and move on. I have no great objection to the patch as such; just wondering what the roadmap is. regards, tom lane -- Sent

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Robert Haas
On Mon, Apr 4, 2011 at 2:42 PM, Tom Lane t...@sss.pgh.pa.us wrote: Robert Haas robertmh...@gmail.com writes: Even if that doesn't turn out to be the case, this is pretty harmless, so maybe we should just apply it and move on. I have no great objection to the patch as such; just wondering what

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Christopher Browne
On Mon, Apr 4, 2011 at 1:26 PM, Susanne Ebrecht susa...@2ndquadrant.com wrote: Anyway, I figured out there is another argument for XML: My information is that DocBook 5.0 won't support SGML anymore. Which means - sooner or later a reaction is needed. Yes, indeed. I don't think that during

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Robert Haas
On Mon, Apr 4, 2011 at 2:50 PM, Christopher Browne cbbro...@gmail.com wrote: On Mon, Apr 4, 2011 at 1:26 PM, Susanne Ebrecht susa...@2ndquadrant.com wrote: Anyway, I figured out there is another argument for XML: My information is that DocBook 5.0 won't support SGML anymore. Which means -

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Tom Lane
Robert Haas robertmh...@gmail.com writes: On Mon, Apr 4, 2011 at 2:50 PM, Christopher Browne cbbro...@gmail.com wrote: There are arguments as to why to switch to version 5, which is, indeed, XML-only. http://www.docbook.org/tdg5/en/html/ch01.html#introduction-why-to-switch AFAICT, the

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Dave Page
On 4/4/11, Robert Haas robertmh...@gmail.com wrote: On Mon, Apr 4, 2011 at 2:50 PM, Christopher Browne cbbro...@gmail.com wrote: On Mon, Apr 4, 2011 at 1:26 PM, Susanne Ebrecht susa...@2ndquadrant.com wrote: Anyway, I figured out there is another argument for XML: My information is that

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Susanne Ebrecht
On 04.04.2011 21:08, Tom Lane wrote: Indeed. One thing I'd like to know is whether docbook v5 is any more portable/easier to install Unfortunately, as far as I know - there isn't a huge difference. regards, Susanne -- Susanne Ebrecht - 2ndQuadrant PostgreSQL Development, 24x7 Support,

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Alvaro Herrera
Excerpts from Gabriele Bartolini's message of lun abr 04 13:18:21 -0400 2011: Il 04/04/11 18:37, Tom Lane ha scritto: AFAIK, the main stumbling block for that is that XML doesn't allow abbreviated close tags (ie,foowhatever/). Which is something that we are not likely to give up. So I'm

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Robert Haas
On Mon, Apr 4, 2011 at 4:15 PM, Alvaro Herrera alvhe...@commandprompt.com wrote: Excerpts from Gabriele Bartolini's message of lun abr 04 13:18:21 -0400 2011: Il 04/04/11 18:37, Tom Lane ha scritto: AFAIK, the main stumbling block for that is that XML doesn't allow abbreviated close tags

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Alvaro Herrera
Excerpts from Robert Haas's message of lun abr 04 16:26:07 -0400 2011: On Mon, Apr 4, 2011 at 4:15 PM, Alvaro Herrera alvhe...@commandprompt.com wrote: Excerpts from Gabriele Bartolini's message of lun abr 04 13:18:21 -0400 2011: Il 04/04/11 18:37, Tom Lane ha scritto: AFAIK, the main

Re: [DOCS] [HACKERS] Uppercase SGML entity declarations

2011-04-04 Thread Gabriele Bartolini
Il 04/04/11 22:26, Robert Haas ha scritto: I think you still need to update Solution.pm to match. Here it is, including change of 3 'Id' attributes (I made them lowercase). Thanks, Gabriele -- Gabriele Bartolini - 2ndQuadrant Italia PostgreSQL Training, Services and Support