Date: Tue, 11 Feb 2003 12:47:52 -0800 From: "Bruce A. Mah" <bmah@FreeBSD.org> To: Tom Rhodes <trhodes@FreeBSD.org> Cc: "Bruce A. Mah" <bmah@FreeBSD.org>, doc@FreeBSD.org Subject: Re: Documenting FreeBSD Officers, Hats, and Working Groups Message-ID: <20030211204752.GA22890@intruder.bmah.org> In-Reply-To: <20030209045440.2ac4aa62.trhodes@FreeBSD.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>
next in thread | previous in thread | raw e-mail | index | archive | help
--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" <bmah@FreeBSD.ORG> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030211204752.GA22890>