This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
tm.texi: Update *ASM_OP docs, adding "including spacing" (to be committed)
- To: gcc-patches at gcc dot gnu dot org
- Subject: tm.texi: Update *ASM_OP docs, adding "including spacing" (to be committed)
- From: Hans-Peter Nilsson <hans-peter dot nilsson at axis dot com>
- Date: Mon, 18 Sep 2000 23:24:39 +0200
This is an update for the documentation of all *ASM_OP:s, simply adding
", including spacing," and fill-paragraph to 74 columns. No, I didn't do
anything more profound than searching for "ASM_OP".
Note there's a repeat description of INIT_SECTION_ASM_OP, but IMHO it
looks better as it is, than changing to an xref in the latter context
(node Sections vs. node Macros for Initialization).
BTW, one effect of letting *ASM_OP:s hold all spacing is that there will
now be two tabs in the output, when *ASM_OP:s are used in asm:s
(e.g. INIT_SECTION_ASM_OP and FINI_SECTION_ASM_OP). Since they will be
emitted inside #APP/#NO_APP pairs, I believe it shouldn't matter.
The change was sweepingly pre-approved by Jeff Law, but I'll wait for a
couple of days before committing it, in case there's something to discuss
about wording or other.
2000-09-18 Hans-Peter Nilsson <hp@axis.com>
* tm.texi: Say that all *_ASM_OP:s (TEXT_SECTION_ASM_OP,
DATA_SECTION_ASM_OP, SHARED_SECTION_ASM_OP, BSS_SECTION_ASM_OP,
SHARED_BSS_SECTION_ASM_OP, INIT_SECTION_ASM_OP,
FINI_SECTION_ASM_OP, EH_FRAME_SECTION_ASM_OP) include spacing.
Fix typos in description for LONG_LONG_TYPE_SIZE and
FINI_SECTION_ASM_OP.
Index: tm.texi
===================================================================
RCS file: /cvs/gcc/egcs/gcc/tm.texi,v
retrieving revision 1.144
diff -p -c -r1.144 tm.texi
*** tm.texi 2000/09/07 22:24:32 1.144
--- tm.texi 2000/09/18 20:43:30
*************** used in @code{cpp}.
*** 1188,1194 ****
@item LONG_LONG_TYPE_SIZE
A C expression for the size in bits of the type @code{long long} on the
target machine. If you don't define this, the default is two
! words. If you want to support GNU Ada on your machine, the value of
macro must be at least 64.
@findex CHAR_TYPE_SIZE
--- 1188,1194 ----
@item LONG_LONG_TYPE_SIZE
A C expression for the size in bits of the type @code{long long} on the
target machine. If you don't define this, the default is two
! words. If you want to support GNU Ada on your machine, the value of this
macro must be at least 64.
@findex CHAR_TYPE_SIZE
*************** can also define additional sections.
*** 5038,5087 ****
@table @code
@findex TEXT_SECTION_ASM_OP
@item TEXT_SECTION_ASM_OP
! A C expression whose value is a string containing the assembler
! operation that should precede instructions and read-only data. Normally
! @code{".text"} is right.
@findex DATA_SECTION_ASM_OP
@item DATA_SECTION_ASM_OP
! A C expression whose value is a string containing the assembler
! operation to identify the following data as writable initialized data.
! Normally @code{".data"} is right.
@findex SHARED_SECTION_ASM_OP
@item SHARED_SECTION_ASM_OP
! If defined, a C expression whose value is a string containing the
! assembler operation to identify the following data as shared data. If
! not defined, @code{DATA_SECTION_ASM_OP} will be used.
@findex BSS_SECTION_ASM_OP
@item BSS_SECTION_ASM_OP
! If defined, a C expression whose value is a string containing the
! assembler operation to identify the following data as uninitialized global
! data. If not defined, and neither @code{ASM_OUTPUT_BSS} nor
! @code{ASM_OUTPUT_ALIGNED_BSS} are defined, uninitialized global data will be
! output in the data section if @samp{-fno-common} is passed, otherwise
! @code{ASM_OUTPUT_COMMON} will be used.
@findex SHARED_BSS_SECTION_ASM_OP
@item SHARED_BSS_SECTION_ASM_OP
! If defined, a C expression whose value is a string containing the
! assembler operation to identify the following data as uninitialized global
! shared data. If not defined, and @code{BSS_SECTION_ASM_OP} is, the latter
! will be used.
@findex INIT_SECTION_ASM_OP
@item INIT_SECTION_ASM_OP
! If defined, a C expression whose value is a string containing the
! assembler operation to identify the following data as initialization
! code. If not defined, GCC will assume such a section does not
! exist.
@findex FINI_SECTION_ASM_OP
@item FINI_SECTION_ASM_OP
! If defined, a C expression whose value is a string containing the
! assembler opration to identify the following data as finalization
! code. If not defined, GCC will assume such a section does not exist.
@findex CRT_CALL_STATIC_FUNCTION
@item CRT_CALL_STATIC_FUNCTION
--- 5038,5089 ----
@table @code
@findex TEXT_SECTION_ASM_OP
@item TEXT_SECTION_ASM_OP
! A C expression whose value is a string, including spacing, containing the
! assembler operation that should precede instructions and read-only data.
! Normally @code{"\t.text"} is right.
@findex DATA_SECTION_ASM_OP
@item DATA_SECTION_ASM_OP
! A C expression whose value is a string, including spacing, containing the
! assembler operation to identify the following data as writable initialized
! data. Normally @code{"\t.data"} is right.
@findex SHARED_SECTION_ASM_OP
@item SHARED_SECTION_ASM_OP
! If defined, a C expression whose value is a string, including spacing,
! containing the assembler operation to identify the following data as
! shared data. If not defined, @code{DATA_SECTION_ASM_OP} will be used.
@findex BSS_SECTION_ASM_OP
@item BSS_SECTION_ASM_OP
! If defined, a C expression whose value is a string, including spacing,
! containing the assembler operation to identify the following data as
! uninitialized global data. If not defined, and neither
! @code{ASM_OUTPUT_BSS} nor @code{ASM_OUTPUT_ALIGNED_BSS} are defined,
! uninitialized global data will be output in the data section if
! @samp{-fno-common} is passed, otherwise @code{ASM_OUTPUT_COMMON} will be
! used.
@findex SHARED_BSS_SECTION_ASM_OP
@item SHARED_BSS_SECTION_ASM_OP
! If defined, a C expression whose value is a string, including spacing,
! containing the assembler operation to identify the following data as
! uninitialized global shared data. If not defined, and
! @code{BSS_SECTION_ASM_OP} is, the latter will be used.
@findex INIT_SECTION_ASM_OP
@item INIT_SECTION_ASM_OP
! If defined, a C expression whose value is a string, including spacing,
! containing the assembler operation to identify the following data as
! initialization code. If not defined, GCC will assume such a section does
! not exist.
@findex FINI_SECTION_ASM_OP
@item FINI_SECTION_ASM_OP
! If defined, a C expression whose value is a string, including spacing,
! containing the assembler operation to identify the following data as
! finalization code. If not defined, GCC will assume such a section does
! not exist.
@findex CRT_CALL_STATIC_FUNCTION
@item CRT_CALL_STATIC_FUNCTION
*************** and termination functions:
*** 6157,6168 ****
@table @code
@findex INIT_SECTION_ASM_OP
@item INIT_SECTION_ASM_OP
! If defined, a C string constant for the assembler operation to identify
! the following data as initialization code. If not defined, GCC will
! assume such a section does not exist. When you are using special
! sections for initialization and termination functions, this macro also
! controls how @file{crtstuff.c} and @file{libgcc2.c} arrange to run the
! initialization functions.
@item HAS_INIT_SECTION
@findex HAS_INIT_SECTION
--- 6159,6170 ----
@table @code
@findex INIT_SECTION_ASM_OP
@item INIT_SECTION_ASM_OP
! If defined, a C string constant, including spacing, for the assembler
! operation to identify the following data as initialization code. If not
! defined, GCC will assume such a section does not exist. When you are
! using special sections for initialization and termination functions, this
! macro also controls how @file{crtstuff.c} and @file{libgcc2.c} arrange to
! run the initialization functions.
@item HAS_INIT_SECTION
@findex HAS_INIT_SECTION
*************** or @samp{-fPIC} is in effect, the @code{
*** 6581,6591 ****
@findex EH_FRAME_SECTION_ASM_OP
@item EH_FRAME_SECTION_ASM_OP
! If defined, a C string constant for the assembler operation to switch to
! the section for exception handling frame unwind information. If not
! defined, GCC will provide a default definition if the target supports
! named sections. @file{crtstuff.c} uses this macro to switch to the
! appropriate section.
You should define this symbol if your target supports DWARF 2 frame
unwind information and the default definition does not work.
--- 6583,6593 ----
@findex EH_FRAME_SECTION_ASM_OP
@item EH_FRAME_SECTION_ASM_OP
! If defined, a C string constant, including spacing, for the assembler
! operation to switch to the section for exception handling frame unwind
! information. If not defined, GCC will provide a default definition if the
! target supports named sections. @file{crtstuff.c} uses this macro to
! switch to the appropriate section.
You should define this symbol if your target supports DWARF 2 frame
unwind information and the default definition does not work.
brgds, H-P