From owner-freebsd-doc Fri Aug 17 1:21:21 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (pc-62-31-42-140-hy.blueyonder.co.uk [62.31.42.140]) by hub.freebsd.org (Postfix) with ESMTP id 89B4F37B407 for ; Fri, 17 Aug 2001 01:21:06 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id f7H8CUJ59353; Fri, 17 Aug 2001 09:12:30 +0100 (BST) (envelope-from nik) Date: Fri, 17 Aug 2001 09:12:30 +0100 From: Nik Clayton To: John Murphy Cc: doc@freebsd.org Subject: Re: Message-ID: <20010817091230.A59279@clan.nothing-going-on.org> References: Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="a8Wt8u1KmwUX3Y2C" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: ; from jfm@blueyonder.co.uk on Fri, Aug 17, 2001 at 01:16:13AM +0100 Organization: FreeBSD Project 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 --a8Wt8u1KmwUX3Y2C Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable 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 :) >=20 > 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 par= t of > the final process. Else I could easily acronymize (sorry), the occurrenc= es I find. >=20 > 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 N= ux!) An acronym is anything formed from (typically the initial) letters from a phrase. 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= =20 this. My personal opinion is that we have, through general usage, evolved= =20 a core set of elements that we use in the documentation -- things like=20 , , , the &man.foo.x; entities, and so on.= =20 If a document is submitted that doesn't use these elements where appropriat= e=20 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 --=20 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 --- --a8Wt8u1KmwUX3Y2C Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjt80e4ACgkQk6gHZCw343UYFgCdHdUVm4NYZJMw9cdLFX/z5cXB vsQAoIbqhHQoc9OPpx+IGVFtQkYPs9rN =L5K8 -----END PGP SIGNATURE----- --a8Wt8u1KmwUX3Y2C-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message