Doug Goldstein kirjoitti:
All,

Here's a GLEP for the addition of USE flag descriptions to package metadata. It does not address any future ideas that others may have had or suggested. It merely gives developers the necessary "tools" to document their USE flag usage it better detail on a per package basis.

An clearly motivation explanation that I didn't add, which I'm going to add once I send this is the fact that as per the QA Project, use.local.desc can not contain a USE flag that already appears globally in use.desc. This would allow a description for that USE flag to be contained in the metadata.

http://www.gentoo.org/proj/en/glep/glep-0056.html

I encourage any and all _technical_ feedback.

Thanks.

As asked in the last council meeting here are my thoughts.

1. Rather than linking to the PMS repo it should refer to the devmanual on CPV http://devmanual.gentoo.org/ebuild-writing/file-format/index.html

2. "Each <flag> XML tag requires a 'name' attribute which is the full USE flag name as it would appear in the IUSE section of the ebuild."

Shouldn't this rather be as it appears. If the use flag is not used in all versions I would rather see that the

3. It should clarify the meaning of the pkg and cat tags as links to other places in the tree. IMHO it doesn't hurt to be explicit.

Regards,
Petteri

Attachment: signature.asc
Description: OpenPGP digital signature

Reply via email to