Re: Unable to generate man pages for translated sgml

Hi,

Starting from 9.0, it seems unable to generate man pages for Japanese
translated sgml(generating html is ok). Until 8.4 it worked fine. Does
anybody succeeded in generating non English/multibyte translated man pages?
--
Tatsuo Ishii
SRA OSS, Inc. Japan
English: http://www.sraoss.co.jp/index_en.php
Japanese: http://www.sraoss.co.jp

On ons, 2010-09-29 at 23:22 +0900, Tatsuo Ishii wrote:
> Starting from 9.0, it seems unable to generate man pages for Japanese
> translated sgml(generating html is ok). Until 8.4 it worked fine. Does
> anybody succeeded in generating non English/multibyte translated man pages?

You leave a lot to be guessed here, but note that since DocBook SGML
always uses Latin-1 encoding, what you are describing is by definition
impossible and could only have worked by some accident.

> On ons, 2010-09-29 at 23:22 +0900, Tatsuo Ishii wrote:
>> Starting from 9.0, it seems unable to generate man pages for Japanese
>> translated sgml(generating html is ok). Until 8.4 it worked fine. Does
>> anybody succeeded in generating non English/multibyte translated man pages?
>
> You leave a lot to be guessed here, but note that since DocBook SGML
> always uses Latin-1 encoding, what you are describing is by definition
> impossible and could only have worked by some accident.

Japanese community has been using the DocBook/SGML tool chain with
EUC-JP translated documents since SGML was emplyed by
PostgreSQL. Problem with 9.0 doc build system is now it's a mixture of
DocBook/SGML *and* DocBook/XML(used for man pages). The former *only*
accepts EUC-JP, the latter *only* accepts UTF-8. So we are stuck.

The leader of Japanse translation team is thinking about to hack 9.0's
doc system to get back to good old days 8.4's. Of course it's a waste
of time in the long term but it seems it's the only thing we can do as
for now. We need to publish complete Japanses docs as soon as possible
since its one of the most important factors to make PostgreSQL popular
in Japan.
--
Tatsuo Ishii
SRA OSS, Inc. Japan
English: http://www.sraoss.co.jp/index_en.php
Japanese: http://www.sraoss.co.jp

On Thu, Sep 30, 2010 at 8:09 AM, Tatsuo Ishii <ishii(at)postgresql(dot)org> wrote:
> Japanese community has been using the DocBook/SGML tool chain with
> EUC-JP translated documents since SGML was emplyed by
> PostgreSQL. Problem with 9.0 doc build system is now it's a mixture of
> DocBook/SGML *and* DocBook/XML(used for man pages). The former *only*
> accepts EUC-JP, the latter *only* accepts UTF-8. So we are stuck.

Why don't we just use UTF-8? I'm not sure why EUC-JP is better than UTF-8.
Also, the original postgres' documentation contains characters not in
EUC-JP, but in UTF-8. Those characters are discarded in Japanese docs?

--
Itagaki Takahiro

> On Thu, Sep 30, 2010 at 8:09 AM, Tatsuo Ishii <ishii(at)postgresql(dot)org> wrote:
>> Japanese community has been using the DocBook/SGML tool chain with
>> EUC-JP translated documents since SGML was emplyed by
>> PostgreSQL. Problem with 9.0 doc build system is now it's a mixture of
>> DocBook/SGML *and* DocBook/XML(used for man pages). The former *only*
>> accepts EUC-JP, the latter *only* accepts UTF-8. So we are stuck.
>
> Why don't we just use UTF-8? I'm not sure why EUC-JP is better than UTF-8.

UTF-8 simply does not work with some of current tool chains.

> Also, the original postgres' documentation contains characters not in
> EUC-JP, but in UTF-8. Those characters are discarded in Japanese docs?

I'm not sure how other people deal with UTF-8 since it doesn't work.
--
Tatsuo Ishii
SRA OSS, Inc. Japan
English: http://www.sraoss.co.jp/index_en.php
Japanese: http://www.sraoss.co.jp

On tor, 2010-09-30 at 08:09 +0900, Tatsuo Ishii wrote:
> Problem with 9.0 doc build system is now it's a mixture of
> DocBook/SGML *and* DocBook/XML(used for man pages). The former *only*
> accepts EUC-JP, the latter *only* accepts UTF-8. So we are stuck.

How do you get to the conclusion that DocBook XML only supports UTF-8?

> On tor, 2010-09-30 at 08:09 +0900, Tatsuo Ishii wrote:
>> Problem with 9.0 doc build system is now it's a mixture of
>> DocBook/SGML *and* DocBook/XML(used for man pages). The former *only*
>> accepts EUC-JP, the latter *only* accepts UTF-8. So we are stuck.
>
> How do you get to the conclusion that DocBook XML only supports UTF-8?

If we use EUC-JP, it produces corrupted/broken man pages.
--
Tatsuo Ishii
SRA OSS, Inc. Japan
English: http://www.sraoss.co.jp/index_en.php
Japanese: http://www.sraoss.co.jp