From owner-freebsd-doc Tue Mar 19 20:27:13 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mired.org (dsl-64-192-6-133.telocity.com [64.192.6.133]) by hub.freebsd.org (Postfix) with SMTP id 382DC37B405 for ; Tue, 19 Mar 2002 20:27:07 -0800 (PST) Received: (qmail 97771 invoked by uid 100); 20 Mar 2002 04:27:05 -0000 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <15512.3992.905972.279159@guru.mired.org> Date: Tue, 19 Mar 2002 22:27:04 -0600 To: swear@blarg.net (Gary W. Swearingen) Cc: freebsd-doc@FreeBSD.ORG Subject: Re: docs/36042: [PATCH] There's not a good description of shared builds in the handbook In-Reply-To: References: <200203192120.g2JLK3o17280@freefall.freebsd.org> X-Mailer: VM 6.90 under 21.1 (patch 14) "Cuyahoga Valley" XEmacs Lucid X-face: "5Mnwy%?j>IIV\)A=):rjWL~NB2aH[}Yq8Z=u~vJ`"(,&SiLvbbz2W`;h9L,Yg`+vb1>RG% *h+%X^n0EZd>TM8_IB;a8F?(Fb"lw'IgCoyM.[Lg#r\ From: Mike Meyer X-Delivery-Agent: TMDA/0.49 (Python 2.2 on freebsd4) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org In , Gary W. Swearingen typed: > Mike Meyer writes: > > In <20020319100000.A57951@sumuk.de>, Martin Heinen typed: > > > Please put two spaces at the end of sentences. > > > > I don't write for 19th century schoolmarms. If the target format > > requires that ugly anachronism, it should be taken care of by the > > style sheet or the formatter. If they can't do that, give me . > > and I'll use that. Or let us use -- instead of —. > > The format of Martin's concern (I'm guessing) is not any proportional- > font target like a printed sheet or a browser's page view, but the > fixed-pitch raw text, which also has readers. The double space > convention was, I suspect, not first required by schoolmarms, but by > early readers of fixed-pitch typing. It was good advice for a hundred > years and it still is. (Though some would prefer a "newline", in these > kinds of raw documents. :) You're saying he wants the raw text formatted the way he would like to read it. Personally, I disagree with you and prefer one space after a period, even in fixed pitch text. That's why I wrote it that way. This is the first time anyone's ever objected to that practice in the documentation I've submitted. I don't see anything in the instructions for submitting documentation to the project on this, or a manual page in section 7 that looks relevant. Personally, I think raising hurdles for those volunteering to write documentation is a bad idea. http://www.mired.org/home/mwm/ Independent WWW/Perforce/FreeBSD/Unix consultant, email for more information. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message