From owner-freebsd-doc Wed Mar 15 16:41:26 2000 Delivered-To: freebsd-doc@freebsd.org Received: from holly.calldei.com (adsl-208-191-146-189.dsl.hstntx.swbell.net [208.191.146.189]) by hub.freebsd.org (Postfix) with ESMTP id 0A68B37B8F2 for ; Wed, 15 Mar 2000 16:41:24 -0800 (PST) (envelope-from chris@holly.calldei.com) Received: (from chris@localhost) by holly.calldei.com (8.9.3/8.9.3) id SAA24188; Wed, 15 Mar 2000 18:40:45 -0600 (CST) (envelope-from chris) Date: Wed, 15 Mar 2000 18:40:45 -0600 From: Chris Costello To: Sheldon Hearn Cc: doc@FreeBSD.ORG Subject: Re: Proposal re SGML style Message-ID: <20000315184045.M14372@holly.calldei.com> Reply-To: chris@calldei.com References: <56968.953140144@axl.ops.uunet.co.za> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii User-Agent: Mutt/0.96.4i In-Reply-To: <56968.953140144@axl.ops.uunet.co.za> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wednesday, March 15, 2000, Sheldon Hearn wrote: > Right now, what I'd like to hear is constructive criticism of the > proposed style. What would the drawbacks be? How would this break the > various kinds of output we can generate from the SGML source? All I can is this: Please do not make the same mistake you did with the man pages, which you did also make in your example. Don't just insert line breaks at the end of each sentence. Carefully reformat it. Otherwise it just looks like garbage. -- |Chris Costello |What this country needs is a good five-cent microcomputer. `---------------------------------------------------------- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message