next up previous contents index
Next: The Cells List Button: Up: The File Menu: Xic Previous: The Files List Button:   Contents   Index

The Libraries List Button: List Open Libraries

This command produces a pop-up which displays a listing of libraries that are currently ``open''. An open library is searched when a cell name is being resolved. The open libraries are searched before the files in the search path. A library is opened if it is ever listed in a content window from the Files Listing panel, or if a cell from that library is ever opened, such as by giving ``/path/library cellname'' to the Edit command in the Edit Menu, or if opened with the Open button (see below).

Libraries are listed and searched in the order opened. When resolving a reference, the first match will supersede any later entries. Clicking on a library in the listing will display a listing of references in that library.

There are five buttons: Edit, Master, Open, Close, and Help. If Edit or Master is active (at most one can be active at once), clicking on a cell reference in a content window will generally edit that cell or add that cell to the master list in the Cell Placement Control pop-up. This will be manifestly true only if the referenced cell is in an archive file. A native cell will always be superseded by an inlined cell of the same reference name found earlier in the library search. Also, the NoReadExclusive and AddToBack variables will affect cell name resolution as in a normal open.

The Open button presents a list of library files found in the search path. To speed the search, only files with a ``.lib'' extension are checked for the library keyword at the top of the file, so library files that do not have a ``.lib'' extension will not appear in this list. The open libraries have an ``O'' in the first column. Clicking on the entries in this list will open/close the libraries. When open, the library will also appear in the main pop-up list.

The Close button will close the library that is currently selected in the main list, after confirmation. Since libraries in this list may have been opened through a lengthly indirection chain, a confirmation is required to actually close the library.

With the Edit or Master button active, clicking on a reference to another library that does not have a cellname will pop-up a content window for that library (opening it in the process).


next up previous contents index
Next: The Cells List Button: Up: The File Menu: Xic Previous: The Files List Button:   Contents   Index
Stephen R. Whiteley 2006-10-23