From af7c36fb9d32653e08fc99550b5eddce080202a7 Mon Sep 17 00:00:00 2001 From: Tristan Gingold Date: Mon, 4 Oct 2021 04:42:33 +0200 Subject: elab-order command: add an option to display libraries. Fix #1736 --- doc/using/InvokingGHDL.rst | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) (limited to 'doc') diff --git a/doc/using/InvokingGHDL.rst b/doc/using/InvokingGHDL.rst index f7ea85418..b50f98626 100644 --- a/doc/using/InvokingGHDL.rst +++ b/doc/using/InvokingGHDL.rst @@ -232,14 +232,18 @@ 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. +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. + +With the :option:`--libraries` option, each line contains first the +library name followed by the file name. + +Without the :option:`--libraries` option, the list does not include +information about the logical library names where each source needs +to be analyzed. Hence, it is useful when all sources belong +to the same ``WORK`` library. .. index:: cmd make -- cgit v1.2.3