X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gas%2Fdoc%2Fc-alpha.texi;h=a38397cb912aa4520195134e147e79ce0b3253fc;hb=d8740be15930b820ab51d7a76695194022a83551;hp=f426b822828d7ab691710c0db72c7a9e14c510c0;hpb=04fe8f58aea4ab08cfaf21329373d251d6e317a7;p=deliverable%2Fbinutils-gdb.git

diff --git a/gas/doc/c-alpha.texi b/gas/doc/c-alpha.texi
index f426b82282..a38397cb91 100644
--- a/gas/doc/c-alpha.texi
+++ b/gas/doc/c-alpha.texi
@@ -1,7 +1,7 @@
-@c Copyright 2002, 2003
-@c Free Software Foundation, Inc.
+@c Copyright (C) 2002-2020 Free Software Foundation, Inc.
 @c This is part of the GAS manual.
 @c For copying conditions, see the file as.texinfo.
+@c man end
 
 @ifset GENERIC
 @page
@@ -38,15 +38,16 @@ features specific to these formats are not yet documented.
 @cindex Alpha options
 @cindex options for Alpha
 
-@table @option
-@cindex @code{-m@var{cpu}} command line option, Alpha
+@c man begin OPTIONS
+@table @gcctabopt
+@cindex @code{-m@var{cpu}} command-line option, Alpha
 @item -m@var{cpu}
 This option specifies the target processor.  If an attempt is made to
 assemble an instruction which will not execute on the target processor,
 the assembler may either expand the instruction as a macro or issue an
 error message.  This option is equivalent to the @code{.arch} directive.
 
-The following processor names are recognized: 
+The following processor names are recognized:
 @code{21064},
 @code{21064a},
 @code{21066},
@@ -74,15 +75,15 @@ and existing practice within @command{MILO} (the Linux ARC bootloader), the
 numbered processor names (e.g.@: 21064) enable the processor-specific PALcode
 instructions, while the ``electro-vlasic'' names (e.g.@: @code{ev4}) do not.
 
-@cindex @code{-mdebug} command line option, Alpha
-@cindex @code{-no-mdebug} command line option, Alpha
+@cindex @code{-mdebug} command-line option, Alpha
+@cindex @code{-no-mdebug} command-line option, Alpha
 @item -mdebug
 @itemx -no-mdebug
 Enables or disables the generation of @code{.mdebug} encapsulation for
 stabs directives and procedure descriptors.  The default is to automatically
 enable @code{.mdebug} when the first stabs directive is seen.
 
-@cindex @code{-relax} command line option, Alpha
+@cindex @code{-relax} command-line option, Alpha
 @item -relax
 This option forces all relocations to be put into the object file, instead
 of saving space and resolving some relocations at assembly time.  Note that
@@ -90,24 +91,34 @@ this option does not propagate all symbol arithmetic into the object file,
 because not all symbol arithmetic can be represented.  However, the option
 can still be useful in specific applications.
 
-@cindex @code{-g} command line option, Alpha
+@cindex @code{-replace} command-line option, Alpha
+@cindex @code{-noreplace} command-line option, Alpha
+@item -replace
+@itemx -noreplace
+Enables or disables the optimization of procedure calls, both at assemblage
+and at link time.  These options are only available for VMS targets and
+@code{-replace} is the default.  See section 1.4.1 of the OpenVMS Linker
+Utility Manual.
+
+@cindex @code{-g} command-line option, Alpha
 @item -g
 This option is used when the compiler generates debug information.  When
 @command{gcc} is using @command{mips-tfile} to generate debug
 information for ECOFF, local labels must be passed through to the object
 file.  Otherwise this option has no effect.
 
-@cindex @code{-G} command line option, Alpha
+@cindex @code{-G} command-line option, Alpha
 @item -G@var{size}
 A local common symbol larger than @var{size} is placed in @code{.bss},
 while smaller symbols are placed in @code{.sbss}.
 
-@cindex @code{-F} command line option, Alpha
-@cindex @code{-32addr} command line option, Alpha
+@cindex @code{-F} command-line option, Alpha
+@cindex @code{-32addr} command-line option, Alpha
 @item -F
 @itemx -32addr
 These options are ignored for backward compatibility.
 @end table
+@c man end
 
 @cindex Alpha Syntax
 @node Alpha Syntax
@@ -127,7 +138,10 @@ OpenVMS syntax, with a few differences for ELF.
 
 @cindex line comment character, Alpha
 @cindex Alpha line comment character
-@samp{#} is the line comment character.
+@samp{#} is the line comment character.  Note that if @samp{#} is the
+first character on a line then it can also be a logical line number
+directive (@pxref{Comments}) or a preprocessor control
+command (@pxref{Preprocessing}).
 
 @cindex line separator, Alpha
 @cindex statement separator, Alpha
@@ -152,7 +166,7 @@ The 32 floating-point registers are referred to as @samp{$f@var{n}}.
 @cindex relocations, Alpha
 
 Some of these relocations are available for ECOFF, but mostly
-only for ELF.  They are modeled after the relocation format 
+only for ELF.  They are modeled after the relocation format
 introduced in Digital Unix 4.0, but there are additions.
 
 The format is @samp{!@var{tag}} or @samp{!@var{tag}!@var{number}}
@@ -228,13 +242,13 @@ jsr  $26,($27),foo  !lituse_jsr!1
 
 @item !lituse_tlsgd!@var{N}
 Used with a register branch format instruction to indicate that the
-literal is the call to @code{__tls_get_addr} used to compute the 
+literal is the call to @code{__tls_get_addr} used to compute the
 address of the thread-local storage variable whose descriptor was
 loaded with @code{!tlsgd!@var{N}}.
 
 @item !lituse_tlsldm!@var{N}
 Used with a register branch format instruction to indicate that the
-literal is the call to @code{__tls_get_addr} used to compute the 
+literal is the call to @code{__tls_get_addr} used to compute the
 address of the base of the thread-local storage block for the current
 module.  The descriptor for the module must have been loaded with
 @code{!tlsldm!@var{N}}.
@@ -244,7 +258,7 @@ Used with @code{ldah} and @code{lda} to load the GP from the current
 address, a-la the @code{ldgp} macro.  The source register for the
 @code{ldah} instruction must contain the address of the @code{ldah}
 instruction.  There must be exactly one @code{lda} instruction paired
-with the @code{ldah} instruction, though it may appear anywhere in 
+with the @code{ldah} instruction, though it may appear anywhere in
 the instruction stream.  The immediate operands must be zero.
 
 @example
@@ -386,8 +400,8 @@ used in some non-standard way and so the linker cannot elide the load of
 the procedure vector during relaxation.
 
 @item .usepv @var{function}, @var{which}
-Used to indicate the use of the @code{$27} register, similar to 
-@code{.prologue}, but without the other semantics of needing to 
+Used to indicate the use of the @code{$27} register, similar to
+@code{.prologue}, but without the other semantics of needing to
 be inside an open @code{.ent}/@code{.end} block.
 
 The @var{which} argument should be either @code{no}, indicating that