On Sat, Aug 1, 2009 at 9:39 AM, Sven-Hendrik Haase<sh@lutzhaase.com> wrote:

Hey everybody,

looking through my /usr/share/doc today I noticed that there were surprisingly few packages that actually installed their documentation there. Not even the SDL package installed its docs in there. I don't mind this too much as I carry all kinds of library documentation in my home directory with me at all times to have it accessible when I have no Internet connection available.

This left me wondering, though, what Arch's general policy is on inclusion/exclusion of library/tool/package documentation for /usr/share/doc and if this policy should be generally applied to AUR packages as well.

-- Sven-Hendrik

The policy is to include them unless they are very, very big. In that case, they can be excluded and, sometimes, provided in a separate package at the maintainer's discretion (e.g. qt and qt-doc). In the past, we were removing the docs systemtically, so packages that have not been rebuilt since then might be missing their docs.