.PS 66,60 .RM 78 .LM 5 .B 2 .C ^&EDITLIB\& .P EDITLIB is a prodecure that allows easy creation and maintenance of libraries. EDITLIB uses the system LIBRARIAN command and allows a new type of library - FORTRAN. Any files created by EDITLIB may also be used by the system LIBRARY command, except the FORTRAN libraries. The FORTRAN libraries must be created and maintained by EDITLIB. Libraries are indexed files that contain modules of code or text. Libraries save disk space by keeping many routines, data, or programs on one file. Libraries also aid in the maintenace of large programs. There are five different types of libraries: FORTRAN, OBJECT, TEXT, HELP and MACRO. .P The five type of libraries are distinquished by their file types: .P FORTRAN libraries (default file type FLB) contain programs, functions and subroutines wriiten in FORTRAN. Each module name is the same as the name of the program, subroutine, or function. Modules are used as the input to the FORTRAN command. The default file type used when creating, inserting, or extracting is FOR for this type of library. .P OBJECT libraries (default file type OLB) contain modules created by FORTRAN or MACRO commands. This type of library is used with the LINK command to satisfy externals. The defualt file type used when creating, inserting, or extracting is OBJ for this type of library. .P TEXT libraries (default file type HLB) contain any sequential record files the user wishes to include. The module name would be the same as the file name. TEXT libraries may be used within a user program or manually from the DIGITAL COMMAND LANGUAGE (DCL) level. The default file type used when creating, inserting, or extracting is TXT for this type of library. .P MACRO libraries (default file type MLB) contain macro definitions used as input to the assembler. These are generally system routines. The default file type used when creating, inserting, or extracting is MAR for this type of library. .P HELP libraries (default file type HLB) contain help modules. The module name would be the same as the file name when inserted. The system help library is maintained by this type of library. User HELP libraries can be created and used with a program by using FORTRAN callable routines. (See Librarian utility in the VAX-11 Utility Reference Manual). .P 0 .NF .NJ .FLAGS CONTROL $ $C +3 +----------------------+---------+--------+-------+------+------+ $C +3 | Default file names | FORTRAN | OBJECT | MACRO | TEXT | HELP | $C +3 +----------------------+---------+--------+-------+------+------+ $C +3 | Library name | .FLB | .OLB | .MLB | .TLB | .HLB | $C +3 +----------------------+---------+--------+-------+------+------+ $C +3 | File name used when | | | | | | $C +3 | creating, inserting, | .FOR | .OBJ | .MAR | .TXT | .HLP | $C +3 | or extracting. | | | | | | $C +3 +----------------------+---------+--------+-------+------+------+ $FLAGS CONTROL . .F .J .PG .P 5 The procedure can be executed on a single command line by including all necessary parameters for a particular option or it can be executed interactively by leaving off all parameters. When executing as a single command and any parameter is left out or the parameter is not complete (such as library name without a file type), the procedure will prompt the user for the additional input necessary. When used interactively, the user will be prompted for any necessary input (such as file name for input file or module names to extract). EDITLIB does not delete any files it uses. Once a library is created, all files used to create it or any files inserted into it should be deleted by the user. .P The complete command string and an explanation of the parameters: .P EDITLIB [P1] [P2] [P3] [P4] .P P1 - EDITLIB options: .P 10 N - Create a new library .P L - List module names on library on screen. .I 15 (To list onto a file, L=file specification) .P R - Replace or add modules to library .P E - Extract modules from library .P D - Delete modules from library .P C - Compress current library and create new library .P X - Change library name that EDITLIB is working on .I 15 (Or X=New library name) .P H - List these options .P S - Stop procedure .P 5 P2 - Library name (If file specification does not include the file type, the user will be prompted for library type.) .P P3 - Parameter depending on option: .P 10 Create option - file name to read modules from .P Replace option - file name to read modules from .P Extract option - file name to write modules to .P Compress option - new library name .P Delete option - list of module name to delete .P 5 P4 - List of module name to extract (wildcards are allowed) .PG .P The LIST option of EDITLIB will create a list of module names on the library and write them seven names to a line, rather than the one name to a line that the Librarian routine uses. Additionally, if the library is an object library, all modules and all entry points will be listed. Entry point names will be preceeded with an asterisk to designate that it is not a module name but an entry point to the preceeding module name. .P Following is a sample list of a FORTRAN library: .LT Directory of TEXT library _DBA1:[EJB.XRLIB]XRLIB.FLB;2 on 20-NOV-1981 08:38:14 Creation date: 24-SEP-1981 15:03:13 Revision date: 27-OCT-1981 13:36:52 ABSOL ARPER CHARHOL DCDE DECODHR DECODI EXTRA FIT FIT3 HOLCHAR IDIGITI INTP1D INTP2D INTP3D LOOKUP MINMAX MINMAX2 MINMAXR MINV MTXE3 PTSLP SPLS TBLNDC TIMRI .EL .P Following is a sample list of an OBJECT library: .LT Directory of OBJECT library _DBA1:[EJB.XRLIB]XRLIB.OLB;5 on 20-NOV-1981 08:38:32 Creation date: 12-SEP-1981 23:05:02 Revision date: 27-OCT-1981 13:36:58 ABSOL ARPER CHARHOL DCDE DECODHR *DECODHI *DECODHI1 *DECODHI2 *DECODHI4 DECODI *DECODI1 *DECODI2 *DECODI4 *DECODR *DECODR4 *DECODR8 EXTRA FIT FIT3 HOLCHAR IDIGITI *IDIGITR INTP1D INTP2D INTP3D LOOKUP MINMAX MINMAX2 MINMAXR MINV MTXE3 NPARMS PTSLP SPLS TBLNDC TIMRI *TIMRB *TIMRE .EL