[Bug binutils/29014] New: Documentation correction

[crh883 at utulsa dot edu]

https://sourceware.org/bugzilla/show_bug.cgi?id=29014

            Bug ID: 29014
           Summary: Documentation correction
           Product: binutils
           Version: pre-2.12
            Status: UNCONFIRMED
          Severity: minor
          Priority: P2
         Component: binutils
          Assignee: unassigned at sourceware dot org
          Reporter: crh883 at utulsa dot edu
  Target Milestone: ---

Looks like this may be obsolete in later versions (?), but at least in one of
the first documentation hits on google the typedef asymbol flags list is
missing flag 0x4. Here's a link to the documentation that I noticed it in:
https://ftp.gnu.org/old-gnu/Manuals/bfd-2.9.1/html_mono/bfd.html#TOC57.

You might also consider adding version numbers to documentation, especially if
large changes are made. (For example, the documentation on
[this](https://doc.ecoscentric.com/gnutools/doc/bfd/typedef-asymbol.html#typedef-asymbol)
page suggests a completely different structure of the flags, which may be from
an earlier (or later) version?)

Might also add something like the following to better clarify that the define
list is indeed flag types and that they are/can be stacked:

/* Values defined below are those that make up the flags field of a symbol
table symbol.  They indicate the classification of the symbol and are not
mutually exclusive (one symbol may have multiple types). Values seen in a given
symbol's flag field are the sum of all relevant flags that pertain to a that
particular symbol. */

-- 
You are receiving this mail because:
You are on the CC list for the bug.