Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 500940 - app-portage/gentoolkit-0.3.1: euse documentation does not cover [F] or [m] (use.force, use.mask) flags
Summary: app-portage/gentoolkit-0.3.1: euse documentation does not cover [F] or [m] (u...
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Tools (show other bugs)
Hardware: AMD64 Linux
: Normal normal (vote)
Assignee: Portage Tools Team
Depends on:
Reported: 2014-02-11 05:18 UTC by Sam Jorna (wraeth)
Modified: 2015-12-24 07:42 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Note You need to log in before you can comment on or make changes to this bug.
Description Sam Jorna (wraeth) gentoo-dev 2014-02-11 05:18:01 UTC
Man page and wiki articles covering euse do not discuss the [F] or [m] status flags from the output of `euse -a`.  Documentation within the code ("Function: get_flagstatus" does describe these flags.

This can lead to confusion in interpreting the results of running `euse -a`.

Reproducible: Always

Steps to Reproduce:
1. Look at documentation
Actual Results:  
Flags ECDG are covered, flags Fm are not

Expected Results:  
Flags ECDGFm should be described

    PYTHON_TARGETS="python2_7 python3_3 (-pypy2_0) -python2_6 -python3_2"
Comment 1 Sam Jorna (wraeth) gentoo-dev 2014-02-11 05:20:21 UTC
From `sed -n 596,609p $(which euse)`:

# Function: get_flagstatus {{{
# Prints a status string for the given flag, each column indicating the presence
# for portage, in the environment, in make.conf, in make.defaults, in
# make.globals, and in use.force and flipped in use.mask.
# Arguments:
# 1 - use flag for which to retrieve status
# Returns:
# 0 (True) if flag is active, 1 (False) if not active
# Outputs:
# Full positive value would be "[+ECDGFm] ", full negative value would be [-ecdgfM],
# full missing value would be "[-      ] " (portage only sees present or not present)