[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add the re
From: |
Ludovic Courtès |
Subject: |
Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add the related procedures. |
Date: |
Tue, 26 Mar 2013 22:02:14 +0100 |
User-agent: |
Gnus/5.130005 (Ma Gnus v0.5) Emacs/24.2 (gnu/linux) |
Nikita Karetnikov <address@hidden> skribis:
>>> I noticed that 'guile-gnome' has two 'doc-url' fields. How can I handle
>>> this? (I ignored it for now.)
>
>> I think it’s 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 ‘doc-urls’ (plural) and having 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’t need it for our purposes?
>> Never ever write ‘get-’ for getters. ;-) It provides no 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’s a shame! ;-)
Seriously, nobody uses that convention. The convention is really
‘employee-name’.
> What about 'set-' for setters?
We don’t use them in Guix. (The convention is ‘set-employee-name!’,
with an exclamation mark.)
Ludo’.
- Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add the related procedures., (continued)
- Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add the related procedures., Ludovic Courtès, 2013/03/22
- Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add the related procedures., Nikita Karetnikov, 2013/03/26
- Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add the related procedures., Ludovic Courtès, 2013/03/26
- Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add the related procedures., Nikita Karetnikov, 2013/03/26
- Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add the related procedures., Ludovic Courtès, 2013/03/26
- Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add the related procedures., Nikita Karetnikov, 2013/03/27
- Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add the related procedures., Ludovic Courtès, 2013/03/27
- Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add the related procedures., Nikita Karetnikov, 2013/03/26
- Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add the related procedures.,
Ludovic Courtès <=
- [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add related procedures., Nikita Karetnikov, 2013/03/27
- Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add related procedures., Ludovic Courtès, 2013/03/28
- Re: [PATCH] gnu-maintenance: Improve 'official-gnu-packages'; add related procedures., Nikita Karetnikov, 2013/03/28