This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Eliminate GNAT User's Guide unnecessary directive and alternative warnings


Howdy,

The GNAT User's Guide contains some unnecessary directives and
alternatives in VMS-only or non-VMS-only sections.  These cause
the following warnings:

 ada/doctools/xgnatug vms ../../gcc/gcc/ada/gnat_ug.texi ../../gcc/gcc/ada/ug_words ../../gcc/gcc/ada/gnat_ug_vms.texi
 ../../gcc/gcc/ada/gnat_ug.texi:14530: warning: directive without effect because of line 14507
 ../../gcc/gcc/ada/gnat_ug.texi:14533: warning: directive without effect because of line 14507
 ../../gcc/gcc/ada/gnat_ug.texi:14545:7: warning: VMS alternative already determined by conditionals
 ../../gcc/gcc/ada/gnat_ug.texi:14546:15: warning: VMS alternative already determined by conditionals
 ../../gcc/gcc/ada/gnat_ug.texi:14549:7: warning: VMS alternative already determined by conditionals
 ../../gcc/gcc/ada/gnat_ug.texi:14550:15: warning: VMS alternative already determined by conditionals
 ../../gcc/gcc/ada/gnat_ug.texi:14554:7: warning: VMS alternative already determined by conditionals
 ../../gcc/gcc/ada/gnat_ug.texi:14555:15: warning: VMS alternative already determined by conditionals
 ../../gcc/gcc/ada/gnat_ug.texi:14558:7: warning: VMS alternative already determined by conditionals
 ../../gcc/gcc/ada/gnat_ug.texi:14559:15: warning: VMS alternative already determined by conditionals
 ../../gcc/gcc/ada/gnat_ug.texi:14560:11: warning: VMS alternative already determined by conditionals
 ../../gcc/gcc/ada/gnat_ug.texi:14564:11: warning: VMS alternative already determined by conditionals
 ../../gcc/gcc/ada/gnat_ug.texi:14757:34: warning: VMS alternative already determined by conditionals
 ../../gcc/gcc/ada/gnat_ug.texi:24608:7: warning: VMS alternative already determined by conditionals

The following patch eliminates these warnings.  I've tested it by
running "make info", "make dvi", and by bootstrapping and
regression testing, all on powerpc-unknown-linux-gnu.

OK to commit?

-- 
Matt Kraai <kraai@alumni.cmu.edu>
Debian GNU/Linux Peon

	* gnat_ug.texi (The GNAT Run-Time Library Builder gnatlbr):
	Remove non-VMS directive.
	(Switches for gnatlbr, Optimization Levels): Remove non-VMS
	alternatives.
	(Examples of gnatls Usage): Remove VMS alternative.

Index: gcc/ada/gnat_ug.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/ada/gnat_ug.texi,v
retrieving revision 1.9
diff -3 -c -p -r1.9 gnat_ug.texi
*** gcc/ada/gnat_ug.texi	27 Feb 2003 14:09:36 -0000	1.9
--- gcc/ada/gnat_ug.texi	29 May 2003 11:34:12 -0000
*************** supplied configuration pragmas.
*** 14527,14538 ****
  The @code{gnatlbr} command has the form
  
  @smallexample
- @ifclear vms
- $ gnatlbr --[create | set | delete]=directory --config=file
- @end ifclear
- @ifset vms
  $ GNAT LIBRARY /[CREATE | SET | DELETE]=directory [/CONFIG=file]
- @end ifset
  @end smallexample
  
  @node Switches for gnatlbr
--- 14527,14533 ----
*************** $ GNAT LIBRARY /[CREATE | SET | DELETE]=
*** 14542,14567 ****
  @code{gnatlbr} recognizes the following switches:
  
  @table @code
! @item ^--create^/CREATE^=directory
! @cindex @code{^--create^/CREATE^=directory} (@code{gnatlbr})
       Create the new run-time library in the specified directory.
  
! @item ^--set^/SET^=directory
! @cindex @code{^--set^/SET^=directory} (@code{gnatlbr})
       Make the library in the specified directory the current run-time
       library.
  
! @item ^--delete^/DELETE^=directory
! @cindex @code{^--delete^/DELETE^=directory} (@code{gnatlbr})
       Delete the run-time library in the specified directory.
  
! @item ^--config^/CONFIG^=file
! @cindex @code{^--config^/CONFIG^=file} (@code{gnatlbr})
!      With ^--create^/CREATE^:
       Use the configuration pragmas in the specified file when building
       the library.
  
!      With ^--set^/SET^:
       Use the configuration pragmas in the specified file when compiling.
  
  @end table
--- 14537,14562 ----
  @code{gnatlbr} recognizes the following switches:
  
  @table @code
! @item /CREATE=directory
! @cindex @code{/CREATE=directory} (@code{gnatlbr})
       Create the new run-time library in the specified directory.
  
! @item /SET=directory
! @cindex @code{/SET=directory} (@code{gnatlbr})
       Make the library in the specified directory the current run-time
       library.
  
! @item /DELETE=directory
! @cindex @code{/DELETE=directory} (@code{gnatlbr})
       Delete the run-time library in the specified directory.
  
! @item /CONFIG=file
! @cindex @code{/CONFIG=file} (@code{gnatlbr})
!      With /CREATE:
       Use the configuration pragmas in the specified file when building
       the library.
  
!      With /SET:
       Use the configuration pragmas in the specified file when compiling.
  
  @end table
*************** The unit contains a pragma Remote_Call_I
*** 14754,14760 ****
  
  @noindent
  Example of using the verbose switch. Note how the source and
! object paths are affected by the ^-I^/SEARCH^ switch.
  
  @smallexample
  $ gnatls -v -I.. demo1.o
--- 14749,14755 ----
  
  @noindent
  Example of using the verbose switch. Note how the source and
! object paths are affected by the -I switch.
  
  @smallexample
  $ gnatls -v -I.. demo1.o
*************** optimization is enabled. You can use the
*** 24605,24611 ****
  @code{-O@var{n}} switch, where @var{n} is an integer from 0 to 3,
  @end ifclear
  @ifset vms
! @code{^-O^/OPTIMIZE^}
  @end ifset
  on the @code{gcc} command line to control the optimization level:
  
--- 24600,24606 ----
  @code{-O@var{n}} switch, where @var{n} is an integer from 0 to 3,
  @end ifclear
  @ifset vms
! @code{/OPTIMIZE}
  @end ifset
  on the @code{gcc} command line to control the optimization level:
  


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]