Patchwork Doc: Merge Alpha/VMS and IA-64/VMS options

login
register
mail settings
Submitter Tristan Gingold
Date March 12, 2012, 1 p.m.
Message ID <FDE4214A-D0DE-47CF-9CC5-A9402CA98851@adacore.com>
Download mbox | patch
Permalink /patch/146098/
State New
Headers show

Comments

Tristan Gingold - March 12, 2012, 1 p.m.
Hi,

this patch merges Alpha/VMS and IA-64/VMS options as there is only one .opt for them, so there is no need to duplicate the doc.

It also documents -mpointer-size.

Tested by 'make info'

Ok for trunk ?

Tristan.

2012-03-12  Tristan Gingold  <gingold@adacore.com>

	* doc/invoke.texi (VMS Options): Merge Alpha/VMS and IA-64/VMS
	Options.  Mention -mpointer-size.
Richard Guenther - March 12, 2012, 1:07 p.m.
On Mon, Mar 12, 2012 at 2:00 PM, Tristan Gingold <gingold@adacore.com> wrote:
> Hi,
>
> this patch merges Alpha/VMS and IA-64/VMS options as there is only one .opt for them, so there is no need to duplicate the doc.
>
> It also documents -mpointer-size.
>
> Tested by 'make info'
>
> Ok for trunk ?

Ok.

Thanks,
Richard.

> Tristan.
>
> 2012-03-12  Tristan Gingold  <gingold@adacore.com>
>
>        * doc/invoke.texi (VMS Options): Merge Alpha/VMS and IA-64/VMS
>        Options.  Mention -mpointer-size.
>
> diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
> index a1196f0..2378ba5 100644
> --- a/gcc/doc/invoke.texi
> +++ b/gcc/doc/invoke.texi
> @@ -569,9 +569,6 @@ Objective-C and Objective-C++ Dialects}.
>  -msmall-text  -mlarge-text @gol
>  -mmemory-latency=@var{time}}
>
> -@emph{DEC Alpha/VMS Options}
> -@gccoptlist{-mvms-return-codes -mdebug-main=@var{prefix} -mmalloc64}
> -
>  @emph{FR30 Options}
>  @gccoptlist{-msmall-model -mno-lsim}
>
> @@ -669,9 +666,6 @@ Objective-C and Objective-C++ Dialects}.
>  -msel-sched-dont-check-control-spec -msched-fp-mem-deps-zero-cost @gol
>  -msched-max-memory-insns-hard-limit -msched-max-memory-insns=@var{max-insns}}
>
> -@emph{IA-64/VMS Options}
> -@gccoptlist{-mvms-return-codes -mdebug-main=@var{prefix} -mmalloc64}
> -
>  @emph{LM32 Options}
>  @gccoptlist{-mbarrel-shift-enabled -mdivide-enabled -mmultiply-enabled @gol
>  -msign-extend-enabled -muser-enabled}
> @@ -946,6 +940,10 @@ See RS/6000 and PowerPC Options.
>  @emph{VAX Options}
>  @gccoptlist{-mg  -mgnu  -munix}
>
> +@emph{VMS Options}
> +@gccoptlist{-mvms-return-codes -mdebug-main=@var{prefix} -mmalloc64 @gol
> +-mpointer-size=@var{size}}
> +
>  @emph{VxWorks Options}
>  @gccoptlist{-mrtp  -non-static  -Bstatic  -Bdynamic @gol
>  -Xbind-lazy  -Xbind-now}
> @@ -4816,8 +4814,8 @@ Allow using extensions of later DWARF standard version than selected with
>
>  @item -gvms
>  @opindex gvms
> -Produce debugging information in VMS debug format (if that is
> -supported).  This is the format used by DEBUG on VMS systems.
> +Produce debugging information in Alpha/VMS debug format (if that is
> +supported).  This is the format used by DEBUG on Alpha/VMS systems.
>
>  @item -g@var{level}
>  @itemx -ggdb@var{level}
> @@ -10331,7 +10329,6 @@ platform.
>  * CR16 Options::
>  * Darwin Options::
>  * DEC Alpha Options::
> -* DEC Alpha/VMS Options::
>  * FR30 Options::
>  * FRV Options::
>  * GNU/Linux Options::
> @@ -10340,7 +10337,6 @@ platform.
>  * i386 and x86-64 Options::
>  * i386 and x86-64 Windows Options::
>  * IA-64 Options::
> -* IA-64/VMS Options::
>  * LM32 Options::
>  * M32C Options::
>  * M32R/D Options::
> @@ -10368,6 +10364,7 @@ platform.
>  * TILEPro Options::
>  * V850 Options::
>  * VAX Options::
> +* VMS Options::
>  * VxWorks Options::
>  * x86-64 Options::
>  * Xstormy16 Options::
> @@ -12392,27 +12389,6 @@ Note that L3 is only valid for EV5.
>  @end table
>  @end table
>
> -@node DEC Alpha/VMS Options
> -@subsection DEC Alpha/VMS Options
> -
> -These @samp{-m} options are defined for the DEC Alpha/VMS implementations:
> -
> -@table @gcctabopt
> -@item -mvms-return-codes
> -@opindex mvms-return-codes
> -Return VMS condition codes from main.  The default is to return POSIX
> -style condition (e.g.@: error) codes.
> -
> -@item -mdebug-main=@var{prefix}
> -@opindex mdebug-main=@var{prefix}
> -Flag the first routine whose name starts with @var{prefix} as the main
> -routine for the debugger.
> -
> -@item -mmalloc64
> -@opindex mmalloc64
> -Default to 64-bit memory allocation routines.
> -@end table
> -
>  @node FR30 Options
>  @subsection FR30 Options
>  @cindex FR30 Options
> @@ -14325,27 +14301,6 @@ be scheduled.
>
>  @end table
>
> -@node IA-64/VMS Options
> -@subsection IA-64/VMS Options
> -
> -These @samp{-m} options are defined for the IA-64/VMS implementations:
> -
> -@table @gcctabopt
> -@item -mvms-return-codes
> -@opindex mvms-return-codes
> -Return VMS condition codes from @code{main}. The default is to return POSIX-style
> -condition (e.g.@ error) codes.
> -
> -@item -mdebug-main=@var{prefix}
> -@opindex mdebug-main=@var{prefix}
> -Flag the first routine whose name starts with @var{prefix} as the main
> -routine for the debugger.
> -
> -@item -mmalloc64
> -@opindex mmalloc64
> -Default to 64-bit memory allocation routines.
> -@end table
> -
>  @node LM32 Options
>  @subsection LM32 Options
>  @cindex LM32 options
> @@ -18939,6 +18894,34 @@ will assemble with the GNU assembler.
>  Output code for G-format floating-point numbers instead of D-format.
>  @end table
>
> +@node VMS Options
> +@subsection VMS Options
> +
> +These @samp{-m} options are defined for the VMS implementations:
> +
> +@table @gcctabopt
> +@item -mvms-return-codes
> +@opindex mvms-return-codes
> +Return VMS condition codes from @code{main}. The default is to return POSIX-style
> +condition (e.g.@ error) codes.
> +
> +@item -mdebug-main=@var{prefix}
> +@opindex mdebug-main=@var{prefix}
> +Flag the first routine whose name starts with @var{prefix} as the main
> +routine for the debugger.
> +
> +@item -mmalloc64
> +@opindex mmalloc64
> +Default to 64-bit memory allocation routines.
> +
> +@item -mpointer-size=@var{size}
> +@opindex -mpointer-size=@var{size}
> +Set the default size of pointers. Possible options for @var{size} are
> +@samp{32} or @samp{short} for 32 bit pointers, @samp{64} or @samp{long}
> +for 64 bit pointers, and @samp{no} for supporting only 32 bit pointers.
> +The later option disables @code{pragma pointer_size}.
> +@end table
> +
>  @node VxWorks Options
>  @subsection VxWorks Options
>  @cindex VxWorks Options
Tristan Gingold - March 12, 2012, 2:27 p.m.
On Mar 12, 2012, at 2:07 PM, Richard Guenther wrote:

> On Mon, Mar 12, 2012 at 2:00 PM, Tristan Gingold <gingold@adacore.com> wrote:
>> Hi,
>> 
>> this patch merges Alpha/VMS and IA-64/VMS options as there is only one .opt for them, so there is no need to duplicate the doc.
>> 
>> It also documents -mpointer-size.
>> 
>> Tested by 'make info'
>> 
>> Ok for trunk ?
> 
> Ok.

Thanks, committed.

Tristan.

Patch

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index a1196f0..2378ba5 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -569,9 +569,6 @@  Objective-C and Objective-C++ Dialects}.
 -msmall-text  -mlarge-text @gol
 -mmemory-latency=@var{time}}
 
-@emph{DEC Alpha/VMS Options}
-@gccoptlist{-mvms-return-codes -mdebug-main=@var{prefix} -mmalloc64}
-
 @emph{FR30 Options}
 @gccoptlist{-msmall-model -mno-lsim}
 
@@ -669,9 +666,6 @@  Objective-C and Objective-C++ Dialects}.
 -msel-sched-dont-check-control-spec -msched-fp-mem-deps-zero-cost @gol
 -msched-max-memory-insns-hard-limit -msched-max-memory-insns=@var{max-insns}}
 
-@emph{IA-64/VMS Options}
-@gccoptlist{-mvms-return-codes -mdebug-main=@var{prefix} -mmalloc64}
-
 @emph{LM32 Options}
 @gccoptlist{-mbarrel-shift-enabled -mdivide-enabled -mmultiply-enabled @gol
 -msign-extend-enabled -muser-enabled}
@@ -946,6 +940,10 @@  See RS/6000 and PowerPC Options.
 @emph{VAX Options}
 @gccoptlist{-mg  -mgnu  -munix}
 
+@emph{VMS Options}
+@gccoptlist{-mvms-return-codes -mdebug-main=@var{prefix} -mmalloc64 @gol
+-mpointer-size=@var{size}}
+
 @emph{VxWorks Options}
 @gccoptlist{-mrtp  -non-static  -Bstatic  -Bdynamic @gol
 -Xbind-lazy  -Xbind-now}
@@ -4816,8 +4814,8 @@  Allow using extensions of later DWARF standard version than selected with
 
 @item -gvms
 @opindex gvms
-Produce debugging information in VMS debug format (if that is
-supported).  This is the format used by DEBUG on VMS systems.
+Produce debugging information in Alpha/VMS debug format (if that is
+supported).  This is the format used by DEBUG on Alpha/VMS systems.
 
 @item -g@var{level}
 @itemx -ggdb@var{level}
@@ -10331,7 +10329,6 @@  platform.
 * CR16 Options::
 * Darwin Options::
 * DEC Alpha Options::
-* DEC Alpha/VMS Options::
 * FR30 Options::
 * FRV Options::
 * GNU/Linux Options::
@@ -10340,7 +10337,6 @@  platform.
 * i386 and x86-64 Options::
 * i386 and x86-64 Windows Options::
 * IA-64 Options::
-* IA-64/VMS Options::
 * LM32 Options::
 * M32C Options::
 * M32R/D Options::
@@ -10368,6 +10364,7 @@  platform.
 * TILEPro Options::
 * V850 Options::
 * VAX Options::
+* VMS Options::
 * VxWorks Options::
 * x86-64 Options::
 * Xstormy16 Options::
@@ -12392,27 +12389,6 @@  Note that L3 is only valid for EV5.
 @end table
 @end table
 
-@node DEC Alpha/VMS Options
-@subsection DEC Alpha/VMS Options
-
-These @samp{-m} options are defined for the DEC Alpha/VMS implementations:
-
-@table @gcctabopt
-@item -mvms-return-codes
-@opindex mvms-return-codes
-Return VMS condition codes from main.  The default is to return POSIX
-style condition (e.g.@: error) codes.
-
-@item -mdebug-main=@var{prefix}
-@opindex mdebug-main=@var{prefix}
-Flag the first routine whose name starts with @var{prefix} as the main
-routine for the debugger.
-
-@item -mmalloc64
-@opindex mmalloc64
-Default to 64-bit memory allocation routines.
-@end table
-
 @node FR30 Options
 @subsection FR30 Options
 @cindex FR30 Options
@@ -14325,27 +14301,6 @@  be scheduled.
 
 @end table
 
-@node IA-64/VMS Options
-@subsection IA-64/VMS Options
-
-These @samp{-m} options are defined for the IA-64/VMS implementations:
-
-@table @gcctabopt
-@item -mvms-return-codes
-@opindex mvms-return-codes
-Return VMS condition codes from @code{main}. The default is to return POSIX-style
-condition (e.g.@ error) codes.
-
-@item -mdebug-main=@var{prefix}
-@opindex mdebug-main=@var{prefix}
-Flag the first routine whose name starts with @var{prefix} as the main
-routine for the debugger.
-
-@item -mmalloc64
-@opindex mmalloc64
-Default to 64-bit memory allocation routines.
-@end table
-
 @node LM32 Options
 @subsection LM32 Options
 @cindex LM32 options
@@ -18939,6 +18894,34 @@  will assemble with the GNU assembler.
 Output code for G-format floating-point numbers instead of D-format.
 @end table
 
+@node VMS Options
+@subsection VMS Options
+
+These @samp{-m} options are defined for the VMS implementations:
+
+@table @gcctabopt
+@item -mvms-return-codes
+@opindex mvms-return-codes
+Return VMS condition codes from @code{main}. The default is to return POSIX-style
+condition (e.g.@ error) codes.
+
+@item -mdebug-main=@var{prefix}
+@opindex mdebug-main=@var{prefix}
+Flag the first routine whose name starts with @var{prefix} as the main
+routine for the debugger.
+
+@item -mmalloc64
+@opindex mmalloc64
+Default to 64-bit memory allocation routines.
+
+@item -mpointer-size=@var{size}
+@opindex -mpointer-size=@var{size}
+Set the default size of pointers. Possible options for @var{size} are
+@samp{32} or @samp{short} for 32 bit pointers, @samp{64} or @samp{long}
+for 64 bit pointers, and @samp{no} for supporting only 32 bit pointers.
+The later option disables @code{pragma pointer_size}.
+@end table
+
 @node VxWorks Options
 @subsection VxWorks Options
 @cindex VxWorks Options