Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 04 Nov 2012 18:18:12 +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:  <5096A354.9070701@freebsd.org>
In-Reply-To: <20121104165934.GB1343@glenbarber.us>
References:  <5095AF77.2070908@freebsd.org> <20121104165934.GB1343@glenbarber.us>

next in thread | previous in thread | raw e-mail | index | archive | help
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..
> 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;">

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é



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