[Bug 1631631] [NEW] Trivial bug in man documentation: forgotten --strip-unneeded option in objcopy SYNOPSIS

[Oleksandr Pikozh]

Public bug reported:

In the man page of "objcopy" the "--strip-unneeded" option:
- is described in OPTIONS section;
- but is forgotten in SYNOPSIS section (don't confuse with "--strip-unneeded-symbol=" and "--strip-unneeded-symbols=", which aren't forgotten).

$ lsb_release -rd
Description:    Ubuntu 16.04.1 LTS
Release:        16.04

$ apt-cache policy binutils
binutils:
  Installed: 2.26.1-1ubuntu1~16.04.3
  Candidate: 2.26.1-1ubuntu1~16.04.3
  Version table:
 *** 2.26.1-1ubuntu1~16.04.3 500
        500 http://ua.archive.ubuntu.com/ubuntu xenial-updates/main amd64 Packages
        500 http://security.ubuntu.com/ubuntu xenial-security/main amd64 Packages
        100 /var/lib/dpkg/status
     2.26-8ubuntu2 500
        500 http://ua.archive.ubuntu.com/ubuntu xenial/main amd64 Packages

I expected SYNOPSIS and OPTIONS sections of the man page of "objcopy" to
be consistent.

Option "--strip-unneeded" present in OPTIONS section, is absent in
SYNOPSIS section.

** Affects: binutils (Ubuntu)
     Importance: Undecided
         Status: New


** Tags: manpage

** Attachment added: "1objcopy.txt"
   https://bugs.launchpad.net/bugs/1631631/+attachment/4757410/+files/1objcopy.txt

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to binutils in Ubuntu.
https://bugs.launchpad.net/bugs/1631631

Title:
  Trivial bug in man documentation: forgotten --strip-unneeded option in
  objcopy SYNOPSIS

Status in binutils package in Ubuntu:
  New

Bug description:
  In the man page of "objcopy" the "--strip-unneeded" option:
  - is described in OPTIONS section;
  - but is forgotten in SYNOPSIS section (don't confuse with "--strip-unneeded-symbol=" and "--strip-unneeded-symbols=", which aren't forgotten).

  $ lsb_release -rd
  Description:    Ubuntu 16.04.1 LTS
  Release:        16.04

  $ apt-cache policy binutils
  binutils:
    Installed: 2.26.1-1ubuntu1~16.04.3
    Candidate: 2.26.1-1ubuntu1~16.04.3
    Version table:
   *** 2.26.1-1ubuntu1~16.04.3 500
          500 http://ua.archive.ubuntu.com/ubuntu xenial-updates/main amd64 Packages
          500 http://security.ubuntu.com/ubuntu xenial-security/main amd64 Packages
          100 /var/lib/dpkg/status
       2.26-8ubuntu2 500
          500 http://ua.archive.ubuntu.com/ubuntu xenial/main amd64 Packages

  I expected SYNOPSIS and OPTIONS sections of the man page of "objcopy"
  to be consistent.

  Option "--strip-unneeded" present in OPTIONS section, is absent in
  SYNOPSIS section.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/binutils/+bug/1631631/+subscriptions