Re: [gentoo-dev] About using a CONFIGURATION (or SETUP) file under /usr/share/doc for configuration information

[Pacho Ramos]

El dom, 30-12-2012 a las 00:09 +0100, Pacho Ramos escribió:
[...]
> > I want to have a permanent reference of current elog messages simply
> > showing configuration tips to:
> > 1. Show them via elog messages only first time package is installed
> > 2. Not need to read ebuild directly once people remove summary.log
> >

This would be the idea (applied in this example to acpid package)
--- /home/pacho/gentoo-x86/sys-power/acpid/acpid-2.0.17.ebuild
2012-11-26 09:20:15.000000000 +0100
+++ ./acpid-2.0.17.ebuild	2012-12-31 14:18:41.000000000 +0100
@@ -37,6 +37,13 @@
 	newconfd "${FILESDIR}"/${PN}-2.0.16-conf.d ${PN}
 
 	systemd_dounit "${FILESDIR}"/systemd/${PN}.{service,socket}
+
+	cat > CONFIGURATION <<-EOF
+		You may wish to read the Gentoo Linux Power Management Guide,
+		which can be found online at:
+		http://www.gentoo.org/doc/en/power-management-guide.xml
+	EOF
+	dodoc CONFIGURATION
 }
 
 pkg_postinst() {

Some improvements I am not sure how to implement just now:
- What would be the proper way to "elog" contents
of /usr/share/doc/${PF}/CONFIGURATION.bz2 and, then, allow the following
to be shorter:

	if ! has_version 'sys-power/acpid'; then
		elog
		elog "You may wish to read the Gentoo Linux Power Management Guide,"
		elog "which can be found online at:"
		elog "http://www.gentoo.org/doc/en/power-management-guide.xml"
		elog
	fi
?

Thanks for your help