diff options
author | Iain Buclaw <ibuclaw@gdcproject.org> | 2020-04-23 10:02:46 +0200 |
---|---|---|
committer | Iain Buclaw <ibuclaw@gdcproject.org> | 2020-04-23 10:03:28 +0200 |
commit | 66c2273714eb14bf8f6ba052e8c0e26c25709bc9 (patch) | |
tree | b09995e3ce6db63a53f7ef33e0098536bbeb78d9 /gcc/doc | |
parent | a39ed81b8a0b46320a7c6ece3f7ad4c3f8519609 (diff) | |
download | gcc-66c2273714eb14bf8f6ba052e8c0e26c25709bc9.zip gcc-66c2273714eb14bf8f6ba052e8c0e26c25709bc9.tar.gz gcc-66c2273714eb14bf8f6ba052e8c0e26c25709bc9.tar.bz2 |
doc: Document all D-specific configuration options.
gcc/ChangeLog:
* doc/install.texi (D-Specific Options): Document
--enable-libphobos-checking and --with-libphobos-druntime-only.
Diffstat (limited to 'gcc/doc')
-rw-r--r-- | gcc/doc/install.texi | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index bc5259d..39ae068 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -2460,6 +2460,37 @@ default locations. The following options apply to the build of the D runtime library. @table @code +@item --enable-libphobos-checking +@itemx --disable-libphobos-checking +@itemx --enable-libphobos-checking=@var{list} +This option controls whether run-time checks and contracts are compiled into +the D runtime library. When the option is not specified, the library is built +with @samp{release} checking. When the option is specified without a +@var{list}, the result is the same as @samp{--enable-libphobos-checking=yes}. +Likewise, @samp{--disable-libphobos-checking} is equivalent to +@samp{--enable-libphobos-checking=no}. + +The categories of checks available in @var{list} are @samp{yes} (compiles +libphobos with @option{-fno-release}), @samp{no} (compiles libphobos with +@option{-frelease}), @samp{all} (same as @samp{yes}), @samp{none} or +@samp{release} (same as @samp{no}). + +Individual checks available in @var{list} are @samp{assert} (compiles libphobos +with an extra option @option{-fassert}). + +@item --with-libphobos-druntime-only +@itemx --with-libphobos-druntime-only=@var{choice} +Specify whether to build only the core D runtime library (druntime), or both +the core and standard library (phobos) into libphobos. This is useful for +targets that have full support in druntime, but no or incomplete support +in phobos. @var{choice} can be one of @samp{auto}, @samp{yes}, and @samp{no} +where @samp{auto} is the default. + +When the option is not specified, the default choice @samp{auto} means that it +is inferred whether the target has support for the phobos standard library. +When the option is specified without a @var{choice}, the result is the same as +@samp{--with-libphobos-druntime-only=yes}. + @item --with-target-system-zlib Use installed @samp{zlib} rather than that included with GCC@. This needs to be available for each multilib variant, unless configured with |