From owner-freebsd-doc Wed Apr 10 1:20:10 2002 Delivered-To: freebsd-doc@freebsd.org Received: from rhadamanth.submonkey.net (pc4-card4-0-cust162.cdf.cable.ntl.com [80.4.14.162]) by hub.freebsd.org (Postfix) with ESMTP id A84F837B404; Wed, 10 Apr 2002 01:20:03 -0700 (PDT) Received: from setantae by rhadamanth.submonkey.net with local (Exim 3.35 #1) id 16vDKk-000IoG-00; Wed, 10 Apr 2002 09:20:02 +0100 Date: Wed, 10 Apr 2002 09:20:02 +0100 From: Ceri Davies To: Murray Stokely Cc: doc@FreeBSD.org Subject: Re: FAQ and Indexterm finished Message-ID: <20020410082002.GB71876@submonkey.net> Mail-Followup-To: Ceri Davies , Murray Stokely , doc@FreeBSD.org References: <20020409171830.GA65916@submonkey.net> <20020409212304.GC22329@freebsdmall.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20020409212304.GC22329@freebsdmall.com> User-Agent: Mutt/1.3.28i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Tue, Apr 09, 2002 at 02:23:04PM -0700, Murray Stokely wrote: > On Tue, Apr 09, 2002 at 06:18:30PM +0100, Ceri Davies wrote: > > Big ol' patch at http://www.submonkey.net/patches/faq.full.diff > > I think a lot of these secondary indexterms are unnecessary. For > example, IOMega Zip Drive, etc. That's not really a high level topic > with lots of subtopics. I would change some of those very specific > things to just primaries without a secondary indexterm. If you look > in a normal book index, you will see mostly primary indexterms and > indexterms with secondary entries are usually in the minority. In > this patch, they make up 100% of the indexterms, which is not ideal. > and are available when the organization of the > content requires it -- you shouldn't feel obligated to give every > index term a two-tier designation. Good point. > I think sendmail should be a primary, not a secondary under > software. Somewhere under the "mail" or "email" entries there should > be a to sendmail. grep the Handbook for examples of usage. There are 's ?! Dammit, that's handy! > It is much more likely that someone is going to look under sendmail > for this information in the Index. For some of these, you may want to > add a or element to the index easier to follow. > > > I realise that it's not the most beautiful thing ever, but if I > > get this in, then I'll be more than happy to see people help out > > with tidying it up. > > It's great work, so feel free to commit it with or without my > suggestion above. No, in light of the 's I'm going to redo it, I think. I can do it better with those. Thanks, Ceri -- get the cool shoe shine To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message