.. status: ok


16.14 )library
--------------

ugSysCmdlibrary

library

 User Level Required: interpreter

 Command Syntax:





)library libName1 [libName2 ...]





)library )dir dirName





)library )only objName1 [objlib2 ...]





)library )noexpose





 Command Description:

This command replaces the )load system command that was available in
FriCAS releases before version 2.0. The )library command makes available
to FriCAS the compiled objects in the libraries listed.

For example, if you )compile dopler.as in your home directory, issue
)library dopler to have FriCAS look at the library, determine the
category and domain constructors present, update the internal database
with various properties of the constructors, and arrange for the
constructors to be automatically loaded when needed. If the )noexpose
option has not been given, the constructors will be exposed (that is,
available) in the current frame.

If you compiled a file with the old system compiler, you will have an
NRLIB present, for example, DOPLER.NRLIB, where DOPLER is a constructor
abbreviation. The command )library DOPLER will then do the analysis and
database updates as above.

To tell the system about all libraries in a directory, use )library )dir
dirName where dirName is an explicit directory. You may specify . as the
directory, which means the current directory from which you started the
system or the one you set via the )cd command. The directory name is
required.

You may only want to tell the system about particular constructors
within a library. In this case, use the )only option. The command
)library dopler )only Test1 will only cause the Test1 constructor to be
analyzed, autoloaded, etc..

Finally, each constructor in a library are usually automatically exposed
when the )library command is used. Use the )noexpose option if you not
want them exposed. At a later time you can use )set expose add
constructor to expose any hidden constructors.

 Note for FriCAS beta testers: At various times this command was called
)local and )with before the name )library became the official name.

 Also See: )cd ugSysCmdcd, )compile ugSysCmdcompile, )frame
ugSysCmdframe, and )set ugSysCmdset.