Date: Mon, 16 Jul 2001 20:27:37 +0300 From: Ruslan Ermilov <ru@FreeBSD.org> To: Nik Clayton <nik@FreeBSD.org> Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org, doc@FreeBSD.org Subject: The use of enclosure mdoc(7) macros like .Pq (was: Re: cvs commit: src/share/man/man7 hier.7) Message-ID: <20010716202737.J51681@sunbay.com> In-Reply-To: <200107161609.f6GG9M117281@freefall.freebsd.org>; from nik@FreeBSD.org on Mon, Jul 16, 2001 at 09:09:22AM -0700 References: <200107161609.f6GG9M117281@freefall.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, Jul 16, 2001 at 09:09:22AM -0700, Nik Clayton wrote: > nik 2001/07/16 09:09:22 PDT > > Modified files: > share/man/man7 hier.7 > Log: > Note which entries are created by sysinstall(8). > > Requested by: ru > > Revision Changes Path > 1.51 +5 -2 src/share/man/man7/hier.7 > Thanks! PLEASE DON'T USE ENCLOSURE MACROS LIKE .Pq FOR PLAIN TEXT! In the past (before -mdocNG), all enclosure macros had a problem with the size of enclosing text, and this has since been fixed. So this is no longer the case. But the following still applies. With -mdocNG, the use of almost any -mdoc macro intentionally prevents hyphenation in its arguments. Compare these: .Po Hostnames are domains, where a domain is a hierarchical, dot-separated list of subdomains; for example, the machine monet, in the Berkeley subdomain of the EDU subdomain of the Internet would be represented as .Pc .Pp (Hostnames are domains, where a domain is a hierarchical, dot-separated list of subdomains; for example, the machine monet, in the Berkeley subdomain of the EDU subdomain of the Internet would be represented as) Also, the use of macros increases the processing time. IOW, the .Pq created by Xr sysinstall 8 should be written like (created by .Xr sysinstall 8 ) 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 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?20010716202737.J51681>