Re: Figures in docs

From: Tatsuo Ishii <ishii(at)postgresql(dot)org>
To: pgsql-kr(at)postgresql(dot)kr
Cc: obartunov(at)gmail(dot)com, ishii(at)postgresql(dot)org, p(dot)luzanov(at)postgrespro(dot)ru, pgsql-hackers(at)postgresql(dot)org, a(dot)lakhin(at)postgrespro(dot)ru, peter_e(at)gmx(dot)net
Subject: Re: Figures in docs
Date: 2016-02-17 06:17:18
Message-ID: 20160217.151718.1884426426964236702.t-ishii@sraoss.co.jp
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

> Hi.
>
> In DocBook 4.2 sgml dtd, figure tag is supported already.
> that was implemented for multi output format.

Ok, there's no technical problems with figures then. MySQL docs has
some nice figures. I am jealous.

> I remember that very old postgresql document has some picture (eg.
> system architecture, ERD ...).

So it seems to be a matter of policy? At some point we prefer not to
include figures, maybe.

> when release new version, these might be changed, nevertheless these can
> not been.
>
> this proposer is not about xml or sgml.
> how can new figures be modified for new documents.

Keep the source files (LibreOffice Draw for example).

> regards ioseph.
>
> 2016-02-17 (수), 08:26 +0300, Oleg Bartunov:
>>
>>
>> On Wed, Feb 17, 2016 at 4:17 AM, Tatsuo Ishii <ishii(at)postgresql(dot)org>
>> wrote:
>> It seems there's no figures/diagrams in our docs. I vaguely
>> recall that
>> we used to have a few diagrams in our docs. If so, was there
>> any
>> technical reason to remove them?
>>
>> I don't know the reason, but it's shame, we are still in sgml !
>>
>> We already do our translations (as others) in xml using custom
>> scripting. xml provides us better integration with available tools
>> and ability to insert graphics. Last time we asked in -docs about
>> moving to xml and Alexander demonstrated acceptable speed of xml
>> build, but there were no reply from Peter, who is (?) responsible for
>> our documentation infrastructure. Probably, we should just created a
>> patch and submit to commitfest. You can check this thread
>> http://www.postgresql.org/message-id/1428009501118.85114@postgrespro.ru
>>
>>
>>
>> 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-hackers mailing list
>> (pgsql-hackers(at)postgresql(dot)org)
>> To make changes to your subscription:
>> http://www.postgresql.org/mailpref/pgsql-hackers
>>
>>
>
>

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Amit Langote 2016-02-17 06:18:17 Re: On Conflict Do nothing errors IF conflict and there is a data type length or check failure
Previous Message Michael Paquier 2016-02-17 06:12:58 Re: Bug in StartupSUBTRANS