Gentoo Archives: gentoo-dev

From: Donnie Berkholz <dberkholz@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] About using a CONFIGURATION (or SETUP) file under /usr/share/doc for configuration information
Date: Sat, 05 Jan 2013 05:36:01
Message-Id: 20130105053459.GB9570@comet.hsd1.mn.comcast.net
In Reply to: [gentoo-dev] About using a CONFIGURATION (or SETUP) file under /usr/share/doc for configuration information by Pacho Ramos
1 On 10:26 Sat 22 Dec , Pacho Ramos wrote:
2 > Hello
3 >
4 > After seeing:
5 > https://bugs.gentoo.org/show_bug.cgi?id=440214
6 >
7 > Looking to a lot of its blockers shows that we are using "elog" messages
8 > for informing people about configuration (like pointing people to
9 > external links to get proper way of configuring things, tell them to add
10 > to some system groups...). I thought that maybe this kind of information
11 > could be simply included in a canonical file under /usr/share/doc/
12 > package dir called, for example, CONFIGURATION or SETUP. We would them
13 > point people (now with a news item, for the long term provably a note to
14 > handbook to newcomers would be nice) to that file to configure their
15 > setups. The main advantages I see:
16 > - We will flood less summary.log ;)
17 > - The information to configure the package is always present while
18 > package is installed, now, if we remove merge produced logs, people will
19 > need to reemerge the package or read directly the ebuild
20 >
21 > What do you think?
22
23 Bikeshedding ... would go with README.gentoo, because people are already
24 used to looking for README files. Every time we can eliminate
25 Gentoo-specific weirdness, we should.
26
27 --
28 Thanks,
29 Donnie
30
31 Donnie Berkholz
32 Council Member / Sr. Developer, Gentoo Linux <http://dberkholz.com>
33 Analyst, RedMonk <http://redmonk.com/dberkholz/>

Replies