Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 566178

Summary: Do not mention INSOPTIONS, DIROPTIONS, EXEOPTIONS, LIBOPTIONS
Product: Gentoo Hosted Projects Reporter: Michał Górny <mgorny>
Component: PMS/EAPIAssignee: PMS/EAPI <pms>
Status: RESOLVED FIXED    
Severity: normal    
Priority: Normal    
Version: unspecified   
Hardware: All   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---
Attachments: Do not mention various *OPTIONS variables.

Description Michał Górny archtester Gentoo Infrastructure gentoo-dev Security 2015-11-19 07:14:34 UTC
*DESTTREE variables are mentioned in helper descriptions and the variable table. *OPTIONS only in the former.

We should either ban them (remove them and refer via 'most recent call', like in dodoc, or make them 'conceptual'), or use them consistently for all helpers.
Comment 1 Ulrich Müller gentoo-dev 2015-11-19 07:27:49 UTC

*** This bug has been marked as a duplicate of bug 173630 ***
Comment 2 Ulrich Müller gentoo-dev 2015-11-19 10:01:19 UTC
Thinking about it, issues are different enough to deserve two bugs.

Using bug 173630 for DESTTREE and INSDESTTREE.
Reopening this bug for INSOPTIONS, DIROPTIONS, EXEOPTIONS, and LIBOPTIONS.
Comment 3 Ulrich Müller gentoo-dev 2015-11-19 13:09:48 UTC
Created attachment 417364 [details, diff]
Do not mention various *OPTIONS variables.

Actually PMS doesn't say that *OPTIONS are shell variables or that they would be exported to the ebuild environment. Also all command descriptions explicitly require that the insopts etc. functions are used for setting these variables.
Comment 4 Ulrich Müller gentoo-dev 2015-11-22 12:35:46 UTC
(In reply to Ulrich Müller from comment #3)
> Created attachment 417364 [details, diff] [details, diff]
> Do not mention various *OPTIONS variables.

Pushed to master:
https://gitweb.gentoo.org/proj/pms.git/commit/?id=a75487848fb744906ed16d6f3e03708898d213ec