Re: documentation is now XML

2018-06-20 Thread Tatsuo Ishii
>> It's unfortunate that we'll have to deal with different formats in the >> supported branches for several more years, but we at Postgres Professional >> are >> ready to accept any your decision on this matter for now. > > I had not thought of translations, but wouldn't all translations also >

Re: documentation is now XML

2018-06-20 Thread Bruce Momjian
On Wed, Jun 20, 2018 at 04:46:24PM +0300, Alexander Lakhin wrote: > 20.06.2018 15:03, Bruce Momjian wrote: > > On Wed, Jun 20, 2018 at 10:48:47AM +0300, Liudmila Mantrova wrote: > > It's unfortunate that we'll have to deal with different formats in the > supported branches

Re: documentation is now XML

2018-06-20 Thread Alexander Lakhin
20.06.2018 15:03, Bruce Momjian wrote: > On Wed, Jun 20, 2018 at 10:48:47AM +0300, Liudmila Mantrova wrote: >> It's unfortunate that we'll have to deal with different formats in the >> supported branches for several more years, but we at Postgres Professional >> are >> ready to accept any your

Re: documentation is now XML

2018-06-20 Thread Bruce Momjian
On Wed, Jun 20, 2018 at 10:48:47AM +0300, Liudmila Mantrova wrote: > To complete the picture of possible issues with older branches in XML, we > posted a question in packager lists some time ago and didn't receive any > objections. Just to keep record of all related questions in one place, here's

Re: documentation is now XML

2018-06-20 Thread Liudmila Mantrova
On 04/27/2018 06:36 PM, Tom Lane wrote: Bruce Momjian writes: On Fri, Apr 27, 2018 at 11:00:36AM -0400, Peter Eisentraut wrote: That proposal seemed to indicate not only converting the source code to XML but also the build system to XSL. The latter is out of the question, I think. Why is

Re: documentation is now XML

2018-05-03 Thread Liudmila Mantrova
Hi Peter, Thank you for taking your time to comment on this long-discussed topic. I was not around when all the great work was done to implement XSLT transforms in branch 10 and convert branch 11 to XML, but judging by this thread

Re: documentation is now XML

2018-04-30 Thread Bruce Momjian
On Mon, Apr 30, 2018 at 03:20:44PM -0400, Peter Eisentraut wrote: > On 4/27/18 11:03, Bruce Momjian wrote: > > On Fri, Apr 27, 2018 at 11:00:36AM -0400, Peter Eisentraut wrote: > >> On 4/23/18 05:54, Liudmila Mantrova wrote: > >>> Reading this thread, I got an impression that everyone would

Re: documentation is now XML

2018-04-30 Thread Peter Eisentraut
On 4/27/18 11:03, Bruce Momjian wrote: > On Fri, Apr 27, 2018 at 11:00:36AM -0400, Peter Eisentraut wrote: >> On 4/23/18 05:54, Liudmila Mantrova wrote: >>> Reading this thread, I got an impression that everyone would benefit >>> from converting back branches to XML, but the main concern is lack

Re: documentation is now XML

2018-04-27 Thread Tom Lane
Bruce Momjian writes: > On Fri, Apr 27, 2018 at 11:00:36AM -0400, Peter Eisentraut wrote: >> That proposal seemed to indicate not only converting the source code to >> XML but also the build system to XSL. The latter is out of the >> question, I think. > Why is that? I

Re: documentation is now XML

2018-04-27 Thread Bruce Momjian
On Fri, Apr 27, 2018 at 11:00:36AM -0400, Peter Eisentraut wrote: > On 4/23/18 05:54, Liudmila Mantrova wrote: > > Reading this thread, I got an impression that everyone would benefit > > from converting back branches to XML, but the main concern is lack of > > resources to complete this task. Are

Re: documentation is now XML

2018-04-27 Thread Peter Eisentraut
On 4/23/18 05:54, Liudmila Mantrova wrote: > Reading this thread, I got an impression that everyone would benefit > from converting back branches to XML, but the main concern is lack of > resources to complete this task. Are there any other issues that affect > this decision? Looks like Aleksander

Re: documentation is now XML

2018-04-23 Thread Bruce Momjian
On Mon, Apr 23, 2018 at 12:54:40PM +0300, Liudmila Mantrova wrote: > Hi everyone, > > Reading this thread, I got an impression that everyone would benefit from > converting back branches to XML, but the main concern is lack of resources to > complete this task. Are there any other issues that

Re: documentation is now XML

2018-04-23 Thread Liudmila Mantrova
Hi everyone, Reading this thread, I got an impression that everyone would benefit from converting back branches to XML, but the main concern is lack of resources to complete this task. Are there any other issues that affect this decision? Looks like Aleksander Lakhin's offer to prepare

Re: documentation is now XML

2018-01-24 Thread Peter Eisentraut
On 1/24/18 09:45, Bruce Momjian wrote: > So we are not > using TeX anymore for PG11+ docs? as of PG10 -- Peter Eisentraut http://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

Re: documentation is now XML

2018-01-24 Thread Bruce Momjian
On Wed, Jan 24, 2018 at 04:53:57PM +0100, David Fetter wrote: > On Wed, Jan 24, 2018 at 10:49:38AM -0500, Stephen Frost wrote: > > David, Alvaro, > > > > * Alvaro Herrera (alvhe...@alvh.no-ip.org) wrote: > > > David Fetter wrote: > > > > > > > Speaking of legacy things, do we want to see about

Re: documentation is now XML

2018-01-24 Thread David Fetter
On Wed, Jan 24, 2018 at 10:49:38AM -0500, Stephen Frost wrote: > David, Alvaro, > > * Alvaro Herrera (alvhe...@alvh.no-ip.org) wrote: > > David Fetter wrote: > > > > > Speaking of legacy things, do we want to see about deprecating > > > LaTeX output for tables in psql? I haven't seen such a

Re: documentation is now XML

2018-01-24 Thread Stephen Frost
David, Alvaro, * Alvaro Herrera (alvhe...@alvh.no-ip.org) wrote: > David Fetter wrote: > > > Speaking of legacy things, do we want to see about deprecating LaTeX > > output for tables in psql? I haven't seen such a thing in production, > > but maybe I'm missing something important. > > I've

Re: documentation is now XML

2018-01-24 Thread David Fetter
On Wed, Jan 24, 2018 at 10:06:49AM -0500, Tom Lane wrote: > Alvaro Herrera writes: > > David Fetter wrote: > >> Speaking of legacy things, do we want to see about deprecating LaTeX > >> output for tables in psql? I haven't seen such a thing in production, > >> but maybe

Re: documentation is now XML

2018-01-24 Thread David Fetter
On Tue, Jan 23, 2018 at 11:16:23PM -0500, Tom Lane wrote: > "David G. Johnston" writes: > > On Tuesday, January 23, 2018, Bruce Momjian wrote: > >> All agreed, but what alternatives are being developed? > > > I seem to recall a proposal a while back

Re: documentation is now XML

2018-01-24 Thread Bruce Momjian
On Wed, Jan 24, 2018 at 08:21:21AM -0500, Peter Eisentraut wrote: > On 1/23/18 22:24, Bruce Momjian wrote: > >> I like TeX as much as the next guy --- I wrote my thesis with it, > >> a long time ago --- but there's no denying that (a) it's got hard > >> limits we're approaching, (b) the downstream

Re: documentation is now XML

2018-01-23 Thread Tom Lane
"David G. Johnston" writes: > On Tuesday, January 23, 2018, Bruce Momjian wrote: >> All agreed, but what alternatives are being developed? > I seem to recall a proposal a while back to gain margin on some of the > limits by pruning the release notes

Re: documentation is now XML

2018-01-23 Thread David G. Johnston
On Tuesday, January 23, 2018, Bruce Momjian wrote: > On Tue, Jan 23, 2018 at 10:22:53PM -0500, Tom Lane wrote: > (a) it's got hard > > limits we're approaching, > All agreed, but what alternatives are being developed? > > I seem to recall a proposal a while back to gain

Re: documentation is now XML

2018-01-23 Thread Tom Lane
Bruce Momjian writes: > On Thu, Nov 23, 2017 at 03:39:24PM -0500, Tom Lane wrote: >> Also, we're way overdue for getting out from under the creaky TeX-based >> toolchain for producing PDFs. > I am coming in late here, but I am not aware of any open source > professional

Re: documentation is now XML

2018-01-23 Thread Bruce Momjian
On Thu, Nov 23, 2017 at 03:39:24PM -0500, Tom Lane wrote: > Also, we're way overdue for getting out from under the creaky TeX-based > toolchain for producing PDFs. Every time we make releases, I worry > whether we're going to get blindsided by its bugs with hotlinks that get > split across pages,

Re: documentation is now XML

2017-11-28 Thread Tom Lane
Andrew Dunstan writes: > On 11/28/2017 12:06 PM, Tom Lane wrote: >> One thing we'd definitely better do is enable some buildfarm coverage. >> AFAIK, the only buildfarm animal that's building the docs is guaibasaurus, >> and it only seems to be doing that on HEAD.

Re: documentation is now XML

2017-11-28 Thread Andrew Dunstan
On 11/28/2017 12:06 PM, Tom Lane wrote: > > One thing we'd definitely better do is enable some buildfarm coverage. > AFAIK, the only buildfarm animal that's building the docs is guaibasaurus, > and it only seems to be doing that on HEAD. Since this has considerably > increased the risks of

Re: documentation is now XML

2017-11-28 Thread Tom Lane
Peter Eisentraut writes: > On 11/23/17 15:39, Tom Lane wrote: >> I think we should have a discussion about whether it'd be smart >> to convert the back branches' documentation to XML as well. > My short answer to that is, I don't have time for that. I don't

Re: documentation is now XML

2017-11-28 Thread Peter Eisentraut
On 11/23/17 15:39, Tom Lane wrote: > I think we should have a discussion about whether it'd be smart > to convert the back branches' documentation to XML as well. My short answer to that is, I don't have time for that. I don't know if anyone else wants to investigate it. But it took us years to

Re: documentation is now XML

2017-11-24 Thread Michael Paquier
On Fri, Nov 24, 2017 at 5:39 AM, Tom Lane wrote: > Peter Eisentraut writes: >> The documentation sources are now DocBook XML, not SGML. (The files are >> still named *.sgml. That's something to think about separately.) > > I think we should

Re: documentation is now XML

2017-11-23 Thread Michael Paquier
On Fri, Nov 24, 2017 at 12:21 AM, Oleg Bartunov wrote: > On Thu, Nov 23, 2017 at 6:01 PM, Peter Eisentraut > wrote: >> The documentation sources are now DocBook XML, not SGML. (The files are >> still named *.sgml. That's something to think