Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 04 Nov 2012 19:16:36 +0100
From:      =?ISO-8859-1?Q?Ren=E9_Ladan?= <rene@freebsd.org>
To:        Glen Barber <gjb@FreeBSD.org>
Cc:        FBSD Doc project <doc@FreeBSD.org>
Subject:   Re: authors.ent and developers.ent ?
Message-ID:  <5096B104.1030602@freebsd.org>
In-Reply-To: <20121104174938.GD1343@glenbarber.us>
References:  <5095AF77.2070908@freebsd.org> <20121104165934.GB1343@glenbarber.us> <5096A354.9070701@freebsd.org> <20121104174938.GD1343@glenbarber.us>

next in thread | previous in thread | raw e-mail | index | archive | help
On 04-11-2012 18:49, Glen Barber wrote:
> 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; &lt;<a
>>>> href="mailto:name@FreeBSD.org">name@FreeBSD.org</a>&gt;</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.  :-)
OK :-)
>>> 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@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; &lt;<a
>> href=mailto:rene@FreeBSD.org">rene@FreeBSD.org</a>&gt;">
>>
> Would this be necessary?  I think this is handled automatically by the
> <email> tag we already use.
That would even be better of course.

René




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?5096B104.1030602>