diff mbox

update docs for --enable-languages

Message ID CABXYE2X9vZA_YWToHr-4d3iH90e2FPj-L1QRu+nS8fv=R=0A1w@mail.gmail.com
State New
Headers show

Commit Message

Jim Wilson April 28, 2015, 12:09 a.m. UTC 
I noticed this while working on my mostlyclean patch.  The list of
languages in the docs for --enable-languages is incomplete.  It is
missing jit and lto.  I also noticed that the grep command matches
boot_language= in addition to language= which is a little confusing,
so I added the ^.

The sentence I added for lto is awkward.  It isn't a default language,
but it is built by default.  Maybe this would make more sense if we
talked about boot languages, but then that gets us into another mess
describing exactly when languages are boot languages.  C is always a
boot language.  C++ is a boot language if bootstrapping.  And lto is a
boot language if --enable-lto which is the default.

Jim

Comments

Jim Wilson May 7, 2015, 10:15 p.m. UTC | #1 
ping

https://gcc.gnu.org/ml/gcc-patches/2015-04/msg01690.html

Jim

On Mon, Apr 27, 2015 at 5:09 PM, Jim Wilson <jim.wilson@linaro.org> wrote:
> I noticed this while working on my mostlyclean patch.  The list of
> languages in the docs for --enable-languages is incomplete.  It is
> missing jit and lto.  I also noticed that the grep command matches
> boot_language= in addition to language= which is a little confusing,
> so I added the ^.
>
> The sentence I added for lto is awkward.  It isn't a default language,
> but it is built by default.  Maybe this would make more sense if we
> talked about boot languages, but then that gets us into another mess
> describing exactly when languages are boot languages.  C is always a
> boot language.  C++ is a boot language if bootstrapping.  And lto is a
> boot language if --enable-lto which is the default.
>
> Jim
diff mbox

Patch

Index: ChangeLog
===================================================================
--- ChangeLog	(revision 222491)
+++ ChangeLog	(working copy)
@@ -1,3 +1,8 @@ 
+2015-04-27  Jim Wilson  <jim.wilson@linaro.org>
+
+	* install.texi (--enable-languages): Add missing jit and lto info.
+	Add ^ to grep command.
+
 2015-04-27  Yoshinori Sato <ysato@users.sourceforge.jp>
 
 	* config.gcc: Add h8300-*-linux.
Index: doc/install.texi
===================================================================
--- doc/install.texi	(revision 222491)
+++ doc/install.texi	(working copy)
@@ -1544,15 +1544,17 @@ 
 @var{langN} you can issue the following command in the
 @file{gcc} directory of your GCC source tree:@*
 @smallexample
-grep language= */config-lang.in
+grep ^language= */config-lang.in
 @end smallexample
 Currently, you can use any of the following:
 @code{all}, @code{ada}, @code{c}, @code{c++}, @code{fortran},
-@code{go}, @code{java}, @code{objc}, @code{obj-c++}.
+@code{go}, @code{java}, @code{jit}, @code{lto}, @code{objc}, @code{obj-c++}.
 Building the Ada compiler has special requirements, see below.
 If you do not pass this flag, or specify the option @code{all}, then all
 default languages available in the @file{gcc} sub-tree will be configured.
-Ada, Go and Objective-C++ are not default languages; the rest are.
+Ada, Go, Jit, and Objective-C++ are not default languages.  LTO is not a
+default language, but is built by default because @option{--enable-lto} is
+enabled by default.  The other languages are default languages.
 
 @item --enable-stage1-languages=@var{lang1},@var{lang2},@dots{}
 Specify that a particular subset of compilers and their runtime