pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedno more SGML empty tags
6+ messages / 3 participants
[nested] [flat]
Commits from this thread:
2017-10-19 e250c8c840 0ab77a34f8 Fix incorrect link in v10 release notes.
* no more SGML empty tags
@ 2017-10-17 20:21 Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
0 siblings, 2 replies; 6+ messages in thread
From: Peter Eisentraut @ 2017-10-17 20:21 UTC (permalink / raw)
To: pgsql-docs
In XML, empty tags such as </> are no longer allowed. In preparation
for converting the documentation to DocBook XML, I have committed a
patch that expands all such empty tags. There is also now a warning
from onsgmls when empty tags are used. (There is no -werror option,
unfortunately.)
(I have found that in a fully tagged SGML source file, an editor's XML
tab completion works much better, so maybe try that if you want to avoid
additional typing.)
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: no more SGML empty tags
@ 2017-10-18 00:09 Tatsuo Ishii <ishii@sraoss.co.jp>
parent: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
1 sibling, 1 reply; 6+ messages in thread
From: Tatsuo Ishii @ 2017-10-18 00:09 UTC (permalink / raw)
To: peter.eisentraut@2ndquadrant.com; +Cc: pgsql-docs
> In XML, empty tags such as </> are no longer allowed. In preparation
> for converting the documentation to DocBook XML, I have committed a
> patch that expands all such empty tags. There is also now a warning
> from onsgmls when empty tags are used. (There is no -werror option,
> unfortunately.)
Just out of curiosity, did you do the work (expanding the empty tags)
manually or using some tools? We are using SGML DocBook in the
Pgpool-II project and a little bit annoyed by the empty tags (for
example emacs auto indentation does not work with empty tags).
Best regards,
--
Tatsuo Ishii
SRA OSS, Inc. Japan
English: http://www.sraoss.co.jp/index_en.php
Japanese:http://www.sraoss.co.jp
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: no more SGML empty tags
@ 2017-10-18 12:17 Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
parent: Tatsuo Ishii <ishii@sraoss.co.jp>
0 siblings, 1 reply; 6+ messages in thread
From: Peter Eisentraut @ 2017-10-18 12:17 UTC (permalink / raw)
To: Tatsuo Ishii <ishii@sraoss.co.jp>; +Cc: pgsql-docs
On 10/17/17 20:09, Tatsuo Ishii wrote:
>> In XML, empty tags such as </> are no longer allowed. In preparation
>> for converting the documentation to DocBook XML, I have committed a
>> patch that expands all such empty tags. There is also now a warning
>> from onsgmls when empty tags are used. (There is no -werror option,
>> unfortunately.)
>
> Just out of curiosity, did you do the work (expanding the empty tags)
> manually or using some tools? We are using SGML DocBook in the
> Pgpool-II project and a little bit annoyed by the empty tags (for
> example emacs auto indentation does not work with empty tags).
I used the tools provided in the "Docbook 5.x" thread, in particular the
sgml2xml.pl script. I think you should be able to use that for your
documentation as well.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: no more SGML empty tags
@ 2017-10-18 12:22 Tatsuo Ishii <ishii@sraoss.co.jp>
parent: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
0 siblings, 0 replies; 6+ messages in thread
From: Tatsuo Ishii @ 2017-10-18 12:22 UTC (permalink / raw)
To: peter.eisentraut@2ndquadrant.com; +Cc: pgsql-docs
Peter,
>> Just out of curiosity, did you do the work (expanding the empty tags)
>> manually or using some tools? We are using SGML DocBook in the
>> Pgpool-II project and a little bit annoyed by the empty tags (for
>> example emacs auto indentation does not work with empty tags).
>
> I used the tools provided in the "Docbook 5.x" thread, in particular the
> sgml2xml.pl script. I think you should be able to use that for your
> documentation as well.
Thank you for the info!
--
Tatsuo Ishii
SRA OSS, Inc. Japan
English: http://www.sraoss.co.jp/index_en.php
Japanese:http://www.sraoss.co.jp
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: no more SGML empty tags
@ 2017-10-19 15:11 Tom Lane <tgl@sss.pgh.pa.us>
parent: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
1 sibling, 1 reply; 6+ messages in thread
From: Tom Lane @ 2017-10-19 15:11 UTC (permalink / raw)
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>; +Cc: pgsql-docs
Peter Eisentraut <peter.eisentraut@2ndquadrant.com> writes:
> In XML, empty tags such as </> are no longer allowed. In preparation
> for converting the documentation to DocBook XML, I have committed a
> patch that expands all such empty tags. There is also now a warning
> from onsgmls when empty tags are used. (There is no -werror option,
> unfortunately.)
I just want to point out that this patch has more or less entirely
destroyed any hope of cleanly back-patching documentation changes.
Should we consider applying the same transformation to the back
branches?
regards, tom lane
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: no more SGML empty tags
@ 2017-10-21 16:58 Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
parent: Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 6+ messages in thread
From: Peter Eisentraut @ 2017-10-21 16:58 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: pgsql-docs
On 10/19/17 11:11, Tom Lane wrote:
> I just want to point out that this patch has more or less entirely
> destroyed any hope of cleanly back-patching documentation changes.
>
> Should we consider applying the same transformation to the back
> branches?
Good point. There is an additional issue to consider about
backpatching, about which I have started a separate thread. It might
depend on the outcome of that what we want to do here.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 6+ messages in thread
end of thread, other threads:[~2017-10-21 16:58 UTC | newest]
Thread overview: 6+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2017-10-17 20:21 no more SGML empty tags Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
2017-10-18 00:09 ` Tatsuo Ishii <ishii@sraoss.co.jp>
2017-10-18 12:17 ` Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
2017-10-18 12:22 ` Tatsuo Ishii <ishii@sraoss.co.jp>
2017-10-19 15:11 ` Tom Lane <tgl@sss.pgh.pa.us>
2017-10-21 16:58 ` Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox