[PATCH] revise GAS description of local symbols

[Bob Wilson <bwilson at tensilica dot com>]

The description of "local symbols" in the GAS documentation is  
outdated and confusing.  There are many places that assume the a.out  
convention of local symbols starting with "L", and nothing that even  
mentions that the ELF default local label prefix is ".L".  To the  
extent that there is a definition of "local symbols", it is attached  
to the description of the -L option.  If you look at the "Local  
Symbol Names" section, you'll find a description of the temporary  
"forward/backward" labels.

This patch attempts to fix those problems.  First, it makes a  
distinction in terminology, using "local label" for the temporary  
forward/backward labels vs. "local symbol" for symbols that are not  
written to the object file.  It accordingly renames the existing  
section on forward/backward labels to "Local Labels" and reuses the  
"Local Symbol Names" heading for a new section, containing a  
definition of "local symbols".

OK?

gas/
        * doc/as.texinfo (Overview): Revise description of --keep- 
locals.
        Add xref to "Symbol Names".
        (L): Refer to "local symbols" instead of "local labels".  Move
        definition to "Symbol Names" section; add xref to that section.
        (Symbol Names): Use "Local Symbol Names" section to define  
local
        symbols.  Add "Local Labels" heading for description of  
temporary
        forward/backward labels, and refer to those as "local labels".

Attachment: gas-local-sym.patch
Description: Binary data