pkgsrc-WIP-changes archive

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

Re: cannonball: Add a MESSAGE banner post-install with instructions to the place to copy ROMs. Suggested by nia@



Greg Troxel writes:
> Santhosh Raju <fox%NetBSD.org@localhost> writes:
> > [...]
> > Log Message:
> > cannonball: Add a MESSAGE banner post-install with instructions to the place to copy ROMs. Suggested by nia@
>
> With binary package managers, MESSAGE no longer really works because
> many scroll by.  While we have a lot of them, I think most should go
> away.  Please put this in something like
> ${PREFIX}/share/doc/cannonball/README.foo instead.  This is really just
> 'how to configure this package' which is normal documentation.   If the
> upstream documentation already explains this, there is no need.

IMHO instructions to how quickly setup a package - like they seem in
that case - is a good use case for MESSAGE: all the instructions are
specific to the package packaged in pkgsrc.

Or, in other words (but not sure if I am too used to in doing that!):
my first reflex when I couldn't find any man page is to first do a
`pkg_info <pkg>' to see if there is any interesting MESSAGE and *then*
check `pkg_info -L <pkg>' if it provides any documentation. :)

Apart that, with MESSAGE it is clear that these instructions were added
by pkgsrc maintainers while by adding README in share/doc/<package> it
seems like that file is part of the official documentation.


Home | Main Index | Thread Index | Old Index