summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTristan Gingold2015-11-29 07:36:36 +0100
committerTristan Gingold2015-11-30 08:02:16 +0100
commitbc46c647a48f84d75f4fd9adcf9673cb1d581b5f (patch)
tree9a5016e1f8a5f4b3b200b6c015d6136d4e87ade9
parent5e46a4e22a2a1438ee19fd4e964f4b3b2169ea1c (diff)
downloadghdl-bc46c647a48f84d75f4fd9adcf9673cb1d581b5f.tar.gz
ghdl-bc46c647a48f84d75f4fd9adcf9673cb1d581b5f.tar.bz2
ghdl-bc46c647a48f84d75f4fd9adcf9673cb1d581b5f.zip
Rework --dir command so that it could display ieee content.
Adjust doc.
-rw-r--r--doc/Invoking_GHDL.rst59
-rw-r--r--src/ghdldrv/ghdllocal.adb28
2 files changed, 40 insertions, 47 deletions
diff --git a/doc/Invoking_GHDL.rst b/doc/Invoking_GHDL.rst
index c126c25..e8f17de 100644
--- a/doc/Invoking_GHDL.rst
+++ b/doc/Invoking_GHDL.rst
@@ -22,7 +22,7 @@ Analysis command
.. index:: analysis
-.. index:: *-a* command
+.. index:: -a command
Analyze one or severals files::
@@ -48,7 +48,7 @@ Elaboration command
.. index:: elaboration
-.. index:: *-e* command
+.. index:: -e command
Elaborate a design::
@@ -101,7 +101,7 @@ Run command
.. index:: run
-.. index:: *-r* command
+.. index:: -r command
Run (or simulate) a design::
@@ -131,7 +131,7 @@ Elaborate and run command
.. index:: elaborate and run
-.. index:: *--elab-run* command
+.. index:: --elab-run command
Elaborate and then simulate a design unit::
@@ -148,7 +148,7 @@ Bind command
.. index:: binding
-.. index:: *--bind* command
+.. index:: --bind command
Bind a design unit and prepare the link step::
@@ -168,7 +168,7 @@ Link command
.. index:: linking
-.. index:: *--link* command
+.. index:: --link command
Link an already bound design unit::
@@ -184,7 +184,7 @@ equivalent to the bind command followed by the link command.
List link command
-----------------
-.. index:: *--list-link* command
+.. index:: --list-link command
Display files which will be linked::
@@ -203,7 +203,7 @@ Check syntax command
.. index:: checking syntax
-.. index:: *-s* command
+.. index:: -s command
Analyze files but do not generate code::
@@ -219,7 +219,7 @@ Analyze and elaborate command
.. index:: Analyze and elaborate command
-.. index:: *-c* command
+.. index:: -c command
Analyze files and elaborate them at the same time.
@@ -582,7 +582,7 @@ Import command
.. index:: importing files
-.. index:: *-i* command
+.. index:: -i command
Add files in the work design library::
@@ -611,7 +611,7 @@ Make command
.. index:: make
-.. index:: *-m* command
+.. index:: -m command
Analyze automatically outdated files and elaborate a design::
@@ -659,7 +659,7 @@ such a case, re-run the make command of GHDL.
Generate Makefile command
-------------------------
-.. index:: *--gen-makefile* command
+.. index:: --gen-makefile command
Generate a Makefile to build a design unit::
@@ -679,15 +679,16 @@ Directory command
.. index:: displaying library
-.. index:: *-d* command
+.. index:: --dir command
+.. option::--dir
Display the name of the units contained in a design library::
- ghdl -d [options]
+ ghdl --dir [options] [libs]
-
-The directory command, selected with the `-d` command line argument
-displays the content of the work design library. All options are
+The directory command, selected with the `--dir` command line argument
+displays the content of the design libraries (by default the
+:samp:`work` library). All options are
allowed, but only a few are meaningful: :option:`--work=NAME`,
:option:`--workdir=PATH` and :option:`--std=VER`.
@@ -696,7 +697,7 @@ Clean command
.. index:: cleaning
-.. index:: *--clean* command
+.. index:: --clean command
Remove object and executable files but keep the library::
@@ -716,7 +717,7 @@ Remove command
.. index:: cleaning all
-.. index:: *--remove* command
+.. index:: --remove command
Do like the clean command but remove the library too::
@@ -734,7 +735,7 @@ Copy command
.. index:: copying library
-.. index:: *--copy* command
+.. index:: --copy command
Make a local copy of an existing library::
@@ -807,7 +808,7 @@ files, therefore, they work even if a file has semantic errors.
Pretty print command
--------------------
-.. index:: *--pp-html* command
+.. index:: --pp-html command
.. index:: pretty printing
@@ -834,7 +835,7 @@ See :ref:`Cross-reference_command`, for more details about this CSS file.
Find command
------------
-.. index:: *-f* command
+.. index:: -f command
Display the name of the design units in files::
@@ -848,7 +849,7 @@ design hierarchy.
Chop command
------------
-.. index:: *--chop* command
+.. index:: --chop command
Chop (or split) files at design unit::
@@ -877,7 +878,7 @@ reduced too.
Lines command
-------------
-.. index:: *--lines* command
+.. index:: --lines command
Display on the standard output lines of files preceded by line number::
@@ -894,9 +895,9 @@ There are a few GHDL commands which are seldom useful.
Help command
------------
-.. index:: *-h* command
+.. index:: -h command
-.. index:: *--help* command
+.. index:: --help command
Display (on the standard output) a short description of the all the commands
available. If the help switch is followed by a command switch, then options
@@ -912,7 +913,7 @@ for this later command are displayed::
Disp config command
-------------------
-.. index:: *--disp-config* command
+.. index:: --disp-config command
.. index:: display configuration
@@ -926,7 +927,7 @@ This may be useful to track installation errors.
Disp standard command
---------------------
-.. index:: *--disp-standard* command
+.. index:: --disp-standard command
.. index:: display :samp:`std.standard`
@@ -938,7 +939,7 @@ Display the :samp:`std.standard` package::
Version command
---------------
-.. index:: *--version* command
+.. index:: --version command
.. index:: version
diff --git a/src/ghdldrv/ghdllocal.adb b/src/ghdldrv/ghdllocal.adb
index b79a06f..0072b37 100644
--- a/src/ghdldrv/ghdllocal.adb
+++ b/src/ghdldrv/ghdllocal.adb
@@ -596,6 +596,7 @@ package body Ghdllocal is
is
pragma Unreferenced (Cmd);
begin
+ -- '-d' is for compatibility.
return Name = "-d" or else Name = "--dir";
end Decode_Command;
@@ -603,31 +604,22 @@ package body Ghdllocal is
is
pragma Unreferenced (Cmd);
begin
- return "-d or --dir Disp contents of the work library";
+ return "--dir [LIBs] Disp contents of the libraries";
end Get_Short_Help;
procedure Perform_Action (Cmd : in out Command_Dir; Args : Argument_List)
is
pragma Unreferenced (Cmd);
begin
- if Args'Length /= 0 then
- Error ("command '-d' does not accept any argument");
- raise Option_Error;
- end if;
-
- Flags.Bootstrap := True;
- -- Load word library.
- Libraries.Load_Std_Library;
- Libraries.Load_Work_Library;
-
- Disp_Library (Std_Names.Name_Work);
+ Setup_Libraries (True);
--- else
--- for L in Libs'Range loop
--- Id := Get_Identifier (Libs (L).all);
--- Disp_Library (Id);
--- end loop;
--- end if;
+ if Args'Length = 0 then
+ Disp_Library (Std_Names.Name_Work);
+ else
+ for I in Args'Range loop
+ Disp_Library (Name_Table.Get_Identifier (Args (I).all));
+ end loop;
+ end if;
end Perform_Action;
-- Command Find.