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