From a81f695b15865268fea6ee062a381ba8e43a02b4 Mon Sep 17 00:00:00 2001
From: gingold <gingold@b72b5c32-5f01-0410-b925-b5c7b92870f7>
Date: Mon, 2 Oct 2006 04:33:36 +0000
Subject: direct drivers and bugs fix

---
 doc/ghdl.texi | 31 +++++++++++++++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

(limited to 'doc/ghdl.texi')

diff --git a/doc/ghdl.texi b/doc/ghdl.texi
index e83a0ac55..38ff82a33 100644
--- a/doc/ghdl.texi
+++ b/doc/ghdl.texi
@@ -516,6 +516,7 @@ no options are allowed after a filename or a unit name.
 * Cross-reference command::     
 * File commands::               
 * Misc commands::               
+* Installation Directory::      
 * IEEE library pitfalls::       
 @end menu
 
@@ -893,6 +894,11 @@ library which has been named in your design.
 
 This option is only useful during elaboration.
 
+@item --PREFIX=@var{PATH}
+@cindex @option{--PREFIX} switch
+Use @var{PATH} as the prefix path to find commands and pre-installed (std and
+ieee) libraries.
+
 @item --GHDL1=@var{COMMAND}
 @cindex @option{--GHLD1} switch
 Use @var{COMMAND} as the command name for the compiler.  If @var{COMMAND} is
@@ -1291,7 +1297,7 @@ Display on the standard output lines of files preceded by line number.
 $ ghdl --lines @var{files}
 @end smallexample
 
-@node Misc commands, IEEE library pitfalls, File commands, Invoking GHDL
+@node Misc commands, Installation Directory, File commands, Invoking GHDL
 @comment  node-name,  next,  previous,  up
 @section Misc commands
 There are a few GHDL commands which are seldom useful.
@@ -1352,7 +1358,28 @@ Display the @code{GHDL} version and exit.
 $ ghdl --version
 @end smallexample
 
-@node IEEE library pitfalls,  , Misc commands, Invoking GHDL
+@node Installation Directory, IEEE library pitfalls, Misc commands, Invoking GHDL
+@comment  node-name,  next,  previous,  up
+@section Installation Directory
+@c @code{GHDL} is installed with the @code{std} and @code{ieee} libraries.  
+During analysis and elaboration @code{GHDL} may read the @code{std}
+and @code{ieee} files.  The location of these files is based on the prefix,
+which is (in priority order):
+@enumerate
+@item
+the @option{--PREFIX=} command line option
+
+@item
+the @var{GHDL_PREFIX} environment variable
+
+@item
+a built-in default path.  It is an hard-coded path on GNU/Linux and the
+value of the @samp{HKLM\Software\Ghdl\Install_Dir} registry entry on Windows.
+@end enumerate
+
+You should use the @option{--dispconfig} command (@pxref{Dispconfig command} for details) to disp and debug installation problems.
+
+@node IEEE library pitfalls,  , Installation Directory, Invoking GHDL
 @comment  node-name,  next,  previous,  up
 @section IEEE library pitfalls
 When you use options @option{--ieee=synopsys} or @option{--ieee=mentor},
-- 
cgit v1.2.3