From owner-freebsd-doc Tue Feb 11 12:47:58 2003 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 3F04137B401; Tue, 11 Feb 2003 12:47:55 -0800 (PST) Received: from sccrmhc03.attbi.com (sccrmhc03.attbi.com [204.127.202.63]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1AF6B43FAF; Tue, 11 Feb 2003 12:47:54 -0800 (PST) (envelope-from bmah@employees.org) Received: from bmah.dyndns.org (12-240-204-110.client.attbi.com[12.240.204.110]) by sccrmhc03.attbi.com (sccrmhc03) with ESMTP id <2003021120475300300k0sd3e>; Tue, 11 Feb 2003 20:47:53 +0000 Received: from intruder.bmah.org (localhost [IPv6:::1]) by bmah.dyndns.org (8.12.6/8.12.6) with ESMTP id h1BKlqRG022943; Tue, 11 Feb 2003 12:47:52 -0800 (PST) (envelope-from bmah@intruder.bmah.org) Received: (from bmah@localhost) by intruder.bmah.org (8.12.6/8.12.6/Submit) id h1BKlqFp022942; Tue, 11 Feb 2003 12:47:52 -0800 (PST) (envelope-from bmah) Date: Tue, 11 Feb 2003 12:47:52 -0800 From: "Bruce A. Mah" To: Tom Rhodes Cc: "Bruce A. Mah" , doc@FreeBSD.org Subject: Re: Documenting FreeBSD Officers, Hats, and Working Groups Message-ID: <20030211204752.GA22890@intruder.bmah.org> References: <20030206221455.GC17028@submonkey.net> <20030206174120.0075fcd5.trhodes@FreeBSD.org> <20030206230229.GD18106@submonkey.net> <20030206184047.4b08943a.trhodes@FreeBSD.org> <20030207005155.GA67667@intruder.bmah.org> <20030206202110.76ae4e7e.trhodes@FreeBSD.org> <20030207013803.GA68113@intruder.bmah.org> <20030206205228.42486a38.trhodes@FreeBSD.org> <20030209021707.GA94205@intruder.bmah.org> <20030209045440.2ac4aa62.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="3V7upXqbjpZ4EhLz" Content-Disposition: inline In-Reply-To: <20030209045440.2ac4aa62.trhodes@FreeBSD.org> User-Agent: Mutt/1.4i X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-url: http://www.employees.org/~bmah/ 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 --3V7upXqbjpZ4EhLz Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable If memory serves me right, Tom Rhodes wrote: > On Sat, 8 Feb 2003 18:17:07 -0800 > "Bruce A. Mah" wrote: > > 1. Why is your entity definition file called "hats.ent" and not > > "hats.sgml"? File defining entities in the www/ tree seem to have > > *.sgml extensions (see developers.sgml). I tried to ask you this in a > > prior message, but apparently I didn't ask very clearly. >=20 > Well, because it is not really an sgml file, and isn't really anything > like developers.sgml and includes.sgml. It's not? Are we looking at the same file? I'm saying that the function and structure of www/en/developers.sgml and www/en/hats.ent are very similar. (I'm pushing for following the existing naming convention even though it may or may not be correct.) > If this is a large deal, I'll > fix by either a repcopy or cvs add/remove. Hmmm. Not calling for that...still trying to understand the Grand Scheme o' Things here. > > 2. Why did you define b.* entities for names of developers, rather > > than use the existing a.* entities defined in developers.sgml? (Yes, > > I know you added links to email addresses, but you could easily add > > that to the existing entities too.) >=20 > I did this for two reasons: >=20 > 1: So developers would not get confused and/or it can be used with > the developers.sgml and cause no problems. I think it's way more confusing to define very similar entities for developers in two different files. > 2: I could have added email addresses to the developers.sgml file but > then I'm either going to mess up several tables throughout the www/ > tree (ie: the tables will expand beyond a resonable limit.) Along > with putting people through alot of work when they add developers, > some people may just want names. I hope this is ok. I think there should be exactly one file that defines the developer entities. If somebody wants his/her email address listed in her entity, he/she can add it in *that* one file. If It Were Up To Me: I'd get rid of all the "Hat Owners" in hats.ent, and make all of the other entities refer to the &a.* entities that are already defined in developers.sgml. [snip] > > PS. OK, this one *is* a criticism. Did you do a case-insensitive > > search-and-replace to change "a." to "b."? If so, consider that=20 > > "a." (or "A.") occurs in other places than entity names. Ahem. :-) > >=20 > >=20 >=20 > Nope. I tried to keep away from all the other entities, and to make > an attempt at keeping them less confusing. Anyway, its 5:00AM EST and > I'm going to sleep now. Enjoy! I'll go fix it myself in a minute. It'll be obvious. :-) Bruce. --3V7upXqbjpZ4EhLz Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.0 (FreeBSD) iD8DBQE+SWF22MoxcVugUsMRAhWLAJ0dsq6+Y9s0h4/FWjo6LGIh8/8iUACg/ny3 JfHign0v8yXAXXH3YJuN0TY= =NFF6 -----END PGP SIGNATURE----- --3V7upXqbjpZ4EhLz-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message