Re: Debian documentation
On Mon, Jun 24, 2002 at 03:49:05PM +0700, Rahmat M. Samik-Ibrahim wrote:
> Osamu Aoki wrote:
> > On Fri, Jun 21, 2002 at 08:48:39AM +0700, Rahmat M. Samik-Ibrahim wrote:
> >> On Wed, Jun 19, 2002 at 11:27:01PM -0700, Osamu Aoki wrote:
> >>> I think "Debian specific documents" needs to be better organized for
> >>> woody+1 in /usr/share/doc/DEBIAN/, just like HOWTO and RFC.
> >> It would be nice, if it is split based on language. BTW, my
> >> interest is to make an automated compressed tarball
> >> (10-30 Mbytes) that have everything I need, offline.
> >> See also http://debid.vLSM.org as an idea.
> > I did not understand the merit well??
> > You mean tar-ball of html and pdf files? Or source files?
> Basically, it would be nice if the document directory is categorized
> based on language and file types. For example, at the top level would be
> like "doc.en", "doc.ca", "doc.cs", "doc.ja", "doc.zh-hk", "doc.zh-tw", etc.
> Then, there will be "file types" directories like "html", "pdf", "XML",
> As I have written before, I am interested to make html tarballs of
> one type of language only (english html). See also:
> It would be simpler to extract, if they are categorized as suggested above.
> Sure, I can (and currently use) filters. But to filter Chinese, I currently
> have to filter:
> *.zh-cn.html, *.zh-cn.info, *.zh-cn.txt,
> *-zh-cn.html, *-zh-cn.info, *-zh-cn.txt,
> *.zh-hk.html, *.zh-hk.info, *.zh-hk.txt,
> *-zh-hk.html, *-zh-hk.info, *-zh-hk.txt,
> *.zh-tw.html, *.zh-tw.info, *.zh-tw.txt,
> *-zh-tw.html, *-zh-tw.info, *-zh-tw.txt,
> *.zh_TW.html, *.zh_TW.info, *.zh_TW.txt,
> *-zh_TW.html, *-zh_TW.info, *-zh_TW.txt,
> *.zh_tw.html, *.zh_tw.info, *.zh_tw.txt,
> *-zh_tw.html, *-zh_tw.info, *-zh_tw.txt,
I think they should drop document into as:
Must be at one location to be used by apache auto language
(I want to do wiythout info if it is not a problem.)
/usr/share/doc/Debian/$(MANUAL).tar.gz (Just source file,
unified source at DDP so all languages are in one source. Goes
nice with po-debiandoc transition too.)
This is what I am doing after hearing everyone in this discussion. (I
only have en, fr, and it, so easier.
> > *.deb files already do equivalent things for the packaged documents.
> > DEB format is nothing but "ar" and "tar" combind. :)
> But, they are sometimes less upto date :^).
So let DDP publish daily from CVS.
DDP server needs patch installed to handle ps and PDF.
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
Osamu Aoki @ Cupertino CA USA
See "User's Guide": http://www.debian.org/doc/manuals/users-guide/
See "Debian reference": http://www.debian.org/doc/manuals/debian-reference/
"Debian reference" Project at: http://qref.sf.net
I welcome your constructive criticisms and corrections.
To UNSUBSCRIBE, email to email@example.com
with a subject of "unsubscribe". Trouble? Contact firstname.lastname@example.org