From owner-freebsd-doc@FreeBSD.ORG  Sun May 16 12:31:50 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 6E4E416A55D; Sun, 16 May 2004 12:31:50 -0700 (PDT)
Received: from shaft.techsupport.co.uk (shaft.techsupport.co.uk
	[212.250.77.214])	by mx1.FreeBSD.org (Postfix) with ESMTP
	id E577243D1F; Sun, 16 May 2004 12:31:49 -0700 (PDT)
	(envelope-from setantae@submonkey.net)
Received: from cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com
	([81.103.67.204] helo=shrike.submonkey.net ident=mailnull)
	by shaft.techsupport.co.uk with esmtp (TLSv1:DHE-RSA-AES256-SHA:256)
	(Exim 4.34; FreeBSD)
	id 1BPRMS-000Cob-MW; Sun, 16 May 2004 20:31:48 +0100
Received: from setantae by shrike.submonkey.net with local (Exim 4.34;
	FreeBSD)	id 1BPRMQ-000GO2-CN; Sun, 16 May 2004 20:31:46 +0100
Date: Sun, 16 May 2004 20:31:46 +0100
From: Ceri Davies <ceri@submonkey.net>
To: Josef El-Rayes <josef@FreeBSD.org>
Message-ID: <20040516193146.GH1518@submonkey.net>
Mail-Followup-To: Ceri Davies <ceri@submonkey.net>,
	Josef El-Rayes <josef@FreeBSD.org>, freebsd-doc@freebsd.org
References: <20040516175705.GA577@jenny.daemon.li>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="yZnyZsPjQYjG7xG7"
Content-Disposition: inline
In-Reply-To: <20040516175705.GA577@jenny.daemon.li>
X-PGP: finger ceri@FreeBSD.org
User-Agent: Mutt/1.5.4i
Sender: Ceri Davies <setantae@submonkey.net>
cc: freebsd-doc@freebsd.org
Subject: Re: standardize the authors line
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/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, 16 May 2004 19:31:50 -0000


--yZnyZsPjQYjG7xG7
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Sun, May 16, 2004 at 07:57:05PM +0200, Josef El-Rayes wrote:
> hi friends!
>=20
> as i am reading through the developers and arch handbook
> i noticed that there is no common way the contributor line
> looks:
>=20
> - This chapter was written by Murray Stokely and Jeroen Ruigrok van der W=
erven.
> - This chapter was written by Murray Stokely <murray@FreeBSD.org>.
> - Contributed by Poul-Henning Kamp <phk@FreeBSD.org>.
> - John Baldwin and Robert Watson. Copyright ? 2002, 2003 John BaldwinRobe=
rt Watson
> - Contributed by Matthew Dillon.
> - Chris Costello and Robert Watson.
>=20
> somethimes there is a preceeding "contributed by" or a "this was written =
by"
> sometimes there is a copyright statement, sometimes not, sometimes there =
is an
> email adress, sometimes not.
>=20
> i would like to change it to a common:
> =20
> Contributed by Bla Blabla <bla@FreeBSD.org> and Foo Foofoo <foo@FreeBSD.o=
rg>
>=20
> what do you think about this?

If we were using authorgroup markup on sections like we should, then
this situation couldn't arise.  I'd suggest synchronising these up by
migrating that way.

Ceri
--=20

--yZnyZsPjQYjG7xG7
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (FreeBSD)

iD8DBQFAp8GiocfcwTS3JF8RAq2/AKCYW0yxdirvFc83l/CKCNwdRk4ICQCgjvSN
vRS2IvpW8ESQ3zEUPpVpa6c=
=9N6X
-----END PGP SIGNATURE-----

--yZnyZsPjQYjG7xG7--