Gentoo Archives: gentoo-dev

From: Pacho Ramos <pacho@g.o>
To: gentoo-dev@l.g.o
Subject: [gentoo-dev] About using a CONFIGURATION (or SETUP) file under /usr/share/doc for configuration information
Date: Sat, 22 Dec 2012 09:27:42
Message-Id: 1356168400.2133.69.camel@belkin4
1 Hello
2
3 After seeing:
4 https://bugs.gentoo.org/show_bug.cgi?id=440214
5
6 Looking to a lot of its blockers shows that we are using "elog" messages
7 for informing people about configuration (like pointing people to
8 external links to get proper way of configuring things, tell them to add
9 to some system groups...). I thought that maybe this kind of information
10 could be simply included in a canonical file under /usr/share/doc/
11 package dir called, for example, CONFIGURATION or SETUP. We would them
12 point people (now with a news item, for the long term provably a note to
13 handbook to newcomers would be nice) to that file to configure their
14 setups. The main advantages I see:
15 - We will flood less summary.log ;)
16 - The information to configure the package is always present while
17 package is installed, now, if we remove merge produced logs, people will
18 need to reemerge the package or read directly the ebuild
19
20 What do you think?

Attachments

File name MIME type
signature.asc application/pgp-signature

Replies