aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorumarcor <unai.martinezcorral@ehu.eus>2021-04-22 16:39:56 +0200
committertgingold <tgingold@users.noreply.github.com>2021-04-22 18:53:03 +0200
commite6f2e299607dd76fd0c9f1129a138a0517e7646c (patch)
tree1be6dfd14c9480d65e242e30d0582404c3c6be49 /doc
parent8444c4d233aade37c218ef778bd1105dca693f48 (diff)
downloadghdl-e6f2e299607dd76fd0c9f1129a138a0517e7646c.tar.gz
ghdl-e6f2e299607dd76fd0c9f1129a138a0517e7646c.tar.bz2
ghdl-e6f2e299607dd76fd0c9f1129a138a0517e7646c.zip
doc: style, use '[options...]' consistently
Diffstat (limited to 'doc')
-rw-r--r--doc/using/InvokingGHDL.rst20
-rw-r--r--doc/using/Synthesis.rst6
2 files changed, 13 insertions, 13 deletions
diff --git a/doc/using/InvokingGHDL.rst b/doc/using/InvokingGHDL.rst
index 1b0805591..247e0efa3 100644
--- a/doc/using/InvokingGHDL.rst
+++ b/doc/using/InvokingGHDL.rst
@@ -151,7 +151,7 @@ See :option:`-e`, :option:`-r` and :ref:`USING:Simulation`.
Check syntax [``-s``]
---------------------
-.. option:: -s <[options] files>
+.. option:: -s <[options...] files>
Analyze files but do not generate code.
This command may be used to check the syntax of files.
@@ -163,7 +163,7 @@ It does not update the library.
Analyze and elaborate [``-c``]
------------------------------
-.. option:: -c <[options] file... -<e|r> top_unit [arch]>
+.. option:: -c <[options...] file... -<e|r> top_unit [arch]>
.. HINT::
With GCC/LLVM, :option:`-e` should be used, and :option:`-r` with mcode.
@@ -208,7 +208,7 @@ GHDL has a few commands for rebuilding a design.
Import [``-i``]
---------------
-.. option:: -i <[options] file...>
+.. option:: -i <[options...] file...>
All the files specified in the command line are scanned, parsed and added into the libraries but as not yet analyzed.
No object files are created.
@@ -231,7 +231,7 @@ See :option:`-m`, to actually build the design.
Make [``-m``]
-------------
-.. option:: -m <[options] [library.]top_unit [arch]>
+.. option:: -m <[options...] [library.]top_unit [arch]>
Analyze automatically outdated files and elaborate a design.
The primary unit denoted by the ``[library.]top_unit`` argument must already be known by the system, either because you
@@ -276,7 +276,7 @@ If necessary, the design hierarchy is elaborated.
Generate Makefile [``--gen-makefile``]
--------------------------------------
-.. option:: --gen-makefile <[options] [library.]top_unit [arch]>
+.. option:: --gen-makefile <[options...] [library.]top_unit [arch]>
This command works like the make command (see :option:`-m`), but only a makefile is generated on the standard output.
@@ -285,7 +285,7 @@ This command works like the make command (see :option:`-m`), but only a makefile
Generate dependency file command [``--gen-depends``]
----------------------------------------------------
-.. option:: --gen-depends <[options] [library.]top_unit [arch]>
+.. option:: --gen-depends <[options...] [library.]top_unit [arch]>
Generate a Makefile containing only dependencies to build a design unit.
@@ -653,7 +653,7 @@ Furthermore, GHDL provides a few commands which act on a library:
.. index:: cmd library directory
-.. option:: --dir <[options] [libs]>
+.. option:: --dir <[options...] [libs]>
Displays the content of the design libraries (by default the ``work`` library).
All options are allowed, but only a few are meaningful: :option:`--work`, :option:`--workdir` and :option:`--std`.
@@ -663,7 +663,7 @@ All options are allowed, but only a few are meaningful: :option:`--work`, :optio
.. _Clean:command:
-.. option:: --clean <[options]>
+.. option:: --clean <[options...]>
Try to remove any object, executable or temporary file it could have created.
Source files are not removed.
@@ -674,7 +674,7 @@ The library is kept.
.. _Remove:command:
-.. option:: --remove <[options]>
+.. option:: --remove <[options...]>
Acts like the clean command but removes the library too.
Note that after removing a design library, the files are not known anymore by GHDL.
@@ -682,7 +682,7 @@ Note that after removing a design library, the files are not known anymore by GH
.. index:: cmd library copy
-.. option:: --copy <--work=name [options]>
+.. option:: --copy <--work=name [options...]>
Make a local copy of an existing library.
This is very useful if you want to add units to the ``ieee`` library:
diff --git a/doc/using/Synthesis.rst b/doc/using/Synthesis.rst
index c1a954e31..575da022b 100644
--- a/doc/using/Synthesis.rst
+++ b/doc/using/Synthesis.rst
@@ -30,14 +30,14 @@ versions of the standard, but which don't provide the most recent features.
Currently, the default output is a generic netlist using a (very simple) subset of VHDL 1993.
See :option:`--out` and :ghdlsharp:`1174` for on-going discussion about other output formats.
-.. option:: --synth <[options] [library.]top_unit [arch]>
+.. option:: --synth <[options...] [library.]top_unit [arch]>
Elaborates for synthesis the design whose top unit is indicated by ``[library.]top_unit [arch]``.
.. ATTENTION::
All the units must have been analyzed; that is, the artifacts of previously executed :option:`-a` calls must exist.
-.. option:: --synth <[options] files... -e [top_unit [arch]]>
+.. option:: --synth <[options...] files... -e [top_unit [arch]]>
Analyses and elaborates for synthesis the files present on the command line only.
Elaboration starts from the top unit indicated by ``[top_unit [arch]]``.
@@ -45,7 +45,7 @@ See :option:`--out` and :ghdlsharp:`1174` for on-going discussion about other ou
.. IMPORTANT::
Files can be provided in any order, but ``-e`` must be provided after them.
- That is, ``--synth <[options] files...>`` is NOT supported.
+ That is, ``--synth <[options...] files...>`` is NOT supported.
This is because we want to unambiguously tell files and the unit specification apart.
We don't want to rely on parsing the items and guessing whether we are dealing with files or a top unit name.
In corner cases, a filename might exist which matches the name of a primary unit: ``ghdl synth name``.