[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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", 
> "etc".
> As I have written before, I am interested to make html tarballs of
> one type of language only (english html). See also:
>        http://bebas.vLSM.org/v05/Linux/debid.tar.bz2
> 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 debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org

Reply to: