Date: Wed, 18 Jul 2001 12:42:48 +0300 From: Ruslan Ermilov <ru@FreeBSD.org> To: Sheldon Hearn <sheldonh@starjuice.net> Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/share/examples/mdoc example.1 example.3 example.4 Message-ID: <20010718124248.C19889@sunbay.com> In-Reply-To: <6893.995448384@axl.seasidesoftware.co.za>; from sheldonh@starjuice.net on Wed, Jul 18, 2001 at 11:26:24AM %2B0200 References: <20010718121944.B19889@sunbay.com> <6893.995448384@axl.seasidesoftware.co.za>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, Jul 18, 2001 at 11:26:24AM +0200, Sheldon Hearn wrote:
>
>
> On Wed, 18 Jul 2001 12:19:44 +0300, Ruslan Ermilov wrote:
>
> > These aren't gratuitous. From the mdoc(7) manpage:
>
> I take that back, then. I looked at a couple of examples, and couldn't
> see any cases where the sweep on trailing whitespace had actually
> changed any rendering. But I guess I assumed too much.
>
Well, it's really hard to make trailing spaces cause the troubles, as:
: Filling and Adjusting
: ---------------------
:
: When `gtroff' reads text, it collects words from the input and fits
: as many of them together on one output line as it can. This is known as
: "filling".
:
: Once `gtroff' has a "filled" line, it tries to "adjust" it. This
: means it widens the spacing between words until the text reaches the
: right margin (in the default adjustment mode). Extra spaces between
: words are preserved, but spaces at the end of lines are ignored.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
: Spaces at the front of a line cause a "break" (breaks are explained in
: *Note Implicit Line Breaks::)
But there's at least one case (I know of) where this matters:
: *Caution:* Unlike other requests, the second argument to the `ds'
: request takes up the entire line including trailing spaces. This
^^^^^^^^^^^^^^^^^^^^^^^^^
: means that comments on a line with such a request can introduce
: unwanted space into a string.
So, a slightly artificial example would be:
.No "text
text
Note the double quote and trailing spaces after the .No's argument.
Cheers,
--
Ruslan Ermilov Oracle Developer/DBA,
ru@sunbay.com Sunbay Software AG,
ru@FreeBSD.org FreeBSD committer,
+380.652.512.251 Simferopol, Ukraine
http://www.FreeBSD.org The Power To Serve
http://www.oracle.com Enabling The Information Age
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010718124248.C19889>