Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 19 Mar 2002 22:27:04 -0600
From:      Mike Meyer <mwm-dated-1017030425.b95013@mired.org>
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
Message-ID:  <15512.3992.905972.279159@guru.mired.org>
In-Reply-To: <mfr8mf98vb.8mf@localhost.localdomain>
References:  <200203192120.g2JLK3o17280@freefall.freebsd.org> <mfr8mf98vb.8mf@localhost.localdomain>

next in thread | previous in thread | raw e-mail | index | archive | help
In <mfr8mf98vb.8mf@localhost.localdomain>, Gary W. Swearingen <swear@blarg.net> typed:
> Mike Meyer <mwm-dated-1017004489.c7e726@mired.org> writes:
> >  In <20020319100000.A57951@sumuk.de>, Martin Heinen <martin@sumuk.de> 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 &period;
> >  and I'll use that. Or let us use -- instead of &mdash;.
> 
> 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.

	<mike
--
Mike Meyer <mwm@mired.org>			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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?15512.3992.905972.279159>