Date: Tue, 15 Jan 2002 16:00:01 -0800 (PST) From: Giorgos Keramidas <keramida@freebsd.org> To: freebsd-doc@freebsd.org Subject: Re: docs/33390: Markup fix for tuning.7 Message-ID: <200201160000.g0G001723206@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/33390; it has been noted by GNATS.
From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Ceri <setantae@submonkey.net>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/33390: Markup fix for tuning.7
Date: Tue, 15 Jan 2002 18:09:53 +0200
> tuning.7 contains two strange pieces of markup regarding /var/tmp.
> I can see why it's been done, since the author clearly wishes to refer to
> /tmp and/or /var/tmp, but it looks horrific : [/var]/tmp
How about explicitly mentioning both directories in something like:
temporary directories (usually
.Pa /var/tmp
or
.Pa /tmp ")."
Does this look better to you?
Although I have to admit that [/var]/tmp does not look that bad.
Brackets are customarily used to denote optional parts in several
places (command line arguments in SYNOPSIS sections, for example).
--
Giorgos Keramidas . . . . . . . . . keramida@{ceid.upatras.gr,freebsd.org}
FreeBSD Documentation Project . . . http://www.freebsd.org/docproj/
FreeBSD: The power to serve . . . . http://www.freebsd.org/
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?200201160000.g0G001723206>