From owner-freebsd-doc@FreeBSD.ORG Wed Jun 16 11:51:58 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6BFAB16A4CE for ; Wed, 16 Jun 2004 11:51:58 +0000 (GMT) Received: from tigra.ip.net.ua (tigra.ip.net.ua [82.193.96.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 33E7843D5C for ; Wed, 16 Jun 2004 11:51:57 +0000 (GMT) (envelope-from ru@ip.net.ua) Received: from heffalump.ip.net.ua (heffalump.ip.net.ua [82.193.96.213]) by tigra.ip.net.ua (8.12.11/8.12.11) with ESMTP id i5GBwB7o034218 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 16 Jun 2004 14:58:12 +0300 (EEST) (envelope-from ru@ip.net.ua) Received: (from ru@localhost) by heffalump.ip.net.ua (8.12.11/8.12.11) id i5GBphlF023587; Wed, 16 Jun 2004 14:51:43 +0300 (EEST) (envelope-from ru) Date: Wed, 16 Jun 2004 14:51:43 +0300 From: Ruslan Ermilov To: Dag-Erling Sm?rgrav Message-ID: <20040616115143.GA23524@ip.net.ua> References: <200406150124.i5F1Ofp9084012@repoman.freebsd.org> <200406151522.i5FFMeIc001885@khavrinen.lcs.mit.edu> <20040616062409.GC20866@ip.net.ua> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="/9DWx/yDrRhgMJTb" Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.6i X-Virus-Scanned: by amavisd-new X-Spam-Checker-Version: SpamAssassin 2.55 (1.174.2.19-2003-05-19-exp) cc: doc@freebsd.org cc: Garrett Wollman Subject: Marking up POSIX symbolic limits X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 16 Jun 2004 11:51:58 -0000 --/9DWx/yDrRhgMJTb Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable [ Moved to -doc, please keep me Cc:ed. ] On Wed, Jun 16, 2004 at 01:19:27PM +0200, Dag-Erling Sm?rgrav wrote: > Ruslan Ermilov writes: > > On Tue, Jun 15, 2004 at 11:22:40AM -0400, Garrett Wollman wrote: > > > Actually, it's {IOV_MAX}. > > You mean you want it marked up like in POSIX, with curlies? > > We still use guidelines from mdoc(7) (where is talks about > > "Defined Variables"), and there are no curlies here, but we > > can change the practice if strongly necessary. I failed to > > find a definition of using curlies in this case in the POSIX > > spec, can you point me into the right direction? >=20 > Note 4 in the _Typographical Conventions_ section in the frontmatter: >=20 > "Names surrounded by braces represent symbolic limits or configuration > values which may be declared in appropriate headers by means of the C > #define construct." >=20 > Note that POSIX does not require IOV_MAX to be defined in ; > if it isn't, the value of sysconf(_SC_IOV_MAX) should be used instead. >=20 OK, so POSIX makes a distinction between a "symbolic constant" and a "symbolic limit, configuration value". The question is: do we want such a distinction in FreeBSD manpages? If necessary, ``.Brq Dv IOV_MAX'' should do just fine. Cheers, --=20 Ruslan Ermilov ru@FreeBSD.org FreeBSD committer --/9DWx/yDrRhgMJTb Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA0DRPqRfpzJluFF4RAkh5AJsH93ThutmwoXBkzrAEyrphaxM5GACfVcNk E17d55pL+XaBl4RN5GSeJ4U= =IHEv -----END PGP SIGNATURE----- --/9DWx/yDrRhgMJTb--