home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / BUSI / BIBL64.ZIP / BIBL.DOC next >
Text File  |  1992-04-08  |  72KB  |  1,564 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         B I B L
  8.  
  9.  
  10.         release 6.4
  11.  
  12.  
  13.   
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.         (c) 1991,92 GMUtant Software
  44.  
  45.  
  46.          Clyde W. Grotophorst
  47.          Route 1, Box 296
  48.          Hamilton, Virginia 22068
  49.          U.S.A.
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.         This documentation covers both the SHAREWARE and REGISTERED
  58.         versions of the package. An [R] appears in the left margin when
  59.         a registered-version-only feature is discussed. Non-registered
  60.         users of this software are granted a limited license to make an
  61.         evaluation copy for trial use on a private, non-commercial basis,
  62.         for the express purpose of determining whether BIBL meets their
  63.         needs. At the end of this trial period, (30 days) you should
  64.         either register your copy or discontinue use.
  65.  
  66.         Registration licenses you to use the product on a regular
  67.         basis. Registration also provides you with access to the GMUtant
  68.         Online BBS ((703) 993-2219) as a registered user--where you may
  69.         receive support, leave questions, requests for enhancements, or
  70.         download the latest release of the program. The registered
  71.         version offers expanded capabilities.
  72.  
  73.         Registering BIBL will also allow you to download special
  74.         programs from the GMUtant OnLine BBS--for example, BIBL286 is a
  75.         version of BIBL using machine code for the 80286 or 80386
  76.         processor. This allows BIBL to take better advantage of these
  77.         CPUs and creates a slightly smaller BIBL.EXE file.
  78.  
  79.         Registration requires a contribution of $ 39.00 to the
  80.         author, as a reimbursement for the time spent working on this
  81.         program. Once you have registered, you will be given a
  82.         registration number. You may 'upgrade' your SHAREWARE version to
  83.         REGISTERED by entering that number into BIBL (via CONVERT on
  84.         the maintenance menu). By using this method, you may
  85.         instantly upgrade any subsequent release without having to call
  86.         our BBS to download the file.
  87.  
  88.  
  89.                                  * * * * *
  90.  
  91.         If you have registered a previous version of BIBL, you are
  92.         also a registered user of any subsequent version. You may
  93.         upgrade at any time by sending $ 5.00 to the address below. The
  94.         latest version will be sent by return 1st Class mail (specify
  95.         disk size).
  96.  
  97.                                  * * * * *
  98.  
  99.         Send your name, address and registration payment to:
  100.  
  101.                             Clyde W. Grotophorst
  102.                             Route 1, Box 296
  103.                             Hamilton, Virginia 22068
  104.  
  105.                           ** CREDIT CARD ORDERS **
  106.  
  107.         You may also order the registered version of BIBL from Public
  108.         (software) Library with your MasterCard, Visa, American Express,
  109.         or Discover Card by calling 800-2424-PSL or 713-524-6394 or by
  110.         FAX to 713-524-6398, or by CompuServe to 71355,470 or by mail to
  111.         PsL, P.O. Box 35705, Houston, Texas 77235-5705. These numbers
  112.         are for ordering only. The cost is $ 39.00 which includes a copy
  113.         of the latest registered version to you by return 1st class mail.
  114.  
  115.  
  116.  
  117.         BIBL (6.4)         (c) 1991, GMUtant Software               = 2 =
  118.  
  119.         We've included sample records with BIBL for demonstration
  120.         purposes. The sample database and index are inside BIBLDEMO.EXE.
  121.         Type BIBLDEMO at the DOS prompt to extract these files. You may
  122.         delete DEMO.DAT and DEMO.IX when you are ready to begin entering
  123.         information you want to keep. To see the sorts of things included
  124.         in the sample file, and to study how you might use the fields in
  125.         a BIBL record, activate BIBL then press L, the last record in the
  126.         file will display. Press [B] to move backward through the file.
  127.  
  128.                            Q U I C K S T A R T
  129.  
  130.         Copy BIBL.EXE to a sub-directory on your disk (e.g., C:\BIBL)
  131.         then type BIBL to activate the program. If you have not extracted
  132.         the demo database, enter the name of the database you want to
  133.         create. If you want to use the sample database instead of
  134.         beginning with an empty one, type BIBLDEMO before running BIBL.
  135.         This will extract the demonstration files (DEMO.DAT and DEMO.IX).
  136.         Minimum files needed: BIBL.EXE and BIBL.HLP
  137.  
  138.         
  139.         BIBL Features [SHAREWARE and REGISTERED]:
  140.  
  141.  
  142.  
  143.         - an unlimited number of databases are supported.
  144.         - more records from one database to another
  145.         - menu-driven.
  146.         - mouse-support for most areas of the program.
  147.         - easily understood user interface (bounce-bar menus or accepts
  148.           first letter of each command).
  149.         - five indexes are maintained (in a single file) for fast
  150.           retrieval and sorted extracts (author, author/title, title,
  151.           subject, and descriptor).
  152.         - up to 8 words from the descriptor field are indexed individually.
  153.         - produces bibliographies in several forms (brief, annotated,
  154.           full (and with registered version, labelled) based on
  155.           information in any field. Each bibliography is sorted by
  156.           author, then within author, by title. Registered version
  157.           also supports searching *anywhere* in a record for matches.
  158.         - user-selected fields for output (soft return option available).
  159.         - when no match is made on an indexed search, BIBL displays where
  160.           in the index your query would have appeared (near misses).
  161.         - produces a wide variety of lists (in ASCII form) which may be
  162.           printed or edited with any word-processor that accepts ASCII
  163.           files for input (most do).
  164.         - use WordPerfect or other large program as your external
  165.           editor/viewer/printing program. BIBL uses complex memory
  166.           management routines to enable even WordPerfect to run as
  167.           a 'child' process.
  168.         - if desired, BIBL will run in a 'read-only' mode. This allows
  169.           copies of your database to be accessed by the public but
  170.           protects against editing, deleting or otherwise modifying the file.
  171.         - BIBL offers an ASCII file viewer that supports a mouse, and is
  172.           moveable, resizeable, and ZOOMable.
  173.         - Index graph shows progress as indexing/reindexing occurs.
  174.         - ability to print or save to disk any individual record.
  175.         - main menu screen always reports active database and number of
  176.           records in that file.
  177.         - verification of keywords during data entry (if desired)
  178.  
  179.          BIBL (6.4)             (c) 1991, GMUtant Software          = 3 =
  180.  
  181.         Features (continued)
  182.  
  183.         - empty records (e.g., after deletions) are used as new records  are added.
  184.         - BIBL shells out to PKZIP, LHA or ARJ to create compressed
  185.           backup copies of your database. BIBL will find the compression
  186.           utility if it exists ANYWHERE on your DOS path.
  187.         - Boolean AND, OR, NOT searching supported for ALL fields. Up to
  188.           four terms may be used. May also limit search to descriptor field.
  189.         - Selected reports (list of subjects, list of titles, etc) may be
  190.           viewed onscreen and/or sent to disk.
  191.         - BIBL can produce a comma-delimited file of the database.
  192.         - any ASCII file may be used for display when I (INFORMATION) is
  193.           pressed on the main menu.
  194.         - Shell to DOS (heap compression frees additional memory)
  195.         - Use an external program as your file viewer (editor/printer)
  196.  
  197.                    REGISTERED version adds these features:
  198.  
  199.         - BIBL will store index data in EMS (Expanded Memory) if it is
  200.           available on your system...otherwise, a 40% of available RAM
  201.           (after BIBL loads) is devoted to in-memory index storage. BIBL
  202.           will allocate up to 33% of available EMS to index storage. EMS
  203.           speeds retrieval and cut reindexing time for larger databases.
  204.           In tests on systems without disk caching, we found an average
  205.           improvement of 33%.
  206.  
  207.         - Using the "LABELLED" output option under BIBLIOGRAPHIES, you
  208.           may create an ASCII (*. BIX) file of records suitable for
  209.           import to other databases via the ASCII Import option on the
  210.           Maintenance menu. Using this method you also have the option of
  211.           deleting exported records from your original file as they transfer.
  212.  
  213.         - Bibliographies (option D under EXPORT) as well as other reports
  214.           may be created in 'word-processing' form (this will put soft
  215.           returns in your file within a given citation, hard returns
  216.           between them). This makes it much easier to do subsequent
  217.           editing of your bibliography with a word processor.
  218.  
  219.         - Bibliographies. Registered version supports export of records
  220.           based on ANY field in the record, not just Author, Publisher,
  221.           Subject, or Descriptor. Even *anywhere* in the record.
  222.  
  223.         - When running a BOOLEAN search, you may send matching records to
  224.           disk if desired. BIBL offers two formats for output (BIX or
  225.           unlabelled). Selecting BIX format enables you to move the
  226.           matching data to another BIBL database.
  227.  
  228.         BIBL (6.4)          (c) 1991, GMUtant Software              = 4 =
  229.  
  230.         Registered features (continued)
  231.  
  232.         - Store Datafiles and Indexes (*.DAT and *.IX) on another drive
  233.           or in  another subdirectory. This enables you to use BIBL on
  234.           remote disks if desired (e.g., on a LAN).
  235.  
  236.         - Global Find & Replace for text in ANY field, across the
  237.           database.
  238.  
  239.         - BIBL will run in 43/50 line mode.
  240.  
  241.                          I N S T A L L A T I O N
  242.  
  243.         Copy BIBL.EXE and BIBL.DOC to a sub─directory. If you want to
  244.         experiment with the sample database we provide, copy BIBLDEMO.EXE
  245.         to this sub-directory as well. Type BIBLDEMO at the DOS prompt
  246.         to extract the demostration files, then type BIBL to activate the
  247.         program. After you have experimented with the capabilities of
  248.         BIBL using the demo database, delete DEMO.DAT and the DEMO.IX
  249.         file. When you next activate BIBL, you will have the opportunity
  250.         to create a new (empty) database. Be sure your CONFIG.SYS file
  251.         contains the following minimum values:
  252.  
  253.           FILES=20,
  254.           BUFFERS=20.
  255.  
  256.         To find out whether your machine has a CONFIG.SYS file, issue the
  257.         following commands:
  258.  
  259.         PROMPT $P$G [press return. You may already be using this prompt
  260.          string, but if not, at least from here on out you will know what
  261.          drive and sub-directory you are defaulting to.]
  262.  
  263.         C: [press return...we want to log onto the C: drive]
  264.  
  265.         CD\ [press return], this should put us in the root directory
  266.         a 'C:\>' prompt should appear. If so, type the following command:
  267.  
  268.         DIR C*.SYS [press return]
  269.  
  270.         If you do not see a file named CONFIG.SYS in the newly displayed
  271.         text, you can safely assume that one does not exist.
  272.  
  273.         To Create CONFIG.SYS:
  274.  
  275.         Issue the following commands at C:\> prompt (to be a bit more
  276.         technical, while logged onto the root directory of the boot drive
  277.         (typically C:) of your system):
  278.  
  279.         Copy Con: CONFIG.SYS [press return]
  280.         FILES=20   [press return]
  281.         BUFFERS=20 [press F6]
  282.  
  283.         BIBL (6.4)          (c) 1991, GMUtant Software               = 5 =
  284.  
  285.  
  286.         You should receive a '1 file copied.' message. Reboot your
  287.         computer. The CONFIG.SYS file is read only during initial boot
  288.         of your system. Questions about this can be resolved by looking
  289.         at your DOS manual.
  290.  
  291.                           S Y S T E M   O V E R V I E W
  292.  
  293.         BIBL (rhymes with nibble) is a simple to use online catalog for
  294.         your personal library. Written in Turbo Pascal 6.0 and using full
  295.         B-tree indexing (thanks to TurboPower's B-Tree Filer package),
  296.         the system is fast, small, and very efficient. Menu-driven, BIBL
  297.         can be used to track your book collection, article reprints,
  298.         index your vertical file, manage a small office library, and so
  299.         on... In most areas bounce-bar menus are used. To select a particular
  300.         option, move the bar via the cursor until your desired operation
  301.         is highlighted, then press RETURN. If you're a touch typist, you
  302.         might prefer pressing the highlighted letter within (or just to
  303.         the left of) the choice you wish to make (e.g., Press S to
  304.         activate SEARCH on the main menu). On single line menus (e.g.,
  305.         when displaying matches), you may hit the highlighted letter to
  306.         execute the command, or move between them via the TAB key.
  307.         Clicking a mouse on your menu choice will also activate it.
  308.  
  309.         Command Line Switches ( DatabaseName or /p or /m or /v )
  310.  
  311.         DATABASE SELECTION. Put the name (DAT extension unnecessary)
  312.         of the database you want to use on the command line if
  313.         desired. This will bypass the selection menu if you have more
  314.         than one *.DAT/*.IX combination in the same subdirectory.
  315.         For example: BIBL DEMO /m [RETURN] at the DOS prompt would
  316.         activate BIBL in monochrome mode and open the database named
  317.         DEMO.
  318.  
  319.         If on a monochrome monitor you find you can not clearly read the
  320.         various BIBL status line displays, activate program with an '/m'
  321.         switch (for mono), e.g., BIBL /M <cr>.
  322.  
  323.         OPAC (Online Public Access Catalog) . If you want to have others
  324.         use your BIBL database but don't want them adding, deleting, or
  325.         editing records, begin BIBL with the /p switch. This activates
  326.         OPAC mode, disabling the Add function and Maintenance Menu.
  327.  
  328.         You may use any combination of command line arguments, in any
  329.         order--with the exception that FILENAME if it appears must
  330.         be the first one.
  331.  
  332.         [R] BIBL will also run in 43 or 50 line mode (EGA or VGA) if you
  333.         [R] start the program with a /v switch. BIBL will automatically
  334.         [R] detect hardware and make the appropriate setting.
  335.         [R] Upon exit, the 25 line mode will be restored. If you use
  336.         [R] WordPerfect 5.1 as your installed editor/viewer, and are
  337.         [R] BIBL in the 43/50 line mode, your call to WordPerfect will
  338.         [R] switch that package into 43/50 line mode as well.
  339.  
  340.         BIBL (6.4)          (c) 1991, GMUtant Software          = 6 =
  341.  
  342.  
  343.                                  OPENING MENU
  344.  
  345.         When you type BIBL at the DOS prompt, several things happen...
  346.  
  347.         1) the program allocates RAM for in-memory storage of the
  348.            indexes. The SHAREWARE version sets aside 40K, the REGISTERED
  349.            version uses 40% of available RAM (or 40K RAM and 1/3 of EMS).
  350.  
  351.         2) if you are using the SHAREWARE version, a reminder to
  352.            register screen appears (actually appears about 50% of the
  353.            time).
  354.  
  355.         3) the program next checks your disk to see how many *.DAT
  356.            files can be found...
  357.  
  358.                 a) One, BIBL opens that database.
  359.                 b) More than one, a pick-list appears. Saelect the file
  360.                    you want to use by moving the light bar with the
  361.                    cursor arrows until desired file is highlighted--then
  362.                    press RETURN (or double-click mouse on desired file).
  363.  
  364.         4) the main menu appears.
  365.  
  366.  
  367.                                 Main Menu Options
  368.  
  369.         L  List items in the database. This option allows you to
  370.            move through the database a record at a time. The records
  371.            appear in the order in which they were entered into the
  372.            system. Pressing L on the main menu takes you to the last
  373.            record in the file (the assumption being that you are
  374.            probably more interested in the more recent records). You
  375.            may move about the file via the J (Jump) command--which
  376.            'jumps' you to the record number you enter.
  377.         A  Add an item to the file. Use for entering data into a
  378.            database.  Disabled with /p switch used at startup.
  379.         S  Search a database. Supports a variety of search types.
  380.         E  Export data. Enables user to produce a variety of
  381.            reports, including bibliographies.
  382.         V  View ASCII file(s). Allows user to look at an ASCII file.
  383.            If you are using the registered version, and have
  384.            installed a word processing program (e.g., WordPerfect)
  385.            as your external editor/viewer, then pressing V calls
  386.            that program and passes the name of the file to view.
  387.         M  Maintenance functions. This function provides a variety
  388.            of support operations (rebuilding indexes, creating new
  389.            databases, deleting databases, Shell to DOS, backup, etc.).
  390.            Disabled if /p OPAC switch is used when starting BIBL.
  391.         D  Database selection. Once you have created a second
  392.            database, this function allows you to move between
  393.            database files.
  394.  
  395.         BIBL (6.4)          (c) 1991, GMUtant Software          = 7 =
  396.  
  397.         Main menu options (continued)
  398.  
  399.         I  Information on BIBL. Pressing I on the Main Menu causes
  400.            the file BIBL.HLP to display in a window on your screen.
  401.            To create your own help file, make an ASCII file and name
  402.            it BIBL.HLP. You do not have to worry about page breaks
  403.            or other formatting.
  404.         Q  Quit to DOS. Closes all files, halts program and exits.
  405.  
  406.                                 DATABASES
  407.  
  408.         BIBL can manage up to 200 distinct databases. While the
  409.         structure of each database is the same, you may have
  410.         several--enabling you to separate out records that belong
  411.         together. Each 'database' consists of two files (*.DAT and *.IX).
  412.         You create empty databases from the Maintenance sub-menu. Once
  413.         created, you may select (or activate) a particular database via
  414.         the Database Selection option on the main menu.
  415.  
  416.         I. ADDING RECORDS TO A DATABASE
  417.  
  418.         Each database is limited to 2 billion records although you'll run
  419.         out of disk space long before that becomes an issue. To begin
  420.         working toward that 2 billion, press A as the main menu displays.
  421.  
  422.         A blank record appears on the screen. Enter data in the
  423.         highlighted fields. If you want to skip a field, just press
  424.         RETURN when the cursor is inside that field's highlighted box.
  425.  
  426.         When you are finished, either press return when the highlighted
  427.         box is in line 7 of the note field, or press ESC.
  428.         BIBL will then offer a prompt line at the bottom of the screen,
  429.         asking to file the record, continue editing, verify keywords or
  430.         abandon it. You may click the appropriate response with your mouse
  431.         or enter the highlighted first letter of the option you desire
  432.         (e.g., A to Abandon).
  433.  
  434.         [Y] Yes, file record. This will add the record to the database
  435.             and update the index file (unless all fields in the record
  436.             are empty, in which case the command to file is ignored).
  437.         [N] No, edit Record. Returns cursor to 1st field of record.
  438.         [V] Verify. BIBL checks each descriptor against the database,
  439.             showing you which ones are currently used. This helps with
  440.             maintaining a 'controlled vocabularly.'
  441.         [A] Abandon. Releases data and returns you to the main menu.
  442.          
  443.         BIBL (6.4)          (c) 1991, GMUtant Software          = 8 =
  444.  
  445.                                 BIBL INDEXING
  446.  
  447.         Five indexes are maintained in the single file: 1) the first 20
  448.         characters of the author field, 25 characters of the TITLE field,
  449.         the entire SUBJECT field, each word (something with a space
  450.         before and after it) of the DESCRIPTOR field (must be more than a
  451.         single character), and a fifth index used to create temporary
  452.         sorts (by call number, author/title, etc.). By putting all five
  453.         indexes in a single file, performance is improved over systems
  454.         that put each index in its own file--DOS does not allocate a
  455.         large number of file handles for BIBL's use.
  456.  
  457.         Information is stored in upper case in the index file and your
  458.         query is converted to upper case before a search begins--thus you
  459.         don't have to worry about capitalization (although the way you
  460.         enter data is the way it will display and appear in any ASCII
  461.         file created by BIBL.
  462.  
  463.         FIELDS (Subject vs Descriptor): Most fields are obvious, but you
  464.         might not be familiar with the distinction we're making between
  465.         subject and descriptors. Put the most important term in the
  466.         subject field and other less useful but desired descriptive terms
  467.         in the DESC: field.
  468.  
  469.         EVERY word (anything between spaces) in the descriptor field
  470.         is individually indexed.
  471.  
  472.         Caution: No term in the descriptor field can be longer than 20
  473.         characters (or it will be truncated to 20 characters in the
  474.         index). The indexing algorithm considers a word to be anything
  475.         between two blank spaces. If you have a compound term, include a
  476.         '-' between the words so they'll be considered a single term
  477.         (e.g., 'World-War-II' is considered 1 term while 'World War II'
  478.         is three.). Up to 8 words in any one DESC field will be indexed.
  479.         A single letter WILL NOT be indexed. Each 'word' must be longer
  480.         than one character.
  481.  
  482.         LOCATION: You may use the location field for either a
  483.         classification number (if your organization system is
  484.         that evolved) or simply where you have stored the
  485.         physical item referenced in the BIBL record.
  486.  
  487.         There are three ways under the EXPORT sub-menu to produce a
  488.         report sorted on Location: Option [L] (C/A/T); Option
  489.         [M] (User-Defines); or Option [O], Location First.  The latter
  490.         writes each citation with location text first, then author,
  491.         title, publisher, and note.
  492.  
  493.         II. SEARCHING THE DATABASE
  494.  
  495.         To search, press S at the main menu, then via the light bar
  496.         select which field you wish to search (Author, Title, Subject,
  497.         etc.). Once you have selected the field you wish to
  498.         search, a 'QUERY' box will appear. Enter the text you wish
  499.         to locate in this box, at the 'Query >>' prompt.
  500.  
  501.         BIBL (6.4)          (c) 1991, GMUtant Software          = 9 =
  502.  
  503.         You may search text in ANY field of a BIBL record. Matches are
  504.         made using your input as a stem; that is, if you enter SMI and
  505.         SMITH exists, you'll get a match (it's called implied truncation).
  506.  
  507.         Note that while retrieval on indexed fields is very fast, searching
  508.         non-indexed fields (e.g., line 3 of the note field) is much slower.
  509.         On non-indexed fields, BIBL must read each record, comparing your query
  510.         with the contents of the field. You may abort a non-indexed search
  511.         by pressing any key to interrupt. On indexed field searches, if BIBL
  512.         can not find a match for your query, it will display several index
  513.         entries that come before and after where your query would have
  514.         fallen in the index. As your database grows, this becomes more useful.
  515.  
  516.         If you want to abandon searching after you have selected a particular
  517.         field to search, press RETURN instead of entering a search statement
  518.         at the 'Query >>' prompt. You will be returned to the main menu.
  519.  
  520.                         BOOLEAN SEARCHING (AND / OR / NOT)
  521.  
  522.         Use BOOLEAN search to search for up to 4 terms in a record. You
  523.         may search either the full record or limit the search to the
  524.         descriptor field. BOOLEAN searching does not use an index, so
  525.         retrieval time is a bit longer. When the full record is searched,
  526.         a high speed search algorithm (Boyer-Moore) is employed--this yields
  527.         a significant performance improvement over searching just the
  528.         Descriptor field--where BIBL uses a more traditional approach
  529.         (reading each record and comparing the field to your input).
  530.  
  531.         [R] Registered version supports dumping the results of a boolean
  532.         [R] search to disk. You may select either BIX format (for subsequent
  533.         [R] transfer to another datbase) or plain ASCII (no labels, formatted
  534.         [R] like QUERY.TXT entries).  You give BIBL a name for the output file
  535.         [R] and based on your format choice, the extension (BIX or TXT) is
  536.         [R] automatically appended. LAN users: If you have directed BIBL to
  537.         [R] look on a remote drive for the database (via BIBLPATH.CFG), the
  538.         [R] BIX file will be put where BIBL.EXE resides, not where the
  539.         [R] database (*.DAT and *.IX file) resides.
  540.  
  541.         III. EDITING/DELETING RECORDS IN THE DATABASE
  542.  
  543.         You may enter EDIT mode either via a search or by the LIST function
  544.         (press E when the desired record displays.  You may well find editing
  545.         via LIST more efficient (since BIBL does not return you to the
  546.         search menu after a change is made).
  547.  
  548.         As you first enter EDIT mode, the author's name field will be
  549.         highlighted. Make any changes you desire, using the cursor arrow
  550.         keys to move between fields. When you have finished making changes,
  551.         press ESC (or RETURN if line 7 of the note field is highlighted).
  552.         You will receive an 'OK to file (y/n)?' prompt. Respond with:
  553.  
  554.          Y - The index will be updated if editing changed an indexed field.
  555.          N - Changes will be discarded. The original record redisplays.
  556.  
  557.         BIBL (6.4)          (c) 1991, GMUtant Software          = 10 =
  558.  
  559.  
  560.         You may also enter EDIT mode via the 'List records in the
  561.         database' option from the main menu. The only difference between
  562.         editing from this menu choice instead of SEARCH is that BIBL will
  563.         display all records in the database, beginning with the last
  564.         record. With the 'Jump' command, you may find this method of
  565.         editing superior to that offered during a search--you don't exit
  566.         the loop after performing an edit.
  567.  
  568.         IV. SYSTEM MAINTENANCE
  569.  
  570.         The MAINTENANCE function offers several options:
  571.  
  572.          - Convert Shareware to REGISTERED.
  573.          - Rebuild Indexes
  574.          - Call External Editor/Call Up Any ASCII files
  575.          - Shell to DOS
  576.          - Install Editor/Viewer
  577.          - UnInstall Editor/Viewer
  578.          - Make a new database
  579.          - Delete a database
  580.          - ASCII Import (Read BIX files)
  581.          - Global Change
  582.          - Backup database (create ZIP, LZH or ARJ archive)
  583.  
  584.         A. CONVERT SHAREWARE to REGISTERED.
  585.  
  586.         With Release 5.25 we've introduced a new wrinkle, which should
  587.         prove popular with registered users. Instead of having to obtain
  588.         a new copy of BIBL with the registered features, you can
  589.         instantly upgrade the shareware version and 'unlock' the
  590.         registered features.
  591.  
  592.         Here's how it works:
  593.  
  594.         When you register, you will receive by return mail a registration
  595.         number. Select option C under the Maintenance sub-menu, then
  596.         enter the number EXACTLY as it appears. BIBL will verify that it
  597.         is a valid number (we do some check-digit math in case you're
  598.         interested in such things) and will then create an ASCII file
  599.         (BIBL.REG) which stores that number. From then on, when BIBL
  600.         activates from the DOS prompt, it will read that file, verify
  601.         the number, and present you the user with a registered version
  602.         of the program.
  603.  
  604.         The real value is that forever more you can upgrade any SHAREWARE
  605.         release to REGISTERED, just by entering your secret number.
  606.         Actually, as long as you leave BIBL.REG in your BIBL
  607.         sub-directory, the upgrade process will be automatic. You won't
  608.         have to check our BBS for the latest registered version or have
  609.         to send us a disk or pay the extra $ 5.00 to receive one by
  610.         return mail. If you see a newer shareware version on a BBS or
  611.         CompuServe, download it and immediately have the benefits of
  612.         an upgraded registered version.
  613.  
  614.         BIBL (6.4)          (c) 1991, GMUtant Software          = 11 =
  615.  
  616.  
  617.         B. REBUILDING INDEXES
  618.  
  619.         BIBL includes an index rebuild function to create new indexes from
  620.         the database file on demand. You may never need this function,
  621.         but if add records through the ASCII import function; take a
  622.         power hit during data entry, or experience some other sort of
  623.         hardware (disk) failure, the index can become invalid or
  624.         corrupted.
  625.  
  626.         Rebuilding indexes will correct any problems of this sort. When
  627.         rebuilding the indexes, BIBL provides a graph which shows the
  628.         status of the effort (0%-100% complete for each index). If you
  629.         have fewer than 50 records, the blocks in the graph represent
  630.         each record. You may also permanently purge deleted records
  631.         from your file during the Rebuild Index function. If
  632.         you answer "Y", the following steps occur:
  633.  
  634.         1. Original database is renamed *.SAV (was *.DAT). A new empty
  635.         database with the *.DAT extension is created.
  636.  
  637.         Note: Should you experience a hardware failure during the
  638.               purge (for example, losing power on your PC), rename
  639.               XXXXX.SAV to XXXXX.DAT and run BRX.
  640.  
  641.         2. A new fileblock (database and index) are created. Records are
  642.         read from the *.SAV file and those not marked for deletion are
  643.         copied to the new (*.DAT) file.
  644.  
  645.         3. Some preliminary indexing occurs on the new file.
  646.  
  647.         4. New file/index block closed. If copy of new records was
  648.         successful, the *.SAV file is then erased.
  649.  
  650.         If you experience SERIOUS problems with your database, run the
  651.         utility program BRX which rebuilds both the datafile and index.
  652.  
  653.         C. CALL EXTERNAL EDITOR/CALL UP ASCII FILE
  654.  
  655.         You may view your savefile (QUERY.TXT) or any other ASCII file
  656.         from within BIBL. The viewer built into BIBL is quite powerful.
  657.         It responds to a mouse with the following options:
  658.  
  659.         Click on small box in upper left..................closes window.
  660.         Click on scroll bars......................move through the file.
  661.         Click on [arrow] in upper right corner.....ZOOMs to full-screen.
  662.         Click on top line of window ..........move window around screen.
  663.         Click on lower right corner, then drag,,,........resizes window.
  664.  
  665.         BIBL (6.4)          (c) 1991, GMUtant Software          = 12 =
  666.  
  667.         Keyboard commands:
  668.  
  669.         F5  Zoom the view window to fill the screen. F5 a second time to
  670.             restore original size.
  671.  
  672.         ALT-F5 Resize the window (Press ALT-F5 then with the cursor
  673.                keys size the window until it meets your needs, then
  674.                press RETURN.
  675.  
  676.         CTRL-F5 Move the window. Press CTRL-F5 then move the window
  677.                 with the cursor arrow keys. Press RETURN when done
  678.  
  679.         PgUp/PgDn        Move up and down a screen at the time.
  680.  
  681.         CTRL PgUp/PgDn   Move to the top or bottom of the document
  682.  
  683.         ESC or F10       Close the window and return to BIBL.
  684.  
  685.         If you have an external program linked to BIBL, that program is
  686.         called and passed the name of the file you want to view.
  687.  
  688.         D. SHELL TO DOS
  689.  
  690.         BIBL allows you to drop out of the program momentarily and return
  691.         to your DOS prompt. This option allows you to delete files, use
  692.         a program like LIST to view a file, check disk space, or do other
  693.         DOS-type things. BIBL provides a special prompt to remind you to
  694.         enter EXIT to return to the program.
  695.  
  696.         When you type EXIT, BIBL will reactivate and check to see that
  697.         the operating system is still defaulting to the sub-directory
  698.         where your BIBL files are kept. If not, BIBL will change to
  699.         that drive and directory before continuing. If BIBL is unable to
  700.         change to the original sub-directory, you will receive a message
  701.         to that effect...so you can manually issue the command (e.g.,
  702.         CD\BIBL <cr>) from the DOS prompt.
  703.  
  704.         E. INSTALL EDITOR/VIEWER
  705.  
  706.         BIBL allows you to specify some program other than BIBL to handle
  707.         viewing of your save file or other text files as well as
  708.         editing and printing of reports.
  709.  
  710.         The program you use must be capable of accepting a file
  711.         name as a command line argument (e.g., WP filename <cr>).
  712.         BIBL will send the name of your external program (drive, path,
  713.         program name and extension) to DOS as well as the name of the
  714.         file (drive, path, filename, and extension). This allows you to
  715.         access an external program on another drive if desired.
  716.  
  717.         BIBL (6.4)          (c) 1991, GMUtant Software          = 13 =
  718.  
  719.         BIBL creates a simple configuration file (BIBL.CFG) when an
  720.         external viewer/editor is defined. If you want to remove the
  721.         editor/viewer altogether, just delete the BIBL.CFG file. If you
  722.         later install another package, BIBL will create the configuration
  723.         file again. Note: UNinstall Editor will accomplish this
  724.         deletion for you.
  725.  
  726.         BIBL swaps most of itself out to disk (or EMS if available),
  727.         freeing up more system memory for your editor/viewer. EMS
  728.         will be automatically used if available, otherwise the swap
  729.         is to disk. While the program normally requires 350K or more
  730.         to run, after compressing itself and swapping out, a 55-65K
  731.         kernel of BIBL remains in memory--enabling you to use a very
  732.         large program (e.g., WordPerfect) as your editor/viewer. When
  733.         the external program finishes, BIBL returns!
  734.  
  735.         If BIBL encounters a problem (too little memory, invalid name for
  736.         the viewer/editor program, viewer/editor not found in path,
  737.         etc.), it will just ignore the request and return to the main
  738.         menu.
  739.  
  740.         Once installed, the name of the viewing program (no extension)
  741.         appears on the BIBL main menu in the VIEW option bar.
  742.  
  743.         F. MAKE A NEW DATABASE.
  744.  
  745.         To create a new, empty database, press M on the maintenance menu,
  746.         then enter a name for the database file. You may enter up to 8
  747.         letters for your database name. You should try to give the file
  748.         a name that will later give some indication of the file's
  749.         contents.
  750.  
  751.         TIP: When creating databases, give your most popular file a
  752.              name that sorts first. The Database Selection option on
  753.              the main menu sorts the various *.DAT files before
  754.              displaying them. The first file in the list will be
  755.              highlighted when the list displays. If it is the file
  756.              you want, just press RETURN (or ESC).  Note that you can
  757.              also specify a database on the command line when
  758.              activating BIBL from the DOS prompt (e.g., BIBL Myfile).
  759.  
  760.  
  761.         G. DELETE A DATABASE.
  762.  
  763.         You may use this function to delete a database and it's
  764.         associated index file. You may also delete a database and index
  765.         by simple using the DOS delete command while at the DOS prompt.
  766.         BIBL dynamically determines your databases by scanning the
  767.         directory where BIBL.EXE resides for files ending with the *.DAT
  768.         extension. You may NOT DELETE the database you are currently using.
  769.  
  770.         BIBL (6.4)          (c) 1991, GMUtant Software          = 14 =
  771.  
  772.  
  773.         H. ASCII Import
  774.  
  775.         Using the ASCII import option enables you to read any labelled
  776.         ASCII file into the currently active BIBL database. The file
  777.         separated with **'s and each line is labelled. The labelled
  778.         option under the Export Menu creates this format as does the
  779.         Transfer option when displaying an individual record.
  780.         If you want to experiment with ASCII import (say you're trying to
  781.         import an ASCII file from some other source--like bibliographic
  782.         data downloaded from a CD-ROM), you should follow these steps:
  783.  
  784.         1. Use MAKE A NEW DATABASE option on maintenance menu to create a
  785.            database called something like TEST
  786.  
  787.         2. Use DATABASE SELECTION on the main menu to select the TEST
  788.            database.
  789.  
  790.         3. Run ASCII import from the maintenance menu. You BIX file must
  791.            be in the same subdirectory where BIBL.EXE resides.
  792.  
  793.         4. After reviewing the results (the records added to TEST),
  794.            select the database you want to use and run ASCII import
  795.            again. When finished, you can delete TEST.DAT and TEST.IX
  796.            via Delete a Database (on the maintenance submenu).
  797.  
  798.         For CD-ROM downloads from ERIC, ABI/Inform, PsycInfo and Medline
  799.         get CD2BIBL...from the GMUtant BBS or Compuserve (IBM APPS).
  800.  
  801.         I. GLOBAL CHANGE
  802.  
  803.         You may make global changes ('find & replace') to text in any
  804.         record across your database. The unregistered version is
  805.         limited to making these global changes on the Subject and/or
  806.         location fields.
  807.  
  808.         [R] The registered version of BIBL allows you to change the text
  809.         [R] in any field of all records for a given database.
  810.  
  811.         To make a global find and replacement, select the field you want
  812.         to modify (the database will be the currently active file--the
  813.         database that displays on the status bar at the bottom of your
  814.         screen). After selecting the field to modify, you must next
  815.         enter the original text (what's currently in the record(s)) and
  816.         then the new text. In both situations (the finding and the
  817.         replacing) the case of the text you enter is significant and your
  818.         'find' input must match the database EXACTLY.
  819.  
  820.         Be advised that the subsitution you instruct BIBL to make
  821.         will occur anywhere BIBL finds a match for your 'change'
  822.         text. Without a bit of thought on your part, this can quickly
  823.         become a nightmare.  If you elect to change a short word--one
  824.         that also appears as part of a larger word in the same field--you
  825.         can have problems. For example, asking BIBL to change NETWORK
  826.         to LAN can (if you also have NETWORKING in the same field) lead
  827.         rather quickly to LANING...
  828.  
  829.         You are not limited to whole word changes (if the text you enter
  830.         happens to match a few letters inside another word in that field,
  831.         it will be changed. Again, think your change through before you
  832.         begin.
  833.  
  834.         BIBL (6.4)          (c) 1991, GMUtant Software          = 15 =
  835.  
  836.         It is possible that the length of your replacement term(s) will
  837.         force the truncation of the field. For example, if your
  838.         descriptor field has 60 characters and you change one 5 letter
  839.         word to a 15 letter word, the field would now be 75 characters
  840.         long...so the last 5 characters of your field after the 5 letter
  841.         word becomes a 15 letter one will be chopped off.
  842.  
  843.         V. OUTPUT OPTIONS / REPORTS / BIBLIOGRAPHIES
  844.  
  845.         While BIBL offers only limited print support, it will dump your
  846.         database to disk in an ASCII file--which you can then edit and
  847.         print using your favorite word processor.
  848.  
  849.         Blank fields do not appear in the ASCII files BIBL creates.
  850.         (the exception being DELIMITED format).
  851.  
  852.         You may select Author, Title, Subject, Delimited or the order
  853.         records appear in the database. Note that each time you call the
  854.         dump to disk routine it overwrites any previously created file.
  855.         Here is a list of the files created via the Export function.
  856.         Where you are given the option of naming the file, you should use
  857.         a *.TXT extension when possible. This will allow you to see all
  858.         available export files under the CALL EXTERNAL EDITOR function
  859.         when you accept the default *.TXT mask.
  860.  
  861.         Content          Name BIBL will give ASCII file
  862.  
  863.         Author           AUTHLIST.TXT (sorted by author, then title)
  864.         Title            TITLLIST.TXT
  865.         Subject          SUBJLIST.TXT
  866.         Delimited        BIBLDLM.TXT
  867.         Labelled         BIBLLIST.BIX
  868.  
  869.         You may assign names to these files...and include a pathname if
  870.         desired. For example, to put the file on a floppy, preceed the
  871.         name with A: (e.g.,A:MYFILE.TXT).
  872.  
  873.         Bibliographies   User names this file. Registered version also
  874.                          offers option of using SOFT RETURNS.
  875.  
  876.         Keyword List     KEYWORD.TXT (user can rename)
  877.         Title List       TIBRIEF.TXT
  878.         Subject List     SUBRIEF.TXT
  879.         Author List      AUBRIEF.TXT
  880.  
  881.         A/T/L (Author/Title/Location)   ATLLIST.TXT
  882.         L/A/T (Location/Author/Title)   LATLIST.TXT
  883.  
  884.         User-Defined User names this file. WP format available.
  885.  
  886.         Title First      TITLES.TXT    (user can rename). Soft returns.
  887.         Location First   LOCATION.TXT  (user can rename). Soft returns.
  888.  
  889.         BIBL (6.4)          (c) 1991, GMUtant Software          = 16 =
  890.  
  891.         BIBL can create ASCII files (full, annotated or brief form) for
  892.         all records that contain your search string.
  893.  
  894.         [R] The registered version also supports LABELLED output of
  895.         [R] bibliographies. Using this feature and the ASCII Import
  896.         [R] option on the Maintenance menu, you can select out records
  897.         [R] from one database based on text that appears in a given
  898.         [R] field, then use ASCII Import to read those records into
  899.         [R] another database. This gives you an 'automatic' means of
  900.         [R] moving records from one database to another.
  901.  
  902.         [R] Registered version supports bibliography creation on ANY
  903.         [R] field in the record. The registered version of BIBL also
  904.         [R] provides the option to create output files using soft returns
  905.         [R] (instead of hard ASCII returns) after each line. This
  906.         [R] greatly simplifies subsequent editing if using a word
  907.         [R] processor that supports a variety of fonts.
  908.  
  909.         Annotated form will produce a listing with author, title,
  910.         publisher and the notes fields. Brief includes only the author,
  911.         title, and publisher field. Below, a sample 'annotated' reference
  912.         appears:
  913.  
  914.         Bratley, Paul and Choueka, Yaacov
  915.                 Processing Truncated Terms in Document Retrieval Systems.
  916.         Information Processing and Management v18 n5 p257-66 1982
  917.  
  918.             Presents uniform and efficient approach for processing all
  919.         truncated query terms in information retrieval which requires one
  920.         disk access to obtain from the permuted dictionary all strings
  921.         represented by truncated term. The problem of the overhead
  922.         storage required to implement the permuted dictionary is
  923.         discussed. Fifteen references.
  924.  
  925.         You assign the name for the bibliography output file. If the name
  926.         is already in use, BIBL asks you to use another name. Note that using
  927.         the Word Processing [WP] format option will produce a citation
  928.         where fields follow one another on a line. A hard return follows
  929.         the PUBL field.
  930.  
  931.           Bratley, Paul and Choueka, Yaacov. Processing Truncated
  932.         Terms in Document Retrieval Systems. Information Processing and
  933.         Management. v18 n5 p257-66. 1982.
  934.  
  935.         'Smart' Punctuation [WP format]
  936.  
  937.         [R] As BIBL creates your bibliography, it will check to see
  938.         [R] if each field ends with punctuation. If so, the existing
  939.         [R] punctuation will be written to your file. If not, BIBL
  940.         [R] will add periods after each field. This saves you having to
  941.         [R] use end-of-field punctuation in your BIBL database entry.
  942.  
  943.         BIBL (6.4)          (c) 1991, GMUtant Software          = 17 =
  944.  
  945.         DELIMITED FORMAT
  946.  
  947.         Delimited format is used when you want to move your BIBL database
  948.         to dBASE or some other database system (why?). The next few
  949.         paragraphs point out a few things you should be aware of:
  950.  
  951.         Note that in delimited format BIBL will change any quotation mark
  952.         that appears in the Title, Descriptor, or Note fields to a single
  953.         quote--to preserve the exported data's integrity. If any double
  954.         quotes were to appear in the exported data (that is, anywhere
  955.         other than between the fields), the the importing program might
  956.         not process the data correctly.
  957.  
  958.         For example, if you have: Jones is author of the article, "This
  959.         is My Life's Work." in your note field, under delimited format,
  960.         BIBL will export: "Jones is author of the article, 'This is My
  961.         Life's Work.'"
  962.  
  963.         A CR/LF appears at the end of each record. dBASE will accept this
  964.         for input if you first set up a dBASE file with the proper
  965.         structure. Use the field lengths as they appear at the end of
  966.         this documentation. With the database structure created, activate
  967.         dBASE and issue the following command:
  968.  
  969.          . USE MYBOOKS <cr>
  970.          . APPEND FROM BIBLDLM.TXT DELIM <cr>
  971.  
  972.  
  973.         LIST SUBJECTS/LIST DESCRIPTORS (Keywords)
  974.  
  975.         You should use these export functions periodically to check the
  976.         uniformity of your subject headings and descriptor fields. For
  977.         example, if your list shows you have 10 items under computer and
  978.         1 under computers, you should edit the COMPUTERS entry (changing
  979.         it to COMPUTER). As an aid in helping you identify the records, a
  980.         bit of the title is included with each entry.
  981.  
  982.         Note that there is an entry in the list for each heading in a
  983.         record (if you have 10 records with the subject BASEBALL, you'll
  984.         get 10 entries for BASEBALL in the SUBRIEF.TXT file).
  985.  
  986.         KEYWORD.TXT - this option lists all terms used in the descriptor
  987.         field of your database. With each term, the number of times it
  988.         appears is also listed. This list can be a big help in
  989.         eliminating redundant terms and consolidating similar terms to
  990.         yield a stronger database.
  991.  
  992.                                  Related Topics
  993.  
  994.         Send To Disk. Beyond creating large reports, during any search
  995.         you may elect to send a copy of a single record to an
  996.         ASCII file (QUERY.TXT). Each time you press 'S' a copy is
  997.         appended to this file. When you are finished with the file,
  998.         delete it (via DOS) or rename it. Then when you next send a
  999.         record to disk, BIBL will create a new copy of QUERY.TXT.
  1000.  
  1001.         BIBL (6.4)          (c) 1991, GMUtant Software          = 18 =
  1002.  
  1003.         Transfer: Any time an individual record is displayed, you have
  1004.         the option of copying it to a transfer file (TRANSFER.BIX).
  1005.         Pressing T (or clicking on the word 'Transfer' will add the
  1006.         record to TRANSFER.BIX.
  1007.  
  1008.         To move the records in TRANSFER.BIX use ASCII import on the
  1009.         maintenance menu.  Be sure to delete any existing TRANSFER.BIX
  1010.         file if you want to make a file of new records...if TRANSFER.BIX
  1011.         exists on your disk, transferred records will be appended to
  1012.         it. If it is missing when 'T' is pressed, BIBL will create
  1013.         a new copy of it.
  1014.         
  1015.         [R] Registered users can also transfer records in groups, based
  1016.         [R] on text occurring in any field. Select
  1017.         [R] Bibliographies/Transfer on the Export
  1018.         [R] menu, then proceed as you would when creating a bibliography.
  1019.         [R] When prompted for output format, select Labelled. You will
  1020.         [R] next be asked if you want to delete transferred records from
  1021.         [R] your original file. You may want to run this option once
  1022.         [R] before you go back and ask BIBL to delete copied records
  1023.         [R] (just to verify that you did retrieve the records you
  1024.         [R] wanted AND to insure that you were able to import them
  1025.         [R] to another database successfully).
  1026.  
  1027.         IMPORTANT
  1028.  
  1029.         [R] Once you ask BIBL to delete these records, they will be
  1030.         [R] gone...deleted from the original database which will then be
  1031.         [R] packed and re-indexed before returning to the Main Menu!
  1032.  
  1033.          USAGE NOTES / TIPS
  1034.  
  1035.         A. Here are some of the ways we've heard BIBL is being used:
  1036.  
  1037.          - as an online index to a personal book collection.
  1038.          - tracking magazine articles.
  1039.          - indexing a vertical file (for non-library types, a vertical
  1040.            file is usually a filing cabinet of clippings, brochures, etc.).
  1041.          - using BIBL instead of 3x5 cards for research.
  1042.          - tracking reserve reading materials in a corporate library.
  1043.          - with /p (OPAC) switch set, running BIBL as a DOOR on a BBS to
  1044.            provide users an online catalog.
  1045.          - Managing an office library.
  1046.          - A public service agency has 30+ copies of BIBL. The home office
  1047.            creates databases and sends them out to branches. With OPAC mode
  1048.            set, the integrity of the files is preserved.
  1049.  
  1050.         B. Using WordPefect (5.0 or 5.1) as your external editor (or
  1051.            viewer or printer) with BIBL
  1052.  
  1053.         While BIBL does not possess a direct interface to WordPerfect
  1054.         it does work particularly well with that word processor. Follow
  1055.         the sequence below to install WordPerfect as your editor/viewer:
  1056.  
  1057.         BIBL (6.4)          (c) 1991, GMUtant Software          = 19 =
  1058.  
  1059.  
  1060.         Note: the sequence is the same for any word-processor...just
  1061.         be sure that the program accepts a filename to edit on the
  1062.         command line (e.g., WP MYFILE [RETURN] on the DOS command line
  1063.         will start WordPerfect and load a file named MYFILE). WordStar
  1064.         also behaves this way as do other programs.
  1065.  
  1066.         1. Select MAINTENANCE from the BIBL main menu (press M)
  1067.         2. Press I (Install Editor/Viewer).
  1068.         3. Enter the full path name to your copy of WP.EXE
  1069.            (e.g., C:\WP51\WP.EXE).
  1070.  
  1071.         Now, when you select CALL UP ASCII FILE under the MAINTENANCE
  1072.         option, BIBL will load WordPerfect and pass along the name of the
  1073.         file you want to view, edit or print. When you are finished with
  1074.         the document, press F7 to save and then exit WordPerfect...you
  1075.         will be returned to BIBL. The file you worked on is stored on
  1076.         the drive and sub-directory where BIBL.EXE resides.
  1077.  
  1078.         C. Remote Drives / LAN usage (registered version only).
  1079.  
  1080.         [R] You may store your database and index files on a
  1081.         [R] drive/sub-directory other than were the BIBL.EXE file is
  1082.         [R] kept. This will allow you to use BIBL on a LAN or in an
  1083.         [R] environment where disk drives are shared between users. While
  1084.         [R] BIBL is still a single user product (network version of BIBL
  1085.         [R] tentatively scheduled for release in early 1992), you can
  1086.         [R] store your database and index on the server disk.
  1087.  
  1088.         IMPORTANT: BIBL databases MUST reside in a subdirectory, not the
  1089.         root directory, of any remote drive you use. For example, say
  1090.         you want to put a BIBL database and index (*.DAT and *.IX) file
  1091.         on a RAM disk. Be sure to create a subdirectory on your RAM
  1092.         drive and move the files there. Do not simply create a drive
  1093.         (e.g., D:) and copy the files there. If you try to run BIBL using
  1094.         a root directory, you'll get a error about locked databases and
  1095.         the system won't operate!
  1096.  
  1097.         To point BIBL to some location other than the drive/directory
  1098.         where BIBL.EXE resides, you must create a configuration file.
  1099.  
  1100.         Name of file: BIBLPATH.CFG
  1101.  
  1102.         Location: Must reside in same directory as BIBL.EXE
  1103.  
  1104.         Purpose: When BIBL first initializes, if it finds BIBLPATH.CFG
  1105.                  it opens the file and reads the data path statement.
  1106.                  That path then is added to all subsequent database
  1107.                  access calls.
  1108.  
  1109.         Format:  ASCII text file that contains the following statement:
  1110.                  DATAPATH=X:\XXXXX where X:\XXXXX is the full path
  1111.                  name of the subdirectory you want to use for storing
  1112.                  the database & index file.
  1113.  
  1114.  
  1115.         BIBL (6.4)          (c) 1991, GMUtant Software          = 20 =
  1116.  
  1117.         Example: Suppose you store BIBL.EXE in your C:\BIBL
  1118.                  subdirectory, and you want to put your datafiles and
  1119.                  indexes on the fileserver (say, drive H:) and in a
  1120.                  special subdirectory reserved for your use (e.g.,
  1121.                  MYFILES\BIBL). Create BIBLPATH.CFG and enter this
  1122.                  statement: DATAPATH=H:\MYFILES\BIBL (no need for the
  1123.                  '\' on the end of the line)
  1124.  
  1125.         To create: You can use an ASCII editor (e.g., QEDIT) or simply
  1126.                    create the file from the DOS prompt. Here's how you
  1127.                    create the file using only DOS:
  1128.  
  1129.          1) Log onto the subdirectory where BIBL.EXE resides
  1130.          2) At the DOS prompt, type the following lines. Use
  1131.          UPPER CASE. ([CR] means press RETURN. [F6] means press F6.)
  1132.  
  1133.          COPY CON: BIBLPATH.CFG[CR]
  1134.          DATAPATH=X:\XXXXXX[CR]
  1135.          [F6]
  1136.  
  1137.  
  1138.         D. Using BIBL's [WP] format with WordPefect.
  1139.  
  1140.         Here's how you create a WordPerfect-ready version of your
  1141.         database, (printing author, title and publisher fields), sorted
  1142.         by Author, then title:
  1143.  
  1144.         1. Press E on the BIBL main menu (EXPORT).
  1145.         2. Press M (user-selects).
  1146.         3. Answer 'Y' that you want to continue.
  1147.         4. Enter 123 and press return (to indicate that you want fields
  1148.            one (author), two (title) and three (publisher).
  1149.         5. Enter 'Y' to indicate that you're satisfied with these fields.
  1150.         6. Enter 1 to indicate that sort should be on author (it will
  1151.            actually be on author, then title within author).
  1152.         7. Enter 'E' to indicate that you want [WP] format.
  1153.         8. Enter the name you want to give your output file.
  1154.  
  1155.  
  1156.         BIBL (6.4)          (c) 1991, GMUtant Software          = 21 =
  1157.  
  1158.  
  1159.         If you are using WordPerfect as your external editor, once BIBL
  1160.         finishes making your file and returns to the main menu, press M
  1161.         (for Maintenance), then press C to 'CALL External Editor, enter
  1162.         the name you gave the file in step 8 (or just hit return and
  1163.         pick from the *.TXT files displayed), then sit back as
  1164.         BIBL compresses itself, then loads WordPerfect (passing along
  1165.         the name of your file).
  1166.  
  1167.         If you need to reset your margins (because the text is wrapping
  1168.         around incorrectly), go to the top of the document and press
  1169.         SHIFT-F8, then L (for Line), then M for margins.
  1170.  
  1171.         E. Modifying HELP display (INFORMATION on the main menu).
  1172.  
  1173.         BIBL displays the file BIBL.HLP when 'I' is pressed on the Main
  1174.         Menu. If you want to change the help display file, just rename
  1175.         any ASCII file to BIBL.HLP and BIBL will display it...
  1176.  
  1177.         F. BACKUP? Many users have found that using the LABELLED option
  1178.         under Export provides a space-saving means of making a backup
  1179.         copy of your database(s). Since only the data from your database
  1180.         is exported (not the empty spaces inside each record), the
  1181.         resulting file is usually about 40% smaller than your database.
  1182.         With ASCII Import (on Maintenance menu), you can read this file
  1183.         back into BIBL should you ever need to reconstitute your
  1184.         database.
  1185.  
  1186.         With 5.41 another option has been introduced. You may use BIBL to
  1187.         'drive' any one of three third-party archiving utility programs
  1188.         (LHA.EXE - .LZH files; PKZIP.EXE - .ZIP files, and ARJ.EXE - .ARJ
  1189.         files). The archiving program *MUST* be either in your BIBL
  1190.         subdirectory or in a sub-directory that is included in your DOS
  1191.         path statement. If one of the supported archiving programs is not
  1192.         found, BIBL will ignore the request.
  1193.  
  1194.         If it is found, BIBL compresses itself in memory (down to about
  1195.         91K), then launches the archiving program. When it is finished,
  1196.         BIBL reexpands in memory and continues running. If you have EMS
  1197.         memory, BIBL will swap itself to EMS during this process
  1198.         (otherwise, it swaps to disk).
  1199.  
  1200.         Both the data file (*.DAT) and the index file (*.IX) are combined
  1201.         in the archive you create. Since BIBL always initializes both
  1202.         records and index entries with 0's before use, these programs
  1203.         achieve a compression of 85 - 90%! Thus, you can probably fit a
  1204.         2,000 record database (and index) on a 360K floppy.
  1205.  
  1206.         Technical Specs:
  1207.  
  1208.         1. Memory required. BIBL requires a minimum of 350K RAM to
  1209.         operate. If you have more, then more will be available when you
  1210.         Shell to DOS, and to load an external program.
  1211.  
  1212.         BIBL (6.4)          (c) 1991, GMUtant Software          = 22 =
  1213.  
  1214.  
  1215.         PASCAL structure for a BIBL record:
  1216.  
  1217.          bookrec = RECORD
  1218.          recordstatus : longint;
  1219.           author1 : string[70];
  1220.           author2 : string[70];
  1221.            Title1 : string[70];
  1222.            title2 : STRING[70];
  1223.            title3 : string[70];
  1224.              publ : STRING[70];
  1225.             publ2 : string[70];
  1226.             class : STRING[40];
  1227.          subject1 : string[30];
  1228.          subject2 : STRING[70]; {descriptor field}
  1229.             flag1 : char;       {flag1..3 not used at present}
  1230.             flag2 : char;
  1231.             flag3 : char;
  1232.             value : string[7]; {date}
  1233.             note1 : STRING[70];
  1234.             note2 : STRING[70];
  1235.             note3 : STRING[70];
  1236.             note4 : STRING[70];
  1237.             note5 : STRING[70];
  1238.             note6 : STRING[70];
  1239.             note7 : string[70];
  1240.            end;
  1241.  
  1242.         Indexes (the following keys are maintained in each .IX file):
  1243.  
  1244.         Author          first 20 characters of the field (stored upper case)
  1245.         Title           first 25 characters of the field (stored upper case)
  1246.         Subject         all characters of subject1 (stored upper case)
  1247.         Descripton      first each word ofthe field is extracted (a word
  1248.                         being a string of characters separated by a space or
  1249.                         comma).
  1250.  
  1251.          Up to 20 characters of each 'word' is indexed.
  1252.          Up to 8 words from any one line are indexed. If you
  1253.          have 9 words on the line, the ninth is ignored.
  1254.  
  1255.          IMPORTANT: place a '-' between words you want BIBL to index together.
  1256.  
  1257.         A fifth index is reserved for 'on-the-fly' reports (bibliographies,
  1258.         sort on publisher or location field, etc). Data stored in this
  1259.         index is compressed (to allow larger text values to be represented.
  1260.         The key length is 15 characters although with data compression,
  1261.         20 characters are used to build the key). During bibliography
  1262.         production (Option D on Export Menu), the key value for this
  1263.         fifth index is: author (14 characters)+title (6 characters) which
  1264.         yields an author/title sort.
  1265.  
  1266.         During User-Defined output (Option M on Export Menu), with a sort
  1267.         on the location field (field #4), the sort key is location (15
  1268.         characters)+author (5 characters), to yield a location/author sort.
  1269.         This same sort is used on 'Location first' reports.
  1270.  
  1271.         BIBL (6.4)          (c) 1991, GMUtant Software            = 23 =
  1272.  
  1273.         If publisher field sort is selected for Option M, then 20
  1274.         characters of the publisher field are used to generate the key.
  1275.  
  1276.         File extensions used by BIBL:
  1277.  
  1278.         .DAT - a datafile
  1279.         .IX - the index to a DAT datafile.
  1280.         .HLP - Help file (displays when I is pressed on Main Menu)
  1281.         .SAV - temporary file, used during index rebuild/purge.
  1282.  
  1283.         The *.DAT and *.IX files together form 'a database.' You must
  1284.         have the same name on both you .DAT and .IX files--usually taken
  1285.         care of by BIBL but if you rename a database via DOS (for
  1286.         example, renaming DEMO.DAT to MYFILE.DAT, be sure to rename
  1287.         DEMO.IX to MYFILE.IX too!).
  1288.  
  1289.         .TXT - any ASCII file.
  1290.         .BIX - BIBL Import/Export. A labelled ASCII file. This file uses a
  1291.                specific format where each field is labelled (e.g., A1:, A2:
  1292.                for the 2 author fields, T1: T2: T3: for the title fields, and
  1293.                so on. Each record in the file is separated by '**'. The
  1294.                ASCII import function on the Maintenance Menu will read a
  1295.                BIX file and write the information to BIBL records. You
  1296.                can use this facility for backing up your database or
  1297.                moving records from one database to another.
  1298.  
  1299.         Here is a sample record in BIX format:
  1300.  
  1301.         **
  1302.         A1: Bratley, Paul and Choueka, Yaacov
  1303.         T1: Processing Truncated Terms in Document Retrieval Systems.
  1304.         PB: Information Processing and Management. Volume 18, Number 5
  1305.         P2: pages 276-66. 1982
  1306.         SU: Information Retrieval
  1307.         DE: Information-Storage Permuted-Indexes Subject-Indexing
  1308.         N1: Presents uniform and efficient approach for processing all
  1309.         N2: query terms in information retrieval which requires one disk
  1310.         N3: access to obtain from the permuted dictionary all strings
  1311.         N4: represented by the truncated term. The problem of the
  1312.         N5: overhead storage required to implement the permuted
  1313.         N6: dictionary is discussed. Fifteen references
  1314.         N7: are provided.
  1315.         **
  1316.  
  1317.         Note: BIBL.EXE has been compressed with PKLITE version 1.13
  1318.  
  1319.         Questions, comments, complaints, encouragement???
  1320.  
  1321.         Contact:
  1322.  
  1323.         Clyde W. Grotophorst, Route 1, Box 296, Hamilton, VA 22068
  1324.         voice: (703) 993-2239 or call the GMUtant OnLine BBS (703) 993-2219,
  1325.         and leave a comment for the Sysop. The Bulletin Board is your source for
  1326.         updates and additional BIBL utilities. You may also reach the author
  1327.         via Compuserve (70404,3376).
  1328.  
  1329.         BIBL (6.4)          (c) 1991, GMUtant Software          = 24 =
  1330.  
  1331.         Notes:
  1332.  
  1333.  
  1334.         BIBL REGISTRATION [Release 6.4]
  1335.  
  1336.          Name ___________________________________________________
  1337.          Company Name___________________________________________________
  1338.          Address ___________________________________________________
  1339.          ___________________________________________________
  1340.          City ____________________ State __ Zip ____________
  1341.          Country ____________________ Phone (optional)____________
  1342.  
  1343.          How (or where) did you obtain your copy of BIBL?
  1344.  
  1345.          Comments on the program:
  1346.  
  1347.          Are you currently a user of GMUtant OnLine BBS? Yes ___ No ___.
  1348.          If not, when you first call, leave a comment to the Sysop, so we
  1349.          can upgrade your security and provide you with access to the
  1350.          registered users portion of our system. BBS #: 703-993-2219
  1351.          9600(v.32)/2400/1200 24 hours a day. When you register, you
  1352.          will be sent a registration number by return mail.
  1353.  
  1354.          Registration Fees:
  1355.  
  1356.         Basic Registration (w/ access to BBS)           $ 39.00
  1357.  
  1358.         Site License (2-15 copies)                      $ 26.75 each (-25%)
  1359.          (16-50 copies)                                 $ 17.50 each (-50%)
  1360.          (51+ copies)                                   $ 10.50 each (-70%)
  1361.  
  1362.          printed copy of BIBL.DOC file                  $ 5.00
  1363.  
  1364.                                       Total enclosed: $ __________
  1365.  
  1366.         Please indicate desired format for diskette: ___ 3.50" ___ 5.25"
  1367.  
  1368.         ( ) MasterCard ( ) Visa ( ) American Express ( ) Check
  1369.  
  1370.         Checks must be in US Dollars from a US account with an ABA
  1371.         routing number, made payable to: Clyde W. Grotophorst
  1372.  
  1373.         I authorize The Public (Software) Library to debit my
  1374.          AmExp/ Mastercard/ Visa account:
  1375.  
  1376.         Card Number _____________________________
  1377.         Name as it appears on card (print) ______________________________
  1378.         Expiration Date __/__
  1379.         Signature _________________________________
  1380.  
  1381.         Cash/Money Orders: Credit Card Orders:
  1382.  
  1383.         Clyde W. Grotophorst                    Public (Software) Library
  1384.         Route 1, Box 296                        PO Box 35705
  1385.         Hamilton, VA 22068 USA                  Houston, TX 77235-5705
  1386.         BBS: (703) 993-2219                     Orders ONLY:1-800-242-4775
  1387.                                                 Fax: 713 524-6398
  1388.  
  1389.  
  1390.  
  1391.                                 I N D E X
  1392.  
  1393.         Archive utilities 22
  1394.         ARJ.EXE 22
  1395.         ASCII file import 15
  1396.         B-Tree Filer (5.22) 7
  1397.         BIBL.CFG 15
  1398.         BIBL.HLP 8,22
  1399.         BIBL.REG 11
  1400.         BIBLDEMO.EXE 4
  1401.         Bibliographies
  1402.          Annotated format 17
  1403.          BIX format 17
  1404.          WP format 17
  1405.         BIBLPATH.CFG
  1406.          Creation of 20
  1407.          Example 21
  1408.         BIX (Bibl Import eXport) format
  1409.          explained 24
  1410.         Boolean searching 10
  1411.          matches to disk (registered only) 10
  1412.         BRX.EXE 12
  1413.         CD-ROM (CD2BIBL) 16
  1414.         Case (of search arguments)  9
  1415.         Command line switches 7
  1416.         Commands (viewer)
  1417.          keyboard 14
  1418.          mouse 13
  1419.         Compuserve
  1420.          Author's CIS # 24
  1421.         CONFIG.SYS
  1422.          creation of 6
  1423.          requirements for 6
  1424.         Databases
  1425.          Backing up... 24
  1426.          Deleting 14
  1427.          Stored on remote drives 20
  1428.          Transferring records 15,19
  1429.         dBASE
  1430.          delimited format 18
  1431.         Deleted records 13
  1432.         Delimited format 17
  1433.         Descritor field
  1434.          indexing 9
  1435.          boolean searching 10
  1436.         Editing 11
  1437.          using JUMP during edit 7,11
  1438.          Installing external editor 14
  1439.         EXPORT options 17
  1440.          Files created (names) 17
  1441.         External editor
  1442.          installing 13
  1443.         Features
  1444.          Added in registered version 5
  1445.         Fields
  1446.          Descriptor vs. subject 10
  1447.          Files (extensions) 24
  1448.         Global change 15
  1449.  
  1450.  
  1451.         Indexes
  1452.           specifications 23
  1453.           purging deleted records 12
  1454.           rebuild progress graph 12
  1455.         Installation 5
  1456.         KEYWORD.TXT 18
  1457.         Keyword verification 8
  1458.         LHA.EXE 22
  1459.         Main Menu (options listed) 8
  1460.         Maintenance options 11
  1461.         Memory
  1462.          required 14
  1463.          allocation 4,7,14
  1464.         Menus
  1465.          highlighted characters 7
  1466.         Monochrome operation 6
  1467.         Network usage 20
  1468.         Pascal record structure
  1469.          used by BIBL 23
  1470.         PKLITE.EXE
  1471.          BIBL compressed with 24
  1472.         PKZIP.EXE 22
  1473.         QUERY.TXT
  1474.          Send to Disk 18
  1475.         Read-Only mode
  1476.          'OPAC' setting 6
  1477.         Registration
  1478.          Credit Cards 2
  1479.          Enhancements 4-5
  1480.          form 26
  1481.         Searching
  1482.          Boolean searches 10
  1483.          Boyer-Moore algorithm 10
  1484.         Send to Disk
  1485.          QUERY.TXT 19
  1486.         Shareware
  1487.          Converting to registered 12
  1488.         Shell to DOS 14
  1489.          changing directories 14
  1490.         Smart punctuation 17
  1491.         Specifications
  1492.          BIBL record structure 23
  1493.          indexing scheme 23
  1494.          number of records limit 9
  1495.         Transfer 20
  1496.         Truncation
  1497.          implied in searches 11
  1498.         Windows (3.1) appendix
  1499.         WordPerfect
  1500.          use with BIBL 20
  1501.  
  1502.  
  1503.  
  1504.                                 ADDENDUM
  1505.  
  1506.               LAN (Novell) version of BIBL is now available!
  1507.  
  1508.  
  1509. A Novell NetWare (release 2.x or later) version of BIBL is now available.
  1510. This multi-user version of BIBL is ideal for the organization maintaining
  1511. a library or interested in providing LAN users with a means of tracking
  1512. journals, books, newspaper articles and so on...
  1513.  
  1514. Simultaneous users supported: 50
  1515.          Databases supported: Unlimited
  1516.        NetWare compatibility: NetWare, Advanced NetWare, ELS or NetWare 3.x
  1517.                        Price: $ 195.00 per server
  1518.  
  1519. BIBL/NET offers full database locking support for 1 to 50 simultaneous
  1520. users.  A sophisticated security system has been implemented so that
  1521. users may be assigned various rights within the BIBL system.  Six
  1522. levels of security are supported. When BIBL is loaded by a workstation,
  1523. the user must login -- giving a user name and a password. Based on a
  1524. security table maintained by the LAN adminstrator, the user is then
  1525. assigned a security level.
  1526.  
  1527.   Level 0: If the user has no user name (e.g., a guest), BIBL runs
  1528.            in read-only mode for that user.
  1529.   Level 1: Read-Only access. Limited Export options.
  1530.   Level 2: May add records to public (shared) databases but may not
  1531.            edit or delete *ANY* records.  Suitable for individuals
  1532.            whose data entry needs reviewing.
  1533.   Level 3: Add records. Edit and or delete any records that that user
  1534.            has added to a public (shared) database.  (Each record
  1535.            contains a stamp indicating which user created it).
  1536.            Level 3 and above users may create and maintain
  1537.            personal (private) databases.
  1538.   Level 4: Add, Delete, Edit any records in any public (shared) database.
  1539.   Level 5: Unlimited access. Create / Delete databases. Rebuild indexes.
  1540.  
  1541.         Registration of BIBL/NET ($ 195.00 per server) includes:
  1542.  
  1543.              BIBL/NET software for 1-50 simultaneous users
  1544.               (version compiled for 286/386/486 included)
  1545. Printed documentation                        90 days telephone support
  1546. 90 days automatic update service          Access to GMUtant OnLine BBS
  1547.  
  1548.  
  1549. BIBL/NET is available via SHAREWARE.  The unregistered version of the
  1550. package is fully functional - but limited to five simultaneous users.
  1551. To obtain BIBL/NET for evaluation, check CompuServe or the GMUtant OnLine
  1552. BBS.  We will also be distributing the product to shareware markets during
  1553. the coming months.
  1554.  
  1555. Versions of BIBL/NET for Lantastic, 3Com, PC-NET,MS-NET and PC-LAN are
  1556. also available.  Please specify desired network version when ordering.
  1557.  
  1558. APPENDIX
  1559.  
  1560. Using BIBL with Windows 3.1.
  1561.  
  1562. The BIBL.PIF file will enable BIBL to run in a window under Microsoft
  1563. Windows 3.1.  Under Windows 3.0, BIBL will only run full-screen.
  1564.