home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / gl_4_131.zip / GLITCH.DOC < prev    next >
Text File  |  1990-03-29  |  120KB  |  2,243 lines

  1.                                     GLitch v 4.xx                         i
  2.  
  3.  
  4.  
  5.                                        GLitch
  6.  
  7.                                 Global LITerature searCH
  8.  
  9.                             GLitch version 4.xx March 1990
  10.  
  11.                            GLitch is copyrighted material
  12.                             1986, 1987, 1988, 1989 & 1990
  13.  
  14.           You may however use it and distribute it to others on the
  15.           following conditions:
  16.           a. No fee shall be charged for copying and distribution.
  17.           b. GLitch may not be reverse assembled or modified in any way.
  18.           c. All the files must be distributed together.
  19.  
  20.  
  21.  
  22.           In short, GLitch is a user supported database program that can be
  23.           used for storing, retrieving and printing out (to disk or onto
  24.           paper) literature references.
  25.                                    GLitch v 4.xx                         ii
  26.  
  27.  
  28.  
  29.                                            1
  30.           GLitch is user supported software
  31.  
  32.           The user supported software concept (usually referred to as
  33.           freeware) is an attempt to provide software at low cost. The cost
  34.           of offering a new product by conventional means is staggering,
  35.           and hence dissuades many independent authors and small companies
  36.           from developing and promoting their ideas. User supported
  37.           software is an attempt to develop a new marketing channel, where
  38.           products can be introduced at low cost.
  39.  
  40.           If user supported software works, then everyone will benefit. The
  41.           user will benefit by receiving quality products at low cost, and
  42.           by being able to "test drive" software thoroughly before
  43.           purchasing it. The author benefits by being able to enter the
  44.           commercial software arena without first needing large sources of
  45.           venture capital.
  46.  
  47.           But it can only work with your support. We're not just talking
  48.           about GLitch here, but about all user supported software. If you
  49.           find that you are still using a program after a couple of weeks,
  50.           then it is obviously worth something to you, and you should send
  51.           in a contribution.
  52.  
  53.           Contributions ($25.00 recommended) towards GLitch should be sent
  54.           to:
  55.  
  56.                   D.M. Schultz
  57.                   31 Rethman Street
  58.                   New Germany
  59.                   3610
  60.                   South Africa
  61.  
  62.           Registered users of previous versions of GLitch can update as
  63.           follows:
  64.  
  65.                  1.xx           $15.00
  66.                  2.xx           $10.00
  67.                  3.xx            $5.00
  68.  
  69.           -------------------------
  70.           1
  71.            This description of freeware is based on that given in the
  72.           documentation of ARC, a freeware product by System Enhancement
  73.           Associates, 21 New Street, Wayne, NJ 07470
  74.                                    GLitch v 4.xx                        iii
  75.  
  76.  
  77.                                   Table of Contents
  78.           1 Introduction                                                  1
  79.           1.1 What is GLitch ?                                            1
  80.           1.2 Why do I need GLitch ?                                      1
  81.           1.3 What is needed to run GLitch ?                              1
  82.           1.4 What does GLitch store ?                                    2
  83.           1.5 What are the capacities of GLitch ?                         2
  84.           1.6 How is the GLitch program started ?                         2
  85.           1.6.1 Creating a BOOT disk                                      2
  86.           1.6.2 Using a floppy drive system                               3
  87.           1.6.3 Using a hard disk                                         3
  88.           2 Using GLitch.                                                 3
  89.           2.1 General                                                     3
  90.           2.1.1 Terminology                                               3
  91.           2.1.2 Selecting options                                         3
  92.           2.1.3 Entering information                                      4
  93.           2.1.4 Editing information on-screen.                            4
  94.           2.1.4.1 Cursor movement                                         4
  95.           2.2 Creating a GLitch reference database                        4
  96.           2.3 Entering references into GLitch.                            7
  97.           2.3.1 Entering Author information                               7
  98.           2.3.2 Entering Title information                                8
  99.           2.3.3 Entering Keywords                                         8
  100.           2.3.4 Entering Memoranda or Abstract                            9
  101.           2.3.5 The next reference                                        9
  102.           2.4 Working with a GLitch database                              9
  103.           2.4.1 Main Menu Overview                                       10
  104.           2.4.2 Adding references (option A from the Main Menu)          12
  105.           2.4.3 Tagging references (option T from the Main Menu)         12
  106.           2.4.3.1 An overview                                            13
  107.           2.4.3.2 Setting tags (option T from the Tagging menu)          14
  108.           2.4.3.2.1 Author selection                                     15
  109.           2.4.3.2.2 Year of publication selection                        15
  110.           2.4.3.2.3 String                                               15
  111.           2.4.3.2.4 Keyword selection                                    16
  112.           2.4.3.2.5 Phonetic keyword                                     16
  113.           2.4.3.2.6 User sequence numbers                                17
  114.           2.4.3.2.7 Every reference selection                            17
  115.           2.4.3.3 Clearing tags  (option C on the tagging menu)          17
  116.           2.4.3.4 Switching the search domain (option A on the tagging
  117.                     menu)                                                17
  118.           2.4.3.5 Leaving the tags as they are (option L from tagging
  119.                     menu)                                                18
  120.           2.4.4 Browsing through references (option B from Main Menu)    19
  121.           2.4.4.1 Adding to a reference (option A from Browse)           20
  122.           2.4.4.2 Jumping to a reference (option J from Browse)          20
  123.           2.4.4.3 Editing a reference (option E from Browse)             21                                    GLitch v 4.xx                         iv
  124.  
  125.  
  126.           2.4.4.3.1 Authors                                              21
  127.           2.4.4.3.2 Title information                                    21
  128.           2.4.4.3.4 Memoranda                                            22
  129.           2.4.4.4 Deleting or Wiping a reference (option W from Browse)  22
  130.           2.4.5 Printing (option P from the Main Menu)                   22
  131.           2.4.6 Dumping references to disk (option D from Main Menu)     24
  132.           2.4.6.1 Reference Dump                                         25
  133.           2.4.6.2 Group index dumps                                      26
  134.           2.4.6.2.1 Plain Group Index (option G)                         26
  135.           2.4.6.2.2 Automatic Author Index  (options A and B)            27
  136.           2.4.6.2.3 Automatic keyword Index  (options K and L)           27
  137.           2.4.7 User sequence number allocation (option S from Main Menu)28
  138.           2.4.8 Keyword editing (option K from Main Menu)                29
  139.           2.4.9 Erasing references  (option E from the Main Menu)        30
  140.           2.4.10 Refreshing and Packing the database (option R from Main
  141.                     Menu)                                                31
  142.           2.4.11 Merging with another database (option M from Main Menu) 32
  143.           2.4.12 Leaving the Main Menu (option X from Main Menu)         33
  144.           2.5 Selecting a file group to work on.                         33
  145.           2.6 Using a RAM or virtual drive (option R)                    35
  146.           2.6.1 Introduction                                             35
  147.           2.6.2 Using a RAM drive with GLitch (R option)                 35
  148.           2.7 Optimising  (O option)                                     37
  149.           2.8 Exiting from GLitch (X option)                             37
  150.           Appendix A.                                                    39
  151.           Appendix B.                                                    40
  152.           Appendix C.                                                    41
  153.           Appendix D.                                                    45
  154.           Appendix E.                                                    46
  155.           Appendix F.                                                    47
  156.                                     GLitch v 4.xx                         1
  157.  
  158.  
  159.           1 Introduction
  160.  
  161.           1.1 What is GLitch ?
  162.  
  163.           Glitch is a database program that will store and retrieve
  164.           literature references. References are entered and stored after
  165.           which they can be found rapidly by means of searches for
  166.           keywords, authors, dates, titles etcetera. References can be
  167.           printed out or sent to a disk file to be incorporated into a
  168.           bibliography using your own word processor.
  169.  
  170.           1.2 Why do I need GLitch ?
  171.  
  172.           1.2.1 Suppose you read or see an article, book or paper that you
  173.           may want to refer to at some time in the future. By entering the
  174.           pertinent information into GLitch you will be able to find the
  175.           reference later even if you have forgotten the author(s), title
  176.           or journal where you saw it. So long as you know something about
  177.           the reference you will be able to locate it in the database,
  178.           perhaps by searching by means of a keyword.
  179.  
  180.           1.2.2. If you are writing a paper or working on a thesis, you
  181.           could enter all references that you use or read into GLitch.
  182.           Later when you come to producing a bibliography, the references
  183.           that you select will not have to be re-typed ! GLitch will dump
  184.           the references that you need into a disk file which you can then
  185.           use with your word processor ! The references will be arranged in
  186.           alphabetical author and date order.
  187.  
  188.           1.2.3 You would like to keep track of all known references on a
  189.           certain subject and want to know where to be able to get a copy
  190.           if you need it. Other workers in your field may also have
  191.           compiled a database which you could search through in case they
  192.           have found references that escaped your attention.
  193.  
  194.           1.2.4 How do you find all the references on a certain subject in
  195.           a manual system (perhaps written on cards), if you want to
  196.           exclude a particular author (maybe yourself) and only look at
  197.           references that were published within a specific time period ? If
  198.           your references were on computer you could do all this (and more)
  199.           and then print a list of them too !
  200.  
  201.           1.3 What is needed to run GLitch ?
  202.  
  203.           GLitch will run on an IBM or compatible PC. A printer is
  204.           optional. A single disk drive is required and will run on a hard
  205.           disk or floppy system. 384K memory is required.                                     GLitch v 4.xx                         2
  206.  
  207.  
  208.  
  209.           1.4 What does GLitch store ?
  210.  
  211.           Each database has four main sections:
  212.  
  213.                   1.4.1 Author(s)
  214.  
  215.                   1.4.2 Title information
  216.  
  217.                   1.4.3 Memorandum or Abstract (any notes you would like to
  218.                   make)
  219.  
  220.                   1.4.4 Keywords
  221.  
  222.           1.5 What are the capacities of GLitch ?
  223.  
  224.           In practical terms the size of your database is only limited by
  225.           the available disk space. Within this limitation each reference
  226.           can have:
  227.  
  228.           1.5.1 Author section
  229.           32 authors. Each author has a surname of 25 characters and 6
  230.           characters for initials,
  231.  
  232.           1.5.2 Title section which is subdivided into:
  233.  
  234.           254 characters for title information,
  235.  
  236.           4 characters for the year of publication and type of date,
  237.  
  238.           254 characters for the source information,
  239.  
  240.           80 characters describing the location of a copy of the reference,
  241.  
  242.           1.5.3 Memo or Abstract section
  243.           Up to 32 000 characters of memorandum or abstract.
  244.  
  245.           1.5.4 Keyword section
  246.           2048 keywords each 20 characters long.
  247.  
  248.           1.5.5 In addition, each reference has a User Sequence number that
  249.           can reallocated.
  250.  
  251.           1.6 How is the GLitch program started ?
  252.  
  253.           1.6.1 Creating a BOOT disk
  254.           If your copy if GLitch is not on a bootable system disk FORMAT a
  255.           disk with the /S parameter. You must then copy ALL the files that                                     GLitch v 4.xx                         3
  256.  
  257.  
  258.           came with GLitch to this new floppy, including the CONFIG.SYS
  259.           files etcetera. This disk is then your GLitch program disk.
  260.  
  261.           1.6.2 Using a floppy drive system
  262.           Insert the GLitch program disk into drive A and switch on the
  263.           computer.
  264.  
  265.           1.6.3 Using a hard disk
  266.           The GINSTALL.BAT batch file will install GLitch on your hard
  267.           disk. To run GLitch, change to the GLitch directory and type
  268.           GLITCH
  269.  
  270.           2 Using GLitch.
  271.  
  272.           The ensuing pages explain how to use GLitch once it is running on
  273.           your PC.
  274.  
  275.           2.1 General
  276.  
  277.           2.1.1 Terminology
  278.           The following terms are used in the subsequent documentation and
  279.           are defined here for clarification
  280.  
  281.           2.1.1.1 File group
  282.           Each reference database consists of a number of disk files which
  283.           together are termed a file group. A group name consists of up to
  284.           eight characters which can then serve as a `handle' for all the
  285.           files that are required or will be created by GLitch.
  286.  
  287.           2.1.1.2 Option
  288.           A choice from one of the menus, selected by a single character.
  289.  
  290.           2.1.1.3 User Sequence number
  291.           The user sequence numbers that you may allocate to the
  292.           references. Their primary use is in creating cross- referenced
  293.           bibliographies, references are allocated a user sequence number
  294.           that refers back to the main reference entry.
  295.  
  296.           2.1.1.4 Group index
  297.           A group index is a cross-reference list of user sequence numbers
  298.           that are associated with a particular subset of references. For
  299.           example, it may be a list of the sequence numbers for all
  300.           references by a particular author. Group indexes are usually used
  301.           when compiling cross-referenced bibliographies.
  302.  
  303.           2.1.2 Selecting options
  304.           All options in GLitch are selected by a single keystroke. It is
  305.           not necessary to press ENTER or RETURN after the option letter.                                     GLitch v 4.xx                         4
  306.  
  307.  
  308.           The option letters have been chosen so as to be as closely
  309.           related to the function of the option as possible. Upper or lower
  310.           case can be used when selecting any option.
  311.  
  312.           2.1.3 Entering information
  313.           Where a file group or other information which may have a variable
  314.           length is to be entered, RETURN must be pressed to indicate the
  315.           end of the information.
  316.  
  317.           2.1.4 Editing information on-screen.
  318.           Information that is to be changed is displayed in inverse video
  319.           on the monitor.
  320.  
  321.           2.1.4.1 Cursor movement
  322.           The cursor can be moved from one datum to another using the up
  323.           and down arrow keys. After pressing return in any field, the
  324.           cursor moves to the first character of the next field. Page- down
  325.           will terminate all editing on the screen. HOME and END will move
  326.           the cursor to the first and last character of the present field
  327.           being edited respectively.
  328.  
  329.           2.1.4.2 Insert mode
  330.           The INSERT key can be used to toggle the insert or overwrite mode
  331.           which is indicated by "Ins"  at the top of the screen.
  332.  
  333.           2.1.4.3 Finishing editing
  334.           When all the fields displayed in inverse video are as you want
  335.           them, press PAGE DOWN or press RETURN whilst in the last field.
  336.           The ESC key will abandon any changes made.
  337.  
  338.           2.2 Creating a GLitch reference database
  339.  
  340.           As soon as GLitch starts up a banner proclaiming GLitch is
  341.           displayed on the screen. Press any key, and the following screen
  342.           will be displayed:                                     GLitch v 4.xx                         5
  343.  
  344.  
  345.  
  346.      +---------------------------------------------------------------------+
  347.      |                                                                     |
  348.      |                              GLitch       v  4.xx                   |
  349.      |                                                                     |
  350.      |               Global LITerature searCH program                      |
  351.      |                                                                     |
  352.      |S. Select a file group                                               |
  353.      |C. Create a new file group                                           |
  354.      |R. Use RAM disk                                                      |
  355.      |O. Optimise a file                                                   |
  356.      |X. eXit GLitch                                                       |
  357.      |                                                                     |
  358.      |                                                                     |
  359.      |                                                                     |
  360.      |                                                                     |
  361.      |                                                                     |
  362.      |Select your choice..                                                 |
  363.      |                                                                     |
  364.      +---------------------------------------------------------------------+
  365.  
  366.  
  367.           The screen above displays the version of your copy of GLitch and
  368.           the options of the file selection menu.
  369.  
  370.           We shall deal with C :- "Create a new file group" first.
  371.  
  372.           In order to create a new database for yourself enter "C"
  373.  
  374.           The screen will then display:
  375.  
  376.     +---------------------------------------------------------------------+
  377.     |                                                                     |
  378.     |   On which drive must the database be stored ?                      |
  379.     |       Note: the drive specified must be formatted                   |
  380.     +---------------------------------------------------------------------+
  381.  
  382.           At this stage you must enter the drive letter that you want the
  383.           database to be stored on. Valid drives are A through to F. Enter
  384.           a single character in either upper or lower case. If you are not
  385.           using a hard disk it is recommended that you use a separate disk
  386.           to the GLitch program disk.
  387.  
  388.           Each database consists of a number of files. All the files for
  389.           each database are grouped together as a file group. The file
  390.           group name can be up to eight (8) characters long and can consist
  391.           of all the alphabetic characters and numbers (standard DOS file                                     GLitch v 4.xx                         6
  392.  
  393.  
  394.           name characters), except the full stop. When creating a database,
  395.           GLitch must know what you want to call it so it says:
  396.  
  397.     +---------------------------------------------------------------------+
  398.     |           Enter new group name                                      |
  399.     |                                                                     |
  400.     |  New Group:                                                         |
  401.     |                                                                     |
  402.     +---------------------------------------------------------------------+
  403.  
  404.           Enter the group name for your references and press RETURN
  405.  
  406.           GLitch will then create all the required files for your new
  407.           literature database, and display:
  408.  
  409.     +---------------------------------------------------------------------+
  410.     |      Since this database is brand new and does not                  |
  411.     |       have any data, we will start off by entering some !           |
  412.     |                                                                     |
  413.     |  Press any key to continue...                                       |
  414.     +---------------------------------------------------------------------+
  415.  
  416.  
  417.           You will be prompted to enter the first reference. It is hoped
  418.           that it will be the first of very many !
  419.                                     GLitch v 4.xx                         7
  420.  
  421.  
  422.           2.3 Entering references into GLitch.
  423.  
  424.           There are four stages in entering information:
  425.                   a. Author(s)
  426.                   b. Title, date, source and location
  427.                   c. Keywords
  428.                   d. Memoranda
  429.  
  430.           Only (a) and (b) above are required.
  431.  
  432.           2.3.1 Entering Author information
  433.  
  434.           Each author in entered independently, surname first, then
  435.           Initials
  436.  
  437.   +-------------------------------------------------------------------------+
  438.   |          Author's SURNAME                                               |
  439.   |          Bloggs                                                         |
  440.   |                                                                         |
  441.   | Initials DJ                                                             |
  442.   |                                                                         |
  443.   |                                     A blank surname will terminate input|
  444.   +-------------------------------------------------------------------------+
  445.  
  446.           The first letter of the author's surname and all initials will be
  447.           automatically converted to capital letters. If the authors's
  448.           surname does start with a lower case letter, enter it twice and
  449.           then you can delete the first letter later. It is recommended
  450.           that initials are entered without any spaces or periods,
  451.           conforming to modern practice. After entering each author GLitch
  452.           will display each author in the order in which they were
  453.           entered:-
  454.  
  455.     +---------------------------------------------------------------------+
  456.     |           Bloggs               DJ                                   |
  457.     |           Shoddyrods           TG                                   |
  458.     |                                                                     |
  459.     |           Author's SURNAME                                          |
  460.     |                                                                     |
  461.     |                                                                     |
  462.     |  Initials                                                           |
  463.     |                                                                     |
  464.     |                                A blank surname will terminate input |
  465.     +---------------------------------------------------------------------+
  466.  
  467.  
  468.           When all the authors have been entered press PAGE DOWN or enter a
  469.           blank surname and GLitch will start soliciting the title
  470.           information.                                     GLitch v 4.xx                         8
  471.  
  472.  
  473.  
  474.           2.3.2 Entering Title information
  475.  
  476.           Enter the title of the article or book, year of publication,
  477.           source and location of a copy in the relevant fields as shown
  478.           below:
  479.  
  480.    +------------------------------------------------------------------------+
  481.    |            Title of reference                                          |
  482.    |  Field guide to the sharks of Central Kalahari                         |
  483.    |                                                                        |
  484.    |                                                                        |
  485.    |                                                                        |
  486.    |                                           Date type 1    normal = 1    |
  487.    |  Year of publication 1987                                In Prep. = P  |
  488.    |                                                          In Press = S  |
  489.    |                                                          circa = C     |
  490.    |            Source                                                      |
  491.    |  Printum Book Co., Upington                                            |
  492.    |                                                                        |
  493.    |                                                                        |
  494.    |                                                                        |
  495.    |                                                                        |
  496.    |  Where is there a copy available ?                                     |
  497.    |  Marico Town Library                                                   |
  498.    |                                                                        |
  499.    +------------------------------------------------------------------------+
  500.  
  501.  
  502.           Note that the year of publication may not be later than the
  503.           current year. To this end it must be ensured that the system
  504.           clock on your PC has had its date set correctly ! GLitch will
  505.           supply the default date type of "1". If the exact date of
  506.           publication is not known enter a "C", this will cause "ca." to be
  507.           placed in front of the year of publication whenever the reference
  508.           is displayed or printed. Select "P" or "S" if the reference is in
  509.           press or preparation respectively, causing "in prep" or "in
  510.           press" to be appended to the year. The Source field should
  511.           contain all the `reference' part of the article that is not part
  512.           of the title, such as the journal name, volume number etcetera.
  513.  
  514.           2.3.3 Entering Keywords
  515.  
  516.           You may enter as many keywords as you like, one at a time. All
  517.           keywords are converted to upper case to ensure that the keywords
  518.           SHARKS and sharks will always match.
  519.  
  520.     +---------------------------------------------------------------------+
  521.     |           Enter keywords one at a time SHARKS                       |
  522.     |                                                                     |
  523.     |                Enter a blank keyword to stop                        |
  524.     +---------------------------------------------------------------------+                                     GLitch v 4.xx                         9
  525.  
  526.  
  527.  
  528.           As each keyword is entered, it is printed above the prompt area
  529.           and they will scroll up the screen as they are recorded. Entering
  530.           a blank keyword will terminate entry of keywords.
  531.  
  532.           2.3.4 Entering Memoranda or Abstract
  533.  
  534.           Any notes that you would like to have linked to the reference can
  535.           be typed in as memoranda. The entire abstract of the paper can be
  536.           entered too !
  537.  
  538.           GLitch will ask you if you would like to enter some memoranda.
  539.  
  540. +------------------------------------------------------------------------------+
  541. | Memoranda are entered with the XyWrite type editor called XyEd.              |
  542. |                                                                              |
  543. | If you are not familiar with XyWrite then consult Appendix F of the GLitch   |
  544. | manual, or a XyWrite manual.                                                 |
  545. |                                                                              |
  546. | It is not difficult, you just have to type in the memoranda and              |
  547. |                      ALT-S will STORE the memoranda and                      |
  548. |                      ALT-X will ABORT any editing..                          |
  549. |                                                                              |
  550. |                                                                              |
  551. |    Do you wish to enter Memoranda                                            |
  552. +------------------------------------------------------------------------------+
  553.  
  554.           GLitch uses a XyWrite type editor called XyEd to enter or edit
  555.           all memoranda. If you are not familiar with XyWrite, consult
  556.           Appendix F. If you choose to enter some memoranda the editor will
  557.           be activated. You can always add memoranda to the reference
  558.           later.
  559.  
  560.           2.3.5 The next reference
  561.  
  562.           Once the memoranda (if any) have been entered, GLitch will ask if
  563.           you intend entering another reference...
  564.  
  565.                          +----------------------------+
  566.                          | Another reference ?        |
  567.                          +----------------------------+
  568.  
  569.  
  570.           Entering Y will start the next reference and N will take you to
  571.           the MAIN MENU of GLitch.
  572.  
  573.           2.4 Working with a GLitch database
  574.  
  575.           This section deals with how and what can be done with a GLitch
  576.           reference database. An overview of the Main Menu is given first
  577.           and then each option is discussed in more detail.                                    GLitch v 4.xx                         10
  578.  
  579.  
  580.  
  581.           2.4.1 Main Menu Overview
  582.  
  583.           Once a database has been created, you are in a position to choose
  584.           what you want to do with it. Each type of activity is selected by
  585.           choosing the relevant option from the GLitch Main Menu. When a
  586.           particular activity is complete, you will find yourself back at
  587.           the Main Menu again in order that you may choose what you want to
  588.           do next.
  589.  
  590.           The complete Main Menu looks like this:
  591.  
  592.    +-----------------------------------------------------------------------+
  593.    |                               GLitch Main menu....                    |
  594.    |                                                                       |
  595.    |                                         File group NODDY  on drive B: |
  596.    |                                                                       |
  597.    | A DD a ref                             2 references exist             |
  598.    | T AG (or untag) references             2 references tagged            |
  599.    | B ROWSE references                                                    |
  600.    | P RINT references, keywords, authors or manual                        |
  601.    | D UMP references to disk                                              |
  602.    | U SER sequence number                                                 |
  603.    | K EYWORD editing on all tagged references                             |
  604.    | N OTES on NODDY                                                       |
  605.    |                                                                       |
  606.    |                                                                       |
  607.    | Select your choice.._                                                 |
  608.    |                                                                       |
  609.    | E RASE references                                                     |
  610.    | R EFRESH and PACK file                                                |
  611.    | M ERGE NODDY with another database                                    |
  612.    | X EXIT or change FILE GROUP selection                                 |
  613.    +-----------------------------------------------------------------------+
  614.  
  615.  
  616.           The choices available from the Main Menu are briefly explained
  617.           below. For a more detailed description of each option see
  618.           subsequent sections. Each option is selected by typing the
  619.           leading character (upper or lower case) of the option, for
  620.           example type P to print.
  621.  
  622.           The file group name and drive are displayed as a reminder of the
  623.           file group with which you are currently working.
  624.  
  625.           The total number of references that have been entered into the
  626.           database is shown as: nnn references exist The number of                                    GLitch v 4.xx                         11
  627.  
  628.  
  629.           references that are currently selected to be worked with are
  630.           shown as: nnn references tagged. See Option T below.
  631.  
  632.           Brief description of Main Menu options:
  633.  
  634.           Option A will allow you to ADD new references to the database. If
  635.                    you want to add information to existing references see
  636.                    option B below.
  637.  
  638.           Option T is the key to efficient use of GLitch. Each reference
  639.                    can have a TAG or FLAG attached to it which indicates
  640.                    that that reference is currently selected to be
  641.                    manipulated, listed or used in any way. Any reference
  642.                    that is not tagged becomes invisible to yourself and
  643.                    will not be printed, or mentioned in any way by GLitch.
  644.                    Such a reference will not be available to be edited and
  645.                    will even seem to have been deleted. Option T controls
  646.                    which references have their tags set and which have them
  647.                    cleared. References start off tagged when entered.
  648.  
  649.           Option B lets you BROWSE through the references that are
  650.                    currently tagged. When browsing, references can be
  651.                    edited, added to, deleted, untagged or merely displayed
  652.                    one at a time on the screen. All references are
  653.                    presented in alphabetical order of the authors and date
  654.                    of publication. Keywords can also be Viewed.
  655.  
  656.           Option P prints three types of information pertaining to the
  657.                    currently tagged references, or an Invoice. The
  658.                    references, keywords and memoranda, or author or keyword
  659.                    lists can be printed. You must have a printer attached !
  660.  
  661.           Option D creates and sends certain information pertaining to all
  662.                    the tagged references to a disk file of your choice. The
  663.                    file is an ASCII file and is legible to most good word
  664.                    processors and other software. You are given the choice
  665.                    of dumping memoranda and or keywords, or group indexes.
  666.  
  667.           Option S allows you to allocate user sequence numbers to the
  668.                    tagged references. You will be prompted for the first
  669.                    number and the increment. All untagged references will
  670.                    have their user sequence numbers set to zero.
  671.  
  672.           Option K makes it possible to add, edit or delete a keyword from
  673.                    all the tagged references.
  674.  
  675.           Option N is used to attach some notes to the file group, using
  676.                    the XyEd editor. (See Appendix F.)                                    GLitch v 4.xx                         12
  677.  
  678.  
  679.  
  680.           Option E will allow you to erase either the tagged or the
  681.                    untagged references.
  682.  
  683.           Option R does some housekeeping for you by releasing any disk
  684.                    space that may have become available by your deletion of
  685.                    information.
  686.  
  687.           Option M merges the file group with another.
  688.  
  689.           Option X is used to stop working with the present file group: You
  690.                    may want to work with another file group or you might
  691.                    have finished with GLitch.
  692.  
  693.           If none of the references are tagged, only the Add, Tag, Refresh,
  694.           Notes, Merge and eXit options will be available.
  695.  
  696.           Each of the above options will now be described in more detail.
  697.  
  698.           2.4.2 Adding references (option A from the Main Menu)
  699.  
  700.           Adding a reference is done in exactly the same way as entering
  701.           the first reference(s) when the file group was initially created.
  702.           See section 2.3 above called "Entering references into GLitch".
  703.           If you have selected to use a RAM drive please also refer to
  704.           section 2.6.
  705.  
  706.           2.4.3 Tagging references (option T from the Main Menu)
  707.  
  708.           As mentioned before this is the key to the effective utilisation
  709.           of GLitch. Only children who eat all their dinner will ever see
  710.           any pudding, and only references that are tagged will ever be
  711.           seen. Imagine a torch procession on a dark night. By
  712.           extinguishing a torch, the person carrying it can be made to be
  713.           invisible, it does not kill the person. If the torch is re-lit,
  714.           the person will reappear. A tagged reference is like a person
  715.           with a burning torch. The tagging option will allow you to set or
  716.           clear the tags on any subset or all the references that exist.
  717.  
  718.           Selecting the T option from the Main Menu displays the Tagging
  719.           menu:                                    GLitch v 4.xx                         13
  720.  
  721.  
  722.  
  723. +-----------------------------------------------------------------------------+
  724. |                                tag Main menu....                            |
  725. |                                                                             |
  726. |              85 references are in this file group                           |
  727. |                                                    Searches will be GLOBAL  |
  728. |              85 references are currently tagged                             |
  729. |                                                                             |
  730. |                                                                             |
  731. |  T ag certain references                                                    |
  732. |  C lear certain tags                                                        |
  733. |  A lter search domain to TAGGED references only                             |
  734. |                                                                             |
  735. |  L eave tags as they are                                                    |
  736. |                                                                             |
  737. |                                                                             |
  738. |                                                                             |
  739. |                                                                             |
  740. |                                                                             |
  741. |                                                                             |
  742. |                                                                             |
  743. |Select your choice..                                                         |
  744. +-----------------------------------------------------------------------------+
  745.  
  746.  
  747.           The Tag Main menu displays the total number of references and the
  748.           number of these that are tagged. Initially it will also say that
  749.           searches will be GLOBAL. Up to four tagging options are also
  750.           provided.
  751.  
  752.           2.4.3.1 An overview
  753.  
  754.           Option T is used to SET tags. A number of search criteria can be
  755.                    specified enabling a subset of references to be tagged.
  756.  
  757.           Option C is the reverse of T. Existing tags can be cleared for a
  758.                    certain subset of references.
  759.  
  760.           Option A governs what is called the search domain which is either
  761.                    LOCAL or GLOBAL. When searches are GLOBAL, references
  762.                    that are not tagged are searched for a match in the
  763.                    search criteria. References that match become tagged,
  764.                    those that do not match are left as they were. Option A
  765.                    will switch or toggle the search domain from GLOBAL to
  766.                    LOCAL and back again. When the domain is LOCAL, then
  767.                    only those references already tagged are searched, if
  768.                    they do not match the criteria, then their tags are
  769.                    cleared.                                    GLitch v 4.xx                         14
  770.  
  771.  
  772.  
  773.           Option L indicates that you are satisfied with the state of the
  774.                    tags and wish to return to the Main Menu.
  775.  
  776.           If the situation arises where no references are tagged, options C
  777.           and A will not be available since they would be illogical in such
  778.           a circumstance. If the search domain is LOCAL and no references
  779.           match the criteria specified, then all the tags are cleared and
  780.           the domain is then reset to GLOBAL.
  781.  
  782.           The four options are discussed in more detail below.
  783.  
  784.           2.4.3.2 Setting tags (option T from the Tagging menu)
  785.  
  786.           GLitch must know which references are to be tagged and so it will
  787.           then ask for search criteria like this:
  788.  
  789.  
  790. +-----------------------------------------------------------------------------+
  791. |  ADDING TAGS                  Selection of search criteria                  |
  792. |                                                                             |
  793. |           1    references are in this file group                            |
  794. |                                                   Searches will be GLOBAL   |
  795. |           1    references are currently tagged                              |
  796. |                                                                             |
  797. |                                                                             |
  798. |                                                                             |
  799. | A uthor                                                                     |
  800. | Y ear                                                                       |
  801. | S tring                                                                     |
  802. |      in Title, Source, Keyword, Housed or Memoranda                         |
  803. | K eyword                                                                    |
  804. | U ser sequence Nº                                                           |
  805. | P honetic keyword                                                           |
  806. |                                                                             |
  807. |                                                                             |
  808. |                                                                             |
  809. | E very reference                                                            |
  810. +-----------------------------------------------------------------------------+
  811.  
  812.           As can be seen from the menu above, criteria can be specified in
  813.           a number of ways. A 'match all' option is provided by the Every
  814.           reference option.
  815.  
  816.           Select the type of search criteria you would like to use and
  817.           GLitch will then prompt you for more detail. An example of each
  818.           type is given below.                                    GLitch v 4.xx                         15
  819.  
  820.  
  821.  
  822.           2.4.3.2.1 Author selection
  823.           GLitch prompts you for an author's surname:
  824.  
  825.                   +------------------------------------------+
  826.                   |                                          |
  827.                   |    Author surname  BLOGGS                |
  828.                   |                                          |
  829.                   +------------------------------------------+
  830.  
  831.  
  832.           By typing `Bloggs' GLitch will have been informed that we want it
  833.           to tag all references that have Bloggs as one of the authors. If
  834.           two such references exist, then on returning to the Tagging menu
  835.           the screen may look like this:
  836.  
  837.     +---------------------------------------------------------------------+
  838.     |                    tag Main menu....                                |
  839.     |                                                                     |
  840.     |  85 references are in this file group                               |
  841.     |                                        Searches will be GLOBAL      |
  842.     |   2 references are currently tagged                                 |
  843.     |                                                                     |
  844.     +---------------------------------------------------------------------+
  845.  
  846.  
  847.           2.4.3.2.2 Year of publication selection
  848.           A range of years can be specified:
  849.  
  850.                    +---------------------------------------+
  851.                    |                                       |
  852.                    |    Earliest year 1960                 |
  853.                    |                                       |
  854.                    |      Latest year 1987                 |
  855.                    +---------------------------------------+
  856.  
  857.  
  858.           If only a single year is desired, enter it as the earliest year
  859.           since the latest year defaults to the earliest year and all you
  860.           have to do is press RETURN. Note that GLitch will not accept a
  861.           latest year that is before the earliest, nor will it accept a
  862.           year that is after the current year ! The calendar in your PC
  863.           must therefore be correct.
  864.  
  865.           2.4.3.2.3 String
  866.           Any set of characters (a string) can be searched for in the
  867.           Title, Source, Memoranda or Keywords. You will be prompted for                                    GLitch v 4.xx                         16
  868.  
  869.  
  870.           the string to search for and you will also be asked which areas
  871.           of the database must be searched:
  872.  
  873.                  +-------------------------------------------+
  874.                  | Enter String to look for.. arks           |
  875.                  |                                           |
  876.                  |      Must I look in the TITLE ? y         |
  877.                  |                                           |
  878.                  |      Must I look in the SOURCE ? n        |
  879.                  |                                           |
  880.                  |      Must I look in the HOUSED field ? n  |
  881.                  |                                           |
  882.                  |      Must I look in the MEMORANDA ? y     |
  883.                  |                                           |
  884.                  |      Must I look in the KEYWORDS ? y      |
  885.                  +-------------------------------------------+
  886.  
  887.           2.4.3.2.4 Keyword selection
  888.           Specify the keyword that you would like GLitch to search for:
  889.  
  890.     +---------------------------------------------------------------------+
  891.     |                                                                     |
  892.     | key word to search KLEPTOMANIA                                      |
  893.     |                                                                     |
  894.     +---------------------------------------------------------------------+
  895.  
  896.  
  897.           Remember that all keywords are case independent. You will also be
  898.           asked if the keywords must be an exact match. If you answer N(o)
  899.           then any keyword that STARTS with with your specification will
  900.           match. For example VULTURE and VULLY will match VUL.
  901.  
  902.           2.4.3.2.5 Phonetic keyword
  903.           This allows you to search the keywords if you do not know how to
  904.           spell the keyword. You must enter a word that SOUNDS similar to
  905.           the target keyword. GLitch will verify with you that matches
  906.           should be accepted each time a new keyword if found:
  907.  
  908.       +------------------------------------------------------------------+
  909.       | Enter a keyword that SOUNDS similar to the target keyword.       |
  910.       |                                                                  |
  911.       | Note the the first letter must match.                            |
  912.       |                                                                  |
  913.       |      Keyword to search  KALIHARI                                 |
  914.       |                                                                  |
  915.       |                                                                  |
  916.       |           Is KALAHARI a match ?                                  |
  917.       |                                                                  |
  918.       +------------------------------------------------------------------+                                    GLitch v 4.xx                         17
  919.  
  920.  
  921.  
  922.  
  923.           2.4.3.2.6 User sequence numbers
  924.           Specify the lowest number and the highest number to be searched
  925.           for:
  926.  
  927.                       +----------------------------------+
  928.                       |     First sequence number    1   |
  929.                       |                                  |
  930.                       |       Last sequence number 9999  |
  931.                       +----------------------------------+
  932.  
  933.  
  934.           2.4.3.2.7 Every reference selection
  935.           At times one may want to specify that every reference must match
  936.           the search criteria. Option E will do this for you in a single
  937.           step.
  938.  
  939.           2.4.3.3 Clearing tags  (option C on the tagging menu)
  940.  
  941.           The only difference between Tagging and Clearing tags is the
  942.           direction. The specification of the search criteria is identical.
  943.           See the previous section. As a reminder that you are clearing as
  944.           opposed to setting tags, the words CLEARING TAGS are displayed at
  945.           the top left of the display.
  946.  
  947.           2.4.3.4 Switching the search domain (option A on the tagging
  948.           menu)
  949.  
  950.           Altering the domain allows very complex search criteria to be
  951.           built up. When the domain is GLOBAL, any tagging is in addition
  952.           to those references already tagged and can be likened to the
  953.           boolean operator OR. If references having the keyword "GREEN" are
  954.           tagged and then all those with the keyword "RED" are also tagged,
  955.           then a reference will be tagged if it has either a keyword
  956.           "GREEN" OR "RED" or both.
  957.  
  958.           When the domain is LOCAL, tagging will only take place on
  959.           references that are already tagged. Thus tagging can be likened
  960.           to the boolean AND. After tagging all references with keyword
  961.           "GREEN", switching the domain to LOCAL and then tagging all
  962.           references having keyword "RED" would result in only those
  963.           references having both "GREEN" AND "RED" keywords would be
  964.           tagged. Any reference with a keyword "GREEN" but not having a
  965.           keyword "RED" would be UNTAGGED.
  966.  
  967.           When switching the domain from GLOBAL to LOCAL the following
  968.           message is displayed:                                    GLitch v 4.xx                         18
  969.  
  970.  
  971.  
  972.     +---------------------------------------------------------------------+
  973.     |             WARNING !!                                              |
  974.     |       References that match a search in this mode will be the only  |
  975.     |       ones tagged. References that do not meet the criteria         |
  976.     |       will have their tags CLEARED. Only references already         |
  977.     |       tagged will be searched allowing `AND' type conditions.       |
  978.     |                                                                     |
  979.     |   The screen will switch to reverse video until the domain is reset.|
  980.     |                                                                     |
  981.     | Press any key to continue...                                        |
  982.     +---------------------------------------------------------------------+
  983.  
  984.  
  985.           By selectively adding and removing tags within the two domains,
  986.           any complex search criteria can be specified.
  987.  
  988.           If no references match the search criteria whilst the search
  989.           domain is set to LOCAL, the following will be displayed:
  990.  
  991.       +------------------------------------------------------------------+
  992.       |   Since no references match, all tags have been removed and      |
  993.       |    the search domain has been reset to GLOBAL.                   |
  994.       +------------------------------------------------------------------+
  995.  
  996.  
  997.           The resetting of the domain is a logical necessity !
  998.  
  999.           2.4.3.5 Leaving the tags as they are (option L from tagging menu)
  1000.  
  1001.           Selection of this option returns you to the GLitch Main Menu.
  1002.                                    GLitch v 4.xx                         19
  1003.  
  1004.  
  1005.           2.4.4 Browsing through references (option B from Main Menu)
  1006.  
  1007.           All editing and deleting of existing references is done by means
  1008.           of the Browse option. References are displayed on the screen one
  1009.           at a time, in alphabetical author and date order. Each reference
  1010.           can be edited, added to, have its tag cleared or even be deleted.
  1011.           Selecting the Browse option causes the first reference to be
  1012.           displayed:
  1013.  
  1014.      +--------------------------------------------------------------------+
  1015.      | Bloggs              DJ                                             |
  1016.      | Shoddyrods          TG                                             |
  1017.      |    1987                                                            |
  1018.      |         Field Guide to the Sharks of Central Kalahari              |
  1019.      |  Source:Printum Book Co., Upington                                 |
  1020.      |                                                   Sequence Nº   0  |
  1021.      | Housed:                                                            |
  1022.      | Marico Town Library                                                |
  1023.      |                                                                    |
  1024.      |  Memo:                                                             |
  1025.      | not a very big book and easy to read.                              |
  1026.      | N ext  P rev  J ump  V iew  E dit  C lear  A dd  W ipe  X it       |
  1027.      +--------------------------------------------------------------------+
  1028.  
  1029.  
  1030.           Below the display are ten options:
  1031.  
  1032.           Option N moves on to the next reference. If the reference
  1033.                    displayed is the last one, you will be returned to the
  1034.                    Main Menu.
  1035.  
  1036.           Option P goes back to the previous reference. If the reference
  1037.                    displayed is the first one, you will be returned to the
  1038.                    Main Menu.
  1039.  
  1040.           Option J is used to move through the tagged references quickly,
  1041.                    forwards or backwards
  1042.  
  1043.           Option V is used to display the keywords belonging to the
  1044.                    displayed reference. Viewing the keywords is much faster
  1045.                    than Editing them.
  1046.  
  1047.           Option E is for editing any information pertaining to the
  1048.                    currently displayed reference. You will be asked if you
  1049.                    want to edit Authors, Title information, Keywords or
  1050.                    Memoranda.
  1051.                                    GLitch v 4.xx                         20
  1052.  
  1053.  
  1054.           Option C will untag the current reference. This is most often
  1055.                    used when one has tagged a whole lot of references and
  1056.                    is now browsing through them. On finding one that will
  1057.                    not be required (perhaps they are to be printed later),
  1058.                    one can clear the tag with this option.
  1059.  
  1060.           Option A is for adding authors, keywords or memoranda. On
  1061.                    selecting this option you will be asked what type of
  1062.                    information is to be added.
  1063.  
  1064.           Option W is lethal, it will delete the current reference.
  1065.                    Actually it's not that bad, it marks the reference as
  1066.                    deleted only after checking that you do want to wipe it
  1067.                    out !
  1068.  
  1069.           Option X returns you straight to the Main Menu.
  1070.  
  1071.           Options A, J, E and W are described more fully below.
  1072.  
  1073.           2.4.4.1 Adding to a reference (option A from Browse)
  1074.  
  1075.           GLitch will prompt you:
  1076.  
  1077.                      +------------------------------------+
  1078.                      |                                    |
  1079.                      | Add:   Authors, Keywords or Memo   |
  1080.                      |                                    |
  1081.                      +------------------------------------+
  1082.  
  1083.  
  1084.           Enter A, K or M to add Authors, Keywords or Memoranda
  1085.           respectively. Entering the new information is done in exactly the
  1086.           same manner as when first entering references.
  1087.  
  1088.           Note that by adding an author the position of the current
  1089.           reference in the sequence of references may change. For example
  1090.           if there were two references by Bloggs, one in 1967 and the other
  1091.           in 1982, adding a second author to Bloggs 1967 will force its
  1092.           position to after Bloggs 1982 ! You must not therefore be
  1093.           surprised when you come across the same reference again lower
  1094.           down the pile (one may even think it is a duplicate and Wipe it
  1095.           out).
  1096.  
  1097.           2.4.4.2 Jumping to a reference (option J from Browse)
  1098.  
  1099.           After pressing J to jump, you will be asked if you want to go to
  1100.           the first or last reference or move in jumps of ten backward or
  1101.           forward, or to a specific Sequence Number:-                                    GLitch v 4.xx                         21
  1102.  
  1103.  
  1104.  
  1105.       +------------------------------------------------------------------+
  1106.       | N ext  P rev  J ump  V iew  E dit  C lear  A dd  W ipe  X it  j  |
  1107.       | S tart  E nd   F orward 10   B ack 10  No                        |
  1108.       +------------------------------------------------------------------+
  1109.  
  1110.  
  1111.           2.4.4.3 Editing a reference (option E from Browse)
  1112.  
  1113.           Since GLitch must know which part of the reference is to be
  1114.           edited, it will prompt:
  1115.  
  1116.                  +-------------------------------------------+
  1117.                  |                                           |
  1118.                  | Edit:   Authors, Title, Keywords or Memo  |
  1119.                  |                                           |
  1120.                  +-------------------------------------------+
  1121.  
  1122.  
  1123.           Enter A, T, K or M to edit Authors, Title information, Keywords
  1124.           or Memoranda respectively. The layout for editing is very similar
  1125.           to that used when entering data initially. To terminate any type
  1126.           of edit use the PAGE-DOWN key whilst in any field or the RETURN
  1127.           key in the last field. An example of each type of edit is given
  1128.           below:
  1129.  
  1130.           2.4.4.3.1 Authors
  1131.           Two authors could look like this:
  1132.  
  1133.                   +------------------------------------------+
  1134.                   | Space to delete  -  PgDn to end edit     |
  1135.                   |      Bloggs                        DJ    |
  1136.                   |      Shoddyrods                    TG    |
  1137.                   +------------------------------------------+
  1138.  
  1139.           If you want to delete an author, make the first character of the
  1140.           surname a space, and it will be excluded when you have finished
  1141.           editing. Since authors are stored in the order in which they are
  1142.           entered, their sequence for a particular reference can be changed
  1143.           by deleting and adding again.
  1144.  
  1145.           2.4.4.3.2 Title information
  1146.           The layout for editing title information is identical to that
  1147.           used when adding the reference initially.
  1148.  
  1149.           2.4.4.3.3 Keywords
  1150.           Keywords are listed in columns on the screen. Once you have
  1151.           changed the keyword(s) that need editing, press PAGE-DOWN.                                    GLitch v 4.xx                         22
  1152.  
  1153.  
  1154.  
  1155.                +------------------------------------------------+
  1156.                | Pg Dn - end edit.  Space - delete.             |
  1157.                | KALAHARI                                       |
  1158.                | SHARKS                                         |
  1159.                |  URTLES                                        |
  1160.                +------------------------------------------------+
  1161.  
  1162.  
  1163.           Placing a space at the beginning of a keyword will erase it when
  1164.           you press PAGE-DOWN. In the example above, TURTLES will be
  1165.           deleted.
  1166.  
  1167.           2.4.4.3.4 Memoranda
  1168.           Memoranda are edited with XyEd, see Appendix F
  1169.  
  1170.           2.4.4.4 Deleting or Wiping a reference (option W from Browse)
  1171.  
  1172.           To remove a reference from your database press the W key whilst
  1173.           at that reference when Browsing. GLitch will ask if you are sure
  1174.           that you want to delete the reference. You may then enter a Y to
  1175.           confirm the deletion or N to keep the reference.
  1176.  
  1177.      +-------------------------------------------------------------------+
  1178.      | N ext  P rev  J ump  V iew  E dit  C lear  A dd  W ipe  X it  w   |
  1179.      | Do you really want to delete this reference ?  n                  |
  1180.      | Ok it will be kept                                                |
  1181.      | N ext  P rev  J ump  V iew  E dit  C lear  A dd  W ipe  X it      |
  1182.      +-------------------------------------------------------------------+
  1183.  
  1184.           The above four lines of display indicate the sequence of events
  1185.           of deleting a reference but deciding to keep it at the last
  1186.           moment !
  1187.  
  1188.           2.4.5 Printing (option P from the Main Menu)
  1189.  
  1190.           If you need a hard copy of all or some of the references you can
  1191.           print them out in alphabetic author and date order. Only those
  1192.           references that are tagged will be printed out. All the
  1193.           information for each reference is printed or just an author or
  1194.           keyword list. If you do not have a printer connected and on-line
  1195.           then:-
  1196.  
  1197.     +---------------------------------------------------------------------+
  1198.     | You must have a printer connected for this option !                 |
  1199.     |  No printer found. Is it plugged in, switched on and on- line ...?  |
  1200.     | Fix it and type C to continue printing, any other key to quit..     |
  1201.     +---------------------------------------------------------------------+                                    GLitch v 4.xx                         23
  1202.  
  1203.  
  1204.  
  1205.           Once you have a printer connected, press C to continue, any other
  1206.           key will return you to the Main Menu.
  1207.  
  1208.           Three different types of data printout are available:-
  1209.           References, Authors and Keywords. The Reference listing contains
  1210.           all the information for every tagged reference, and is printed in
  1211.           author order. The Author and Keyword listings are of every
  1212.           different author or keyword for the tagged references, listed in
  1213.           alphabetical order. In addition, an invoice or manual can be
  1214.           produced. GLitch presents you with the choice of printouts:-
  1215.  
  1216.               +--------------------------------------------------+
  1217.               | Select the type of printout you want:            |
  1218.               | R eferences   A uthors   K eywords   I nvoice a  |
  1219.               | Page Length 55                                   |
  1220.               +--------------------------------------------------+
  1221.  
  1222.           GLitch will also ask for the Page Length, being the number of
  1223.           lines to be printed on, on each page. Note that no special
  1224.           functions such as underlining or italics are attempted since this
  1225.           would require a special configuration for each type of printer
  1226.           being used. The listing produced by the Print option is not meant
  1227.           to be used for publication quality production. If you want fancy
  1228.           output you must dump the references out to a disk file and read
  1229.           that into your word processor or typesetter (see the D option,
  1230.           section 2.4.6). GLitch is a database program not a word
  1231.           processor.
  1232.  
  1233.           Options R,A and K are self explanatory, option I will print an
  1234.           invoice for GLitch since many organisations cannot effect payment
  1235.           without an invoice. On selecting to print an invoice, you will be
  1236.           asked if your printer can handle the IBM box characters, an
  1237.           invoice will then be printed accordingly.
  1238.                                    GLitch v 4.xx                         24
  1239.  
  1240.  
  1241.           2.4.6 Dumping references to disk (option D from Main Menu)
  1242.  
  1243.           One of the goals of GLitch is that references are typed only
  1244.           once. When you need to construct a bibliography or some neat list
  1245.           of references there should be no need to retype all the
  1246.           references. GLitch gives you the opportunity to extract a subset
  1247.           or all the references from your database in a machine readable
  1248.           form. An ASCII file is produced which should be able to be read
  1249.           by any application program in which you want the data. Probably
  1250.           the most common use will be to format and print the references
  1251.           using your own word processor.
  1252.  
  1253.           There are two main types of file dump that can be made, the first
  1254.           is a dump of the References, the second is a Group index. GLitch
  1255.           will ask you which type of dump you require and the file name to
  1256.           dump to:
  1257.  
  1258. +--------------------------------------------+
  1259. |      R eferences                           |
  1260. |      G roup index                          |
  1261. |      A uthor group index    fast           |
  1262. |      B Author group index   slower         |
  1263. |      K eyword group index   fast           |
  1264. |      L Keyword group index  slower         |
  1265. |                                            |
  1266. |      N one  return to Main Menu            |
  1267. |                                            |
  1268. |    Which dump do you want ?                |
  1269. +--------------------------------------------+
  1270.  
  1271.           A default file name of "groupname.REF" (where groupname is your
  1272.           file group name) will be used by merely pressing RETURN. Thus if
  1273.           the group name of the database is NODDY, the default dump file
  1274.           name will be NODDY.REF. Note that the file need not exist
  1275.           already, in fact if it does already exist, GLitch will confirm
  1276.           that it must be overwritten.
  1277.  
  1278.                   +------------------------------------------+
  1279.                   | Enter output file name BIB.TXT           |
  1280.                   | Whoops ! BIB.TXT already exists !!!!     |
  1281.                   |                                          |
  1282.                   | Overwrite it ? n                         |
  1283.                   | Enter output file name                   |
  1284.                   +------------------------------------------+
  1285.  
  1286.  
  1287.           In the example above, the file BIB.TXT already existed so GLitch
  1288.           asked if it was to be overwritten: N was entered indicating that                                    GLitch v 4.xx                         25
  1289.  
  1290.  
  1291.           it was NOT to be overwritten and so GLitch then prompted the user
  1292.           for a new file name. To overwrite a file enter Y to the question.
  1293.  
  1294.           2.4.6.1 Reference Dump
  1295.  
  1296.           You have the choice of having various types of additional data
  1297.           dumped to the file as well. After requesting a Dump of the tagged
  1298.           references you will be asked what you would like to have included
  1299.           in the dump:-
  1300.  
  1301.               +-------------------------------------------------+
  1302.               | Do you want Memoranda to be dumped ? y          |
  1303.               |                                                 |
  1304.               | Do you want Keywords to be dumped ? y           |
  1305.               |                                                 |
  1306.               | Do you want Sequence Numbers to be dumped ? y   |
  1307.               |                                                 |
  1308.               | Do you want the Housed field to be dumped ? y   |
  1309.               +-------------------------------------------------+
  1310.  
  1311.           Enter Y or N in answer to the questions. One may want to dump all
  1312.           the information if one intended sending the file somewhere using
  1313.           a MODEM or transferring it to another computer. If one has a very
  1314.           large database it is sometimes better to dump all the information
  1315.           and then print it all out with a word processor.
  1316.  
  1317.           You will then be prompted to enter character strings to be used
  1318.           by your word processor for any type of formatting you want to
  1319.           use. The defaults are suitable for XyWrite.
  1320.  
  1321.        +---------------------------------------------------------------+
  1322.        | String to place at top of file                                |
  1323.        |      <SSAUTH><SSMEMO><SSKEY,TS=5,30,55><SSREF,ip=0,5><USAUTH> |
  1324.        |                                                               |
  1325.        | String to start underline/italics    <MDUL>                   |
  1326.        | String to stop underline/italics     <MDNM>                   |
  1327.        |                                                               |
  1328.        | String to put at start of Authors    <NB><USAUTH>             |
  1329.        | String to put at start of Title      <USREF>                  |
  1330.        | String to put at start of Memoranda  <USMEMO>                 |
  1331.        | String to put at start of Keywords   <USKEY>                  |
  1332.        | Insert TAB before each Keyword ?     Y                        |
  1333.        | String for end of each reference     <BB>                     |
  1334.        +---------------------------------------------------------------+
  1335.  
  1336.  
  1337.           GLitch then begins formatting the references.                                    GLitch v 4.xx                         26
  1338.  
  1339.  
  1340.  
  1341.       +-----------------------------------------------------------------+
  1342.       |      References being written to file BIB.TXT                   |
  1343.       |                                                                 |
  1344.       |                                                                 |
  1345.       | Field guide to the sharks of Central Kalahari                   |
  1346.       |                                                                 |
  1347.       +-----------------------------------------------------------------+
  1348.  
  1349.  
  1350.           As each reference is formatted, its title is displayed. When all
  1351.           the tagged references have been processed, control is returned to
  1352.           the Main Menu.
  1353.  
  1354.           2.4.6.2 Group index dumps
  1355.  
  1356.           A Group Index is a list of Sequence numbers that refer to some
  1357.           sub-population of the references. If one was creating a cross-
  1358.           referenced bibliography, one could tag all the references
  1359.           pertaining to some subject, then dump a group index to disk.
  1360.  
  1361.           Three types of Group Index are available from GLitch:
  1362.  
  1363.           2.4.6.2.1 Plain Group Index (option G)
  1364.  
  1365.           This creates a single index for all the tagged references. GLitch
  1366.           will prompt you for the title or description of the group index:
  1367.  
  1368.         +-------------------------------------------------------------+
  1369.         |           Enter the title for references currently tagged   |
  1370.         |                                                             |
  1371.         | Papers by Bloggs post 1946 concerning deserts               |
  1372.         +-------------------------------------------------------------+
  1373.  
  1374.  
  1375.           The dump file will contain the one line description and the User
  1376.           sequence numbers.
  1377.  
  1378.           If GLitch finds that one of the tagged references does not have a
  1379.           sequence number it will ask:
  1380.  
  1381.           +---------------------------------------------------------+
  1382.           | Following reference does not have a sequence number..   |
  1383.           | Field Guide to the Sharks of Central Kalahari           |
  1384.           |                                                         |
  1385.           |                                                         |
  1386.           |           Shall I abort ?                               |
  1387.           +---------------------------------------------------------+                                    GLitch v 4.xx                         27
  1388.  
  1389.  
  1390.  
  1391.           Type Y or N to abort the dump.
  1392.  
  1393.           2.4.6.2.2 Automatic Author Index  (options A and B)
  1394.  
  1395.           Will create a separate index for each author of the tagged
  1396.           references, and place them all in the dump file. Option A is
  1397.           faster but requires some disk space temporarily.
  1398.  
  1399.           2.4.6.2.3 Automatic keyword Index  (options K and L)
  1400.  
  1401.           Will create a separate index for each keyword of the tagged
  1402.           references, and place them all in the dump file. Option K is
  1403.           faster but requires some disk space temporarily.
  1404.                                    GLitch v 4.xx                         28
  1405.  
  1406.  
  1407.           2.4.7 User sequence number allocation (option S from Main Menu)
  1408.  
  1409.           The User sequence numbers are a set of numbers that you may
  1410.           allocate to the references in GLitch. Use these numbers to cross-
  1411.           reference your database by allocating a number to each reference.
  1412.           GLitch will respond to the 'S' option with:
  1413.  
  1414. +-----------------------------------------------------------------------------+
  1415. | This option allows you to define a set of sequence numbers that will be     |
  1416. | applied to TAGGED references. Once allocated these USER sequence numbers    |
  1417. | can only be changed by using this option again. Tagging or the clearing of  |
  1418. | tags will thus have NO effect on the numbers.                               |
  1419. |                                                                             |
  1420. |                                                                             |
  1421. |     Do you wish to continue ? y                                             |
  1422. |                                                                             |
  1423. | Please enter the first number to use, and the increment                     |
  1424. |                                                                             |
  1425. |      Start at     1                                                         |
  1426. |                                                                             |
  1427. |      Increment   1                                                          |
  1428. +-----------------------------------------------------------------------------+
  1429.  
  1430.  
  1431.           Enter the starting number and the size of the increment between
  1432.           successive references. All untagged references will have their
  1433.           User sequence numbers set to zero.
  1434.                                    GLitch v 4.xx                         29
  1435.  
  1436.  
  1437.           2.4.8 Keyword editing (option K from Main Menu)
  1438.  
  1439.           You can add or delete any keyword to or from all the tagged
  1440.           references. GLitch responds to the 'K' option with:
  1441.  
  1442.          +-----------------------------------------------------------+
  1443.          | Keyword editing.....                                      |
  1444.          |                                                           |
  1445.          |                                                           |
  1446.          |      A DD a keyword to each tagged reference              |
  1447.          |                                                           |
  1448.          |      D ELETE a keyword from each tagged reference         |
  1449.          |                                                           |
  1450.          |      R EPLACE keywords                                    |
  1451.          |                                                           |
  1452.          |      S TRIP out duplicate keywords (all references)       |
  1453.          |                                                           |
  1454.          |      N ONE   Return to Main Menu                          |
  1455.          |                                                           |
  1456.          |                                                           |
  1457.          |                                                           |
  1458.          |    Choose type of edit required..                         |
  1459.          |                                                           |
  1460.          +-----------------------------------------------------------+
  1461.  
  1462.           Once you have told GLitch that you want to do, you will be
  1463.           prompted to enter the keyword to be Added, Deleted or Changed.
  1464.  
  1465.           GLitch will not add a keyword to a reference if it already has
  1466.           that keyword.
  1467.  
  1468.           If you opt to Strip duplicate keywords from the database, GLitch
  1469.           will also remove duplicates from any references that are not
  1470.           tagged.
  1471.                                    GLitch v 4.xx                         30
  1472.  
  1473.  
  1474.           2.4.9 Erasing references  (option E from the Main Menu)
  1475.  
  1476.           You can erase all the tagged or untagged references with this
  1477.           Erase option. If all the references are tagged, GLitch will
  1478.           respond:
  1479.  
  1480.  +----------------------------------------------------------------------------+
  1481.  | This option will either delete all the tagged OR the untagged references.  |
  1482.  |                                                                            |
  1483.  | Since there are no UNTAGGED references, GLitch cannot know which are to    |
  1484.  | be deleted !  If you want to delete every reference, just abandon or       |
  1485.  | delete this entire file group as follows..                                 |
  1486.  |                                                                            |
  1487.  |     ERASE NODDY.*                                                          |
  1488.  |                                                                            |
  1489.  |  when you have eXited GLitch and are at the DOS prompt.                    |
  1490.  |                                                                            |
  1491.  | Press any key to continue...                                               |
  1492.  +----------------------------------------------------------------------------+
  1493.  
  1494.           If there are some untagged references, GLitch will tell you how
  1495.           many there are and ask which are to be deleted:
  1496.  
  1497. +-----------------------------------------------------------------------------+
  1498. |           You have:.....                                                    |
  1499. |                                                                             |
  1500. |                             22 references in this file group                |
  1501. |                                                                             |
  1502. |           of which                                                          |
  1503. |                             10 are tagged                                   |
  1504. |                             12 are NOT tagged                               |
  1505. |                                                                             |
  1506. |                                                                             |
  1507. | Do you want to delete all the Tagged or Untagged references ? (T or U) u    |
  1508. |                                                                             |
  1509. | OK, just to be sure,...                                                     |
  1510. |                do you want to delete the tagged ones ?                      |
  1511. |                                                                             |
  1512. |                                                                             |
  1513. +-----------------------------------------------------------------------------+
  1514.  
  1515.           Note that GLitch will double check to see which set of references
  1516.           are to be deleted.
  1517.                                    GLitch v 4.xx                         31
  1518.  
  1519.  
  1520.           2.4.10 Refreshing and Packing the database (option R from Main
  1521.           Menu)
  1522.  
  1523.           When a reference has been deleted using the W option from Browse,
  1524.           or the E option from the main menu, all the data pertaining to
  1525.           that reference are merely flagged as deleted. The information
  1526.           still exists in the files. In order to reclaim that file space
  1527.           and to make your files smaller and thus faster to use, you must
  1528.           PACK the files. The R option will PACK the data files and rebuild
  1529.           the index files used by GLitch. If you suspect that the index
  1530.           file (having the file extension of .AUT) has become corrupted
  1531.           (perhaps GLitch is behaving in a strange way) then use this R
  1532.           option to Refresh the index file, or you may delete the AUT file
  1533.           and GLitch will regenerate it for you.
  1534.                                    GLitch v 4.xx                         32
  1535.  
  1536.  
  1537.           2.4.11 Merging with another database (option M from Main Menu)
  1538.  
  1539.           You can add the contents of one database with the database that
  1540.           you have already opened:
  1541.  
  1542.   +-------------------------------------------------------------------------+
  1543.   | This option will allow you to merge another database onto the one you   |
  1544.   | are currently using (NODDY)                                             |
  1545.   |                                                                         |
  1546.   |      do you wish to continue ? y                                        |
  1547.   |                                                                         |
  1548.   |                                                                         |
  1549.   |    On which drive does the database reside ? c                          |
  1550.   |                                                                         |
  1551.   |                                                                         |
  1552.   |                                                                         |
  1553.   |           Please enter the file group you wish to use                   |
  1554.   |                                                                         |
  1555.   |     Group to be added:  B-EARS                                          |
  1556.   +-------------------------------------------------------------------------+
  1557.  
  1558.           GLitch will then add the new file group.
  1559.                                    GLitch v 4.xx                         33
  1560.  
  1561.  
  1562.           2.4.12 Leaving the Main Menu (option X from Main Menu)
  1563.  
  1564.           If your work on the current file group is complete, the X option
  1565.           will return you to the file selection menu. There is no need to
  1566.           save the database, GLitch stores the information on disk as you
  1567.           enter each reference.
  1568.  
  1569.           2.5 Selecting a file group to work on.
  1570.  
  1571.           Once you have created a file group and you would like to return
  1572.           to work on it, choose the S option from the file selection menu
  1573.           which is the menu presented to you when first starting GLitch or
  1574.           after exiting from the Main Menu.
  1575.  
  1576.              +---------------------------------------------------+
  1577.              |                                                   |
  1578.              |    On which drive does the database reside ?      |
  1579.              |                                                   |
  1580.              +---------------------------------------------------+
  1581.  
  1582.           GLitch must know where to find the file group so enter the drive
  1583.           letter for the database. The program must also know which file
  1584.           group you would like to work on
  1585.  
  1586.        +---------------------------------------------------------------+
  1587.        |           Please enter the file group you wish to use         |
  1588.        |                                                               |
  1589.        |                                                               |
  1590.        | Group:                                                        |
  1591.        +---------------------------------------------------------------+
  1592.  
  1593.  
  1594.           Enter the file group name and press RETURN. If GLitch finds the
  1595.           files for the file group it will display the Main Menu and you
  1596.           may then use the database as you like. If however the file group
  1597.           that you enter does not exist on the drive specified earlier then
  1598.           GLitch will say:
  1599.  
  1600.           +---------------------------------------------------------+
  1601.           | Group: NODY                                             |
  1602.           | File group NODY does not exist                          |
  1603.           | Enter NUL to stop trying to Select a file group         |
  1604.           |                                                         |
  1605.           |                                                         |
  1606.           | Group:                                                  |
  1607.           +---------------------------------------------------------+
  1608.                                    GLitch v 4.xx                         34
  1609.  
  1610.  
  1611.           You may have misspelled the group name, enter the correct name.
  1612.           If in fact the group name is correct, perhaps you specified the
  1613.           incorrect drive. If so enter NUL as the group name and you will
  1614.           be returned to the file selection menu.
  1615.  
  1616.           If on locating the desired file group the index file is missing,
  1617.           GLitch will reconstruct it and inform you that it was missing.
  1618.                                    GLitch v 4.xx                         35
  1619.  
  1620.  
  1621.           2.6 Using a RAM or virtual drive (option R)
  1622.  
  1623.           2.6.1 Introduction
  1624.  
  1625.           A RAM or virtual drive is an emulated disk drive that exists in
  1626.           the memory of the PC. It is not a physical disk drive. The great
  1627.           advantage of a RAM drive is its super fast speed. The
  1628.           disadvantage is that it is volatile and all data will be lost if
  1629.           the PC is switched off. GLitch gives you the option of using a
  1630.           RAM drive to temporarily store your databases. GLitch will also
  1631.           copy all the files automatically to a real (physical) drive when
  1632.           you have finished working with a file group on a RAM drive.
  1633.  
  1634.           A RAM drive can be created in two ways:
  1635.  
  1636.           2.6.1.1 Using a device driver specified in the CONFIG.SYS file
  1637.           that is available when the PC is booted up, for example MDISK.SYS
  1638.           or VDISK.SYS which comes with DOS 3.xx. See your DOS manual.
  1639.  
  1640.           2.6.1.2 Using a purpose made RAM resident program that is run
  1641.           after booting the PC, for example SUPERDRV by AST Research.
  1642.  
  1643.           The first method above is that which is recommended. If you are
  1644.           using floppy disks to store your data, try to create a 360K RAM
  1645.           disk which is the same size as a standard double sided formatted
  1646.           floppy. This ensures that one is not likely to create a file
  1647.           group in RAM that is too large to be stored on a single floppy.
  1648.  
  1649.           The drive designator is always the next letter of the alphabet
  1650.           after your highest physical drive. If you have a twin floppy
  1651.           drive system, the RAM drive will have the drive letter C:, if you
  1652.           have a hard drive called C: then the RAM drive will be D:.
  1653.  
  1654.           2.6.2 Using a RAM drive with GLitch (R option)
  1655.  
  1656.           Note that from version 4 of GLitch onwards, there is not enough
  1657.           memory for a 360K RAM drive and GLitch on a 640K system. You must
  1658.           have your RAM drive above 640K and it is thus preferable to have
  1659.           at least 1 megabyte of RAM. Version 4 is very much faster than
  1660.           previous versions and thus the need for a RAM drive will not be
  1661.           as great.
  1662.  
  1663.           Whilst at the file selection menu, that is before you select or
  1664.           create a new database, select the R option. The programs'
  1665.           response will be:                                    GLitch v 4.xx                         36
  1666.  
  1667.  
  1668.  
  1669.        +---------------------------------------------------------------+
  1670.        |    Which drive is the RAM drive ? c                           |
  1671.        |                                                               |
  1672.        |            In case of power failure whilst working with the   |
  1673.        |            RAM disk, it must be backed up periodically.       |
  1674.        |                                                               |
  1675.        |       Enter time in minutes between each backup 20            |
  1676.        |                                                               |
  1677.        +---------------------------------------------------------------+
  1678.  
  1679.           Enter the drive letter of the RAM drive.
  1680.  
  1681.           You may also enter the time period between backups of the RAM
  1682.           drive. Press return to accept the default of 20 minutes or enter
  1683.           the time interval between backups from the RAM drive to the
  1684.           physical drive on which the file group resides. Whenever you
  1685.           return to the Main Menu, GLitch will check to see if the
  1686.           specified time has elapsed since the last backup and if so, it
  1687.           will ask you if it is to copy the files from the RAM drive to the
  1688.           home drive.
  1689.  
  1690.           The drive letter of the RAM drive and the backup period will be
  1691.           displayed and the R option now reverses its direction, selecting
  1692.           the R option again will cancel the use of the RAM drive.
  1693.  
  1694.           Note that it is possible to specify a physical drive letter,
  1695.           (except A:) and GLitch will be none the wiser, it will dutifully
  1696.           copy the database there and copy it back again when finished. If
  1697.           you want to change the RAM drive specification to another RAM
  1698.           drive, cancel it first and then specify a new letter. You cannot
  1699.           select or create a file group that exists on the same drive as is
  1700.           the specified RAM drive since it would be illogical to do so.
  1701.  
  1702.           If a RAM drive is in use the Main Menu will indicate the RAM
  1703.           drive letter next to the file group name.
  1704.                                    GLitch v 4.xx                         37
  1705.  
  1706.  
  1707.           2.7 Optimising  (O option)
  1708.  
  1709.           The performance of GLitch can be improved by optimising the
  1710.           database. You will be prompted for the name of the file group to
  1711.           be optimised. If there is insufficient disk space GLitch will ask
  1712.           you which drive can be used temporarily. After a file group has
  1713.           been optimised, the index file will need to be recreated. GLitch
  1714.           will do this automatically when you next use the database.
  1715.  
  1716.           2.8 Exiting from GLitch (X option)
  1717.  
  1718.           To return to DOS from GLitch select the X option from the file
  1719.           selection menu. You will be presented with the ending screen with
  1720.           a recommendation to backup your GLitch files, and the author's
  1721.           name and address.
  1722.                                    GLitch v 4.xx                         38
  1723.  
  1724.  
  1725.           GLitch is user supported software
  1726.  
  1727.           The user supported software concept (usually referred to as
  1728.           freeware) is an attempt to provide software at low cost. The cost
  1729.           of offering a new product by conventional means is staggering,
  1730.           and hence dissuades many independent authors and small companies
  1731.           from developing and promoting their ideas. User supported
  1732.           software is an attempt to develop a new marketing channel, where
  1733.           products can be introduced at low cost.
  1734.  
  1735.           If user supported software works, then everyone will benefit. The
  1736.           user will benefit by receiving quality products at low cost, and
  1737.           by being able to "test drive" software thoroughly before
  1738.           purchasing it. The author benefits by being able to enter the
  1739.           commercial software arena without first needing large sources of
  1740.           venture capital.
  1741.  
  1742.           But it can only work with your support. We're not just talking
  1743.           about GLitch here, but about all user supported software. If you
  1744.           find that you are still using a program after a couple of weeks,
  1745.           then pretty obviously it is worth something to you, and you
  1746.           should send in a contribution.
  1747.  
  1748.           Contributions should be sent to:
  1749.  
  1750.                   D.M. Schultz
  1751.                   31 Rethman Street
  1752.                   New Germany
  1753.                   3610
  1754.                   South Africa
  1755.  
  1756.           From the end screen, any key depression will leave you at the DOS
  1757.           prompt.
  1758.                                                                          39
  1759.  
  1760.  
  1761.                                      Appendix A.
  1762.  
  1763.                                Configuring your system
  1764.  
  1765.           GLitch will work best if your CONFIG.SYS file has the following
  1766.           two lines:
  1767.  
  1768.           FILES=20
  1769.           BUFFERS=8
  1770.  
  1771.           If you do not have a file called CONFIG.SYS then it can be
  1772.           created with any ASCII text editor, or from the DOS prompt as
  1773.           follows:
  1774.  
  1775.           COPY CON CONFIG.SYS
  1776.           FILES=20
  1777.           BUFFERS=8
  1778.           ^Z
  1779.  
  1780.           Where ^Z is the f6 key. DOS should respond with:
  1781.             1 file(s) copied.
  1782.  
  1783.           Your DOS manual explains how the CONFIG.SYS file works.
  1784.                                                                          40
  1785.  
  1786.  
  1787.                                      Appendix B.
  1788.  
  1789.                               Advanced Usage of GLitch
  1790.  
  1791.           The following are some useful tips which can lead to a more
  1792.           efficient use of GLitch.
  1793.  
  1794.           B-1 When you come to add references to an existing file group,
  1795.           clear all the existing tags before adding the new information.
  1796.           This will result in the new references being the only ones tagged
  1797.           when you have finished adding them, thus making it possible to
  1798.           print or browse through the new data for checking purposes.
  1799.  
  1800.           B-2 Since journal entries do not have the title of the paper
  1801.           underlined or italicized but the journal name instead, problems
  1802.           could be caused by GLitch when dumping references to disk since
  1803.           GLitch only inserts the starting and ending strings at the
  1804.           beginning and end of the title field. By using a consistent
  1805.           coding scheme, you can control the special attributes for the
  1806.           titles and journal names by embedding the start and end strings
  1807.           in the database itself. For example let us say that you decide to
  1808.           use ## to signify the beginning of an underlined section, and $$
  1809.           the end. To suppress the underlining of a title field enter $$ at
  1810.           the start of the title, thus suppressing it as it starts. To
  1811.           force the underlining of a journal name (within the source area
  1812.           of the reference), enter ## and $$ at either end to underline the
  1813.           applicable information. When you come to dump the references to
  1814.           be used by your word processor, specify the same start and end
  1815.           strings viz. ## and $$. Once you have called the file up in your
  1816.           word processor, change all the ##'s to whatever is required to
  1817.           begin underlining or italics and similarly with the $$. In the
  1818.           interests of compatibility between users, the author suggests
  1819.           using ## and $$ as the start and end strings respectively.
  1820.  
  1821.           B-3 XyWrite users can embed XyWrite formatting commands by
  1822.           including double less-than and greater-than signs. For example
  1823.           <<MDUL>> will automatically be converted to the XyWrite
  1824.           formatting command. See Appendix F also.
  1825.  
  1826.                                                                          41
  1827.  
  1828.  
  1829.                                      Appendix C.
  1830.  
  1831.                                   Revision History
  1832.  
  1833.           The following is a history of the changes made to GLitch
  1834.  
  1835.           1.00 November 1986
  1836.                GLitch was written in November 1986 for Steven Piper of the
  1837.                University of Natal, Durban.
  1838.  
  1839.           1.01 November 1986
  1840.                Tagging bug fixed.
  1841.  
  1842.           1.02 December 1986
  1843.                User input now buffered.
  1844.                Refreshing and Packing option added to Main Menu
  1845.  
  1846.           1.03 January 1987
  1847.                NUL filename available to allow one to escape from selecting
  1848.                a file group.
  1849.                New file groups go directly to Add references.
  1850.                Search domain automatically reset to global if no matches
  1851.                found.
  1852.                Main menu tag option now says "Tag (or untag)"
  1853.                Current file group is displayed on Main Menu
  1854.                Printing option now checks to see if printer is on line and
  1855.                "Printing" is displayed on screen during printing.
  1856.                File name used by the Dump procedure changed from GLOUT.DBF
  1857.                to GOBLANK.DBF. Disks or directories with file groups
  1858.                created by earlier versions must have the file renamed using
  1859.                the DOS rename command.
  1860.                Any characters can now be used in an author's surname.
  1861.                Documentation added to later copies.
  1862.  
  1863.           2.00 March 1987
  1864.                Date type added and backward compatible too !
  1865.                Periodic RAM backup facility added.
  1866.                Memoranda and/or Keywords can optionally be Dumped
  1867.                Two additional printouts    added, Keywords and Authors.
  1868.                Printouts now paginated and with a header indicating number
  1869.                of references extant and tagged, date, etc..
  1870.                Author input terminated by a nul author.
  1871.                Keywords and Memoranda scroll up the screen as entered.
  1872.                Jump option added to Browse
  1873.                Browse display will not scroll off the screen due to many
  1874.                lines of memoranda but will ask if user wishes to see more
  1875.                memo lines first.                                                                          42
  1876.  
  1877.  
  1878.                View option added to display Keywords quickly.
  1879.                Documentation file updated and special box characters
  1880.                removed.
  1881.                Installation batch files constructed.
  1882.  
  1883.           2.01 March 1987
  1884.                Period is inserted after the date in file dumps.
  1885.                Files are erased from RAM drive when finished with leaving,
  1886.                room for another file group to be placed in RAM.
  1887.                Spurious form feeds between printouts removed.
  1888.  
  1889.           2.02 April 1987
  1890.                Bug in creating a file group using a RAM drive fixed.
  1891.  
  1892.           2.03 May 1987
  1893.                Invoice and Manual options added to Print option.
  1894.                Disclaimer added to final screen.
  1895.                Index added to Manual.
  1896.  
  1897.           3.01 September 1987
  1898.                Internal reference numbers displayed in printout and can be
  1899.                used to Jump to a specific reference whilst Browsing.
  1900.                User sequence numbers added.
  1901.                File structure changed to allow a 'header' record to
  1902.                remember the number of references extant and tagged
  1903.                resulting in a much faster load time. Old format files are
  1904.                converted.
  1905.                Tagging feature speeded up slightly.
  1906.                Face prompt used throughout.
  1907.                Author sorting fixed so that surnames starting with lower
  1908.                case letter are sorted correctly.
  1909.                Bug in local tagging of title information killed.
  1910.                Added keyword editing facility.
  1911.                Added Group index dump feature.
  1912.                Creation of new file groups now done without any reference
  1913.                to external blank files.
  1914.                Backup of RAM drive no longer confined to Adding references
  1915.                and backup time is displayed at file selection menu.
  1916.                                                                          43
  1917.  
  1918.  
  1919.           4.01 July 1988
  1920.                GLitch was rewritten with a new file structure for increased
  1921.                speed. The new file structure imposed some limitations on
  1922.                each reference:
  1923.                 32 Authors
  1924.                 2048 Keywords
  1925.                 32K of Memoranda
  1926.                More memory is required (about 384K)
  1927.                Group name can now be 8 characters long.
  1928.                Version 3 files are converted automatically.
  1929.                Notes can be attached to each File Group.
  1930.                Full screen editor used for editing Memoranda and Notes
  1931.                Available disk space is monitored.
  1932.                Browsing, and Editing of Authors, Keywords and Memoranda
  1933.                much faster.
  1934.                Highest drive letter now F:
  1935.                Bug in sorting of references fixed.
  1936.                Tagging can be done by Phonetic keyword.
  1937.                Strings can be searched for in Keywords and Memoranda !
  1938.                Dump section prompts for stings to be placed throughout the
  1939.                reference, defaults to XyWrite style sheets.
  1940.                Dump no longer places brackets around the date and it places
  1941.                'and' before the last author.
  1942.                Automatic Group Indexes for Authors and Keywords added.
  1943.                Internal reference numbers scrapped. One may now Jump to a
  1944.                User Sequence number.
  1945.                Print section checks that printer in on-line.
  1946.                Printouts can be paused or aborted.
  1947.                The manual must be printed from outside GLitch.
  1948.                All fields can be optionally dumped.
  1949.                Keyword editing has been extended, Changes can be made and
  1950.                duplicated keywords Stripped.
  1951.  
  1952.           4.02 September 1988
  1953.                Bug in printing of keywords when printing references fixed.
  1954.  
  1955.           4.03 September 1988
  1956.                String can now be searched for in Housed field
  1957.  
  1958.           4.04 October 1988
  1959.                Memoranda printing and browsing improved.
  1960.  
  1961.           4.05 October 1988
  1962.                Problem in editing more than 24 keywords fixed.
  1963.  
  1964.           4.06 October 1988
  1965.                Carriage returns left in dumped memos. Comma removed from
  1966.                after the title.                                                                          44
  1967.  
  1968.  
  1969.  
  1970.           4.07 November 1988
  1971.                You can now Add Authors to a reference if there are none.
  1972.  
  1973.           4.08 November 1988
  1974.                Bug with soft returns (introduced in 4.06) terminated.
  1975.                Author sorting fixed when Adding an anuthor.
  1976.  
  1977.           4.09 Febraury 1989
  1978.                Cross referenced dumps speeded up dramatically.
  1979.  
  1980.           4.10 April 1989
  1981.                File name error in optimisation found and fixed (.dbt =
  1982.                .bdt) when not enough disk space available.
  1983.                LAN usage: GLitch checks that file is not already in use.
  1984.  
  1985.           4.11 October 1989
  1986.                Incorrect number of references count after merging databases
  1987.                fixed.
  1988.                Allowable drives now up to Z:. Again for LAN usage.
  1989.                Date of creation of database and version is now placed in
  1990.                the Notes for the database.
  1991.                'Wait' message displayed when Leaving tagging menu.
  1992.  
  1993.           4.12 November 1989
  1994.                Spaces in file names get changed to underscores.
  1995.                Optimisation is now recommended after erasing references.
  1996.  
  1997.           4.13 March 1990
  1998.                .TMP file created during file creation is now erased when
  1999.                the drive being used is not the default drive.
  2000.                Leaning on an incorrect option key will no longer hang the
  2001.                machine.
  2002.                                                                          45
  2003.  
  2004.  
  2005.                                      Appendix D.
  2006.  
  2007.                                        Trouble
  2008.  
  2009.           If GLitch runs into trouble, an error diagnostic will appear at
  2010.           the top of the screen along with the question:
  2011.                Continue ?
  2012.  
  2013.           Press N to cancel GLitch and return to DOS, or Y to attempt to
  2014.           continue.
  2015.  
  2016.           Errors are only likely to be encountered if you specify a non-
  2017.           existent drive (DOS error 3) or your disk becomes full etc. Check
  2018.           for these sorts of mistakes. If there IS a bug in GLitch please
  2019.           inform the author. Please note all the information displayed at
  2020.           the top of the screen.
  2021.  
  2022.           If you suspect that your database is currupted, do the following:
  2023.  
  2024.           Call up the database and get to the Main Menu. Press ALT-C then N
  2025.           and you will drop back to DOS. Delete the .AUT file associated
  2026.           with your database. Run GLitch again and call up the database.
  2027.           GLitch will regenerate the .AUT file and also physically count
  2028.           the references, tagged and total.
  2029.                                                                          46
  2030.  
  2031.  
  2032.                                      Appendix E.
  2033.  
  2034.                            Conversion of old file formats
  2035.  
  2036.           GLitch files created with versions 1 or 2 must be converted to
  2037.           the version 3 format before being converted to version 4 format.
  2038.           GLitch will convert from 3 to 4 automatically but it needs to
  2039.           have some spare disk space during the conversion. If there is not
  2040.           enough space on the default drive, GLitch will ask you to
  2041.           indicate a drive that has some space that can be used
  2042.           temporarily. Enter the drive letter to be used, and GLitch will
  2043.           continue with the conversion.
  2044.  
  2045.                                                                          47
  2046.  
  2047.  
  2048.                                      Appendix F.
  2049.  
  2050.                                      XyEd editor
  2051.  
  2052.           GLitch uses a XyWrite-like editor called XyEd for editing
  2053.           Memoranda and the Notes attached to any file group.
  2054.  
  2055.           XyEd version 1.00 July 1988
  2056.  
  2057.           Commands are issued on the first line of the screen called the
  2058.           Command Line.
  2059.  
  2060.           f5   will move the cursor to the Command Line and clear it.
  2061.           f9   will execute a command that is already on the Command Line.
  2062.           f10  will move to the Command Line without erasing what is
  2063.                already there.
  2064.           Alt-f5 will delete the current line.
  2065.           Alt-f9 will activate HELP, exit with ESC or Alt-f9 again
  2066.  
  2067.           The following commands are supported:
  2068.  
  2069.           SA or SAVE     will save and allow you to continue editing
  2070.           ST or STORE    will save and exit the editor
  2071.           AB or ABORT    will discard any changes and exit the editor
  2072.           ME filename    will import an ASCII file at the cursor position
  2073.           DOS            will take you to DOS. Return by typing EXIT
  2074.           QUIT           will exit the editor
  2075.  
  2076.           Any other command will be embedded in the XyWrite format. For
  2077.           example MD UL will be inserted as <<MDUL>>
  2078.  
  2079.           If one ABORTs or QUITs and you have made some changes, XyEd will
  2080.           ask you if you want to abandon the changes or STORE. Press Y to
  2081.           abandon, N to stay in the editor and S to STORE.
  2082.  
  2083.           The following keystrokes provide shortcuts:
  2084.  
  2085.           Alt-S will STORE
  2086.           Alt-X will Abort
  2087.           ALT and the horizontal numbers insert the XyWrite formatting
  2088.           commands for the MD commands.
  2089.  
  2090.           Any ASCII character can be inserted by holding down ALT and
  2091.           typing the ASCII number on the numeric keypad. For example 248
  2092.           will place the degree symbol into the text.
  2093.  
  2094.           I cannot gain control over the keyboard properly with the result
  2095.           that the following keys are different:                                                                          48
  2096.  
  2097.  
  2098.  
  2099.           Control <- and ->     move a word at a time
  2100.           Home and End          move to beginning and end of the LINE
  2101.           Control PgUp & PgDn   move to beginning and end of the FILE
  2102.           Control Home & End    move to beginning and end of the SCREEN
  2103.  
  2104.           You cannot leave EXPANDED mode.
  2105.  
  2106.           Note that the function keys must NOT have been reprogrammed via
  2107.           the ANSI.SYS screen driver. This does not preclude the use of
  2108.           ANSI.SYS with XyEd.
  2109.  
  2110.           XyWrite is an outstanding product by XyQuest Inc. XyEd does not
  2111.           attempt to compete with XyWrite in any way and has been made to
  2112.           be compatible in the interests of standardisation. XyWrite is far
  2113.           more powerful and easier to use than XyEd and thus should not be
  2114.           judged on observations of XyEd.
  2115.  
  2116.  
  2117.                                                                          49
  2118.  
  2119.  
  2120.                                         Index
  2121.  
  2122.           abstract see Memoranda..........................................9
  2123.           adding a reference.............................................11
  2124.           adding references..............................................12
  2125.           adding to a reference..........................................20
  2126.           ASCII characters...............................................47
  2127.           ASCII file creation - see dumping..............................24
  2128.           author, entering................................................7
  2129.           Author, printing...............................................23
  2130.           Authors - entering..............................................7
  2131.           Authors, editing...............................................21
  2132.           Authors, Group Index...........................................27
  2133.           backup, files..................................................37
  2134.           backup, RAM drive..............................................36
  2135.           boot disk.......................................................2
  2136.           browsing...................................................11, 19
  2137.           clearing - see tagging.........................................13
  2138.           clearing tags..............................................17, 20
  2139.           clock...........................................................8
  2140.           command line...................................................47
  2141.           CONFIG.SYS.....................................................39
  2142.           configuring your system........................................39
  2143.           converting versions............................................46
  2144.           creating a File Group...........................................5
  2145.           cursor movement.............................................4, 48
  2146.           date............................................................8
  2147.           deleting a reference...........................................22
  2148.           deleting references............................................30
  2149.           DOS............................................................47
  2150.           DOS error......................................................45
  2151.           drive letter....................................................5
  2152.           dumping....................................................11, 24
  2153.           dumping, Group Index...........................................26
  2154.           dumping, references............................................25
  2155.           editing.........................................................4
  2156.           editing a reference............................................21
  2157.           editing, Authors...............................................21
  2158.           editing, Keywords..............................................21
  2159.           editing, memoranda.............................................22
  2160.           editing, Title.................................................21
  2161.           editor.........................................................47
  2162.           erasing references.........................................12, 30
  2163.           file group......................................................5
  2164.           file group - definition.........................................3
  2165.           files...........................................................5
  2166.           floppy drive....................................................3                                                                          50
  2167.  
  2168.  
  2169.           global - see tagging...........................................13
  2170.           global searching...............................................17
  2171.           Group Index - definition........................................3
  2172.           hard disk.......................................................3
  2173.           help...........................................................47
  2174.           index file.....................................................31
  2175.           insert key......................................................4
  2176.           invoice........................................................11
  2177.           invoice, printing..............................................23
  2178.           italics................................................23, 25, 40
  2179.           journals.......................................................40
  2180.           jumping....................................................19, 20
  2181.           keyword editing................................................11
  2182.           Keyword, printing..............................................23
  2183.           keywords - entering.............................................8
  2184.           Keywords, adding...............................................29
  2185.           Keywords, deleting.............................................29
  2186.           Keywords, duplicates...........................................29
  2187.           Keywords, editing..........................................21, 29
  2188.           Keywords, Group Index..........................................27
  2189.           limitation......................................................2
  2190.           local - see tagging............................................13
  2191.           local searching................................................17
  2192.           Main Menu......................................................10
  2193.           Memoranda - entering............................................9
  2194.           memoranda, editing.............................................22
  2195.           memory..........................................................2
  2196.           merging........................................................12
  2197.           merging file groups............................................32
  2198.           moving - see jumping...........................................19
  2199.           next reference.................................................19
  2200.           notes..........................................................11
  2201.           old versions of GLitch.........................................46
  2202.           optimising a database..........................................37
  2203.           order of references............................................19
  2204.           packing........................................................31
  2205.           Page length....................................................23
  2206.           previous reference.............................................19
  2207.           printer....................................................11, 23
  2208.           printing...................................................11, 22
  2209.           RAM drive..................................................35, 36
  2210.           Refreshing a database..........................................31
  2211.           registration...................................................ii
  2212.           saving Memoranda...............................................47
  2213.           searching - see tagging........................................14
  2214.           selecting a File Group.........................................33
  2215.           selecting references - see tagging.............................14                                                                          51
  2216.  
  2217.  
  2218.           system requirements.............................................1
  2219.           tagging........................................................12
  2220.           tagging references.............................................11
  2221.           tagging, all references........................................17
  2222.           tagging, author................................................15
  2223.           tagging, clearing..............................................13
  2224.           tagging, clearing tags.........................................17
  2225.           tagging, keywords..............................................16
  2226.           tagging, local and global searches.............................13
  2227.           tagging, phonetic keywords.....................................16
  2228.           tagging, strings...............................................15
  2229.           tagging, User Sequence Numbers.................................17
  2230.           tagging, year..................................................15
  2231.           Title - entering................................................8
  2232.           Title, editing.................................................21
  2233.           underlining............................................23, 25, 40
  2234.           User Sequence Number - definition...............................3
  2235.           User Sequence Numbers......................................11, 28
  2236.           User supported software........................................ii
  2237.           viewing - see browsing.........................................19
  2238.           viewing keywords...............................................19
  2239.           wiping a reference.............................................22
  2240.           word processor ................................................23
  2241.           XyEd........................................................9, 47
  2242.           XyWrite.................................................9, 40, 47
  2243.           year of publication.............................................8