Re: UTF-8 docs - Mailing list pgsql-docs

From Tatsuo Ishii
Subject Re: UTF-8 docs
Date
Msg-id 20160823.234340.102844932353677705.t-ishii@sraoss.co.jp
Whole thread Raw
In response to Re: UTF-8 docs  (Jürgen Purtz <juergen@purtz.de>)
Responses Re: UTF-8 docs  (Alexander Law <exclusion@gmail.com>)
Re: UTF-8 docs  (Jürgen Purtz <juergen@purtz.de>)
List pgsql-docs
>> Really, what change we need, it is conversion from SGML to XML format.
>> It would solve some real problems, such as ability to include diagrams
>> in the docs,

This argument sounds weak to me. Last time when I proposed to include
diagrams in the docs in the pgsql-hackers list, some developers were
against the idea because if the diagram is binary, it's hard to
maintain in git. However up to now, there's no consensus that which
text base diagram source (which allows to generate real diagrams from
it) is good for our purpose. I don't see why just migrating to XML
solves the problem.

(the discussion on diagrams stopped in 2011, as far as I know)
https://www.postgresql.org/message-id/1307972167.2862.518.camel@core2

Don't get me wrong. I am not against migrating to XML. I just want to
say that let's not pretend that migrating to XML would solve all the
problems we have.

Best regards,
--
Tatsuo Ishii
SRA OSS, Inc. Japan
English: http://www.sraoss.co.jp/index_en.php
Japanese:http://www.sraoss.co.jp


pgsql-docs by date:

Previous
From: Alexander Law
Date:
Subject: Re: Docbook 5.x
Next
From: Alexander Law
Date:
Subject: Re: UTF-8 docs