authors.ent and developers.ent ?

[Glen Barber]

On Sun, Nov 04, 2012 at 12:57:43AM +0100, René Ladan wrote:
> Hi,
> 
> author entities are defined both in authors.ent (with email address) and 
> developers.ent (without email address). The latter is used in e.g. 
> htdocs/administration.xml, resulting in cumbersome lines like
> 
>   <li>&a.name; <<a 
> href="mailto:name at FreeBSD.org">name at FreeBSD.org</a>></li>
> 
> where just
> 
> <li>&a.name;</li> would be clearer.
> 
> So would there be some way to merge these two files (both docbook-wise 
> and content-wise) to avoid having to maintain two files and avoiding 
> cumbersome lines?
> 

I'm a bit baffled by this, to be honest.

Perhaps we can merge these files together, and have each developer
entity consist of two lines, one for name only, one for name + email?

Something like this, maybe?

 <!ENTITY a.gjb.name "Glen Barber">
 <!ENTITY a.gjb.email "&a.gjb.name <email>gjb at FreeBSD.org</email>">

This would allow us to keep the current multi-format entries, and
consolidate them into one file.

Thoughts?

Glen

PS:  That idea is conceptual, I haven't actually tried this change.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 488 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20121104/8590b555/attachment.sig>