International Samba (fwd)

[Steve Langasek]

On Thu, 9 Aug 2001, Gerald Carter wrote:

> [For those that aren't aware of it.  Rafal
>  recently sent me a polish translation of the 2.2.0
>  man pages in SGML. :-)  And hence our conversation
>  here...]

> I'm going to back up a little and pose the question
> of "What is the best way to maintain multiple
> language versions of the same docs?"
> Particularly, I'm curious about the generation
> of the various formats (nroff, html, etc...)
> Doesn't Apache do this?  Anyone know?

Apache has a mechanism for selecting language-specific versions of
documents... very slick, and doesn't get used nearly as often as I think it
ought to.  I believe it supports both page.html.ll and page.ll.html for names,
where ll is the two-letter language code.


I'll take the opportunity to piggyback another doc-related question onto the
current discussion.  I've been sifting through the bugs currently open against
Samba in the Debian BTS, and I was bemused to find a bug filed in February,
1998 against Samba 1.9.18alpha14 reporting broken links in docs/faq -- bemused
because the links are indeed still broken in the docs shipping with Samba
2.2.1a.

Fixing the broken links is easy enough -- I can just remove the paragraph
that's pointing to non-existent documentation. :)  But I am wondering about
the status of the docs/faq subdirectory.  Have these files been superseded by
anything more current?  The auto-generated FAQ currently on the samba.org
websites doesn't seem to fill the same role as docs/faq does, but docs/faq
also only claims to be current up to 1.9.17...  Should this FAQ be replaced
with something better maintained, or should they just be removed so as not to
cause confusion?

Steve Langasek
postmodern programmer