Date: Wed, 27 Feb 2002 14:48:08 +0200 From: Peter Pentchev <roam@ringlet.net> To: Yonatan Bokovza <Yonatan@xpert.com> Cc: "'freebsd-doc@freebsd.org'" <freebsd-doc@freebsd.org> Subject: Re: &man question Message-ID: <20020227144808.A359@straylight.oblivion.bg> In-Reply-To: <EB513E68D3F5D41191CA000255588101B43830@mailserv.xpert.com>; from Yonatan@xpert.com on Wed, Feb 27, 2002 at 01:30:27PM %2B0200 References: <EB513E68D3F5D41191CA000255588101B43830@mailserv.xpert.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020227144808.A359>