[gentoo-dev] Misc questions on ebuilds

[gentoo-dev] Misc questions on ebuilds

[Keith Gross]

I'm trying to improve the ebuilds I've been writing by reviewing the existing 
ebuilds but there seems they very widely.  Everything from simple somewhat 
crude examples that looksomething like my efforts to other that are much 
larger and elaborate.

I'm wondering if someone with more experience might have a couple of ebuilds 
they're particularly proud of that perhaps would make examples?  I'd hate to 
perpetuate practices that are no longer the proper way of doing things.

I was also wondering if portage has a standard method of specifying a menu 
item or complete menu that should be created when the package is installed 
that would work for multiple different desktop environments.

Re: [gentoo-dev] Misc questions on ebuilds

[Brandon Low]

Have you used the "lintool" script that comes with gentoolkit?  It is a 
nice tool which checks for most common ebuilding mistakes...

On Fri, 06/14/02 at 22:21:59 -0500, Keith Gross wrote:
> I'm trying to improve the ebuilds I've been writing by reviewing the existing 
> ebuilds but there seems they very widely.  Everything from simple somewhat 
> crude examples that looksomething like my efforts to other that are much 
> larger and elaborate.
> 
> I'm wondering if someone with more experience might have a couple of ebuilds 
> they're particularly proud of that perhaps would make examples?  I'd hate to 
> perpetuate practices that are no longer the proper way of doing things.
> 
> I was also wondering if portage has a standard method of specifying a menu 
> item or complete menu that should be created when the package is installed 
> that would work for multiple different desktop environments.
> _______________________________________________
> gentoo-dev mailing list
> gentoo-dev@gentoo.org
> http://lists.gentoo.org/mailman/listinfo/gentoo-dev

[gentoo-dev] Re: Misc questions on ebuilds

[Mark Gordon]

On Fri, 14 Jun 2002 22:56:29 -0500, Brandon Low <lostlogic@gentoo.org>
wrote:

>Have you used the "lintool" script that comes with gentoolkit?  It is a 
>nice tool which checks for most common ebuilding mistakes...

Some questions about that. Looking at skel.ebuild I thought that
RDEPEND did not need to be defined since it would default to DEPEND,
yet lintool considers not defining it an error.

Is it considered better to allow things to default when the documented
defaults are correct or to explicitly define everything, in which case
I would have thought the skel.ebuild should tell you the normal values
but not say they are defaults for when items are not specified.

I've already submitted one ebuild and hope to submit more, so I want
to get them as 'correct' as possible.
-- 
Mark Gordon

Re: [gentoo-dev] Re: Misc questions on ebuilds

[Brandon Low]

The current policy is to explicitly define everything as lintool asks...
for many/most ebuilds RDEPEND="${DEPEND}" works for now... SLOT is 
semi-optional, but for a new package, just make it SLOT="0" for 
consistency...

--Brandon

On Sat, 06/15/02 at 20:53:04 +0100, Mark Gordon wrote:
> On Fri, 14 Jun 2002 22:56:29 -0500, Brandon Low <lostlogic@gentoo.org>
> wrote:
> 
> >Have you used the "lintool" script that comes with gentoolkit?  It is a 
> >nice tool which checks for most common ebuilding mistakes...
> 
> Some questions about that. Looking at skel.ebuild I thought that
> RDEPEND did not need to be defined since it would default to DEPEND,
> yet lintool considers not defining it an error.
> 
> Is it considered better to allow things to default when the documented
> defaults are correct or to explicitly define everything, in which case
> I would have thought the skel.ebuild should tell you the normal values
> but not say they are defaults for when items are not specified.
> 
> I've already submitted one ebuild and hope to submit more, so I want
> to get them as 'correct' as possible.
> -- 
> Mark Gordon
> 
> 
> _______________________________________________
> gentoo-dev mailing list
> gentoo-dev@gentoo.org
> http://lists.gentoo.org/mailman/listinfo/gentoo-dev

Re: [gentoo-dev] Misc questions on ebuilds

[Marcelo Fontenele S Santos]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Saturday 15 June 2002 00:56, Brandon Low wrote:
> Have you used the "lintool" script that comes with gentoolkit?  It is a
> nice tool which checks for most common ebuilding mistakes...
>
> On Fri, 06/14/02 at 22:21:59 -0500, Keith Gross wrote:
> > I'm trying to improve the ebuilds I've been writing by reviewing the
> > existing ebuilds but there seems they very widely.  Everything from
> > simple somewhat crude examples that looksomething like my efforts to
> > other that are much larger and elaborate.

Hi,

I have some questions about lintool.

In the lintool man page it says that it checks for conformance with the ebuild 
style guide. I found a Gentoo Linux Developers HOWTO and the Eclass (OOP-like 
ebuild) HOWTO but no Style Guide. Where is it?

I also don't know what those errors mean:
- - Testing for malformed headers
- - Testing for presence of env vars

What is a malformed header? 
Or a wellformed? 
Is the one in skel.ebuild correct?

What is the error in using an env var inside an ebuild? 
How can/can't one be used?

If you run lintool on skel.ebuild it gives:

/usr/portage/skel.ebuild                                               : Not 
OK

- -------------------------------------------------------------------------------
 Summary for all 1 ebuild(s) checked                             # 
errors/warns
- -------------------------------------------------------------------------------
Testing for illegal space characters, weird backslash formatting  : 0 / 0
Testing for malformed headers                                     : 0 / 1
Testing for occurence of deprecated try                           : 0 / 0
Testing for superfluous A=${P}.tar.gz                             : 0 / 0
Testing for empty DEPEND                                          : 0 / 1
Testing for empty HOMEPAGE                                        : 0 / 0
Testing for empty DESCRIPTION                                     : 0 / 0
Testing for presence of env vars                                  : 1 / 1
Testing for sane USE flag usage                                   : 0 / 0

Total number of ebuilds with errors                               : 1 (100%)
Total number of ebuilds with warnings                             : 1 (100%)

Thanks,
- -- 
Marcelo Fontenele S Santos<msantos@pobox.com>

ICQ# 2103731
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (GNU/Linux)

iD8DBQE9DNu0CBYGr8x5oV8RAl54AJ0RIoZIWwewBsUcd1h62Hjge3PrewCdHitS
7+TW6Yw1t0X8G0X2r+uffeA=
=CcxG
-----END PGP SIGNATURE-----