On Fri, Jan 04, 2013 at 11:34:59PM -0600, Donnie Berkholz wrote: > On 10:26 Sat 22 Dec , Pacho Ramos wrote: > > Hello > > > > After seeing: > > https://bugs.gentoo.org/show_bug.cgi?id=440214 > > > > Looking to a lot of its blockers shows that we are using "elog" messages > > for informing people about configuration (like pointing people to > > external links to get proper way of configuring things, tell them to add > > to some system groups...). I thought that maybe this kind of information > > could be simply included in a canonical file under /usr/share/doc/ > > package dir called, for example, CONFIGURATION or SETUP. We would them > > point people (now with a news item, for the long term provably a note to > > handbook to newcomers would be nice) to that file to configure their > > setups. The main advantages I see: > > - We will flood less summary.log ;) > > - The information to configure the package is always present while > > package is installed, now, if we remove merge produced logs, people will > > need to reemerge the package or read directly the ebuild > > > > What do you think? > > Bikeshedding ... would go with README.gentoo, because people are already > used to looking for README files. Every time we can eliminate > Gentoo-specific weirdness, we should.
Thinking about this, I tend to agree. That way we can put the README
file in ${FILESDIR} and change it whenever we need to for different
versions of the package.
William
>
> --
> Thanks,
> Donnie
>
> Donnie Berkholz
> Council Member / Sr. Developer, Gentoo Linux <http://dberkholz.com>
> Analyst, RedMonk <http://redmonk.com/dberkholz/>
pgpruzYrr009F.pgp
Description: PGP signature
