From owner-freebsd-doc@FreeBSD.ORG  Sun Nov  4 16:59:38 2012
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
 by hub.freebsd.org (Postfix) with ESMTP id ADA39289;
 Sun,  4 Nov 2012 16:59:38 +0000 (UTC) (envelope-from gjb@FreeBSD.org)
Received: from onyx.glenbarber.us (onyx.glenbarber.us
 [IPv6:2607:fc50:1000:c200::face])
 by mx1.freebsd.org (Postfix) with ESMTP id 77D428FC0C;
 Sun,  4 Nov 2012 16:59:38 +0000 (UTC)
Received: from glenbarber.us (unknown [IPv6:2001:470:8:1205:2:2:0:100])
 (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
 (No client certificate requested) (Authenticated sender: gjb)
 by onyx.glenbarber.us (Postfix) with ESMTPSA id 5F29723F645;
 Sun,  4 Nov 2012 11:59:37 -0500 (EST)
Date: Sun, 4 Nov 2012 11:59:34 -0500
From: Glen Barber <gjb@FreeBSD.org>
To: =?iso-8859-1?Q?Ren=E9?= Ladan <rene@freebsd.org>
Subject: Re: authors.ent and developers.ent ?
Message-ID: <20121104165934.GB1343@glenbarber.us>
References: <5095AF77.2070908@freebsd.org>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
 protocol="application/pgp-signature"; boundary="UHN/qo2QbUvPLonB"
Content-Disposition: inline
In-Reply-To: <5095AF77.2070908@freebsd.org>
X-Operating-System: FreeBSD 10.0-CURRENT amd64
User-Agent: Mutt/1.5.21 (2010-09-15)
Cc: FBSD Doc project <doc@FreeBSD.org>
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 04 Nov 2012 16:59:38 -0000


--UHN/qo2QbUvPLonB
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

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

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


--UHN/qo2QbUvPLonB
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.19 (FreeBSD)

iQEcBAEBCAAGBQJQlp72AAoJEFJPDDeguUaju48H/jVDepFjZ7flPTmhiPp5AFMi
q2IfW8lIk4kIwbi5vgs8x7gYcWjYvavySssUXWCwJ2bxcYD1YSkO85qa1emT/F/t
W2ZmTbmvrAFzKBLhHcgCDdHgxCwaaWWC/5qQzmvyEMPHB0aOfEcdKx4BDfuNET2d
uJp+uA/vTjo9acAhI1Hf7pvB4ocpOux9KLfLEhQERJmWzvxFwEi5CproYrRRzvEO
YgApaCFo4et6bgI9p+uCF0LHUoh7ZAq73jDsB9XkV13zeOBUu8zPwCe3Ww9JlZPp
7ivRJb5gMcqMSDHKyfJuXIPrLO99KUAckEnMeDIp7r8DleQPojDfRU2UlqjaHBw=
=cMri
-----END PGP SIGNATURE-----

--UHN/qo2QbUvPLonB--