home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / desktop / lst113.arj / LSTDOC1.TXT < prev    next >
Text File  |  1992-01-27  |  57KB  |  1,177 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.           ||       ========   ========   ========   ======== ========  || 
  23.           ||          ||      ||            ||         ||       ||     ||
  24.           ||          ||      ||            ||         ||       ||     ||
  25.           ||          ||      ||======      ||   ____  ||       ||     ||
  26.           ||          ||             ||     ||         ||       ||     ||
  27.           ||          ||             ||     ||         ||       ||     
  28.           ||=====  ========   =======||     ||      ========    ||     ()
  29.  
  30.  
  31.                               
  32.                                  Version 1.1
  33.  
  34.  
  35.  
  36.  
  37.                       R E F E R E N C E       M A N U A L
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.             
  48.  
  49.  
  50.                      Copyright (c) 1991,1992 by Luis Sanchez
  51.  
  52.                              2625 S.E. 2nd Court
  53.                              Pompano Beach, Florida 33062
  54.                              Compuserve # 71237,2721
  55.  
  56.                      All Rights Reserved                             TABLE OF CONTENTS
  57.  
  58.  
  59.           About List-It!.........................................1
  60.  
  61.           Find Module............................................2
  62.  
  63.           Browse Module..........................................5
  64.  
  65.           Sort Module............................................7
  66.  
  67.           Zap Module.............................................8
  68.  
  69.           Enter Module...........................................9
  70.  
  71.           Delete Module.........................................12
  72.  
  73.           Print Module..........................................13
  74.  
  75.           Quit..................................................16
  76.  
  77.           Utility Sub-Menu
  78.           Directory.............................................17
  79.  
  80.           Backup File...........................................19
  81.  
  82.           Export................................................21
  83.  
  84.           Import................................................22
  85.  
  86.           Load File.............................................27
  87.  
  88.           Copy File.............................................28
  89.  
  90.           Color Change Module...................................29
  91.  
  92.           Rename File...........................................31
  93.  
  94.           Get Info..............................................32
  95.  
  96.           Undelete..............................................34
  97.  
  98.           ReOrder...............................................35
  99.  
  100.           Afterword.............................................36
  101.  
  102.           License...............................................37
  103.  
  104.           Warranty..............................................38
  105.  
  106.           Ordering Info.........................................39
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.           List-It!                     -i-                                   About List-It!
  116.  
  117.                Thanks for trying out List-It!. A handy, quick,
  118.           full-featured little program that's a great electronic substitute
  119.           for your telephone and mailing lists. 
  120.  
  121.                With this program you can take complete charge of the
  122.           numbers and addresses in your possession with an ease you never
  123.           thought was possible.
  124.  
  125.                Need to find a name in a hurry but you forgot how to spell
  126.           it? That's no problem for this program. Just give it the letters
  127.           you remember, and any records that contain those letters will be
  128.           pulled from your database. In fact, it can conduct a search on any
  129.           field in the record. You can then look through the retrieved list
  130.           until you find the record you want.
  131.  
  132.                Need to sort your database? The program currently sorts on
  133.           two fields, Last Name and Zip Code. You can also restore the
  134.           database to the condition it was in before the sort.
  135.  
  136.                Do you want to print your Christmas mailing list on address
  137.           labels? Can do! Just select print from the main menu and tag
  138.           the fields you need. When you're done tagging fields, (first
  139.           name, last name, address, etc...), then press the <F5> key and
  140.           Voila! instant labels. 
  141.  
  142.               There are also a variety of features available to you
  143.           through the Utility menu:  
  144.       
  145.           Directory module which gives you a view of files located 
  146.               on your disk. 
  147.           Copy file module through which you can copy the contents
  148.               of the currently loaded PDF* file to a new, different file.
  149.           Backup module allows you to back up your data files.
  150.           Load file module which allows you to load and work with
  151.               other PDF files.
  152.           Rename module allows you to change the name of the 
  153.               currently loaded PDF file. 
  154.           Color module permits you to alter the colors to suit your fancy.
  155.           Import allows you to use the database files of other programs
  156.                so that you need not re-enter information.
  157.           Export module permits other programs to use your PDF files.
  158.           Undelete allows you to retrieve deleted records and use them 
  159.                as you normally would any other record in your database.
  160.           Get Info module supplies you with information about the          
  161.                currently loaded PDF file.
  162.           ReOrder allows you to change the order of the records in your
  163.                database.
  164.  
  165.                The program is completely menu-driven. You select a menu 
  166.           item by either pressing the highlighted letter of the desired 
  167.           item, or by moving the highlight bar to the desired item with 
  168.           the space bar and hitting the Enter key.
  169.  
  170.           There's also plenty of on-screen help, so use and enjoy List-It!   
  171.            
  172.           * PDF refers to the extension of the data file used by List-It!.
  173.  
  174.           List-It!                     -1-                                    FIND MODULE
  175.  
  176.                With this module you can search your database for any record
  177.           or group of records you wish.
  178.  
  179.                One very handy feature I have given the program is the
  180.           ability to pull records without entering the entire name you are
  181.           searching for. This is a great help if you forget the spelling
  182.           of any names. 
  183.  
  184.                When you first enter this module, another menu will appear;
  185.  
  186.                                 ┌───────────────┐ 
  187.                                 │Field search   │ 
  188.                                 │Number search  │ 
  189.                                 │Record search  │ 
  190.                                 │Logical search │ 
  191.                                 └───────────────┘ 
  192.  
  193.                                    FIELD SEARCH  
  194.  
  195.                Selecting the field search displays another menu along the
  196.           left edge of your screen. This menu lists all the fields in the
  197.           database; that is name, address, city and so on. You select the
  198.           field you wish to search, by moving the highlight bar to the
  199.           desired field with the up or down cursor keys and then hitting the
  200.           <enter> key. 
  201.  
  202.                An alternative method of selecting a field to search is to
  203.           press the key that is highlighted in the desired field. This is
  204.           typically the first letter of the field. This automatically brings
  205.           the menu bar to that field and brings up the input line.
  206.  
  207.                Once you've chosen the field you wish to search on, you will
  208.           be shown the symbols >> followed by a row of underline marks
  209.           which indicate the maximum length of the search string you can
  210.           enter. Type in what you are searching for, hit <enter>, and the
  211.           program will scan the entire database for records that match the
  212.           search string.
  213.  
  214.                If you enter more characters than the program is expecting,
  215.           the maximum number is indicated by the number of underline
  216.           characters, the program will beep, clear the line and wait for
  217.           you to enter the search string again. 
  218.  
  219.                Time for an example. Let's say you wish to inspect the 
  220.           records of all clients whose last names begin with Sand, because
  221.           you have forgotten exactly how a particular client spells his name.
  222.           Take the following steps:
  223.  
  224.                At the Main Menu you would press <F>ind then <F>ield then
  225.           <L>ast name. At the prompt type in <sand> and hit <enter>. (You
  226.           also don't have to worry about capitalization with this program.)
  227.           The following records will then be displayed for your inspection;
  228.           Sandberg, Sandstrom, Sandstone, and Misand. 
  229.  
  230.  
  231.  
  232.  
  233.           List-It!                     -2-                                   
  234.  
  235.  
  236.                Notice that the search item can be anywhere in the field
  237.           and the program will still pull the record. You can then browse
  238.           through the retrieved list until you find the record you needed.
  239.  
  240.                                    NUMBER SEARCH
  241.  
  242.                To search by record number press <n>, and you will be asked 
  243.           to enter the record number you wish to view. If it is a valid
  244.           number, then the proper record will be displayed on your screen.   
  245.  
  246.                This feature is only useful if you happen to know the record
  247.           number that you need. When you are unsure, use one of the other
  248.           menu options.
  249.  
  250.                                    RECORD SEARCH
  251.  
  252.                This menu option is especially useful when you remember the
  253.           name of a client or correspondent you need, but you can't remember
  254.           the field this name is in. It could have been entered in the
  255.           Note field, the Contact field, or the Last Name field. With this
  256.           option, all fields are searched.
  257.  
  258.                When you choose this option, you are prompted for a string to
  259.           search. Enter the name you wish to locate, (up to 45 characters in
  260.           length). The program will look for this string in each field in
  261.           the record, tagging the record when it finds a match, or proceeding
  262.           to the next record when the last field in the record is scanned. 
  263.  
  264.                You can see just how much easier your searches will be, when
  265.           you use this menu option. Of course, searches will not be as fast
  266.           since the whole record is scanned instead of just one field in each
  267.           record. This is a small price to pay for making your searches
  268.           easier.
  269.  
  270.                                    LOGICAL SEARCH
  271.  
  272.                This menu option allows you to use the three logical operands
  273.           AND, OR, and NOT, in your searches. You are able to enter two
  274.           search strings when you use the logical operands OR, and AND. 
  275.  
  276.                Suppose you are looking for all persons in your database 
  277.           that are both Doctors and Dentists. This is what you would enter
  278.           when prompted for the search string;
  279.   
  280.                                 Doctor AND Dentist
  281.  
  282.                 You could also shorten the search string, and the time it
  283.           takes you to enter it, by just entering;
  284.  
  285.                                     Doc AND Den
  286.  
  287.                 In any case, you must remember to capitalize the logical
  288.           operand or the program will treat the entire phrase as the search
  289.           string. This of course, will not find any records, (unless there 
  290.           is a record that has the phrase doctor and dentist in it.) 
  291.  
  292.           List-It!                     -3-  
  293.  
  294.  
  295.                The results of this search will be each record that contains
  296.           the words doctor and dentist.
  297.  
  298.                Let's say now that you want all records that contain either
  299.           word. To find these records enter the following;
  300.  
  301.                                    Doc OR Den
  302.  
  303.                This will retrieve each record that contains either Doctor, 
  304.           or Dentist.
  305.  
  306.                Let's say now that you wish to find all your clients or
  307.           correspondents that are neither Doctors or Dentists. The NOT
  308.           logical operand must be used here, and it MUST BE THE FIRST WORD 
  309.           in the search string. To start this search enter the following
  310.           phrase:
  311.  
  312.                                   NOT Doc OR Den
  313.  
  314.               This string will bring up records that do not contain the
  315.           word Doctor or the word Dentist. 
  316.  
  317.               If, however, you only want to exclude from your search records
  318.           that contain both words, Doctor and Dentist, then enter the
  319.           following phrase:
  320.    
  321.                                   NOT doc AND den
  322.  
  323.               Then only the records that do not contain both words will be
  324.           retrieved.
  325.  
  326.  
  327.               In all cases, the search will not stop at the first match but
  328.           will continue until the last record is searched. All records that
  329.           match your search item will be displayed. You can then browse
  330.           through this retrieved list in a forward or backward direction,
  331.           or go from the first record to the last record with the touch of
  332.           a key. The command bar at the bottom of the screen shows the active
  333.           keys and their functions.
  334.  
  335.                In fact, all the functions that were available to you at the
  336.           Browse module are available to you here, including editing or
  337.           deleting the displayed record. For a review of those functions
  338.           please refer to the Look module section.
  339.  
  340.  
  341.               
  342.                
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.           List-It!                     -4-                                   BROWSE MODULE
  352.  
  353.  
  354.                This module allows you to browse through your database one
  355.           record at a time. Once a record is displayed, you also have the
  356.           opportunity to edit or delete it.
  357.  
  358.                Remember that <F1> is active here as it is in most areas of
  359.           the program. However, here the window is linked to a series of
  360.           other help windows. You move from window to window by pressing
  361.           the Home, End, Page Up or Page Dn keys. Or by pressing <Esc> to
  362.           quit viewing the help window. 
  363.  
  364.                A sample screen follows:
  365.  
  366.           ┌──────────────────────────────────────────────────────────────┐
  367.           │ Browsing...         Record Listed: 1       Total Records: 2  │
  368.           ╞══════════════════════════════════════════════════════════════╡ 
  369.           │                                                              │ 
  370.           │                                                              │ 
  371.           │ Sanchez Luis                                                 │
  372.           │ 2625 SE 2nd Court                                            │ 
  373.           │ Pompano Beach, FL 33062                                      │ 
  374.           │                                                              │
  375.           │ Company Name:                                                │
  376.           │ Contact:                                                     │
  377.           │ Business phone:                                              │
  378.           │ Fax:                                                         │ 
  379.           │                                                              │
  380.           │                                                              │
  381.           │                                                              │
  382.           ╞══════════════════════════════════════════════════════════════╡
  383.           │ < >, <+> : next  <Home>, <Pg Up> : first    <e> : to edit    │ 
  384.           │ < >, <-> : prev  <End> , <Pg Dn> : last     <d> : to delete  │ 
  385.           │     <F1> : Help        <Esc> : to Quit                       │
  386.           └──────────────────────────────────────────────────────────────┘
  387.                                     Figure 1   
  388.  
  389.                As you can see, the command bar is at the bottom of the 
  390.           screen. The top of the screen tells you where you are in the       
  391.           program, currently the Browse module. It also shows two figures,
  392.           one is the total number of records in the database, (here it is 2),
  393.           and the other figure indicates the displayed record's position in
  394.           the database, (this record is the first record.) 
  395.         
  396.                If this is your first time with the program then of course,
  397.           there will be no record, and you will be prompted with the
  398.           message, "Empty List". At the bottom of the screen, another
  399.           message will be displayed;
  400.  
  401.                             "Press <ESC> to quit." 
  402.           
  403.                If you are currently viewing a record and press <e> for edit
  404.           you will be shown the main entry screen of the program. This
  405.           screen displays the fields in the database with hyphens showing
  406.           the length of those fields. If a particular field has an entry,
  407.           those contents will be displayed in place of the hyphens.
  408.  
  409.  
  410.           List-It!                     -5-
  411.  
  412.  
  413.                You can navigate through the edit screen at will, with the
  414.           <Tab>, <Shift-Tab>, <Enter>, or Up and Down cursor keys. Just
  415.           move to the field you wish to edit, make your changes and then
  416.           either press the <F9> or <Esc> keys when you are finished making
  417.           your changes.
  418.  
  419.                The current record will then re-display and it will contain
  420.           any changes you may have made.
  421.  
  422.                When editing a record, you have the use of the same keys 
  423.           you do when you are entering a new record: F2, Insert, Delete,
  424.           Backspace, Left and Right Arrow.
  425.  
  426.                <F2> copies the previous record's field contents into the
  427.           current record. (For a more detailed discussion of the use of the
  428.           <F2> key turn to the section describing the Enter Module - pg 13.)
  429.  
  430.                For a brief description of the action of the other keys, while
  431.           you are editing a record, press <F1>. The help window which then
  432.           displays is pictured here:
  433.  
  434.           ╔══════════════════════════════════════════════════════════════╗
  435.           ║ Tab, Up Arrow         - moves you to previous field          ║
  436.           ║ Dn Arrow, <Shift-Tab> - moves you to next field              ║
  437.           ║ Home                  - moves you to the head of the line    ║
  438.           ║ End                   - moves you to the tail of the line    ║
  439.           ║ Backspace             - erases character to left of cursor   ║
  440.           ║ Delete                - erases character at cursor           ║
  441.           ║ Insert                - inserts characters at cursor         ║
  442.           ║                         Block cursor means insert mode is on ║
  443.           ║ Enter                 - accepts entry and goes to next field ║
  444.           ║ Esc                   - accepts entry and quits entry module ║
  445.           ║                                                              ║
  446.           ╚══════════════════════════════════════════════════════════════╝
  447.                                     Figure 2
  448.  
  449.                If you wish to delete a record instead, then press <d>. A
  450.           window will then appear reminding you that this record will be
  451.           deleted. 
  452.  
  453.                              ╔═════════════════════╗ 
  454.                              ║ Delete This Record? ║  
  455.                              ║         Y/N         ║        
  456.                              ╚═════════════════════╝  
  457.                                     Figure 3
  458.       
  459.                You must press <y> to actually delete the record. Pressing
  460.           any key other than the <y> key will leave the record as it is,
  461.           and cause the delete window to disappear. 
  462.  
  463.                In fact, when you press <y> the record is not actually
  464.           deleted, but merely tagged for deletion. It still remains there
  465.           physically. You just can not view, or access it because the program
  466.           always checks for this delete tag before allowing you to use the
  467.           record. If it is set then the record will not display.      
  468.  
  469.           List-It!                     -6-                                    SORT MODULE
  470.  
  471.  
  472.                Selecting this option displays the following screen:
  473.      
  474.           ┌─────────────────────────────────────────────────────────────┐ 
  475.           │ Sort Module...                                              │
  476.           ╞═════════════════════════════════════════════════════════════╡ 
  477.           │                                                             │ 
  478.           │                                                             │ 
  479.           │                        Sort Menu                            │
  480.           │                                                             │ 
  481.           │               (1) Alphabetical sort on last name.           │
  482.           │               (2) Sort on Zip codes.                        │  
  483.           │               (3) Restore database to original order.       │
  484.           │                                                             │ 
  485.           │                                                             │ 
  486.           │           Press number of desired action or <ESC> to quit.  │ 
  487.           │                                                             │ 
  488.           └─────────────────────────────────────────────────────────────┘
  489.                                     Figure 4
  490.  
  491.                Pressing (1) at this menu begins an alphabetic sort in
  492.           ascending order,on the last name field. That is, records will be
  493.           sorted A, B, C,.... and so on, on the basis of the entry in the
  494.           Last Name field.  
  495.  
  496.                Selecting (2) begins a sort on the zip code field. The first
  497.           record will have the lowest zip code and the last record will
  498.           have the highest zip code.  
  499.  
  500.                You can also restore your database to the original order it
  501.           had when records were first entered, as long as you haven't
  502.           zapped your file before you try to restore it.
  503.  
  504.                This is true because when a file is zapped, records in memory,
  505.           starting from the first record, are written to disk. As each record
  506.           is written, it is given a new order number, based on its current 
  507.           position in memory. Therefore, if you sorted the database and then
  508.           zapped it, the original order becomes the order the database was
  509.           given after the sort. 
  510.  
  511.                For instance, you enter the following records: Zag, Bart,
  512.           Apple, and Thomas. You then sort your records, which produces the
  513.           following order:
  514.  
  515.                Apple, Bart, Thomas and Zag.
  516.  
  517.                At this point you can still restore the original order. Now
  518.           you delete Apple and select Zap. The new original order will be
  519.           Bart, Thomas and Zag. If you now enter another record - Klein, and
  520.           sort the records you will see: Bart, Klein, Thomas and Zag. 
  521.  
  522.                When you choose to restore the previous order with the third
  523.           selection from the Sort menu, this is the order you will get:
  524.  
  525.           Bart, Thomas, Zag and Klein. 
  526.  
  527.  
  528.           List-It!                     -7-                                     ZAP MODULE
  529.  
  530.  
  531.                This module is only active when there are deleted records in
  532.           the database. Remember, a record is not physically removed from the
  533.           database, when it is deleted. It still occupies space and memory
  534.           both in RAM and in the PDF file. What does happen is that a delete
  535.           tag is placed within the record's structure. This tag is then 
  536.           checked whenever the program needs to display or search the 
  537.           records in the database.  If it is set, the record is skipped and
  538.           the following record is processed. This might sound like a
  539.           cumbersome procedure but it actually allows you greater freedom in
  540.           the manipulation of your database.
  541.  
  542.                This is because until your database is zapped, all records
  543.           that have been marked for deletion can be retrieved. To undelete
  544.           records you must go to the utility sub-menu. (See the section on
  545.           undeletion - page 35 - for a more detailed discussion.)
  546.  
  547.                When you select Zap at the main menu, you physically removes
  548.           deleted records from the database. This is accomplished through
  549.           pointer adjustment of the records that reside in RAM, so that, when
  550.           the records are written to disk, all deleted records are bypassed.
  551.           The net result is a shrinking of the database size. 
  552.  
  553.                If you have been using the program for awhile and have deleted
  554.           and entered records many times without ever selecting Zap, the size
  555.           of the database file will be much larger than it needed to be. This
  556.           is because it will still contain the records that have been
  557.           deleted. For instance, suppose there are 58 records in your
  558.           database. Now also suppose that you have deleted 30 records. Since
  559.           the approximate size of a record is 300 bytes then the size of the
  560.           file includes 3000 bytes of information that you have marked for
  561.           deletion. 
  562.  
  563.                You might then decide to Zap the database, in order to
  564.           conserve disk space. All deleted records will be permanently
  565.           removed, in effect shrinking the size of the database by those
  566.           3000 bytes. When the process is complete you will then see the
  567.           following message on the top bar;
  568.  
  569.           "30 records zapped."
  570.                
  571.                You will still have 58 records, but now the PDF file will be
  572.           5800 bytes long instead of 8800 bytes. Those 30 records have been
  573.           completely and permanently removed. They can not be retrieved or
  574.           undeleted.
  575.  
  576.                
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.           List-It!                     -8-                                    ENTER MODULE
  588.  
  589.  
  590.                This is the module you use when entering records. Each record
  591.           is fixed in length and includes the following 16 fields, in the
  592.           order shown.  
  593.  
  594.                          FIELD                LENGTH
  595.                          Last name................24
  596.                          First name...............14
  597.                          Address..................34
  598.                          City.....................29
  599.                          State.....................2
  600.                          Zip code..................9
  601.                          Area code.................3
  602.                          Phone.....................7
  603.                          Company..................24
  604.                          Contact..................24
  605.                          Business area code........3
  606.                          Business phone............7
  607.                          Extension.................9
  608.                          Fax area code.............3
  609.                          Fax.......................7
  610.                          Notes....................79
  611.  
  612.                A sample of the screen displayed when you are entering
  613.           records follows;
  614.  
  615.  
  616.           ┌─────────────────────────────────────────────────────────────┐
  617.           │ Enter Module                                                │
  618.           ╞═════════════════════════════════════════════════════════════╡
  619.           │               F2 : Copy field from previous record.         │ 
  620.           │               F9 : When finished with record.               │ 
  621.           │                                                             │
  622.           │                                                             │ 
  623.           │                                                             │
  624.           │                                                             │
  625.           │ Last Name: __________________ First Name: ___________       │ 
  626.           │ Address: __________________________________                 │ 
  627.           │ City:  ______________________ State: __ Zip: _________      │ 
  628.           │ Area code: ___ Phone: _______                               │ 
  629.           │ Company Name: ________________________                      │ 
  630.           │ Contact: ________________________                           │ 
  631.           │ Bus area code: ___ Bus phone: _______ Ext: _________        │ 
  632.           │ Fax area code: ___ Fax: _______                             │ 
  633.           │ Notes:                                                      │ 
  634.           │_____________________________________________________________│
  635.           │                                                             │ 
  636.           │                                                             │
  637.           │                                                             │ 
  638.           │                        F1: Help                             │
  639.           └─────────────────────────────────────────────────────────────┘
  640.                                     Figure 5 
  641.  
  642.                You'll see the two commands at the top of the screen, the 
  643.           main body of the entry screen, and at the bottom of the display the
  644.           
  645.  
  646.           List-It!                     -9-  
  647.  
  648.  
  649.           message, "F1: Help", which tells you that a help window is active
  650.           here. Note also that the cursor is at the first position of the
  651.           first field, waiting for you to begin you input. 
  652.    
  653.                Make your entry now and hit the <Enter> key when you are
  654.           finished. You will then be automatically moved to the next field.
  655.           If you try to enter more characters than the field has space for, 
  656.           the program will beep, and return you to the front of the field.
  657.  
  658.                If the field you have over-filled is the state field,
  659.           (remember you can only enter two letters for the state), then you
  660.           will also see another prompt one line above the F1 : Help
  661.           statement, which says : Press <F1> for two letters state codes.
  662.  
  663.                Pressing <F1> here displays the following window which
  664.           contains the two letter postal codes for every state in the Union.
  665.           Just find the one you wish and type it in. 
  666.  
  667.      ╔═════════════════════════════════════════════════════════════════════╗
  668.      ║ Alabama          - AL  Kentucky         - KY  Ohio             - OH ║
  669.      ║ Alaska           - AK  Louisiana        - LA  Oklahoma         - OK ║
  670.      ║ American Samoa   - AS  Maine            - ME  Oregon           - OR ║
  671.      ║ Arizona          - AZ  Maryland         - MD  Pennsylvania     - PA ║
  672.      ║ Arkansas         - AR  Massachusetts    - MA  Puerto Rico      - PR ║
  673.      ║ California       - CA  Michigan         - MI  Rhode Island     - RI ║
  674.      ║ Canal Zone       - CZ  Minnesota        - MN  South Carolina   - SC ║
  675.      ║ Colorado         - CO  Mississippi      - MS  South Dakota     - SD ║
  676.      ║ Connecticut      - CT  Missouri         - MO  Tennessee        - TN ║
  677.      ║ Delaware         - DE  Montana          - MT  Texas            - TX ║
  678.      ║ Dist. of Col.    - DC  Nebraska         - NE  Trust Territories- TT ║
  679.      ║ Florida          - FL  Nevada           - NV  Utah             - UT ║
  680.      ║ Georgia          - GA  New Hampshire    - NH  Vermont          - VT ║
  681.      ║ Guam             - GU  New Jersey       - NJ  Virginia         - VA ║
  682.      ║ Hawaii           - HI  New Mexico       - NM  Virgin Islands   - VI ║
  683.      ║ Idaho            - ID  New York         - NY  Washington       - WA ║
  684.      ║ Illinois         - IL  North Carolina   - NC  West Virginia    - WV ║
  685.      ║ Indiana          - IN  North Dakota     - ND  Wisconsin        - WI ║ 
  686.      ║ Iowa             - IA  Northern Mariana       Wyoming          - WY ║
  687.      ║ Kansas           - KS       Island      - CM                        ║
  688.      ╚═════════════════════════════════════════════════════════════════════╝
  689.                                     Figure 6
  690.  
  691.                If the cursor is any field besides the state field, and you
  692.           press the <F1> key, then the normal help window will appear, giving
  693.           you brief key descriptions. (See page 8 for a look at the window.)
  694.    
  695.                Another feature of the program is its ability to copy the
  696.           previous record's contents into the current record, one field at a
  697.           time.
  698.  
  699.                Let's say that you want to enter a series of addresses that
  700.           are all in the same city. After you've entered the street address
  701.           you'll be moved to the next field which is the city field. Press
  702.  
  703.  
  704.  
  705.           List-It!                     -10-
  706.  
  707.  
  708.           the <F2> key and the entry within this field in the previous record
  709.           will be automatically entered. That is, the city which you
  710.           already entered in the previous record would be duplicated here.
  711.  
  712.                You can also use this key when record information differs
  713.           only slightly. As when you wish to enter two friends or business
  714.           associates who happen to live at the same street address, but
  715.           with different numbers. Just enter the first record and continue
  716.           with the second until you reach the address field. Press <F2> and
  717.           the street address from the first record will be entered here
  718.           also. You then move the cursor to the part of the address you
  719.           wish to change. Type in the new info and press return when you
  720.           are finished editing the field. 
  721.  
  722.                Of course the F2 key is not active at the first record, since
  723.           there is no previous record.
  724.  
  725.                When you finish entering data into the current record, you
  726.           have the chance to review the record before it is saved. If there
  727.           are any changes to be made, move the cursor to the desired field.
  728.  
  729.               To move to the next field press the <Tab>, <Enter>, or the
  730.           Down cursor keys. To move to the previous field press the
  731.           <Shift + Tab> keys or the Up cursor key. Then make the necessary
  732.           changes and press the <F9> key when you are done. 
  733.  
  734.                The program then checks the database to see if the record
  735.           just entered is a duplicate of one that already exists. It searches
  736.           on three fields; last name, address, and phone number. If all three
  737.           match then you are prompted with a duplicate record message;
  738.  
  739.  
  740.                               Duplicate Record
  741.                   Do you wish to view the original record? y/n
  742.          
  743.  
  744.                If you answer yes, the original record is displayed. You are
  745.           then given the opportunity to edit the original record.  
  746.           
  747.                Whether or not you view the original record, the program
  748.           will then delete the duplicate record.
  749.  
  750.                You can not enter a blank record. If you do not enter any
  751.           information into the fields but simply hit the return key at each
  752.           prompt, or hit the <Esc> key without entering data, the program
  753.           knows that the record is blank and deletes it automatically when
  754.           you leave the Enter Module.
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.           List-It!                     -11-                                    DELETE MODULE
  765.  
  766.  
  767.                This module will allow you to delete records that were
  768.           located or tagged in the last search. Which makes it easy to 
  769.           delete groups of records, instead of only deleting one record at a
  770.           time, as you would through the Browse module.
  771.  
  772.                Suppose you realize that you have a group of records that
  773.           are duplicated in another, or within the same PDF file. This is a
  774.           waste of valuable disk space, so you will want to delete those
  775.           records. All you'd have to do is search for those duplicate records
  776.           through the Find module, then return to the Delete module and press
  777.           the <y> key in response to the following prompt.
  778.  
  779.                         "Delete records from last search? y/n"
  780.          
  781.           When you press <y> you will next be prompted with the question;
  782.  
  783.                "Do you wish to view the records before deletion? y/n." 
  784.   
  785.                This is done for safety's sake, so that you can be sure that
  786.           you're deleting only the records that need deleting. If you're sure
  787.           about the results of the search then you can forego this option,
  788.           by pressing <n> for no. You will then be prompted with a reminder
  789.           that you are about to delete the records located from the last
  790.           search. If you still wish to continue press <y> again. You will
  791.           then be prompted one final time with the query;
  792.  
  793.                               "Proceed? y/n." 
  794.  
  795.                Press <y> to start the deletion process. Every record that
  796.           was tagged at the last search will now be deleted. 
  797.  
  798.                If you don't press <y> then you will be shown the same search
  799.           menu that is shown within the Find Module. You can now search for
  800.           the desired record or groups of records that you want to delete. 
  801.  
  802.                If however, you do wish to view the records that are about to
  803.           be deleted press <y>, and they will be displayed one at a time.
  804.           The following prompt will then appear after each record;
  805.  
  806.                          "Delete this record? y/n." 
  807.  
  808.                The displayed record will only be deleted when you press <y>.
  809.           Pressing any other key will leave the current record alone and 
  810.           display the next record about to be deleted.
  811.  
  812.                You can press the <ESC> key at any one of the previously
  813.           mentioned prompts, to quit the module and return to the main menu.
  814.           This is true even if you are viewing a large group of records that
  815.           you will be deleting, and you haven't reached the end of the list
  816.           yet.
  817.  
  818.                When the last record in the retrieved list has been reached,
  819.           the program will tell you how many records were deleted, and allow
  820.           you to return to the main menu.
  821.  
  822.  
  823.           List-It!                     -12-                                    PRINT MODULE
  824.  
  825.  
  826.                When you first enter this module you will see the following   
  827.        sub-menu:
  828.  
  829.        
  830.                             ┌───────────────────────┐     
  831.                             │Records                │     
  832.                             │Labels 3 1/2 by 15/16  │     
  833.                             └───────────────────────┘     
  834.  
  835.                You can choose to print the records of your database or labels
  836.          from those records, (in labels of the size 3 1/2 x 15/16). If you
  837.          choose labels, then you will see an additonal sub-menu:
  838.  
  839.                                     
  840.                             ┌───────────────────────┐       
  841.                             │Records                │       
  842.                             │Labels 3 1/2 by ┌────────────┐ 
  843.                             └────────────────│Last Search │ 
  844.                                              │All records │ 
  845.                                              └────────────┘ 
  846.  
  847.                This sub-menu allows you to choose how you wish to print your
  848.           labels. You can either print a label from every record in your
  849.           database, or you can restrict the label printing to just a portion
  850.           of it. (For a detailed explanation of how to restrict printing to
  851.           a portion of your database, see the following discussion in Record
  852.           printing. The same rules apply.)
  853.  
  854.                You will be allowed to print test labels to see if the labels
  855.           are aligned correctly in your printer. Just press the <y> key when
  856.           the Print test labels window appears. Three test labels will then
  857.           be printed, and then another window will appear on screen asking 
  858.           if they have printed correctly.
  859.  
  860.                If you notice that they are not aligned correctly, press the
  861.           <n> key. You will then be asked if you want to print test labels
  862.           again. First re-align the labels in your printer, and then answer
  863.           with the <y> key to print test labels again. Once you are satisfied
  864.           with the label alignment, press the <y> key, (when you are asked if
  865.           the labels printed correctly?) 
  866.  
  867.                You will then be prompted with another window asking if you
  868.           wish to start printing. Press the <y> key to initiate printing.
  869.  
  870.                You can abort the printing process pressing the <Esc> key,
  871.           when ever you are asked a question.  
  872.  
  873.                Labels are printed in the standard mailing format;
  874.  
  875.           First name Last Name
  876.           Address
  877.           City, State Zip Code.
  878.                                       
  879.  
  880.  
  881.  
  882.           List-It!                     -13-                                 RECORD PRINTING                              
  883.  
  884.  
  885.                When you enter this module, you will see a vertical list of
  886.           fields on the left side of your screen. (The same one that
  887.           appears when you are in the Find Module.) You will also see a
  888.           command section at the bottom of your screen.
  889.  
  890.               Pressing F1 pops up a series of windows explaining the
  891.           functions available to you in this module. Basically, you can
  892.           print out the contents of your database in a any way you wish.
  893.           You can be selective in the fields you want printed and also in
  894.           what records to print. And of course, you can also print the
  895.           entire database.
  896.  
  897.                The F10 key gives you that choice, that is, printing the
  898.           entire database. Each record is printed in the following format:
  899.  
  900.           Last name First Name
  901.           Address
  902.           City, State Zip Code
  903.           Area Code telephone 
  904.           Company
  905.           Contact
  906.           Business Area Code Business Phone extension
  907.           Fax Area Code Fax number
  908.           Notes
  909.  
  910.                If you need to be more selective in your printing, then you
  911.           are given the option of tagging the fields you wish to print. To
  912.           tag fields you must move the highlight bar, with the up and down
  913.           cursor keys, to the desired fields then press <enter>. (Or
  914.           alternatively, you can press the highlighted letter of the desired
  915.           field. This is more direct and much quicker, than the previous
  916.           method). 
  917.           
  918.                A print-field-tag (*), will appear to the right of the chosen
  919.           field, to let you know it has been chosen. A tagged field can be
  920.           toggled by selecting the same field again. The tag will then
  921.           disappear. 
  922.  
  923.                Once the fields have been chosen, press <F5> to start
  924.           printing. The tagged fields of each record in the database, will
  925.           then be printed. 
  926.  
  927.                The F9 key provides another method of selecting records to
  928.           print, by working with the Find Module. Simply put, it prints
  929.           records that were located at the last search. For example, let's
  930.           say you wish to print the records of friends that are on your Xmas
  931.           list. (These records must of course be marked in this manner,
  932.           perhaps with the words Xmas list in the note field).
  933.  
  934.                From the main menu you must first enter the Find module, go
  935.           to field search and then to the note field, (<F>, <f>, <n>). At 
  936.           the prompt, type in xmas list and hit <enter>. The entire database
  937.           will be searched and all records with these words in the note 
  938.           field will be tagged. Then press <ESC> which will return you to
  939.           the main menu. 
  940.  
  941.           List-It!                     -14-  
  942.           
  943.  
  944.                Next enter the Print Module, choose Print Records and press
  945.           <F9>. You will then see the following phrase, displayed at the top
  946.           of the command area;
  947.  
  948.                     "Printing is confined to Last Search"
  949.  
  950.                This means that when the database is accessed for records to
  951.           print, it will only print those that were located at the last
  952.           search, (in this case, the search was for xmas in the note field). 
  953.  
  954.                You must then tag the fields you wish to have printed, say the
  955.           name and address fields, then press <F5> to start printing. 
  956.  
  957.                The result will be a list of names and addresses of everyone
  958.           on your Christmas list. 
  959.  
  960.                If however, you pressed the <F10> key instead of the <F5> 
  961.           key, then the entire contents of each record with the phrase xmas
  962.           in the note field will be printed.
  963.  
  964.                Whichever method you choose, the printing will be confined
  965.           to those records that have been tagged in the last search. If you
  966.           decide that you want to remove that restriction press <F9> again.
  967.           You'll then see the printing restriction notice disappear. <F9>
  968.           acts as a toggle switch here, either restricting or not restricting
  969.           the print job to records located at last search.
  970.  
  971.                You can also print single records. Again, you must enter the
  972.           Find module and search for the desired record. But it must be a
  973.           search on a field that you know is not duplicated in any other
  974.           record. Let's say you need the record of Bart Jones in hard copy.
  975.           And you know that you only have one Bart in your database. At the
  976.           main menu type, <f>,<f>, <f>. An input line will appear at the
  977.           first name field. Type in Bart and hit <ENTER>. Bart Jones'
  978.           record should then appear on the screen.
  979.  
  980.                You can then return to the main menu and proceed to the
  981.           print menu. Press <F9> and hit <F10>, (or tag the needed fields
  982.           and hit <F5>, if you wish to only view a part of the record.) A
  983.           hard copy of this record will then be printed out.
  984.               
  985.                Before any printing begins the program checks to make sure
  986.           that a printer is attached and ready. (At least for parallel
  987.           printers, that are connected to LPT1. I'll remedy this in future
  988.           versions to include other ports and serial printers).
  989.  
  990.                So if you do have a parallel printer connected to LPT1, then
  991.           the program will notify you when the printer is turned off or is
  992.           off line. It does this within an error window (red background,
  993.           yellow letters), that pops up on your screen. You will be given
  994.           a message corresponding to the status of the printer, plus
  995.           an opportunity to correct the situation. If you choose not to
  996.           correct the problem you are also given the choice of exiting the
  997.           print module by pressing the <ESC> key. 
  998.  
  999.          
  1000.           List-It!                     -15-                                        QUIT
  1001.  
  1002.  
  1003.                Selecting quit from the main menu, returns you to DOS. But
  1004.           there are some housekeeping chores the program does first. It 
  1005.           saves several variables to disk, so they can be used the next 
  1006.           time you run List-It!. 
  1007.  
  1008.                For instance, the program saves the colors that you are using
  1009.           when you quit the program. Then the next time the program runs,
  1010.           these colors are retrieved and used again. So you only have to
  1011.           customize your colors once.
  1012.  
  1013.                Another variable saved is the last record you viewed, through
  1014.           either the Browse or the Find Modules, in the currently loaded PDF
  1015.           file. This means that the next time the file is used and you
  1016.           select Browse from the main menu, the record that was last
  1017.           displayed will be the record that is displayed now. 
  1018.  
  1019.                For example, let's say you have a data file named
  1020.           POLITICAL.PDF which contains information on many political
  1021.           officers, both state and nation wide. You need to know the mailing
  1022.           address of Senator Chiles, so you load in the file POLITICAL.PDF,
  1023.           (through the Load File option in the Utility sub-menu), select 
  1024.           Find from the main menu and start a search for Lawton Chiles. When
  1025.           his record is found it is displayed on screen and you can then get
  1026.           the info you needed. Then, when you quit the program, or load in
  1027.           another file, this record number is saved. 
  1028.  
  1029.                The next time you run List-It!, load the file POLITICAL.PDF
  1030.          and enter the Browse Module, the record of Lawton Chiles will
  1031.          appear first.
  1032.  
  1033.                Before the program allows the user to go back to DOS, a
  1034.           reminder screen asking him not to forget to register is displayed.
  1035.           That line is re-displayed in a different color each second. After 
  1036.           3 seconds, you can stop the process and return to DOS by hitting
  1037.           any key.
  1038.  
  1039.                Please remember that when you register, I will send you the
  1040.           latest version of the program without the commercials. 
  1041.  
  1042.                Thank You for your understanding and patience.
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.           List-It!                     -16-                                  UTILITY Sub-Menu
  1060.  
  1061.  
  1062.                Selecting Utility from the main menu, displays a window  
  1063.           with other menu choices. 
  1064.  
  1065.                                  ┌──────────────┐ 
  1066.                                  │Directory     │ 
  1067.                                  │Backup        │ 
  1068.                                  │Import/Export │ 
  1069.                                  │Load file     │ 
  1070.                                  │Copy file     │ 
  1071.                                  │Change colors │ 
  1072.                                  │Rename file   │ 
  1073.                                  │Get Info      │ 
  1074.                                  │Undelete      │ 
  1075.                                  └──────────────┘ 
  1076.                                      Figure 7
  1077.           
  1078.                You select menu items as you would from the main menu. That   
  1079.           is, by moving the highlight bar, in this case with the up and down 
  1080.           cursor keys, and then hitting <Enter>. Or by pressing the high-    
  1081.           lighted letter of the menu choice you desire.
  1082.                
  1083.                If you press the <F1> key while in the sub-menu, a help window
  1084.           will pop up displaying information about the currently highlighted
  1085.           menu item. Each menu item has it's own help window.
  1086.  
  1087.                We'll now turn to a discussion of the options available to you
  1088.           through this sub-menu.
  1089.  
  1090.                                     DIRECTORY
  1091.  
  1092.                When you select Directory from the menu the program displays a
  1093.           directory tree and then searches the current drive and directory  
  1094.           and lists all files it finds there. The tree is displayed in a     
  1095.           small window to the left of the screen, with the current directory
  1096.           highlighted by the moving bar. You can move the highlight bar along
  1097.           the directory tree, with the up or down cursor keys. If there are
  1098.           more than ten directories, they will scroll in the window. The
  1099.           files are listed on the rest of the screen to the right of the 
  1100.           tree window. 
  1101.                
  1102.                Each time you move the highlight bar, any files that reside
  1103.           within that directory will automatically display on the right side
  1104.           of the screen, in the file area. If there are no files within that
  1105.           directory, then it will be noted there also. 
  1106.               
  1107.                Underneath the directory window are two figures. One figure 
  1108.           represents the amount of free space available on the current drive.
  1109.           This figure will, of course change every time you change the drive
  1110.           that you are viewing.
  1111.  
  1112.                The second figure represents the total number of bytes used
  1113.           by the currently highlighted directory. This amount will vary every
  1114.           time you move the highlight bar to a different directory. 
  1115.  
  1116.  
  1117.          
  1118.           List-It!                     -17-
  1119.  
  1120.  
  1121.                The full path name will be displayed on the top line of the
  1122.           screen. This will be updated each time you move the highlight bar.
  1123.      
  1124.                The command area is on the bottom of the screen. In it you 
  1125.           will find the keys that are active in this module. 
  1126.             
  1127.                  Up Arrow, 
  1128.                  Dn Arrow    - Change Directories
  1129.                  <Space Bar> - When this is displayed, there are too many 
  1130.                                files in the currently selected directory 
  1131.                                to display on one screen. Pressing the 
  1132.                                <Space Bar> clears the file screen and 
  1133.                                displays the remaining files.
  1134.                  F2          - Displays a Drive change menu on the first 
  1135.                                line of the command area. Select a drive 
  1136.                                with the left or right cursor keys, then 
  1137.                                hit <Enter>. 
  1138.                  <Esc>       - Quits the module, returning to the main menu.
  1139.  
  1140.                A sample screen follows;
  1141.  
  1142.             ┌──────────────────────────────────────────────────────────┐
  1143.             │B:\*.*                                                    │   
  1144.             ╞══════════════════════════════════════════════════════════╡
  1145.             │┌──────────────────┐ LST.EXE                              │   
  1146.             ││\                 │ LST-REGI.DOC                         │   
  1147.             │└──────────────────┘ LSTDOC1.TXT                          │   
  1148.             │                     LSTDOC2.TXT                          │   
  1149.             │                                                          │
  1150.             │                                                          │
  1151.             │                                                          │
  1152.             │                                                          │
  1153.             │                                                          │
  1154.             │                                                          │
  1155.             │Bytes Available:                                          │   
  1156.             │10,240                                                    │
  1157.             │                                                          │
  1158.             │Directory Bytes:                                          │   
  1159.             │350,580                                                   │
  1160.             │                                                          │
  1161.             │                                                          │
  1162.             ╞══════════════════════════════════════════════════════════╡
  1163.             │< >, < > : to change directories  <F2>: change drives     │
  1164.             │       ESC>: quit                                         │
  1165.             └──────────────────────────────────────────────────────────┘
  1166.                                       Figure 8
  1167.  
  1168.                This shows a disk in the B drive with 4 files in the root
  1169.           directory, totaling 350,580 bytes. There are 10,240 bytes available
  1170.           on this disk.
  1171.           
  1172.               The directory window contains the only root directory of the
  1173.           disk in the B drive. It will expand, if necessary, to hold ten
  1174.           directories. When there are more than ten, they will scroll out of
  1175.           the window.
  1176.  
  1177.           List-It!                     -18-