[Bug other/14918] -fprofile-generate should be documented as necessary for linking

["mark at codesourcery dot com" <gcc-bugzilla at gcc dot gnu dot org>]

------- Additional Comments From mark at codesourcery dot com  2004-04-18 23:20 -------
Subject: Re:  -fprofile-generate should be documented as
 necessary for linking

pinskia at gcc dot gnu dot org wrote:

>------- Additional Comments From pinskia at gcc dot gnu dot org  2004-04-18 15:59 -------
>Can this doc patch go into 3.4.0: <http://gcc.gnu.org/ml/gcc-patches/2004-04/
>msg00869.html>?
>  
>
I checked in this variant on both the 3.4 branch and the mainline.  (I 
don't think we should explicitly encourage using -lgcov.)

(The docs in this area don't look very well written -- there are some 
grammar and typo issues.  But, that's for another day...)

Index: ChangeLog
===================================================================
RCS file: /cvs/gcc/gcc/gcc/ChangeLog,v
retrieving revision 2.3426
diff -c -5 -p -r2.3426 ChangeLog
*** ChangeLog	18 Apr 2004 22:01:09 -0000	2.3426
--- ChangeLog	18 Apr 2004 23:03:26 -0000
***************
*** 1,7 ****
--- 1,11 ----
  2004-04-18  Mark Mitchell  <mark@codesourcery.com>
  
+ 	PR other/14918
+ 	* doc/invoke.texi (-fprofile-generate): Document requirement to
+ 	use -fprofile-generate when linking.
+ 
  	* doc/extend.texi (Strong Using): Warn users against using this
  	feature.
  
  2004-04-18  Richard Sandiford  <rsandifo@redhat.com>
  
Index: doc/invoke.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/doc/invoke.texi,v
retrieving revision 1.445
diff -c -5 -p -r1.445 invoke.texi
*** doc/invoke.texi	14 Apr 2004 08:36:55 -0000	1.445
--- doc/invoke.texi	18 Apr 2004 23:03:27 -0000
*************** and occasionally eliminate the copy.
*** 4371,4384 ****
  
  Disabled at levels @option{-O}, @option{-O2}, @option{-O3}, @option{-Os}.
  
  @item -fprofile-generate
  @opindex fprofile-generate
- Enable options usually used for instrumenting application to produce profile usefull
- for later recompilation profile feedback based optimization.
  
! The following options are enabled: @code{-fprofile-arcs}, @code{-fprofile-values}, @code{-fvpt}
  
  @item -fprofile-use
  @opindex fprofile-use
  Enable profile feedback directed optimizations, and optimizations
  generally profitable only with profile feedback available.
--- 4371,4387 ----
  
  Disabled at levels @option{-O}, @option{-O2}, @option{-O3}, @option{-Os}.
  
  @item -fprofile-generate
  @opindex fprofile-generate
  
! Enable options usually used for instrumenting application to produce
! profile useful for later recompilation with profile feedback based
! optimization.  You must use @code{-fprofile-generate} both when
! compiling and when linking your program.
! 
! The following options are enabled: @code{-fprofile-arcs}, @code{-fprofile-values}, @code{-fvpt}.
  
  @item -fprofile-use
  @opindex fprofile-use
  Enable profile feedback directed optimizations, and optimizations
  generally profitable only with profile feedback available.


-- 


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=14918