From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id DF9A51381F3 for ; Fri, 12 Apr 2013 18:22:01 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 35B12E0968; Fri, 12 Apr 2013 18:22:00 +0000 (UTC) Received: from vms173007pub.verizon.net (vms173007pub.verizon.net [206.46.173.7]) by pigeon.gentoo.org (Postfix) with ESMTP id 9CCFAE096A for ; Fri, 12 Apr 2013 18:21:59 +0000 (UTC) Received: from odin.tremily.us ([unknown] [72.68.100.81]) by vms173007.mailsrvcs.net (Sun Java(tm) System Messaging Server 7u2-7.02 32bit (built Apr 16 2009)) with ESMTPA id <0ML500EW5N0BN290@vms173007.mailsrvcs.net> for gentoo-catalyst@lists.gentoo.org; Fri, 12 Apr 2013 13:21:48 -0500 (CDT) Received: by odin.tremily.us (Postfix, from userid 1000) id 75A219677B0; Fri, 12 Apr 2013 14:21:47 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=tremily.us; s=odin; t=1365790907; bh=KY/En9kV/nMNK2ohzB/TfH4YzAf09evcv59JXjQzde4=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=GwbE9qQ75yuTFVvn6bXVyoeEm+3X0Du4M+X9Fb3Ann6B5q7reDgPqoqwEtZnQExyW o+ST6/vHgWmnmYfrHtWRJj+vOsAfBX3F+dNlOFJbED2vbyp3NLl+7WFI4EBxwOfkFz 4+WZXQCSQnK58bd1lsFe6oYM1Dy2e/FTFhloouWk= From: "W. Trevor King" To: Catalyst Cc: "W. Trevor King" Subject: [gentoo-catalyst] [PATCH v2 0/2] pkgcache warning in catalyst-config(5) Date: Fri, 12 Apr 2013 14:21:41 -0400 Message-id: X-Mailer: git-send-email 1.8.1.5 In-reply-to: <51683217.3070805@gentoo.org> References: <51683217.3070805@gentoo.org> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-catalyst@lists.gentoo.org Reply-to: gentoo-catalyst@lists.gentoo.org X-Archives-Salt: 4dad82f2-b608-4258-b900-52e200ca3ade X-Archives-Hash: f94d26f389df31352199d533dee3ec57 From: "W. Trevor King" 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