From owner-freebsd-doc Wed Feb 27 4:49: 4 2002 Delivered-To: freebsd-doc@freebsd.org Received: from straylight.ringlet.net (discworld.nanolink.com [217.75.135.248]) by hub.freebsd.org (Postfix) with SMTP id 536DC37B420 for ; Wed, 27 Feb 2002 04:48:32 -0800 (PST) Received: (qmail 791 invoked by uid 1000); 27 Feb 2002 12:48:08 -0000 Date: Wed, 27 Feb 2002 14:48:08 +0200 From: Peter Pentchev To: Yonatan Bokovza Cc: "'freebsd-doc@freebsd.org'" Subject: Re: &man question Message-ID: <20020227144808.A359@straylight.oblivion.bg> Mail-Followup-To: Yonatan Bokovza , "'freebsd-doc@freebsd.org'" References: Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="XsQoSWH+UP9D9v3l" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: ; from Yonatan@xpert.com on Wed, Feb 27, 2002 at 01:30:27PM +0200 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --XsQoSWH+UP9D9v3l Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Feb 27, 2002 at 01:30:27PM +0200, Yonatan Bokovza wrote: > &man.something.1 works. Why doesn't > &man.some_thing.1 works?=20 Uhm.. because &man.some_thing.1 is not defined as an entity? See doc/share/sgml/man-refs.ent for the defined entities. Hm; taking a second look at man-refs.ent, I see that there are indeed entities referring to manual pages which contain underscores; the entities themselves replace the underscore with a dot, e.g. &man.pkg.create.1; for pkg_create(1). If this was your question, it may be something related to the SGML and/or DocBook standard regarding entity naming; it just might be that an underscore is an illegal character for entity names. I doubt that, however; I think that this was more of a decision to reflect another level of naming hierarchy (e.g. all pkg_* pages refer to packaging utilities, and their entities all *seem* to be grouped under a &man.pkg. "tree"). I might be wrong though; maybe some doc old-timers could shed some light on that. It seems that the &man.pkg.create.1; entities date back right to rev. 1.1 of man-refs.ent, committed by Nik Clayton back in 1999. Nik, any ideas on why pkg.create instead of pkg_create? G'luck, Peter --=20 Peter Pentchev roam@ringlet.net roam@FreeBSD.org PGP key: http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553 This would easier understand fewer had omitted. --XsQoSWH+UP9D9v3l Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjx81YgACgkQ7Ri2jRYZRVO3kwCfaY7JaUGae6lwo3jrHtYsPVI/ gjEAn16Ybp4wuUcjn36Tgb4w+HcCpPJM =wiBo -----END PGP SIGNATURE----- --XsQoSWH+UP9D9v3l-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message