[Moin-user] Why oh why!

[Frank Lin PIAT]

Hello Pierre,

On Wed, 2008-12-10 at 21:45 +0100, Pierre Coupard wrote:
> As far as documentation is concerned, the Debian package is quite devoid 
> of it, as are most Debian packages.

Short answer:
  vim -o /usr/share/doc/$packagename/{NEWS,README}.Debian.gz


Long answer:
As you may know, Debian provides a file named NEWS.Debian[1], installed
in the package's doc directory (the one for moinmoin
is /usr/share/doc/python-moinmoin/NEWS.Debian.gz). It summarizes major
changes in a package. It *is* meant for system admins.

|moin (1.7.0) unstable; urgency=low
|
|  * New upstream release, requiring content migration.
|
|    Automated migration:
|    1. Add your MoinMoin wikis to /etc/moin/wikilist, and invoke
|       moin-mass-migrate as root
|    3. Let packaging routines mass-migrate as needed in the future
|
|    Manual migration:
|    See /usr/share/doc/moinmoin-common/README.Migration(.gz).
|
| -- Jonas Smedegaard <dr at jones.dk>  Sun, 22 Jun 2008 11:15:47 +0200

You should file a bug the Debian bug tracking system, If you think the
documentation should be improved (preferably with a patch;)

Regards,

Franklin

[1]
http://www.debian.org/doc/developers-reference/best-pkging-practices.html#bpp-news-debian