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

Bug 500940

Summary: app-portage/gentoolkit-0.3.1: euse documentation does not cover [F] or [m] (use.force, use.mask) flags
Product: Portage Development Reporter: Sam Jorna (wraeth) <wraeth>
Component: ToolsAssignee: Portage Tools Team <tools-portage>
Status: UNCONFIRMED ---    
Severity: normal    
Priority: Normal    
Version: unspecified   
Hardware: AMD64   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---

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

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) 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)