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

Re: duplicate documents

martin f krafft@lists.debian-devel@Mon, 25 Mar 2002 15:08:52 +0100:
>  - move all docs to a -doc package and delete all html and txt
>    documentation (aside changelog, TODO, README etc) from the main
>    package?
This sounds like the best solution to me..

>  - install the docs that come with -src in the main package, but also
>    provide a -doc package with the contents of the -doc tarball? this
>    will efectively result in some duplicate docs installed on the user
>    system.
Or maybe you can make the -doc package symlink to the packages also
available in -src. That'd be a solution as well.

>  [..]. is it that /usr/share/doc/<package> may only be touched by
>  <package> and never by another .deb?
Policy says that documentation should always be in
/usr/share/doc/<package>.. But this looks like an exception:

     If your package comes with extensive documentation in a markup format
     that can be converted to various other formats you should if possible
     ship HTML versions in a binary package, in the directory
     /usr/share/doc/<appropriate-package>' or its subdirectories.[1]

[1]  The rationale: The important thing here is that HTML docs should be
     available in _some_ package, not necessarily in the main binary

   |lintux-@t-lintux-d0t-cx:     _ Ugh! Nio2f says something: ______
   : http://www.lintux.cx/ |    / vbjknyxbvnuchare and the docs in  \

To UNSUBSCRIBE, email to debian-devel-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org

Reply to: