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]

Documentation patches (fwd)


	The patches below add some information regarding the undocumented
command-line switch to gperf which is added by Kaveh's patch.  This really
has become a FAQ on the egcs list recently, and hopefully this new
documentation will clear things up.  Formatting should be correct now, and
the "Last Updated" line has also been fixed to correspond to these
patches.  For convenience, I have also included the patches as an
attachment.
	Any comments, send 'em to me directly as I am not subscribed to
this list.	


								- Bret -


Patch 1
=======

*** wwwdocs/htdocs/cvs.html	Mon Feb 15 09:59:16 1999
--- wwwdocs.orig/htdocs/cvs.html	Wed Feb 10 10:13:44 1999
*************** to check out the egcs sources.
*** 61,73 ****
  update"</code> will sync your local copy with the repository.  See the
  CVS manual for additional information on how to use CVS.
  
! <br><br>
! <strong>Note</strong>
! <p>It may be necessary to obtain patches for common utilities when building
! from CVS.  We recommend you read the <a href="faq.html#generated_files"> 
! FAQ entry</a> regarding additional tools you may need.  Another 
! <a href="faq.html#gperf">FAQ entry</a> documents changes you will likely have
! to make to the gperf utility.
  
  <p> You can check out the egcs-1.0.x release branch with the following command:
  
--- 61,69 ----
  update"</code> will sync your local copy with the repository.  See the
  CVS manual for additional information on how to use CVS.
  
! <p>We recommend you read the <a href="faq.html#generated_files"> 
! FAQ entry regarding additional tools you may need when building from CVS
! sources </a>
  
  <p> You can check out the egcs-1.0.x release branch with the following command:
  
*************** the web pages.
*** 95,101 ****
  <p>Enjoy!
  
  <hr>
! <i>Last modified on February  15, 1999.</i>
  <hr>
  
  <a href="">Return to the egcs home page</a>
--- 91,97 ----
  <p>Enjoy!
  
  <hr>
! <i>Last modified on January  8, 1999.</i>
  <hr>
  
  <a href="">Return to the egcs home page</a>


Patch 2
=======
*** wwwdocs/htdocs/faq.html	Mon Feb 15 09:57:50 1999
--- wwwdocs.orig/htdocs/faq.html	Wed Feb 10 10:13:45 1999
*************** comp.std.c++ FAQ</a>.
*** 95,102 ****
      <li><a href="spam.html">Dealing with spam on the lists</a>
      <li><a href="#squangle">How to work around too long C++ symbol names? 
  	 (<tt>-fsquangle</tt>)</a>
-     <li><a href="#gperf">When building from CVS sources, I see 'gperf: invalid option -- F', 
- 	even with the most current version of gperf.</a>
    </ol>
  </ol>
  
--- 95,100 ----
*************** to rebuild egcs.</p>
*** 981,987 ****
  <p>Autoconf is available from
  <a href="http://sourceware.cygnus.com/autoconf/">
  http://sourceware.cygnus.com/autoconf/</a>; have a look at
! <a href="ftp://egcs.cygnus.com/pub/egcs/infrastructure/">
  ftp://egcs.cygnus.com/pub/egcs/infrastructure/</a> for the other packages.
  </p>
  
--- 979,985 ----
  <p>Autoconf is available from
  <a href="http://sourceware.cygnus.com/autoconf/">
  http://sourceware.cygnus.com/autoconf/</a>; have a look at
! <a name="ftp://egcs.cygnus.com/pub/egcs/infrastructure/">
  ftp://egcs.cygnus.com/pub/egcs/infrastructure/</a> for the other packages.
  </p>
  
*************** initialized by default), then rebuilding
*** 1081,1113 ****
  
  <hr>
  
- <h2><a name="gperf">When building from CVS sources, I see 'gperf: 
- invalid option -- F', even with the most current version of gperf.
- </a></h2>
- 
- <p>The current version of gperf (v2.7) does not support the -F flag 
- which is used when building egcs from CVS sources.  You will need to 
- obtain a patch for gperf and rebuild the program; this patch is available 
- at <a href="ftp://egcs.cygnus.com/pub/egcs/infrastructure">
- ftp://egcs.cygnus.com/pub/egcs/infrastructure/</a>
- 
- <p>Patches for other tools, particularly autoconf, may also be necessary 
- if you're building from CVS sources.  Please see the 
- <a href="#generated_files">FAQ entry</a> regarding these tools to 
- determine if anything else is needed.
- 
- <p>These patched utilities should <strong>only</strong> be required if 
- you are building from CVS sources.  For example, gperf is used to 
- generate C code for a perfect hash function given an input file.  
- Distributions of egcs already contain the generated C code, while the 
- CVS sources will provide only the gperf input file.  So gperf should 
- only be necessary if you are building anything obtained from CVS.
- 
- <hr>
- 
- 
  <p><a href="index.html">Return to the EGCS home page</a>
! <p><i>Last modified:  February 15, 1999</i>
  
  <!--#include virtual="/glimpsebox.html"-->
  </body>
--- 1079,1086 ----
  
  <hr>
  
  <p><a href="index.html">Return to the EGCS home page</a>
! <p><i>Last modified:  January 21, 1999</i>
  
  <!--#include virtual="/glimpsebox.html"-->
  </body>
*** wwwdocs/htdocs/faq.html	Mon Feb 15 09:57:50 1999
--- wwwdocs.orig/htdocs/faq.html	Wed Feb 10 10:13:45 1999
*************** comp.std.c++ FAQ</a>.
*** 95,102 ****
      <li><a href="spam.html">Dealing with spam on the lists</a>
      <li><a href="#squangle">How to work around too long C++ symbol names? 
  	 (<tt>-fsquangle</tt>)</a>
-     <li><a href="#gperf">When building from CVS sources, I see 'gperf: invalid option -- F', 
- 	even with the most current version of gperf.</a>
    </ol>
  </ol>
  
--- 95,100 ----
*************** to rebuild egcs.</p>
*** 981,987 ****
  <p>Autoconf is available from
  <a href="http://sourceware.cygnus.com/autoconf/">
  http://sourceware.cygnus.com/autoconf/</a>; have a look at
! <a href="ftp://egcs.cygnus.com/pub/egcs/infrastructure/">
  ftp://egcs.cygnus.com/pub/egcs/infrastructure/</a> for the other packages.
  </p>
  
--- 979,985 ----
  <p>Autoconf is available from
  <a href="http://sourceware.cygnus.com/autoconf/">
  http://sourceware.cygnus.com/autoconf/</a>; have a look at
! <a name="ftp://egcs.cygnus.com/pub/egcs/infrastructure/">
  ftp://egcs.cygnus.com/pub/egcs/infrastructure/</a> for the other packages.
  </p>
  
*************** initialized by default), then rebuilding
*** 1081,1113 ****
  
  <hr>
  
- <h2><a name="gperf">When building from CVS sources, I see 'gperf: 
- invalid option -- F', even with the most current version of gperf.
- </a></h2>
- 
- <p>The current version of gperf (v2.7) does not support the -F flag 
- which is used when building egcs from CVS sources.  You will need to 
- obtain a patch for gperf and rebuild the program; this patch is available 
- at <a href="ftp://egcs.cygnus.com/pub/egcs/infrastructure">
- ftp://egcs.cygnus.com/pub/egcs/infrastructure/</a>
- 
- <p>Patches for other tools, particularly autoconf, may also be necessary 
- if you're building from CVS sources.  Please see the 
- <a href="#generated_files">FAQ entry</a> regarding these tools to 
- determine if anything else is needed.
- 
- <p>These patched utilities should <strong>only</strong> be required if 
- you are building from CVS sources.  For example, gperf is used to 
- generate C code for a perfect hash function given an input file.  
- Distributions of egcs already contain the generated C code, while the 
- CVS sources will provide only the gperf input file.  So gperf should 
- only be necessary if you are building anything obtained from CVS.
- 
- <hr>
- 
- 
  <p><a href="index.html">Return to the EGCS home page</a>
! <p><i>Last modified:  February 15, 1999</i>
  
  <!--#include virtual="/glimpsebox.html"-->
  </body>
--- 1079,1086 ----
  
  <hr>
  
  <p><a href="index.html">Return to the EGCS home page</a>
! <p><i>Last modified:  January 21, 1999</i>
  
  <!--#include virtual="/glimpsebox.html"-->
  </body>
*** wwwdocs/htdocs/cvs.html	Mon Feb 15 09:59:16 1999
--- wwwdocs.orig/htdocs/cvs.html	Wed Feb 10 10:13:44 1999
*************** to check out the egcs sources.
*** 61,73 ****
  update"</code> will sync your local copy with the repository.  See the
  CVS manual for additional information on how to use CVS.
  
! <br><br>
! <strong>Note</strong>
! <p>It may be necessary to obtain patches for common utilities when building
! from CVS.  We recommend you read the <a href="faq.html#generated_files"> 
! FAQ entry</a> regarding additional tools you may need.  Another 
! <a href="faq.html#gperf">FAQ entry</a> documents changes you will likely have
! to make to the gperf utility.
  
  <p> You can check out the egcs-1.0.x release branch with the following command:
  
--- 61,69 ----
  update"</code> will sync your local copy with the repository.  See the
  CVS manual for additional information on how to use CVS.
  
! <p>We recommend you read the <a href="faq.html#generated_files"> 
! FAQ entry regarding additional tools you may need when building from CVS
! sources </a>
  
  <p> You can check out the egcs-1.0.x release branch with the following command:
  
*************** the web pages.
*** 95,101 ****
  <p>Enjoy!
  
  <hr>
! <i>Last modified on February  15, 1999.</i>
  <hr>
  
  <a href="">Return to the egcs home page</a>
--- 91,97 ----
  <p>Enjoy!
  
  <hr>
! <i>Last modified on January  8, 1999.</i>
  <hr>
  
  <a href="">Return to the egcs home page</a>

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