aboutsummaryrefslogtreecommitdiffstats
path: root/doc/Invoking_GHDL.rst
diff options
context:
space:
mode:
authorTristan Gingold <tgingold@free.fr>2016-08-30 05:00:02 +0200
committerTristan Gingold <tgingold@free.fr>2016-08-30 05:12:39 +0200
commit2566852c5601fd03f4a9c6b5939d30a56d919c5d (patch)
tree4513913d552dcf62793431d3f79aaed241764ccb /doc/Invoking_GHDL.rst
parentd6cb5a78af823c5405730ec71cbc7a1412621871 (diff)
downloadghdl-2566852c5601fd03f4a9c6b5939d30a56d919c5d.tar.gz
ghdl-2566852c5601fd03f4a9c6b5939d30a56d919c5d.tar.bz2
ghdl-2566852c5601fd03f4a9c6b5939d30a56d919c5d.zip
Document response files
Diffstat (limited to 'doc/Invoking_GHDL.rst')
-rw-r--r--doc/Invoking_GHDL.rst19
1 files changed, 12 insertions, 7 deletions
diff --git a/doc/Invoking_GHDL.rst b/doc/Invoking_GHDL.rst
index fda18f802..067cf7194 100644
--- a/doc/Invoking_GHDL.rst
+++ b/doc/Invoking_GHDL.rst
@@ -12,6 +12,11 @@ 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 :samp:`@` is considered as a response file; it is replaced
+by arguments read from the file (separated by blanks and end of line).
+
Building commands
=================
@@ -956,7 +961,7 @@ Display the `GHDL` version and exit::
VPI build commands
-==============
+==================
These commands simplify the compile and the link of a user vpi
module. They are all wrapper: the arguments are in fact a whole
@@ -968,7 +973,7 @@ command before its execution.
.. _VPI_compile_command:
VPI compile command
------------------
+-------------------
.. index:: --vpi-compile command
@@ -991,7 +996,7 @@ executes::
.. _VPI_link_command:
VPI link command
---------------
+----------------
.. index:: --vpi-link command
@@ -1015,7 +1020,7 @@ executes::
.. _VPI_cflags_command:
VPI cflags command
-----------------
+------------------
.. index:: --vpi-cflags command
@@ -1027,7 +1032,7 @@ Display flags added by :option:`--vpi-compile`::
.. _VPI_ldflags_command:
VPI ldflags command
------------------
+-------------------
.. index:: --vpi-ldflags command
@@ -1038,7 +1043,7 @@ Display flags added by :option:`--vpi-link`::
.. _VPI_include_dir_command:
VPI include dir command
---------------------
+-----------------------
.. index:: --vpi-include-dir command
@@ -1049,7 +1054,7 @@ Display the include directory added by the compile flags::
.. _VPI_library_dir_command:
VPI library dir command
--------------------
+-----------------------
.. index:: --vpi-library-dir command