Gentoo Archives: gentoo-pms

From: Christian Faulhammer <fauli@g.o>
To: Ciaran McCreesh <ciaran.mccreesh@××××××××××.com>
Cc: gentoo-pms@l.g.o
Subject: Re: [gentoo-pms] Patches for your reviewing pleasure: Various improvements, including cheat sheet
Date: Mon, 13 Apr 2009 09:02:00
Message-Id: 20090413110148.17d9cd5f@terra.solaris
In Reply to: Re: [gentoo-pms] Patches for your reviewing pleasure: Various improvements, including cheat sheet by Ciaran McCreesh
1 Hi,
2
3 Ciaran McCreesh <ciaran.mccreesh@××××××××××.com>:
4 > > 0004: The complete new EAPI 3 aware cheat sheet.
5 >
6 > Some comments on this one:
7 >
8 > Is the subdirectory necessary? Seems a bit weird to have it for one
9 > thing.
10
11 In the long term we should move the chapter files into a "chapters"
12 subdirectory. I can create a patch for that.
13
14 > Can we make each item have the PMS label name for full details at the
15 > end of its paragraph? And add a new 'Other changes' item with the
16 > label names of other changes not described?
17
18 I wanted to add it when all labels for all EAPIs are ready.
19
20 > The 'pkg_pretend' description should probably tell developers to
21 > duplicate any checks done in pkg_setup.
22 > I've stopped using 'uninstalled' for pkg_info in favour of
23 > 'non-installed'. Think it's less confusing.
24 > 'must be defined' is a bit dodgy for RDEPEND. 'Unset RDEPEND not set
25 > to DEPEND' possibly.
26 > The slot operator deps should include the : before the symbol.
27 > Use dep defaults are in (+) and (-), not + or - on their own.
28 > I'd mention the switch for docompress.
29 > doins symlinks should say that it only works for -r. I probably need
30 > to update the summaries for that too.
31
32 Will work on those items.
33
34 > And some wording tinkering. Can cut the Abstract down to something
35 > like:
36
37 The long abstract was needed to fill the first page, it looked so
38 empty in the first version. So I will cut it down.
39
40 V-Li
41
42 --
43 Christian Faulhammer, Gentoo Lisp project
44 <URL:http://www.gentoo.org/proj/en/lisp/>, #gentoo-lisp on FreeNode
45
46 <URL:http://gentoo.faulhammer.org/>

Attachments

File name MIME type
signature.asc application/pgp-signature

Replies

Subject Author
Re: [gentoo-pms] Patches for your reviewing pleasure: Various improvements, including cheat sheet Ciaran McCreesh <ciaran.mccreesh@××××××××××.com>