From owner-freebsd-doc@FreeBSD.ORG Thu Nov 13 14:30:04 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 33CA51065687 for ; Thu, 13 Nov 2008 14:30:04 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from ey-out-2122.google.com (ey-out-2122.google.com [74.125.78.26]) by mx1.freebsd.org (Postfix) with ESMTP id B58468FC08 for ; Thu, 13 Nov 2008 14:30:03 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by ey-out-2122.google.com with SMTP id 6so389795eyi.7 for ; Thu, 13 Nov 2008 06:30:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=hXJ7FUSNxlW/p9Vy3xvkCGuchwkrH34gURjLDilE8L4=; b=mA3KrqwFZvY2RqBQHIdY/gwIPjOI8bPND67o6EkkGp2RXsGA93BED3kY48XiKrVQK2 TB9aI4nGk0tcJclQ/zaqF1rye/+8xcmsq4tzgzBYJOMnK5eqMxR60whHr13S3kmhrBHJ jmziSu2K+dw3HcaCaEeWLkFyrlfF28zZJKi3Q= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; b=w6tEFM1D93kuz6CWzNmcldrAoeTlFtT9NaiMZonYMsmuyzG5oS6IbZx3pBfndNR1mo 9a0r3jt81iVz59fLm3tTcsME7KTzGoo4xlN5ff4jkn3tZEqEElhraHGWtRvuLFpMgTlD MQS9055v7e3lqeKC1BS2DWNnlmMBEc4rIsR3o= Received: by 10.210.25.19 with SMTP id 19mr11231684eby.114.1226586602401; Thu, 13 Nov 2008 06:30:02 -0800 (PST) Received: from atlantis.dyndns.org (athedsl-4442731.home.otenet.gr [79.129.186.91]) by mx.google.com with ESMTPS id c25sm6303160ika.14.2008.11.13.06.30.00 (version=TLSv1/SSLv3 cipher=RC4-MD5); Thu, 13 Nov 2008 06:30:01 -0800 (PST) Message-ID: <491C39E7.7040609@gmail.com> Date: Thu, 13 Nov 2008 16:29:59 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.17 (X11/20081011) MIME-Version: 1.0 To: Tom Rhodes References: <1226494693.1809.10.camel@localhost> <491B4F01.9020403@gmail.com> <2a7894eb0811121605k1310bf8avf7a69363fc504905@mail.gmail.com> <20081112200755.66c52a48.trhodes@FreeBSD.org> In-Reply-To: <20081112200755.66c52a48.trhodes@FreeBSD.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org, Murray Stokely Subject: Re: Preface need update. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 13 Nov 2008 14:30:04 -0000 Tom Rhodes wrote: > On Wed, 12 Nov 2008 16:05:55 -0800 > "Murray Stokely" wrote: > > >> Thanks Manolis. Maybe we should add a comment to the Makefile so that >> when authors commit new chapters they remember to also update the >> preface summary. Or alternatively, we could put some kind of one >> sentence chapter description in of each chapter and pull >> it out of each file dynamically when building the preface. I'd >> probably recommend the low tech first suggestion as good enough. >> >> - Murray >> > > Yea, because I forget this every time I add a new chapter. :( > > > To take this idea one step further, I suggest we add the following comment to the Makefile: ----------------------------------------------------------------------------------------------------------------- To add a new chapter to the Handbook: - Update this Makefile, chapters.ent and book.sgml - Add a descriptive entry for the new chapter in preface/preface.sgml ----------------------------------------------------------------------------------------------------------------- Do you think this is good enough? Manolis