From owner-freebsd-doc@FreeBSD.ORG Tue May 13 18:45:39 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 E51DB37B401 for ; Tue, 13 May 2003 18:45:39 -0700 (PDT) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6B06843F85 for ; Tue, 13 May 2003 18:45:39 -0700 (PDT) (envelope-from linimon@lonesome.com) Received: from lonesome.lonesome.com (cs242746-11.austin.rr.com [24.27.46.11]) (using TLSv1 with cipher RC4-MD5 (128/128 bits)) (No client certificate requested) by mail.soaustin.net (Postfix) with ESMTP id 87F4E14354 for ; Tue, 13 May 2003 20:45:38 -0500 (CDT) From: Mark Linimon Organization: Lonesome Dove Computing Services To: freebsd-doc@freebsd.org Date: Tue, 13 May 2003 20:49:05 -0500 User-Agent: KMail/1.5 MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Content-Disposition: inline Message-Id: <200305132049.05256.linimon@lonesome.com> Subject: RFC: suggested changes to the Porter's Handbook 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: , X-List-Received-Date: Wed, 14 May 2003 01:45:40 -0000 I have come up with a large number of suggested revisions to the Porter's Handbook. As the diffs are large (>1000 lines (!) ), I have not included them here, but instead put them up for review on http://www.lonesome.com/FreeBSD/index.html. I was told I needed to separate the changes by type, so I did. Each of the changes would be applied in order: * changes to style such as making sure every individual command is a manpage ref, every instance of a filename is included in a filename entity, every instance of a command plus arguments is a command entity, and so forth. * changes to whitespace that become needed for readability after the above changes are applied. * changes to content that range from entirely new sections, to clarifications of unclear explanations, to creating many more links to external and interal projects, to inserting text to say that "something needs to go here", and so on and so forth. I am hoping the first two will be fairly non-controversial (if nothing else, I do not look forward to a merging effort should these changes themselves wind up being changed). The third will of course be controversial, but so it goes. I'm hoping the "new text" and "clarified text" will be less so than the "changed text". I am much more attached to the "new text" than the other two. There are some things in that category that IMHO are the main motivation to update the document. Note: all of this got started when Eric Anholt sent me some other possible changes to review. But note that his own changes are not included in this. This is no slight to him -- I spent the time to carve my own changes up into the multiple diffs but my motivation has flagged at the moment to go back and do them to his. Sigh. So, folks, get your chainsaws out and let's see what happens :-) Mark Linimon