
                              My Little Realm Enterprises

                               -  Private Library 3.0  -

                                   Shareware Version
          ____________________________________________________________________
          
                                        Important
          ____________________________________________________________________

          Private Library is protected by copyright.  It is not freeware, and
          it is not in the public domain.

          This is the Shareware (evaluation) version of My Little Realm's 
          Private Library.  It is a full-featured, fully functional program.
          You are welcome to try it on your computer to ensure that it 
          functions on your system as it should, and that it meets your 
          individual needs.

          If after 30 days you decide to keep using Private Library, you must
          pay for the program.  To print an order form, press <$> in the 
          Options Window or print the text file REGISTER.TXT.

          Bonus!  Get one MLR stand-alone program free with every order.  
          Read DESCRIBE.TXT for details.  This offer expires 12/31/94.

          My Little Realm Enterprises stands behind all of its products with
          a 30-day money back guarantee.

          Thank you for trying Private Library and Shareware!
          ______________________________________________________________________
                                                                         




                             

                              My Little Realm Enterprises


                               -  Private Library 3.0  -



                                       Contents               

               General Information......................................1
                    Introduction........................................1
               Overview.................................................1
                    Interface...........................................1
                    Quickeys............................................1
                    Extended Processing Options.........................2
               Getting Started..........................................2
                    Changing the Quickeys...............................2
                    Creating Records....................................2
               Program Information......................................3
               The Options Window.......................................3
               Option # 1, Adding New Records...........................3
                    Field Definitions...................................3
                         The Default Quickey Categories.................4
                         Hiding the Quickeys............................4
                         Dewey Decimal Codes............................5
               Option # 2, Viewing Your Records.........................5
               Option # 3, Changing the Contents of a Record............5
               Option # 4, Deleting Records.............................6
               Option # 5, Printing records.............................6
               Option # 6, Sorting records..............................6
               Option # 7, Searching Records............................7
                    Searching on the Title and Author Fields............7
                    Searching on the Category Field.....................8
               Extended Processing Options..............................8
                    <\> Change Quickeys Categories......................8
                    <|> Hide/show the Quickeys..........................9
                    <#> Switch Between Color and B/W Modes.............10
                    <?> Display EPO Symbols and Definitions............10
                                                                            
          Private Library                                              Page 1

          ____________________________________________________________________

                                 General Information
          ____________________________________________________________________

                                    Introduction

          Private Library allows you to keep track of your privately owned 
          volumes (including books, records, tapes, cd's and videos).  With 
          Private Library you can perform the standard view, edit, print and 
          sort functions.  Its most powerful feature, however, is its search 
          function.

          For starters, if you'd like to see which books you have of a 
          certain author, enter that author's name in the Search function, 
          and you'll get every work in your library that has that name in the
          Author field.

          If you're a Sci Fi fanatic and you'd like to see what you have on
          robots, tell the Search function to look for "robot" in the Title
          field.

          You can also search on the Category field to see what you have in
          any of your current Quickey categories.

          Would you like a way to keep your books separate from a roommate's?
          Use the Category field to identify ownership.  Then you can search 
          on the Category field to see which works (or items) belong to whom.
          It can help keep the peace.

          ____________________________________________________________________

                                      Overview

          Interface.

          Private Library's screen consists of two types of windows:  a 
          Working Window and an Options Window.

          If you are using a color monitor the Working Window is red and the
          Options Window is blue.

          You select processes (like adding, updating, or deleting records)
          in the Options Window.  You create and view your records in the 
          Working Window.

                             ----------------------------
          
          Quickeys.

          The Quickeys give you single key access to the categories you have
          defined in your Quickey file.  Initially these are very general
          categories like fiction, non-fiction, etc.  You can define them as
          you like using the <\> Change Quickeys EPO.                 
          Private Library                                              Page 2

          Extended Processing Options.
          
          Several processing tasks, called extended processing options or 
          EPO's, are not listed in the Options Windows, because they are 
          functions that only occasionally need to be performed.  EPO's are
          used to "extend" a program's power and functionality.  One EPO you
          should be aware of initially is the Change Quickeys function, which
          allows you to create and change your Reader and Library Quickeys.  
          You invoke it by pressing the backslash in the Options Window.

          To find out what EPO commands are employed by Private Library, 
          enter <?> (the question mark) in the Options Window.  See "Extended
          Processing Options", page 8, for a full description of all the EPO 
          commands and their definitions.

          ____________________________________________________________________

                                   Getting Started

          Changing the Quickeys.
          The Quickeys in Private Library let you categorize your privately 
          owned works just the way you want.  This can be by general 
          categories like fiction, non-fiction, etc., or it could be by 
          owner.  The default categories are defined on page 4.

          If you'd like to see the default Quickeys of Private Library, 
          enter the backslash key in the Options Window.  This invokes the 
          Change Quickeys function, and displays the following query in the 
          Options Window:

                  _______________________________________________
                 |                                               |
                 |    Change which Quickey?  __                  |
                 |           ________________________________    |
                 |          |                                |   |
                 |          |   1  fic    3  l/d    5  a/t   |   |
                 |          |   2  n/f    4  v/t    6  c/d   |   |
                 |          |________________________________|   |
                 |                                               |
                 |_______________________________________________|


          If you don't want to change the Quickeys at this time, simply press
          <esc> when you're finished studying them.  If you'd like to make
          changes, enter the number of the Quickey category you want to 
          change and type in the new definition.  Read the section entitled
          "Extended Processing Options" on page 8 for more details.

          Creating Records.
          The most common items recorded in the Private Library program are
          books.  They're easy to enter since there are only three fields to
          deal with:  the Title field, the Author field, and the Category
          field.  Example:

                   Title                Author                    Cat.

                  Lincoln            Vidal, Gore                  fic    
          Private Library                                              Page 3

          Other personal collectibles that can be recorded are videos.  Enter 
          the title, as you would a book, and in the Author field, enter the 
          time and whether the item is black & white or color.  Finally, 
          enter the Quickey (4 from the above example), v/t, for video tape.
          Example:

                   Title                Author                    Cat.

                Casablanca            103 min.   black/white      v/t

          After you've entered all of your video tapes, you can obtain a
          printed listing (to keep by the television) by invoking the Search
          function and searching the Category field for v/t.  If you want the
          listing in alphabetic order, sort your records first.

          ____________________________________________________________________

                                 Program Information
          ____________________________________________________________________

          Options Window.
          There are seven choices in the Options Window.

                       ________________________________________
                      |                                        |
                      |   1  Add      2  View     3  Change    |
                      |   4  Delete   5  Print    6  Sort      |
                      |               7  Search                |
                      |   ----------------------------------   |
                      |             Choice __                  |
                      |________________________________________|

          
          There are several extended processing options available from the 
          Options Window.  They are detailed on page 8.

          ____________________________________________________________________

          Option # 1, Adding New Records.

          The Add function in this program has three entries.  To back up 
          through the fields in this function, press the up arrow.  To 
          advance through the fields, press the down arrow.

                    Note:  You cannot use the down arrow to go 
                    from the Title field to the Author field unless 
                    the Title field has something in it.

                                ~ Field Definitions ~

          - Title field (38, required).

          Leading articles and prepositions should be put at the end of the 
          title.  For example, the title of the novel "The Agony and the 
          Ecstasy" by Irving Stone would be entered as:

                                 Agony and the Ecstasy, The          
          Private Library                                              Page 4

          - Author field (33, optional).

          An author's name should be entered with the last name first:

                                 Stone, Irving

          The major reason for entering titles and names in this manner is 
          that it facilitates record sorting should you request that option
          (# 6 in the Options Window).  

                                   ____________________

          - Category field (3, optional).

          Private Library displays its built-in Quickeys when it is time to 
          enter the category field.

          The Default Quickey Categories.
                                
                        Quickey     Category       Definition      
                        
                           1           fic          fiction
                           2           n/f          non-fiction
                           3           l/d          laser disc
                           4           v/t          video tape
                           5           a/t          audio tape
                           6           c/d          compact disc


          Hiding the Quickeys.
          Private Library only accepts a Quickey in this field.  You may, on
          occasion, desire to enter numbers in the category field like the
          Dewey Decimal numbers.  Rather than redefine your Category Quickey
          list, you can simply turn off the Quickeys.  When the Quickeys are 
          hidden, you can enter anything you like in the Category field.

          In other words, if the Quickeys are turned on, you are only able to 
          enter a category from the Quickey list.  If you want to enter 
          category information that is not on the Quickey list, turn off 
          (that is, hide) the Quickeys using the <|> EPO.  You can then enter
          any three character string you wish.

          To hide the Quickeys, enter <|>, the pipe symbol on your keyboard, 
          in the Options Window.  Private Library tells you that your
          Quickeys are not hidden and then asks if you want to hide them.
          Respond <Y>, yes.  If you change your mind, press <esc> or <N>.
          See "Extended Processing Options" on page 8 for more details.

          If you should delete any of the Quickey categories, leaving the 
          category blank, Private Library does not let you enter that Quickey
          in the Add or Change functions if the Quickeys are active.

          You can change any of the Quickeys that come with Private Library 
          by using the backslash EPO.  If you plan to use the Dewey Decimal 
          System frequently to categorize your works, change the Quickeys to 
          the DDS codes you'll be using most often.                 
          Private Library                                              Page 5

                      --  The Dewey Decimal System Codes  --

                      DDS Code    Definition                

                        000       General titles (journalism, 
                                      bibliographies, etc.)
                        100       Philosophy
                        200       Religion
                        300       Social Studies
                        400       Languages
                        500       Pure Sciences
                        600       Technology (Applied Sciences)
                        700       Arts
                        800       Literature
                        900       Geography and History

          You can also set up your Quickeys as the initials of the realm 
          members so that you can identify the owner of each of the works you 
          enter in this program.  To use the Change Quickey EPO, refer to the
          section entitled "Extended Processing Options" on page 8.

          Note:  You cannot change the Quickeys if they are hidden.  The only
          exception to this rule is if there are no Quickeys (i.e., you 
          deleted all of them previously), in which case Private Library 
          allows you to create a new Quickey list, but then your new list is
          considered hidden until you expressly state otherwise.

          If you leave Private Library with the Quickeys turned off, Private 
          Library remembers that the next time you run the program.  To show 
          the Quickeys (i.e., turn them on), press <|> in the Options Window 
          and reply <Y>, yes, to Private Library's query.
          ____________________________________________________________________

          Option # 2, Viewing Your Records.

          Private Library asks you which record number you wish to see.  You 
          do not have to enter a record number.  You can use the scrolling 
          keys to browse through your records.

          Should you wish to focus on one particular entry, give the record 
          number to Private Library and that record's information is
          highlighted for you.

          If you have a large number of records and you're trying to find a
          specific title or author, use the Search function, Option # 7, 
          described on page 7.

          To exit the View function and return to the Options Window, press 
          <enter> (without entering a record number) or press <esc>.
          ____________________________________________________________________

          Option # 3, Changing the Contents of a Record.

          To change the contents of a record, you must first find the specific
          record you wish to modify.  Enter the record number, and Private 
          Library highlights the record you have selected to change.   
          Private Library                                              Page 6

          If you select one of the fields to modify and then change your mind,
          press <esc> while on the input line (before you press <enter>), and
          Private Library reinstates the original entry.  Remember, the Title
          field must have an entry.  You cannot leave it blank.

          To exit the Change function and return to the Options Window, press 
          <enter> (without entering a record number) or press <esc>.

          Don't forget that if you want to change the Category field in a 
          record and you want to use the Quickeys, they cannot be hidden.
          ____________________________________________________________________

          Option # 4, Deleting Records.

          Enter the record number.  Private Library highlights the entry and 
          asks you if you are sure.  You must respond <Y> for yes if you 
          wish to effect the delete.  Press <N>, for no, or the <esc> key to
          cancel the delete request.  Be sure the highlighted record is the 
          one that you wish to delete.

          To exit the Delete function and return to the Options Window, press 
          <enter> (without entering a record number) or press <esc>.

          ____________________________________________________________________

          Option # 5, Printing Records.

          The Print function prints a listing of all of your records as they 
          appear at the time you request the printout.

          Thus, if you want the records printed in sorted order, you must 
          select option 6 first, and direct Private Library to sort the array
          containing your records and on which field it is to perform the 
          sort.

          The Sort function then brings up the View procedure and shows you 
          the sorted file.  If all is in order, press <esc> to return to the 
          Options Window and select 5 to print out the results of the sort.

          You can abort the printout at any time during the printing process
          by pressing <esc>.
          ____________________________________________________________________

          Option # 6, Sorting Records.

          Option 6 lets you sort your records by title, author, or category.
          After the sorting is finished, the View function is automatically 
          invoked and your sorted records displayed.

          Press <esc> to return to the Options Window.

          Note:  Private Library stores your records on disk in the same
          order shown in the Viewing Window.  Thus, if you've sorted your
          records by title, they'll be stored that way, and the next time 
          you run Private Library, that's the order in which they'll be 
          displayed.                                                
          Private Library                                              Page 7

          ____________________________________________________________________

          Option # 7, Searching Records.

          The Search function allows you to find all of the records with a
          specific character string, called a keyword, in a given field.  It
          gives you a special look at your library, and it can help you find
          a specific book (or record or video) in seconds.

          You enter keywords without quotes.  You may use the backslash as a 
          special delimiter, described below, to force the Search function to 
          look for external spaces.

          Searching on the Title and Author Fields.
          If you want the Search function to display all of the books with 
          the word "computer" in the title, select the Title field from its 
          sub-menu and enter the keyword "computer" (without the quotes).  In
          short order, the Search function would display all of the volumes 
          it found with the word "computer" in the title.

          If there is more than a screenful of records, the Search function 
          tells you to use the scrolling keys to peruse the listing.  The 
          scrolling keys are the directional keys, <ctrl> + <home>, 
          <ctrl> + <end>, <pageup>, and <pagedown>.

          You can also print the Search function listing by pressing <P>.

          You must be as precise as possible if you are looking for a 
          specific record.  That is to say, if you are looking for a 
          particular author, you must give the Search function the entire 
          name of said author or it might retrieve a number of records whose 
          authors have the same keyword in their names.
          
          As an example, if you were searching for all of the volumes written
          by "Smith, Alice", you could enter "Smith" for a keyword, but you 
          would also get all of the records with any other Smith's you had in
          the Author field.  You would have to enter "Smith, Alice" to have 
          the Search function display only those works by that author.  The 
          same is true for the Title and Category fields.

          When you can't recall the spelling of an author's name or the title 
          of a book (or whatever it is you've cataloged), enter just enough 
          of the keyword to have the Search function weed out the bulk of the
          unwanted records.
          
          For instance, if you're trying to find a book title but all you can
          remember of its author's name is that it contains the syllable 
          "Long", just enter that portion.  The Search function displays 
          the records it finds with that syllable in the Author field, like 
          "Longman" or "Longfellow" or "Longacre", but the number of records 
          has been reduced considerably, and you'll be able to find the
          record you're looking for much more quickly and easily.

          The Search function strips off the external blanks that you enter 
          around a keyword when it performs the search on either the Title 
          Private Library                                              Page 8

          field or the Author field.  "   ABC   ", for example, is reduced 
          to "ABC".  You can force the Search function to search for 
          precisely what you enter by delimiting your keyword with 
          backslashes.  To make the Search function look for a keyword like 
          "   ABC   " (with its concomitant external spaces), you can enter:

                                     \   ABC   \

          Let's assume you have the following titles in your file:

                              Longbows of the 18th Century
                              Long John Silver
                              Longacre's Mysteries

          If you simply entered "Long" at the keyword prompt, the Search
          function would show you all three of those records, even if you 
          entered the keyword as "Long ".  To winnow it down, you can force 
          the Search function to search for "Long " (with a trailing space) 
          by entering \Long \ and get only the second title, "Long John 
          Silver".

          When using the backslash as a delimiter, however, you must ensure
          that you begin and end your keyword with backslashes.  If, instead, 
          you entered:
                                   \ long\acre                          

          the Search function assumes that it is supposed to look for the 
          backslashes since one is embedded, and it searches for exactly what
          you entered ... including the backslashes.

                    Notes:  Private Library's Search function 
                    is not case sensitive, so "ABC" is the 
                    same as "aBc", and so on.

          Searching on the Category Field.
          When you search on the Category field, you must use the Quickeys
          if they are active.  If they are inactive (hidden), you cannot use 
          them, but you can enter any string found in the Quickey list.  You 
          simply have to key it in manually.

          Keywords do not have their external spaces removed when searches 
          are performed on the Category field.  So " d " (with a space on 
          either side) is different from "d  " (with two trailing spaces), 
          and so on.
          ____________________________________________________________________

                                Extended Processing Options

               EPO  Definition
                         
               <\>  Change Quickeys Categories.

                    The Quickeys categories can be up to three letters long, 
                    and are used to describe the categories of your personal 
                    volumes.  Private Library comes with six Quickey classi-
                    fications that represent general purpose categories. 
          Private Library                                              Page 9

                    Default Quickeys.
                                 ________________________________    
                                |                                |   
                                |   1  fic    3  l/d    5  a/t   |   
                                |   2  n/f    4  v/t    6  c/d   |   
                                |________________________________|   

                                 Quickey    Code       Definition      

                                    1        fic       fiction
                                    2        n/f       non-fiction
                                    3        l/d       laser disc
                                    4        v/t       video tape
                                    5        a/t       audio tape
                                    6        c/d       compact disc

                    You can, of course, change any you choose.  For example, 
                    you could make one of your categories "Com" for comic 
                    books or "BBC" for baseball cards.  You can even use
                    the initials of the owners of the works you are 
                    cataloging as a means of identifying ownership, should
                    you wish to keep your works separate from your roommate's.

                    You do not need to use the Quickeys.  For example, while
                    the Quickeys are active, you must either use a Quickey or
                    press <enter> to leave the Category field blank.

                    If you want to be able to enter any random numbers or 
                    letters in the Category field, use the <|> EPO, described
                    below, to hide the Quickeys.  Then you can enter whatever
                    you wish.

                    Note:  You cannot change the Quickeys if they are hidden.

               <|>  Hide/show the Quickeys.

                    The Quickeys are numbers one through six in the first 
                    position of the category entry.  Enter <|> in the
                    Options Window and Private Library tells you if your 
                    Quickeys are hidden or not.  It then asks you if you 
                    want to reverse the situation.

                    If the Quickeys are turned on, you must use them when
                    you are entering data in the Category field.  If you 
                    want to enter categories not found in your Quickey 
                    list, you must either turn off the Quickeys or change 
                    the current Quickeys.  If you turn off the Quickeys, 
                    you can enter anything you wish in the three character 
                    field.

                    You do no harm to your previously entered records by 
                    turning the Quickeys on and off.

                                    - - - - - - - - -                  
          Private Library                                             Page 10
               <+>  Print a Listing of a Specific Category.

                    Note:  This EPO is no longer supported in Version 2.x.
                    See the Search function, option <7> in the Options 
                    Window, for this and many other new features found in
                    Version 2.x and later.

                                    - - - - - - - - -

               <#>  Switch between color and B/W modes.

                                    - - - - - - - - -

               <?>  Display the EPO's used in this Program.

          ____________________________________________________________________

                                      +  The End  +
          ____________________________________________________________________

          (c) Copyright 1991 - 1994 John L. Salisbury                 
