Skip to content

bugzilla.1: Wrong documentation for -f #176

@alejandro-colomar

Description

@alejandro-colomar

I got this error:

$ bugzilla query -f --bug_id=217435
usage: bugzilla query [-h] [-p PRODUCT] [-v VERSION] [-c COMPONENT]
                      [-t SUMMARY] [-l COMMENT]
                      [--sub-component SUB_COMPONENT] [-o OS] [--arch ARCH]
                      [-x SEVERITY] [-z PRIORITY] [--alias ALIAS] [-s STATUS]
                      [-u URL] [-m TARGET_MILESTONE]
                      [--target_release TARGET_RELEASE] [--blocked BLOCKED]
                      [--dependson DEPENDSON] [--keywords KEYWORDS]
                      [--groups GROUPS] [--cc CC] [-a ASSIGNED_TO]
                      [-q QA_CONTACT] [-f FLAG] [--tags TAGS] [-w WHITEBOARD]
                      [--devel_whiteboard DEVEL_WHITEBOARD]
                      [--internal_whiteboard INTERNAL_WHITEBOARD]
                      [--qa_whiteboard QA_WHITEBOARD] [-F FIXED_IN]
                      [--field FIELD=VALUE] [--full] [-i] [-e] [--oneline]
                      [--json] [--includefield INCLUDEFIELD]
                      [--extrafield EXTRAFIELD] [--excludefield EXCLUDEFIELD]
                      [--raw] [--outputformat OUTPUTFORMAT] [-b ID]
                      [-r REPORTER] [--quicksearch QUICKSEARCH]
                      [--savedsearch SAVEDSEARCH]
                      [--savedsearch-sharer-id SAVEDSEARCH_SHARER_ID]
                      [--from-url WEB_QUERY_URL]
bugzilla query: error: argument -f/--flag: expected one argument

But according to the manual page, -f is not synonymous for --flag. See:

$ man bugzilla 2>/dev/null | grep -e ' -f\b' -e ' --flag\b' -e ' --full\b'
   --flag
       Syntax: --flag FLAG
       --flag devel_ack+ Unset a flag with the 'X' value, like --flag  needin‐
   -f, --full
       Syntax: --full
   -f, --file

BTW, you may want to fix some troff(1) warnings:

$ man bugzilla 1>/dev/null
troff:<standard input>:561: warning: cannot select font 'C'
troff:<standard input>:619: warning [p 8, 12.2i]: cannot adjust line
troff:<standard input>:619: warning [p 8, 12.3i]: cannot break line

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions