From owner-freebsd-doc Fri Aug 17 10:32:58 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mta02-svc.ntlworld.com (mta02-svc.ntlworld.com [62.253.162.42]) by hub.freebsd.org (Postfix) with ESMTP id E5BB437B401; Fri, 17 Aug 2001 10:32:53 -0700 (PDT) (envelope-from mark@ntlworld.com) Received: from parish ([62.253.85.106]) by mta02-svc.ntlworld.com (InterMail vM.4.01.03.00 201-229-121) with ESMTP id <20010817173252.DRGW29790.mta02-svc.ntlworld.com@parish>; Fri, 17 Aug 2001 18:32:52 +0100 Received: (from mark@localhost) by parish (8.11.4/8.11.3) id f7HHWxQ01146; Fri, 17 Aug 2001 18:32:59 +0100 (BST) (envelope-from mark) Date: Fri, 17 Aug 2001 18:32:59 +0100 From: Mark Ovens To: Nik Clayton Cc: John Murphy , doc@freebsd.org Subject: Re: Message-ID: <20010817183259.B275@parish> References: <20010817091230.A59279@clan.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit User-Agent: Mutt/1.2.5i In-Reply-To: <20010817091230.A59279@clan.nothing-going-on.org>; from nik@freebsd.org on Fri, Aug 17, 2001 at 09:12:30AM +0100 Organization: Total lack of 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 Fri, Aug 17, 2001 at 09:12:30AM +0100, Nik Clayton wrote: > On Fri, Aug 17, 2001 at 01:16:13AM +0100, John Murphy wrote: > > I am impressed. It is a good way to write a book :) > > > > However: I'm stuck on the tag. I first saw it around IDE, > > then found it not around BIOS or SCSI etc. 'twould seem to me that > > these, and more, are unequivocal throughout the Manual and could, > > therefore, be treated as part of the final process. Else I could easily > > acronymize (sorry), the occurrences I find. > > > > I think i'm confused, because i tend to say I de E, buyos, skuzy. The > > latter two seem more acronymy than the first... (I used to say Lie > > Nux!) > > An acronym is anything formed from (typically the initial) letters from > a phrase. ...that forms a word (either real or contrived), so BIOS and SCSI are acronyms, but IDE isn't (unless you pronounce it "eyed"), and neither is PCI, IBM, etc. c.f. OED acronym. /'aekranim/ n. word made from initial letters of other words. > So BIOS, SCSI, RAID, and IDE are all acronyms. An > abbreviation is a shortened form of a word. > > > Abbreviation tag anyone? > > There is an element. . . > > As to whether we use the elements or not -- there's no "formal" policy on > this. My personal opinion is that we have, through general usage, evolved > a core set of elements that we use in the documentation -- things like > , , , the &man.foo.x; entities, and so on. > If a document is submitted that doesn't use these elements where appropriate > then I'd try to add it to the mark up before committing it. > > Then there are "non-core" elements. and fall in to > this category. They are nice to have, but it's not a showstopper if > they're not used when they should be. But they do add to the value in > the text (because then we can produce tables of acronyms, allowing > readers to see where acronyms like "IDE" are used in the text), so if > you, or anyone else, wants to tighten up the mark up in text that you're > looking at then you should feel free to do so. > > N > -- > FreeBSD: The Power to Serve http://www.freebsd.org/ > FreeBSD Documentation Project http://www.freebsd.org/docproj/ > > --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- -- 4.4 - The number of the Beastie ________________________________________________________________ 51.44°N FreeBSD - The Power To Serve http://www.freebsd.org 2.057°W My Webpage http://ukug.uk.freebsd.org/~mark mailto:marko@freebsd.org http://www.radan.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message