From owner-freebsd-doc Tue Dec 5 10: 1:19 2000 From owner-freebsd-doc@FreeBSD.ORG Tue Dec 5 10:01:18 2000 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mail6.svr.pol.co.uk (mail6.svr.pol.co.uk [195.92.193.212]) by hub.freebsd.org (Postfix) with ESMTP id 1BB0F37B400 for ; Tue, 5 Dec 2000 10:01:17 -0800 (PST) Received: from modem-23.change-management-shark.dialup.pol.co.uk ([62.137.10.23]) by mail6.svr.pol.co.uk with esmtp (Exim 3.13 #0) id 143MOx-0008Bw-00 for doc@freebsd.org; Tue, 05 Dec 2000 18:01:15 +0000 Received: (qmail 5531 invoked by uid 5000); 5 Dec 2000 17:36:40 -0000 Date: Tue, 5 Dec 2000 17:36:40 +0000 From: Tom Hukins To: Ernst de Haan Cc: doc@freebsd.org Subject: Re: SUGG: Using colors in http://www.freebsd.org/porters-handbook/porting-samplem.html Message-ID: <20001205173640.A5452@eborcom.com> Mail-Followup-To: Ernst de Haan , doc@freebsd.org References: <20001201164053.A56563@c187104187.telekabel.chello.nl> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0i In-Reply-To: <20001201164053.A56563@c187104187.telekabel.chello.nl>; from ernst@jollem.com on Fri, Dec 01, 2000 at 04:40:53PM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, Dec 01, 2000 at 04:40:53PM +0100, Ernst de Haan wrote: > > I suggest you use colors in the example Makefile for a new port in: > > * http://www.freebsd.org/porters-handbook/porting-samplem.html > > to make it more obvious for readers what goes in the Makefile and what is just > comments. I've attached a suggested replacement. Thanks for taking the time to do this. I agree with you that it would be a good idea to distinguish between the types of information displayed, but the way you have implemented this is impractical for FreeBSD. Although FreeBSD's documentation is available as HTML, it is written in DocBook, then translated to HTML, PDF, etc. For further information, see . If you can think of a way we can make this change to the DocBook source, please send in your changes as a diff. For more details on what this means, see the Documentation Project's "Submitting Documentation" page linked to from the URL I mentioned earlier. Again, thanks for taking the time to improve FreeBSD's documentation. Tom To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message