authors.ent and developers.ent ?

[Glen Barber]

On Sun, Nov 04, 2012 at 06:18:12PM +0100, René Ladan wrote:
> On 04-11-2012 17:59, Glen Barber wrote:
> > 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.
> Oops..

To clarify, I mean I am baffled by having two files that have very
similar purposes, not your email.  :-)

> > 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?
> That would be a start. What about an defining a third entity (not sure 
> about the name...)
> 
> <!ENTITY a.rene.hrefmail "&a.rene.name; <<a 
> href=mailto:rene at FreeBSD.org">rene at FreeBSD.org</a>>">
> 

Would this be necessary?  I think this is handled automatically by the
<email> tag we already use.

Glen

-------------- 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/84dddcd9/attachment.sig>