From mboxrd@z Thu Jan  1 00:00:00 1970
From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=)
Subject: Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages';
	add the related procedures.
Date: Tue, 26 Mar 2013 22:02:14 +0100
Message-ID: <87ppylvprd.fsf@gnu.org>
References: <87obfchq38.fsf@karetnikov.org> <87sj4ok6sc.fsf@gnu.org>
	<87sj48gxzp.fsf_-_@karetnikov.org> <87lia09khe.fsf@gnu.org>
	<874ngbcfbl.fsf_-_@karetnikov.org> <87vc8rq6ol.fsf@gnu.org>
	<87hajxsx74.fsf@karetnikov.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([208.118.235.92]:40922)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1UKb0l-0001xO-7F
	for bug-guix@gnu.org; Tue, 26 Mar 2013 17:02:28 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1UKb0j-0004cI-VH
	for bug-guix@gnu.org; Tue, 26 Mar 2013 17:02:27 -0400
Received: from [2a01:e0b:1:123:ca0a:a9ff:fe03:271e] (port=42828
	helo=xanadu.aquilenet.fr) by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1UKb0j-0004b7-P1
	for bug-guix@gnu.org; Tue, 26 Mar 2013 17:02:25 -0400
In-Reply-To: <87hajxsx74.fsf@karetnikov.org> (Nikita Karetnikov's message of
	"Wed, 27 Mar 2013 00:49:51 +0400")
List-Id: Bug reports for GNU Guix <bug-guix.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-guix>
List-Post: <mailto:bug-guix@gnu.org>
List-Help: <mailto:bug-guix-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=subscribe>
Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org
Sender: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org
To: Nikita Karetnikov <nikita@karetnikov.org>
Cc: bug-guix@gnu.org

Nikita Karetnikov <nikita@karetnikov.org> skribis:

>>> I noticed that 'guile-gnome' has two 'doc-url' fields.  How can I handle
>>> this?  (I ignored it for now.)
>
>> I think it=E2=80=99s a mistake in this case (could you report it to Karl=
?).  It
>> seems safe to ignore.
>
> Karl said:
>
> "[...] In general doc-url can occur more than once.  I did that when a
> package has an overall documentation page and also many significant
> manuals.  Besides guile-gnome, emacs is a prime example.
>
> In theory, I guess logo: could be duplicated [too] in the event of a
> package having more than one logo, but in practice that has never
> happened.
>
> [...]
>
> I thought of another field that can be repeated, too: doc-shop.
> E.g., in libc."
>
> So, should we create another field for 'doc-url'?

What about calling that field =E2=80=98doc-urls=E2=80=99 (plural) and havin=
g it hold a
list of URLs?

> And what's the best way to handle 'doc-shop'?  Can we ignore it?

What is it?  Perhaps we don=E2=80=99t need it for our purposes?

>> Never ever write =E2=80=98get-=E2=80=99 for getters.  ;-)  It provides n=
o useful
>> information.  See <package> and other records, as examples.
>
> I know; it's easy to end up with something like:
>
>   getObject.getSetter.getString.getField()
>
> I found (name get-employee-name) in the manual and decided that it's a
> convention.

Argh, I just saw that, it=E2=80=99s a shame!  ;-)

Seriously, nobody uses that convention.  The convention is really
=E2=80=98employee-name=E2=80=99.

> What about 'set-' for setters?

We don=E2=80=99t use them in Guix.  (The convention is =E2=80=98set-employe=
e-name!=E2=80=99,
with an exclamation mark.)

Ludo=E2=80=99.