From owner-freebsd-doc@FreeBSD.ORG Wed Nov 28 10:37:48 2012 Return-Path: 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 F41F862E; Wed, 28 Nov 2012 10:37:47 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from mail-lb0-f182.google.com (mail-lb0-f182.google.com [209.85.217.182]) by mx1.freebsd.org (Postfix) with ESMTP id 2DFC98FC14; Wed, 28 Nov 2012 10:37:46 +0000 (UTC) Received: by mail-lb0-f182.google.com with SMTP id go10so10271487lbb.13 for ; Wed, 28 Nov 2012 02:37:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding; bh=H5puU/jqrKW0Ckfykz4PMTVTN/wBnEDhAuceIyre4Xw=; b=deb5XSAcDNqWMAjn3C2bTSOTebGfgk+hLXJPceWjQaw/UYyX5HVDwmrC7VKMzyAdO4 jfPqv5Hx6EgYfpSdFvR8TcM4HqXXdbns5Gl9tPg3s3PEjaxSMKYAESSRpvYKqsOjs3U5 7s7Wo9LojI7Hd2ME+WbautlrHA/jB524/VZ5WibQBV7lOwFrlFlipqtD2Zc+2KqiV30J kbbnsu1WYknTk+nW9pDq1B2m4DZBfnAvlpkw2VDNJD2OvFlEexbJL2/LuoOVYNeJCGSe cwEK4SrJC7VD2NsCGwklPxegZPJkrPSVXaE1ixLoc1s1rVd/55GSAM1QECzPdwpkY8zz NdLA== Received: by 10.112.13.139 with SMTP id h11mr7601275lbc.99.1354099065669; Wed, 28 Nov 2012 02:37:45 -0800 (PST) Received: from ?IPv6:2001:980:d7ed:1:c521:a3f5:b505:8a2a? ([2001:980:d7ed:1:c521:a3f5:b505:8a2a]) by mx.google.com with ESMTPS id ly18sm7845248lab.15.2012.11.28.02.37.43 (version=SSLv3 cipher=OTHER); Wed, 28 Nov 2012 02:37:44 -0800 (PST) Sender: =?UTF-8?Q?Ren=C3=A9_Ladan?= Message-ID: <50B5E975.5090601@freebsd.org> Date: Wed, 28 Nov 2012 11:37:41 +0100 From: =?ISO-8859-1?Q?Ren=E9_Ladan?= User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:17.0) Gecko/17.0 Thunderbird/17.0 MIME-Version: 1.0 To: Glen Barber Subject: Re: [RFC] (partial) patch to clean up authors.ent / developers.ent duplication References: <50B52AAD.7030004@freebsd.org> <20121128000000.GA1303@glenbarber.us> In-Reply-To: <20121128000000.GA1303@glenbarber.us> X-Enigmail-Version: 1.4.6 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 8bit Cc: FBSD Doc project X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 28 Nov 2012 10:37:48 -0000 -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 28-11-2012 01:00, Glen Barber wrote: > Hi, > > [Disclaimer: I have not yet looked at the patch.] > Most of it is mechanical. > On Tue, Nov 27, 2012 at 10:03:41PM +0100, René Ladan wrote: >> Hi, >> >> we currently have two files in our documentation tree for >> committer entries (i.e., &a.committer-name; ): >> share/xml/authors.ent and share/xml/developers.ent, as indicated >> at [1]. Worse, in authors.ent the entities have an email address >> included hile in developers.ent they do not. I have a (partial) >> patch at [2] to merge these two files and unify the meaning of >> these entities. Currently it: >> > > [...] > > All of your proposed changes sound very good to me. > >> Questions: - Maybe this should go in a branch first (especially >> when it is decided to include the translations)? > > My (personal) preference would be to do this in a project branch. > Then we can worry about what to do about translated documents, > contingent on if untouched translations contribute to build > breakages. > OK, I'll see if I can split the patch into more manageable smaller commits. >> - There is no ds@ , although the current documentation somewhat >> suggests he has an account? > > He has an email account, but not a login account (if I remember > correctly). For his case, we can hard-code a ds@ email, if > needed. > I'll add him to authors.ent. >> - The 2005 and 2006 editions of the Summer of Code pages include >> email addresses, while the 2007 and 2008 versions do not? >> > > Hmm.. No idea about this part. > It could be just choice, but anyway now that email addresses will be explicit it might be a good time to go through the articles and books to see if we want email addresses in running text or just names. > Thanks very much for starting this. > > Unless there is objection from anyone, please feel free to create > a projects branch for these changes. > Which triggers some questions: - - is projects/ open for normal committers? - - what would be a suitable name? "entities" comes to mind, in which we could also do a "FreeBSD" -> "&os;" sweep later. - - since I do not have a full doc bit, do I need approval for every commit to projects/ (and at some point the final merge) ? René -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.19 (FreeBSD) Comment: Using GnuPG with undefined - http://www.enigmail.net/ iQIcBAEBAgAGBQJQtel1AAoJEK27+GEKN4m3yAUP/jYSv3BuMBHhHnaz3Q+2p45c WSqexgUN7/arn0mRUyDTvmSUn2gGegAXNMwGo7qwWHcfweCHSvQC7YFa1QBIgYU/ pw6l2DgKuNEkPReNT/htNL4dWnj8RThb76YIPSkJQzQf6J2eIA2I7liQ5kv7mqAj VuDy7iTB9fL2qDgYliHloiIzTAM4WOqy/cKL7jLd2tg4g1gmpuCCk8XXMhsBNeV4 le2BwpwsLeubPmUn0U5coNJUR1E1aArlZu++kbAC48hlTwk2K2hjYluHB/zQ1KqL GhY003+E1ZTxXurAI3KgFCKlOTybhGtPcjoqtYqFW/PgRj4nmyxb1ADjrDuCeK/5 LWM86TBFttB7vAIZwU0+rcgCKdAASsUEJJn+9PjD1+5EwYGtYExouJsej6aCZHze jZMlt6aqcm07J8Fzg+04duxmwKxE3gH2TmiSvW5SMQyAv9Cx70t/EYLU+YFqPQ6n Rgi3HPZo6cZWoy43p4G4N6CUXWdatB/O4ufKYQP1WdOuF80uY0D9nTUbdkT0oQuk SBxR8YE0jLZtwAIs3/9hOEKsJ6qoesVpe8rn4VXHQFyjcGkEWearJxhnxB2JN3CS MPotsm6GrVJm8HfRC+Oxic2jxt3RYst7s5fK1+GsCBc29+9eVgGSVhgYROUfT6wd F0fVeDq6QWaEUjyC1LJg =PAvd -----END PGP SIGNATURE-----