How to integrate i18n docs in HEAD branch

[Rafal Szczesniak]

On Fri, 21 Sep 2001, TAKAHASHI Motonobu wrote:

> Jerry,
>
> To support SWAT i18n, we can determine where to put i18n documents in
> the source archive.
>
> There are several kind of documents.
>
> 1. translation of swat/{help,images,included}
>   At samba-technical, I proposed swat/$ln/{help,images,included}.
>
> Deniz Akkus Kanca wrote:
> >> In Samba Japanese Edition, we put them at
> >> swat/$ln/{help,images,include}. Is this OK?
> >
> >Yes, this directory structure looks OK.
>
>   Another solution is to put swat/lang/$ln/{help,images,included}.
>   The following is mentioned about where to install, not where to put
>   in source archive, but it may be usefull to adjust the directory
>   tree.

What would be in swat/ apart from the lang/ directory ? It seems to me
the dir tree like swat/$ln/{help,images,include} is quite good.

(...)
> 2. translation of docs/{html,text}docs and docs/manpages
>
>   I know Jerry put the Polish SGML files under docbook dir, but for
>   installation we need only html and man page (and some text) files.
>
>   We need to have docs of these formats because I think we should not
>   assume that DOCBOOK - html and man page converter is always
>   installed on the platform.

While I agree with you here, I'm also working on
docs/docbook/configure.in and docs/docbook/Makefile.in files to
automate generating of the html and man files from docs/docbook/$ln
(pl here) directory.

>   docs/$ln/{htmldocs,manpages,faq,textdocs} or
>   docs/{htmldocs,manpages,faq,textdocs} are considerable?
>
>   Of course there should be a discussion whether the Samba archive
>   includes these i18n'ed documentations as I mentioned before, but
>   we can discuss it later.

Well...

(a)
docs/$ln/{html,manpages,faq,textdocs} makes easier extracting i18n'ed
documentation in future and splitting it out as separated "packages"

(b)
docs/html/$ln, docs/manpages/$ln, docs/faq/$ln fits easier in current
source tree



Rafal 'Mimir' Szczesniak <mimir at spin.ict.pwr.wroc.pl>   |
*BSD, Linux and Samba                                  /
______________________________________________________/