From owner-freebsd-doc  Mon Jul 26 14:58:18 1999
Delivered-To: freebsd-doc@freebsd.org
Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66])
	by hub.freebsd.org (Postfix) with ESMTP id 7F7051501C
	for <doc@freebsd.org>; Mon, 26 Jul 1999 14:57:23 -0700 (PDT)
	(envelope-from nik@nothing-going-on.demon.co.uk)
Received: (from nik@localhost)
	by nothing-going-on.demon.co.uk (8.9.3/8.9.2) id VAA16993;
	Mon, 26 Jul 1999 21:38:17 +0100 (BST)
	(envelope-from nik)
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>
References: <19990725212349.E14954@daemon.ninth-circle.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4i
In-Reply-To: <19990725212349.E14954@daemon.ninth-circle.org>; from Jeroen Ruigrok/Asmodai on Sun, Jul 25, 1999 at 09:23:49PM +0200
Organization: Nik at home, where there's nothing going on
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

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