aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/using/InvokingGHDL.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/using/InvokingGHDL.rst b/doc/using/InvokingGHDL.rst
index 3a06338eb..f7ea85418 100644
--- a/doc/using/InvokingGHDL.rst
+++ b/doc/using/InvokingGHDL.rst
@@ -222,6 +222,24 @@ The make command will then be able to recursively build a hierarchy from an enti
However, since they are not analyzed, many errors are tolerated by this command.
See :option:`-m`, to actually build the design.
+See also :option:`--elab-order`, for retrieving the compilation order guessed recursively.
+
+
+.. index:: cmd elaboration order
+
+Elab-order [``--elab-order``]
+-----------------------------
+
+.. option:: --elab-order <[options...] [libray.]top_unit [arch]>
+
+Print the list of sources required for elaborating a unit, in order for them to be analyzed without dependency issues.
+This is expected to be used after :option:`-i`, or for retrieving the order for some unit analyzed through third-party
+scripts.
+
+.. ATTENTION::
+ Currently, the list does not include information about the logical library names where each source needs to be
+ analyzed.
+ Hence, it is mostly useful when all sources belong to the same ``WORK`` library.
.. index:: cmd make