egcs/gcc/invoke.texi

[craig@jcb-sc.com]

Does anyone object to my committing this patch?  (I'm no expert on
the options, just trying to clarify the docs, which seem misleading.)

        tq vm, (burley)


Sat Mar 27 16:55:38 1999  Craig Burley  <craig@jcb-sc.com>

	* invoke.texi (Code Gen Options): Attempt to clarify
	-fcheck-memory-usage.  Minor edits to -fprefix-function-name.
  
*** g77-e/gcc/invoke.texi.~1~	Thu Mar 25 20:04:45 1999
--- g77-e/gcc/invoke.texi	Sat Mar 27 16:54:34 1999
*************** code that is suitable for a detector of 
*** 6061,6069 ****
  @file{Checker}.
  
! You must also specify this option when you compile functions you call that
! have side effects.  If you do not, you may get erroneous messages from
! the detector.  Normally,  you should compile all your code with this option.
  If you use functions from a library that have side-effects (such as
! @code{read}), you may not be able to recompile the library and
  specify this option.  In that case, you can enable the
  @samp{-fprefix-function-name} option, which requests GNU CC to encapsulate
--- 6061,6074 ----
  @file{Checker}.
  
! Normally, you should compile all, or none, of your code with this option.
! 
! If you do mix code compiled with and without this option,
! you must ensure that all code that has side effects
! and that is called by code compiled with this option
! is, itself, compiled with this option.
! If you do not, you might get erroneous messages from the detector.
! 
  If you use functions from a library that have side-effects (such as
! @code{read}), you might not be able to recompile the library and
  specify this option.  In that case, you can enable the
  @samp{-fprefix-function-name} option, which requests GNU CC to encapsulate
*************** your code and make other functions look 
*** 6071,6075 ****
  @samp{-fcheck-memory-usage}.  This is done by calling ``stubs'',
  which are provided by the detector.  If you cannot find or build
! stubs for every function you call, you may have to specify
  @samp{-fcheck-memory-usage} without @samp{-fprefix-function-name}.
  
--- 6076,6080 ----
  @samp{-fcheck-memory-usage}.  This is done by calling ``stubs'',
  which are provided by the detector.  If you cannot find or build
! stubs for every function you call, you might have to specify
  @samp{-fcheck-memory-usage} without @samp{-fprefix-function-name}.
  
*************** Request GNU CC to add a prefix to the sy
*** 6096,6100 ****
  GNU CC adds a prefix to the names of functions defined as well as
  functions called.  Code compiled with this option and code compiled
! without the option can't be linked together, unless or stubs are used.
  
  If you compile the following code with @samp{-fprefix-function-name}
--- 6101,6105 ----
  GNU CC adds a prefix to the names of functions defined as well as
  functions called.  Code compiled with this option and code compiled
! without the option can't be linked together, unless stubs are used.
  
  If you compile the following code with @samp{-fprefix-function-name}
*************** foo (int a)
*** 6105,6109 ****
  @{
    return bar (a + 5);
- 
  @}
  @end example
--- 6110,6113 ----