1 |
-----BEGIN PGP SIGNED MESSAGE----- |
2 |
Hash: SHA1 |
3 |
|
4 |
On Tue, 29 Apr 2003 11:17:13 -0700 |
5 |
"Robin H.Johnson" <robbat2@g.o> wrote: |
6 |
|
7 |
|
8 |
> lintool/repoman do remind you that some of those are required, but for |
9 |
> the most part they require a human to check. The original ebuild |
10 |
|
11 |
I've found lintool useful. Though it does complain sometimes if you |
12 |
omit a tag as it wont be used or if you comment it out. RDEPEND I think |
13 |
is one it made some complaint on so admittedly I forgot to re comment it |
14 |
out on my template I use so I have to go check later and make sure all |
15 |
my older ebuilds again comment it out. |
16 |
|
17 |
> looked as if it was written using only the guide, and none of the |
18 |
> existing ebuilds in portage, many of which server as excellent |
19 |
> examples of ebuild style and how things are done. |
20 |
|
21 |
My first ebuild or two was only using the guide or peaking at some |
22 |
existing ebuilds. Then I found "man 5 ebuild" alot more useful as it |
23 |
listed more things I seemed to need to use. But I was unaware that that |
24 |
particular man page existed til someone pointed it out to me. |
25 |
|
26 |
> However you are partially correct that some of this should be added to |
27 |
> [1]. |
28 |
> most importantly, |
29 |
> - say required items SLOT/KEYWORDS/IUSE/HOMEPAGE |
30 |
> - say that all documentation should be installed |
31 |
|
32 |
Yes that doccumention comment is important. For example I had no clue |
33 |
what should be added that way at first. Til again someone pointed it |
34 |
out. I was unsure if the "README" etc that comes with a tar should be |
35 |
in there. As for the slots I understand their usage however I'm unsure |
36 |
as to if new ebuilds that have no priors for that software if they need |
37 |
a slot number or should just stay at "0". Personally I've left them at |
38 |
"0" as I've seen no other ebuild for them. I get the keyword use good |
39 |
enough for the homepages tho some things don't have them and I've had to |
40 |
resort to using source forge project page or freshmeat info page. |
41 |
|
42 |
> - recommend econf/emake/einstall instead of normal variants |
43 |
> - patch+src_unpack is not efficent and maybe incorrect, use |
44 |
> PATCHES="..." |
45 |
|
46 |
I do like the comments in the skel ebuild for pointing out that emake |
47 |
and einstall don't work for everything. I've had builds fail and found |
48 |
out that I just had to switch that then they were fine. As for the |
49 |
patch yes I have no clue how to do that so that has stopped me from |
50 |
trying to make the odd thing. Also I'm unsure as to how to make an |
51 |
ebuild fetch secondary packages other than listing them as depends and |
52 |
then writing ebuilds for those items. I'd like to make an ebuild for a |
53 |
ham radio quiz program for those wanting to write their license but for |
54 |
example if I do it requires I fetch a group of text files from the arrl |
55 |
site. The perl script that generates the quizes needs those texts to |
56 |
make the questions. I grasp how to make the ebuild for the perl script |
57 |
for the most part but not how to make that ebuild grab those files and |
58 |
shift them to where it's needed. I'm guessing I'd have to put a symlink |
59 |
in the /usr/bin for the script and have the script and the text files in |
60 |
a /usr/share/<dir> |
61 |
|
62 |
> Some of the things I mentioned are also partially my personal |
63 |
> preferences to make life easier on myself. People's code says a lot |
64 |
> about them generally, and if your submitted ebuilds look sloppy and |
65 |
> that lessens the chance that developers will even go thru them and |
66 |
> say what is wrong, let along clean them up. |
67 |
|
68 |
Yes but one point is a person wouldn't have a clue if it's sloppy or not |
69 |
if someone doesn't say why and make a suggestion. Though I've found so |
70 |
far people have nicely done that for me. They've not been nasty and put |
71 |
me off making ebuilds frankly they were reasonably encouraging and just |
72 |
pointed out things I'd missed. Which I felt bad about some were |
73 |
probably dumb errors at the time but we all have lives outside our boxes |
74 |
and sometimes that gets in the way for a moment or two.(I myself have a |
75 |
special needs child to take care of, am busy with divorce stuff, about |
76 |
to have surgery in about a month, and dealing with a variety of other |
77 |
things... so occasionally I miss things. I do know people have quite |
78 |
the work load and are doing it voluntarily here so I do honestly feel |
79 |
bad if I've needlessly added to that. But usually I get told it once or |
80 |
twice... I've taken the hint..) |
81 |
|
82 |
|
83 |
> Repoman replaced lintool. I don't unfortunetly know of a tool that |
84 |
> users can use to check ebuilds themselves, as repoman requires a CVS |
85 |
> checkout. I have said previously that lintool needs to come back |
86 |
> myself, and I have submitted some fixes for it to bugzilla myself. |
87 |
> That document [2] does appear to contradict itself. |
88 |
|
89 |
lintool is still there. I know as I use it. But it does complain on |
90 |
odd things it probably shouldn't. Not sure the full spectrum of what it |
91 |
will complain about but on "lintool ebuild <path to ebuild>" I've had it |
92 |
complain about tags that wont be used that I've either commented out or |
93 |
just not put in. But now I've learned it does that and I've got just |
94 |
enough experience that most ebuilds are straight forward and if it fails |
95 |
when I'm using it I check it further with lintool or start asking |
96 |
questions. |
97 |
|
98 |
> I personally try to avoid packages that do not fill at least one of |
99 |
> the following requirements: |
100 |
> 1) is actively maintained |
101 |
> 2) is widely used |
102 |
> 3) not directly useful to myself |
103 |
|
104 |
I think that is a given for most people. Except in my case if it looks |
105 |
intresting/that it might be useful in the long run(even if it's not |
106 |
personally useful to me) I may give it a try and check it out on gentoo |
107 |
stable to help pass on stability, etc info to help it maybe get bumped |
108 |
into portage. |
109 |
|
110 |
- -- |
111 |
|
112 |
Susie |
113 |
arienadean@××××.ca |
114 |
http://arienadean.tripod.com/ |
115 |
|
116 |
Digitally signed |
117 |
GPG Key ID: E93F0D23 |
118 |
Key fingerprint = 33F8 0E9D 3AD1 23E0 C70F ECC6 7871 D811 E93F 0D23 |
119 |
|
120 |
- ----------------------------------------------------------------------- |
121 |
|
122 |
"Science is everything we understand well enough to explain to a |
123 |
computer. Art is everything else." - David Knuth |
124 |
|
125 |
|
126 |
|
127 |
-----BEGIN PGP SIGNATURE----- |
128 |
Version: GnuPG v1.2.1 (GNU/Linux) |
129 |
|
130 |
iD8DBQE+ruqIeHHYEek/DSMRAicIAKCTEbm5bM2IZnf1JpHajWHAkV+E9wCfUIHt |
131 |
z958tQXCSA33RXKWWYToD3s= |
132 |
=rshx |
133 |
-----END PGP SIGNATURE----- |
134 |
|
135 |
-- |
136 |
gentoo-dev@g.o mailing list |