Date: Mon, 26 Jul 1999 21:38:17 +0100 From: Nik Clayton <nik@nothing-going-on.demon.co.uk> To: Jeroen Ruigrok/Asmodai <asmodai@wxs.nl> Cc: Nik Clayton <nik@nothing-going-on.demon.co.uk>, doc@freebsd.org Subject: Re: some more questions wrt freebsd docbook Message-ID: <19990726213817.B16313@catkin.nothing-going-on.org> In-Reply-To: <19990725212349.E14954@daemon.ninth-circle.org>; from Jeroen Ruigrok/Asmodai on Sun, Jul 25, 1999 at 09:23:49PM %2B0200 References: <19990725212349.E14954@daemon.ninth-circle.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, Jul 25, 1999 at 09:23:49PM +0200, Jeroen Ruigrok/Asmodai wrote:
> in handbook.sgml you use:
>
> <!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
> %man;
>
> what exactly does this allow us to do?
>
> pull in manpages?
Not quite. The definition of the man.foo.n entities (such as &man.csh.1;)
are stored in a file.
That file is referenced by the name
-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN
the catalog file ("catalog") maps that name to a specific file in the
file system.
The "<!ENTITY ..." line maps the contents of that file to the parameter
entity %man;.
%man;
references that parameter entity, and in so doing, makes the SGML parser
include the contents of the manual page file at the current point in the
main file.
See "Using entities to include files" in the primer for more information.
N
--
[intentional self-reference] can be easily accommodated using a blessed,
non-self-referential dummy head-node whose own object destructor severs
the links.
-- Tom Christiansen in <375143b5@cs.colorado.edu>
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?19990726213817.B16313>