svn commit: r40194 - projects/entities/share/xml

[René Ladan]

On 30-11-2012 14:56, Eitan Adler wrote:
> On 30 November 2012 06:53, Rene Ladan <rene at freebsd.org> wrote:
>> Author: rene
>> Date: Fri Nov 30 11:53:51 2012
>> New Revision: 40194
>> URL: http://svnweb.freebsd.org/changeset/doc/40194
>>
>> Log:
>>   - Merge content from developers.ent, notably these hat definitions:
>>     - bugmeister, core, doceng, donations, portmgr, re, so
>>   - Add entities for the following persons, gathered from the tree:
>>     arundel, babb, bhaga, deb, ds, jkb, kuku, matt, tweten, wolf (name and email)
>>     mkm, joe.halpin, pavalos, jwojdacki (name only)
>>
>>   To avoid conflicts between &a.committer; from this file (with email address)
>>   and &a.committer; from developers.ent, restructure the definitions:
>>   - &a.committer; is now defined as the committers' name only
>>   - &a.committer.email; is defined as the committers' name and email address
> Maybe it makes sense to do
> &a.committer.name; - just the name
> &a.committer.email; - just the email
> &a.committer &a.committer.name; &a.committer.email;
>
> or is there never a reason to use just the email address?
Tradition I'd say.  Currently email addresses are not used stand-alone
in the documentation.  See
http://lists.freebsd.org/pipermail/freebsd-doc/2012-November/020720.html
for the history of this
scheme.  Your suggestion would reduce the amount of changes in books/
and articlces/ but would
increase the amount of changes in htdocs/ (and clearly authors.ent would
need another overhaul).

René