[gentoo-catalyst] [PATCH v2 0/2] pkgcache warning in catalyst-config(5)

[W. Trevor King]

From: "W. Trevor King" <wking@×××××××.us>

On Fri, Apr 12, 2013 at 12:11:03PM -0400, Rick "Zero_Chaos" Farina wrote:
> On 04/12/2013 11:33 AM, W. Trevor King wrote:
> > Here I link to the ML from the config file ;).  I'm fine linking
> > somewhere else (doc/catalyst-conf.1.txt?).  Then config file comments
> > could move to the new man page (as spec file comments moved to their
> > own man page).  With more space, we can wax eloquent on the potential
> > pkgcache issues ;).
>
> Yeah, but more reading is not necessarily more better. It is likely
> better if we explain it briefly and not worry about 100% of the details.
> the config file isn't meant for long discussions, it's meant for short
> recommendations and warnings about features at most.

Here's a new man page which breaks the binary package discussion out
into its own section.  This gives me a bit more space to explain
what's going on.  I think that files/catalyst.conf should be stripped
back to only contain things that we thing are really important, since
the detailed information will be in the man page.  What options do
people actually tweak on a regular basis?  What other options do we
want to highlight?

W. Trevor King (2):
  doc/catalyst-config.5.txt: Add man page for catalyst.conf
  doc/catalyst-config.5.txt: Document linking issues with binary
    packages

 doc/catalyst-config.5.txt | 230 ++++++++++++++++++++++++++++++++++++++++++++++
 doc/catalyst-spec.5.txt   |   2 +-
 doc/catalyst.1.txt        |   1 +
 files/.gitignore          |   1 +
 4 files changed, 233 insertions(+), 1 deletion(-)
 create mode 100644 doc/catalyst-config.5.txt

-- 
1.8.2