From owner-cvs-all Wed Jul 18 2:43: 8 2001 Delivered-To: cvs-all@freebsd.org Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by hub.freebsd.org (Postfix) with ESMTP id 90E1837B406; Wed, 18 Jul 2001 02:42:58 -0700 (PDT) (envelope-from ru@whale.sunbay.crimea.ua) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.11.2/8.11.2) id f6I9gmh29106; Wed, 18 Jul 2001 12:42:48 +0300 (EEST) (envelope-from ru) Date: Wed, 18 Jul 2001 12:42:48 +0300 From: Ruslan Ermilov To: Sheldon Hearn 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> Mail-Followup-To: Sheldon Hearn , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org References: <20010718121944.B19889@sunbay.com> <6893.995448384@axl.seasidesoftware.co.za> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <6893.995448384@axl.seasidesoftware.co.za>; from sheldonh@starjuice.net on Wed, Jul 18, 2001 at 11:26:24AM +0200 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG 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