authors.ent and developers.ent ?

René Ladan rene at freebsd.org
Sun Nov 4 17:18:17 UTC 2012


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..
> 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>>">

I think we could just leave &a.rene.name; as &a.rene; and adjust
&a.rene.email; and &a.rene.hrefmail; accordingly.

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

René


More information about the freebsd-doc mailing list