From owner-freebsd-doc@FreeBSD.ORG  Mon Dec  6 22:22:20 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 C835816A4CF
	for <doc@FreeBSD.org>; Mon,  6 Dec 2004 22:22:20 +0000 (GMT)
Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 2CE1543D60
	for <doc@FreeBSD.org>; Mon,  6 Dec 2004 22:22:20 +0000 (GMT)
	(envelope-from trhodes@FreeBSD.org)
Received: from localhost (ip68-100-2-61.dc.dc.cox.net [68.100.2.61])
	(authenticated bits=0)
	by pittgoth.com (8.12.10/8.12.10) with ESMTP id iB6MMIag090782
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT);
	Mon, 6 Dec 2004 17:22:19 -0500 (EST)
	(envelope-from trhodes@FreeBSD.org)
Date: Mon, 6 Dec 2004 17:22:24 -0500
From: Tom Rhodes <trhodes@FreeBSD.org>
To: Tillman Hodgson <tillman@seekingfire.com>
Message-ID: <20041206172224.03a916cb@localhost>
In-Reply-To: <20041206215038.GM569@seekingfire.com>
References: <20041205114254.GD23252@clan.nothing-going-on.org>
	<41B3617B.3080507@centtech.com>
	<20041206192017.GE72462@clan.nothing-going-on.org>
	<20041206212357.GE84191@freebsdmall.com>
	<20041206215038.GM569@seekingfire.com>
X-Mailer: Sylpheed-Claws 0.9.12b (GTK+ 1.2.10; i386-portbld-freebsd5.3)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
cc: doc@FreeBSD.org
Subject: Re: Time for a Network Handbook?
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 06 Dec 2004 22:22:20 -0000

On Mon, 6 Dec 2004 15:50:38 -0600
Tillman Hodgson <tillman@seekingfire.com> wrote:

> On Mon, Dec 06, 2004 at 01:23:57PM -0800, Murray Stokely wrote:
> > One thing we should think about is using link entities to allow the
> > different chapters to be included in different books without breaking
> > the build due to broken references.  Currently, the single-chapter
> > builds often fail because xrefs to other chapters can not be looked
> > up.  If we replaced all xrefs to other chapters with entities like:
> > 
> > &link.chapter.sect;
> > 
> > Then we could define that entity depending on the presence of the -i
> > parameter entity for the given chapter file.  If the chapter to be
> > linked to is included in the build (and it's -i entity defined), then
> > the <xref> is created.  If it is not included in the build, then
> > descriptive text is used instead 'The Blah Chapter in the Handbook'.
> 
> Fixing single-chapter builds would be great.

I'm working on it.

-- 
Tom Rhodes