Public SourceMage Discussion List

[Arwed von Merkatz <v.merkatz AT gmx.net>]

Hi all,

i've done a small change to sorcery (which erics commited to devel
sorcery) that enhances the behaviour of the gather_docs sorcery option.
It's now possible to override the DOCS variable in a spell (preferably
in the DETAILS file, but i think it should work everywhere) to change
what files gather_docs installs to $DOCUMENT_DIRECTORY/$SPELL (currently
/usr/doc/$SPELL).
e.g. in the tvtime DETAILS:
DOCS="README* BUGS NEWS COPYING data/COPYING.* docs/html docs/example.lircrc"

This will hopefully make gather_docs much more useful, as it enables the
spell writers and grimoire gurus to fix doc installs of e.g. mozilla
(which installs a big source directory to /usr/doc/mozilla since it's
named docshell).

I'd like to ask all gurus that when they test spells to test them with
gather_docs on and set DOCS in the spell if the default doesn't work
correctly. This doesn't need to happen right now, but i'd like to see a
really useful $DOCUMENT_DIRECTORY soon :)

It would also be nice if the spells only installed documentation like
that, so that it's easy to disable/enable documentation installation in
sorcery. (exceptions that come to mind are all spells that install stuff
to /usr/share/gtk-doc/, since some programs need them to be there afaik)

Another change i'd like to see is that DOCUMENT_DIRECTORY is set to
/usr/share/doc instead of /usr/doc; the fhs
(http://www.pathname.com/fhs/) doesn't contain /usr/doc, but specifies
/usr/share/doc for documentation.

-- 
Arwed v. Merkatz
Grimoire Guru for video
Grimoire Guru for xfce
Sourcemage GNU/Linux
http://www.sourcemage.org