Bug 500940 – app-portage/gentoolkit-0.3.1: euse documentation does not cover [F] or [m] (use.force, use.mask) flags

• Status: UNCONFIRMED
• Product: Portage Development

[Description Sam Jorna (wraeth) (RETIRED) 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

app-portage/gentoolkit-0.3.0.8-r2
    PYTHON_TARGETS="python2_7 python3_3 (-pypy2_0) -python2_6 -python3_2"

[Comment 1 Sam Jorna (wraeth) (RETIRED) 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)