On Sun, 14 Apr 2013 12:06:48 +0200 Pacho Ramos <[email protected]> wrote:
> The messages are shown the first time by elog *and* saved
> in /usr/share/doc/*/README.gentoo, adding the advantage of users
> having that docs always present without needing to re-emerge the
> package or manually read ebuilds
How are users aware that such file is installed?
It's hidden in front of the huge list (since 'src' comes after
'share'); so, they won't see it in there unless they have a huge
scroll back buffer or look into the log. Or look into the directory
although they may assume there to be no such thing and not even look.
Can we please make the users aware of it being installed?
if ! [[ -n "${HIDE_INFO_MSG}" ]] ; then
einfo "Useful documentation can be found in /usr/share/doc/${PF}"
fi
May not be the exact wording one would want, but at least people
are then aware where they need to look for more information.
The use of "einfo" should give the advantage of not filling the elog
file, while still appearing for the user upon an emerge.
If people don't agree with this apporach, we may want to solve the
actual problem in a different manner; one could write `eselect elog`
just like we have `eselect news`, that would force them to process
through the log messages and just not simply ignore them. Listing that
there are unread elog messages upon the next emerge may be interesting.
--
With kind regards,
Tom Wijsman (TomWij)
Gentoo Developer
E-mail address : [email protected]
GPG Public Key : 6D34E57D
GPG Fingerprint : C165 AF18 AB4C 400B C3D2 ABF0 95B2 1FCD 6D34 E57D
signature.asc
Description: PGP signature
