From owner-freebsd-doc@FreeBSD.ORG Tue May 20 23:33:55 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 71D0437B401; Tue, 20 May 2003 23:33:54 -0700 (PDT) Received: from builder.freebsdmall.com (builder.freebsdmall.com [65.86.180.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id AA79B43F85; Tue, 20 May 2003 23:33:53 -0700 (PDT) (envelope-from murray@builder.freebsdmall.com) Received: (from root@localhost) by builder.freebsdmall.com (8.12.9/8.11.6) id h4L6XrG6063797; Tue, 20 May 2003 23:33:53 -0700 (PDT) (envelope-from murray) From: Murray Stokely To: trhodes@FreeBSD.org Message-ID: <20030520233353.E8403@freebsdmall.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: freebsd-doc@FreeBSD.org Subject: comments on the new rcNG section. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Date: Wed, 21 May 2003 06:33:55 -0000 X-Original-Date: Tue, 20 May 2003 23:33:53 -0700 X-List-Received-Date: Wed, 21 May 2003 06:33:55 -0000 I don't recall if I mentioned this or not, but I don't think we should list all 40 files in /etc/rc.d/ in the rcNG section. It's just going to generate silly PRs when new files are added. It doesn't really matter or add anything to the text. It's just filler. I suggest we invite users to type ls on their own system and maybe list a few files followed by '...'. Attempting to list all, even after qualifying it with something like "at the time of this writing", is I think in general a bad idea unless it is really necessary for clarify. I think this new section could in general do with some more wordsmithing. I'll take another look at it in 24 hours if noone beats me to it. - Murray