[Bug-gnupress] Modifications to gcc.006.txt (#5)

[Paul A. Crable]

These are the proposed modifications for sections
3.17.6-3.17.8:

In the subsection "3.17.6 MN10200 Options"

Replace

"These `-m' options are defined for Matsushita
MN10200 architectures:"

with

"This `-m' option is defined for Matsushita
MN10200 architectures:"

In the subsection "3.17.7 MN10300 Options"

Replace

"-mmult-bug
    "Generate code to avoid bugs in the multiply
    instructions for the MN10300 processors. This is
    the default.

"-mno-mult-bug
    "Do not generate code to avoid bugs in the
    multiply instructions for the MN10300 processors."

with

"-mmult-bug
"-mno-mult-bug
    "Generate (-mmult-bug) or do not generate (-mno-
    mult-bug) output that avoids defects in the
    multiply instructions for the MN10300 processors.
    The default is -mmult-bug."

Replace

"-mam33
    "Generate code which uses features specic to the
    AM33 processor.

"-mno-am33
    "Do not generate code which uses features specic
    to the AM33 pro­ cessor. This is the default."

with

"-mam33
"-mno-am33
    "Generate (-mam33) or do not generate (-mno-am33)
    code which uses features specific to the AM33
    processor.  The default is -mno-am33."

In the subsection "3.17.8 M32R/D Options"

Replace

"-m32rx
    "Generate code for the M32R/X.

"-m32r
    "Generate code for the M32R. This is the default."

with

"-m32rx
"-m32r
    "Generate code for the M32R/X (-m32rx) or the M32R
    (-m32r).  The default is -m32r."

Replace

"-mcode-model=small
    "Assume all objects live in the lower 16MB of
    memory (so that their addresses can be loaded with
    the ld24 instruction), and assume all subroutines
    are reachable with the bl instruction. This is the
    default. The addressability of a particular object
    can be set with the model attribute.

"-mcode-model=medium
    "Assume objects may be anywhere in the 32­bit
    address space (the compiler will generate
    seth/add3 instructions to load their addresses),
    and assume all subroutines are reachable with the
    bl instruction.

"-mcode-model=large
    "Assume objects may be anywhere in the 32­bit
    address space (the compiler will generate
    seth/add3 instructions to load their addresses),
    and assume subroutines may not be reachable with
    the bl instruction (the compiler will generate the
    much slower seth/add3/jl instruction sequence)."

with

"-mcode-model=model_type
    "Specify the memory model to use.  model_type can
    take these values:

        "small--Assume all objects live in the lower 16MB
        of memory (so that their addresses can be loaded
        with the LD24 instruction), and assume all
        subroutines are reachable with the BL instruction.
        This is the default. The addressability of a
        particular object can be set with the model
        attribute.

        "medium--Assume objects may be anywhere in the
        32­bit address space (the compiler will generate
        SETH/ADD3 instructions to load their addresses),
        and assume all subroutines are reachable with the
        BL instruction.

        "large--Assume objects may be anywhere in the
        32­bit address space (the compiler will generate
        SETH/ADD3 instructions to load their addresses),
        and assume subroutines may not be reachable with
        the BL instruction (the compiler will generate the
        much slower seth/add3/jl instruction sequence)."

Replace

"-msdata=none
    "Disable use of the small data area. Variables
    will be put into one of `.data', `bss', or
    `.rodata' (unless the section attribute has been
    specified). This is the default. The small data
    area consists of sections `.sdata' and `.sbss'.
    Objects may be explicitly put in the small data
    area with the section attribute using one of these
    sections.

"-msdata=sdata
    "Put small global and static data in the small
    data area, but do not generate special code to
    reference them.

"-msdata=use
    "Put small global and static data in the small
    data area, and generate special instructions to
    reference them.

with

"-msdata=small_data_area
    "Generate output that uses the small data area
    according to the value of small_data_area.  The
    small data area consists of sections `.sdata' and
    `.sbss'. Objects may be explicitly put in the
    small data area with the section attribute using
    one of these sections.  small_data_area can take
    one of the following values:

        "none--Disable use of the small data area.
        Variables will be put into one of `.data', `bss',
        or `.rodata' (unless the section attribute has
        been specified). This is the default.

        "sdata--Put small global and static data in the
        small data area, but do not generate special code
        to reference them.

        "use--Put small global and static data in the
        small data area, and generate special instructions
        to reference them."

Replace

"-G num
    "Put global and static objects less than or equal
    to num bytes into the small data or bss sections
    instead of the normal data or bss sections. The
    default value of numis 8. The `-msdata' option
    must be set to one of `sdata' or `use' for this
    option to have any effect. All modules should be
    compiled with the same `-G num' value; otherwise,
    the results will be unpredictable."

with

"-G num
    "Put global and static objects less than or equal
    to num bytes into the small data or bss sections
    instead of the normal data or bss sections.   num
    may take the values ??????????????; the default is
    8.  This option takes effect only if -msdata=sdata
    or -msdata=use.  All modules should be compiled
    with the same `-G num' value; otherwise, the
    results will be unpredictable."

Paul A. Crable.  Portland, Oregon, USA