Re: [DOCS] backpatching documentation after conversion to XML

2017-10-22 Thread Jürgen Purtz
ml and errors on that. Just to classify the impact: afaik we use the 'empty tag' technique for the three docbook tags 'xref' (>3000 times), 'co' (7 times), and 'footnoteref' (4 times). Jürgen Purtz -- Sent via pgsql-docs mailing list (pgsql-docs

Re: [DOCS] Docbook 5.x

2017-09-15 Thread Jürgen Purtz
On 15.09.2017 19:32, Peter Eisentraut wrote: On 9/8/17 08:30, Alexander Lakhin wrote: I have started working through these patches now. I have committed the escaping of < and & and will work through the rest slowly, to minimize disruptions to other development. Great! I have rebased all the re

Re: [DOCS] Use of term Master/Slave

2017-08-02 Thread Jürgen Purtz
in short and clear words (after we have found a consensus about them). Jürgen Purtz -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs

[DOCS] Terminology

2017-03-08 Thread Jürgen Purtz
to use exactly this notation. Kind regards Jürgen Purtz Glossary.docx Description: MS-Word 2007 document Glossary.pdf Description: Adobe PDF document -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs

Re: [DOCS] Docbook 5.x

2017-02-28 Thread Jürgen Purtz
Hello Alexander, On 28.02.2017 09:55, Alexander Law wrote: Hello Peter, 16.11.2016 14:30, Alexander Law wrote: So It seems, now we can continue the move to XML. I'd suggest to move in several steps. Please see the attached scripts. The main script is 7_check_conversion.sh. It performs all the

Re: [DOCS] Parallel Query

2017-01-28 Thread Jürgen Purtz
wo terms "leader" and "gather nodes". Are they equivalent terms or is there any difference? 3: In chapter 15.3: Do we miss the word "be" in the phrase "it must (be) constructed so that ..."? Kind regards, Jürgen Purtz Please find my suggestions for top

[DOCS] Parallel Query

2017-01-21 Thread Jürgen Purtz
two terms "leader" and "gather nodes". Are they equivalent terms or is there any difference? 3: In chapter 15.3: Do we miss the word "be" in the phrase "it must (be) constructed so that ..."? Kind regards, Jürgen Purtz

Re: [DOCS] Questionable tag usage

2017-01-11 Thread Jürgen Purtz
cumbersome - workaround: http://www.sagehill.net/docbookxsl/CustomXrefs.html#RoleNotXrefstyle and http://www.sagehill.net/docbookxsl/CustomGentext.html . Kind regards, Jürgen Purtz On 05.01.2017 00:40, Tatsuo Ishii wrote: In: https://www.postgresql.org/docs/devel/static/runtime-config-file

Re: [DOCS] Docbook 5.x

2016-11-16 Thread Jürgen Purtz
uggest the use of Docbook 4.3 (or 4.5) - as a separate commit or implicitly with commit #2. As far as I have seen, all converted documents validate against 4.5. Kind regards Jürgen Purtz -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs

Re: [DOCS] Docbook 5.x

2016-10-19 Thread Jürgen Purtz
The Docbook TC is discussing the mid-term plans for Docbook 6, see: https://lists.oasis-open.org/archives/docbook/201610/msg5.html . Just like at Docbook 5, the normative standard will be written in RelaxNG+Schematron. In the past they generated dtd and xsd files out of RelaxNG. But for Doc

Re: [DOCS] Docbook 5.x

2016-09-14 Thread Jürgen Purtz
On 14.09.2016 13:18, Alexander Law wrote: Hello, Peter. Should we now compare DSSSL outputs with XSLT? I had some success with it before. See my letter: https://www.postgresql.org/message-id/57712848.7060306%40gmail.com Those xslt's (see xhtml-like-dsssl.patch) can help us to see all the differe

Re: [DOCS] UTF-8 docs

2016-08-23 Thread Jürgen Purtz
adable. But if we develop a SVN-library with our own predefined graphical elements, the SVN source gets very clear. The discussion of 2011 mentioned below was continued in 2016: https://www.postgresql.org/message-id/5690218B.9060103%40purtz.de. Regards, Jürgen Purtz On 23.08.2016 16:43, Tat

Re: [DOCS] UTF-8 docs

2016-08-23 Thread Jürgen Purtz
In the previous mails we have seen some statements concerning the source format of postgres' documentation and other statements to formats which are derived from it. In the following I'm only speaking about the original format. Premised this, I want to second Victor Wagner, who wrote on pgsql-h

Re: [DOCS] Docbook 5.x

2016-07-02 Thread Jürgen Purtz
ut have not yet completed that research. It looks like a mistake to me to limit the content model so much when we were consciously trying to maintain backwards compatibility unless there were good reasons not to. Bob Stayton Sagehill Enterprises b...@sagehill.net - Jürgen Purtz Btw: Sin

Re: [DOCS] Docbook 5.x

2016-06-19 Thread Jürgen Purtz
9.5.3/doc/src/db4_xml/postgres_all.html respective pgdoc_online.css to get the files. Please compare the html file with pages you are familiar with. And remember: the look-and-feel is similar, but far from identical. Jürgen Purtz

Re: [DOCS] Math function description issue

2016-06-07 Thread Jürgen Purtz
umbers) we may add a second example with +42.8 and an additional comment - something like: "Please consider the situation with negative numbers: -42 is greater than -43". Jürgen Purtz On 07.06.2016 05:06, Tom Lane wrote: Michael Paquier writes: On Mon, Jun 6, 2016 at 2:40 PM

Re: [DOCS] Docbook 5.x

2016-05-22 Thread Jürgen Purtz
We maintain two css files: docs.css (for online, complex) and stylesheet.css (local, simple). Why do we need stylesheet.css? Because of the references to some png-files in docs.css? Because of Lynx? For of easier comparisons? Kind regards, Jürgen Purtz On 13.05.2016 20:01, Peter Eisentraut

Re: [DOCS] Docbook 5.x

2016-05-13 Thread Jürgen Purtz
Is everybody happy with the performance patch? Is anybody working on the DSSSL --> XSLT conversion? We should avoid parallel work. Jürgen Purtz On 05.05.2016 03:09, Peter Eisentraut wrote: On 5/4/16 11:08 AM, Alexander Law wrote: As was stated in the aforementioned thread, solution 2

Re: [DOCS] Docbook 5.x

2016-05-12 Thread Jürgen Purtz
Additionally I'm missing some of the links. Jürgen Purtz On 04.05.2016 17:30, Jürgen Purtz wrote: On 04.05.2016 16:51, Tom Lane wrote: Ouch. What about output to PDF? While we don't care as much about that as HTML for day-to-day use, it has to be feasible (ie, not hours).

Re: [DOCS] Docbook 5.x

2016-05-04 Thread Jürgen Purtz
Alvaro, the advantage of draft mode is smaller than 15% in the three environments. In Docbook5 it reduces the elapsed time from 4:07 to 4:02. Jürgen Purtz On 04.05.2016 17:18, Alvaro Herrera wrote: The dsl toolchain has a "make html" format which creates the index and a "m

Re: [DOCS] Docbook 5.x

2016-05-04 Thread Jürgen Purtz
entities. The external entities will be replaced by xi:XInclude. At last there are 4 parameter entities, to whom I actually have no solution: %standalone-ignore; %standalone-include; %include-index; %include-xslt-index; . But they should not be a show-stopper. Jürgen Purtz On 04.05.2016 19:12

Re: [DOCS] Docbook 5.x

2016-05-04 Thread Jürgen Purtz
ain produces correct results. Jürgen Purtz -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs

Re: [DOCS] Docbook 5.x

2016-05-04 Thread Jürgen Purtz
ned main memory is short (-Xms -Xmx, ...) - or it comes from some other Java specific issues. I will work on this in the next days. Jürgen Purtz -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs

Re: [DOCS] Docbook 5.x

2016-05-04 Thread Jürgen Purtz
much more work to do). Jürgen Purtz On 03.05.2016 22:13, Oleg Bartunov wrote: On Tue, May 3, 2016 at 10:34 PM, Alvaro Herrera mailto:alvhe...@2ndquadrant.com>> wrote: Jürgen Purtz wrote: > Hi, > actually we use DocBook V4.2 for the PostgreSQL manuals. I sugges

Re: [DOCS] Docbook 5.x

2016-05-03 Thread Jürgen Purtz
ric stylesheet? * Which person has developed this file? * What is the role of the *.xsl files in the sgml-directory and how do they collaborate with stylesheet.dsl? Regards, Jürgen On 20.04.2016 20:41, Simon Riggs wrote: On 20 April 2016 at 15:30, Jürgen Purtz <mailto:juer...@purtz.de>

Re: [DOCS] Docbook 5.x

2016-04-21 Thread Jürgen Purtz
On 20.04.2016 20:41, Simon Riggs wrote: On 20 April 2016 at 15:30, Jürgen Purtz <mailto:juer...@purtz.de>> wrote: What I have done so far is: * Conversion of sgml files to valid xml syntax with a perl skript. I failed to use 'osx' or 'spam'.