From 32229cb7bcdde59869fe7b45aed9b3b8eb40c5ce Mon Sep 17 00:00:00 2001 From: Tristan Gingold Date: Sat, 18 Feb 2017 07:29:08 +0100 Subject: Regenerate ghdl.texi --- doc/ghdl.texi | 344 ++++++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 236 insertions(+), 108 deletions(-) diff --git a/doc/ghdl.texi b/doc/ghdl.texi index e0912f2a7..f686f6a4e 100644 --- a/doc/ghdl.texi +++ b/doc/ghdl.texi @@ -21,7 +21,7 @@ @copying @quotation -GHDL 0.33, July 14, 2016 +GHDL 2016-09-14, February 18, 2017 Tristan Gingold @@ -87,6 +87,7 @@ Invoking GHDL * Building commands:: * GHDL options:: * Passing options to other programs:: +* GHDL Diagnostics Control:: * GHDL warnings:: * Rebuilding commands:: * Library commands:: @@ -657,10 +658,16 @@ the command. The options are used to slightly modify the action. No option is allowed before the command. Except for the run command, no option is allowed after a filename or a unit name. +If the number of options is large and the command line length is +beyond the system limit, you can use a response file. An argument that +starts with a @code{@@} is considered as a response file; it is replaced +by arguments read from the file (separated by blanks and end of line). + @menu * Building commands:: * GHDL options:: * Passing options to other programs:: +* GHDL Diagnostics Control:: * GHDL warnings:: * Rebuilding commands:: * Library commands:: @@ -740,7 +747,8 @@ ghdl -e [options..] primary_unit [secondary_unit] On GNU/Linux, if the GCC backend was enabled during the compilation of @cite{GHDL}, the elaboration command creates an executable containing the code of the @cite{VHDL} -sources, the elaboration code and simulation code to execute a design hierarchy. +sources, the elaboration code and simulation code to execute a design +hierarchy. The executable is created in the current directory. On Windows or if the GCC backend was not enabled, this command elaborates the design but does not generate anything. @@ -806,7 +814,7 @@ The options and arguments are the same as for the elaboration command, @ref{15,, On GNU/Linux this command simply determines the filename of the executable and executes it. Options are ignored. You may also directly execute -the program. +the program. The executable must be in the current directory. This command exists for three reasons: @@ -1151,6 +1159,9 @@ are valid. word. Because the constant @code{state1} and the enumeration literal @code{state1} are homograph, the enumeration literal is hidden in the immediate scope of the constant). + +This option also relaxes the rules about pure functions. Violations +result in warnings instead of errors. @end deffn @geindex command line option; -fpsl @@ -1212,19 +1223,35 @@ ieee) libraries. @deffn {Option} @w{-}@w{-}GHDL1= Use @code{COMMAND} as the command name for the compiler. If @code{COMMAND} is -not a path, then it is search in the list of program directories. +not a path, then it is searched in the path. +@end deffn + +@geindex command line option; --AS= +@anchor{Invoking_GHDL cmdoption--AS}@anchor{36} +@deffn {Option} @w{-}@w{-}AS= + +Use @code{COMMAND} as the command name for the assembler. If @code{COMMAND} is +not a path, then it is searched in the path. The default is @code{as}. +@end deffn + +@geindex command line option; --LINK= +@anchor{Invoking_GHDL cmdoption--LINK}@anchor{37} +@deffn {Option} @w{-}@w{-}LINK= + +Use @code{COMMAND} as the linker driver. If @code{COMMAND} is +not a path, then it is searched in the path. The default is @code{gcc}. @end deffn @geindex command line option; -v -@anchor{Invoking_GHDL cmdoption-v}@anchor{36} +@anchor{Invoking_GHDL cmdoption-v}@anchor{38} @deffn {Option} @w{-}v Be verbose. For example, for analysis, elaboration and make commands, GHDL displays the commands executed. @end deffn -@node Passing options to other programs,GHDL warnings,GHDL options,Invoking GHDL -@anchor{Invoking_GHDL passing-options-to-other-programs}@anchor{37} +@node Passing options to other programs,GHDL Diagnostics Control,GHDL options,Invoking GHDL +@anchor{Invoking_GHDL passing-options-to-other-programs}@anchor{39} @section Passing options to other programs @@ -1237,28 +1264,59 @@ Both the compiler and the linker are in fact GCC programs. See the GCC manual for details on GCC options. @geindex command line option; -Wc@comma{}