home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / dbperl10.zip / IPMANUAL.DOC < prev    next >
Text File  |  1994-11-13  |  17KB  |  316 lines

  1.  
  2.              THE INTERNET PEARLS DATABASE MANUAL
  3.  
  4.     (By either clicking the mouse in the upper left corner, or
  5.     by pressing the F1 key, while in the program, you can call
  6.     up "Help" that displays these same paragraphs.)
  7.  
  8.     The Internet Pearls Database is navigated by the use of
  9.     buttons and fields. Select the button you are interested in
  10.     by pressing the TAB key to reach the button, and pressing
  11.     Enter, or click the mouse on the desired button. This text
  12.     box will then show the desired information. Selecting the
  13.     [Return] button will take you back to the page that you were
  14.     on before entering the Help section. What is actually
  15.     happening is that you are going to the "page" devoted to
  16.     that topic. All of the pages are contained in one "pad" or
  17.     file. Scroll down this text window to learn about the
  18.     commands on the menu bar. Remember, use the [TAB] key to
  19.     enter fields and type in them. If you are using the mouse,
  20.     simply click the left mouse button over the field you want
  21.     to enter or the button you want to take action. One
  22.     reminder: the text fields scroll! Each field usually
  23.     contains much more information than what you can see in the
  24.     small window area. Use the scroll bars and the mouse or the
  25.     Up and Down arrow keys to move within the field. Avoid
  26.     trying to use the [PgUp] and [PgDn] keys to move within the
  27.     field as they are used for going forward and backward in the
  28.     database.
  29.  
  30.     There are several ways to navigate through the pages of this
  31.     or any other pad.  The [PgUp] key goes backward, as in
  32.     "Previous", in the stack of pages, while [PgDn] goes forward,
  33.     as in "Next", through the stack of pages. The [Ctrl]+[PgUp]
  34.     keys go to the first page in the pad. The [Ctrl]+[PgDn] keys
  35.     go to the last page in the pad. Clicking the mouse on the
  36.     desired button is a rapid way to move through the pages.
  37.     Clicking on [Next] and [Previous] also moves forward and
  38.     backward through the stack of pages.
  39.  
  40.     You can also use the bar menu at the top of the page to
  41.     navigate. The menu bar is displayed by pressing the [Alt]
  42.     key. Click on "Go" and you will see the navigation options
  43.     Help, Home, Back, Next, Previous, First, and Last with their
  44.     respective short-cut keys. Help takes you to this page. Home
  45.     will take you to the introduction screen, while Back moves
  46.     you to your previous location. Next means next page and
  47.     Previous means previous page. First means the first page in
  48.     the pad, and Last means the last page in the pad.
  49.  
  50.     When the Menu Bar at the top of the screen is displayed, you
  51.     are given a choice of selecting "File", "Edit", "Go", and
  52.     "Workspace". Under the "File" setting, the possible
  53.     selections are Open, Compress, Run a Program, and Exit.
  54.     Selecting "Open" brings up a list of files belonging to the
  55.     current directory. Only files with ".pad" can be
  56.     opened."Compress" removes free space in a pad left over when
  57.     a page is deleted. "Run a Program" allows you to enter a
  58.     command and have it executed as if you were at the DOS
  59.     prompt."Exit" takes you immediately out of the program.
  60.  
  61.     Under the "Edit" menu, "New Page" adds a page, while "Delete
  62.     Page" removes the current page, and its contents are lost.
  63.     You can mark a block by clicking the mouse over the text you
  64.     want to mark and dragging the mouse with the left button
  65.     depressed. The areas marked will be hilited and available to
  66.     be manipulated by the other menu entries under "Edit". These
  67.     commands are dimmed until a block is marked, then they
  68.     appear as normal menu text. "Cut" removes the hilited area,
  69.     copies it to an internal clip-board and is available to be
  70.     "Pasted". The "Copy" command copies the text without
  71.     disturbing it. It can then be "Pasted" in the field that you
  72.     desire by selecting "Paste" from the menu or pressing the
  73.     Ctrl-V keys. The "Delete" command removes the hilited text
  74.     and does not copy it to a clipboard, but discards the text.
  75.  
  76.     The "Go" commands are explained above. "Workspace" lets you
  77.     select whether or not you want to keep the menu bar as part
  78.     of the regular display. The status bar is located on the
  79.     bottom and tells which pad and which page you are working on.
  80.     This can also be made visible as part of the regular display.
  81.     The message box lets you see the result of operations as
  82.     they are performed. The "Result" is usually a yes, no, 0, 1,
  83.     or "Ok".
  84.  
  85.     Although the menu bar can be helpful, almost all of the
  86.     needed commands to operate the program are included as
  87.     "Buttons" that perform a specific action. These buttons will
  88.     be outlined next. Click on the button that you want to know
  89.     more about, or press the TAB key, and then enter over the
  90.     button you desire.
  91.  
  92.     The "Import" command allows you to transport text from
  93.     outside of the program into a field within the program. This
  94.     allows you to quickly add information to the database, by
  95.     importing the text instead of having to type it in. By using
  96.     the "cut" and "paste" features in the menu bar, you can
  97.     import text into one field, hilite text you want to move to
  98.     another field, select "cut", move the cursor to the other
  99.     field (by mouse or TAB), and select "Paste" or use the Ctrl-V
  100.     keys to have the text transferred to the desired field.
  101.     For instance, you can capture the session you have on the
  102.     Internet with your communications program. This is usually
  103.     stored as a text file. You can select portions of text that
  104.     you want to be able to refer to later, and move them into
  105.     the database with the "Import" command. Each field,
  106.     "Addresses", "Notes", and "Directories" can hold up to 30k
  107.     of text at a time.
  108.  
  109.     As you would guess, the "Next" command takes you to the next
  110.     page (record) in the database. The "Previous" command takes
  111.     you to the previous page (record) in the database.
  112.  
  113.     The "Export" command takes all of the text in one field and
  114.     places it into a text file outside of the program,
  115.     accessible by any DOS program. You will be asked to give a
  116.     name to the text file, which can be any DOS compatible name
  117.     of eight-characters or less.
  118.  
  119.     Sort allows you to arrange the pages in order, based on the
  120.     contents of one of the fields. Most often, you will choose
  121.     the "Address" field to sort on, as this will put all of the
  122.     ftp, gopher, http (www) pages together. On the other hand,
  123.     you may decide to begin a field with a certain name, such as
  124.     the topic name, or the extension of the site (.gov, .edu,
  125.     .com, .net), and place it in the field "Notes" or
  126.     "Directories". You can then choose one of these fields to
  127.     sort on. The program reads the text of the field and sorts
  128.     according to the first text found there.
  129.  
  130.     The "Print" command allows you to obtain a hard copy of
  131.     information in the database. The program will ask you to
  132.     select between "One Field", "This Page", or "All Pages".
  133.     Choosing "One Field" will allow you to specify one field,
  134.     "Address", "Notes", or "Directories" to print. Choosing
  135.     "This Page" will print all 3 fields of the current Page.
  136.     Choosing "All Pages" will print all 3 fields of all of the
  137.     pages in the database. Make sure your printer is "On", and
  138.     the paper is aligned, and then select "Ok" when asked "Ok to
  139.     Print?".
  140.  
  141.     The "Query" command can be extremely useful. While the
  142.     "Find" and "Find Next" commands search for and hilite
  143.     specified text, the "Query" function gathers pages from the
  144.     pad together that match certain criteria. You can then work
  145.     with the subset of pages as if they were the only pages in
  146.     the pad. An example would be to select the "Query" command,
  147.     and then the program inquires as to which field you want to
  148.     use for the query, click on "Address", and then you will be
  149.     asked what text you want to use as criteria to include in
  150.     the query. Enter "ftp" and press enter. You have asked the
  151.     program to gather all of the pages that match the criteria
  152.     of having "ftp" in the field "address". This can greatly
  153.     speed your work if you are wanting to review just certain
  154.     items, such as "Address" fields that have ".edu" as part of
  155.     their name, or contain "finger". You could also create a
  156.     subset of pages with "NASA" in the "Directories" field. This
  157.     subset continues to be all that you can access, until you
  158.     use the "Clear Query" command, which will then return you to
  159.     working with all of the pages in a pad. When you use the
  160.     query function, flip through the pages gathered by using the
  161.     "Next" button. If you see a page that does not seem to meet
  162.     the criteria, use the "Find" command and it will locate and
  163.     hilite the proper text for you. Remember, the text fields
  164.     scroll! So, do not assume that the query command is not
  165.     working prematurely. Your text is there, guaranteed. Use the
  166.     "Find" command to locate it on the page you are on, use the
  167.     "Find Next" command to find and hilite the text in the pages
  168.     that follow.
  169.  
  170.     "Clear Query" allows you to clear the current query. See the
  171.     "Query" button notes. Query gathers pages out of the
  172.     database into one set. The whole database is no longer
  173.     available to act on, only the subset defined by "Query".
  174.     "Clear Query" eliminates the subset of pages and allows you
  175.     to access the whole database again.
  176.  
  177.     The "Find" command finds the first instance of the specified
  178.     text and hilites this text, showing you the location of it
  179.     in the field. You do not have to tell the program which
  180.     field to search in, as it automatically searches in all
  181.     three fields for the desired text. The "Find Next" command
  182.     is what you use if you want to keep searching. Selecting
  183.     "Find Next" will begin searching on the very next page from
  184.     where "Find" located text. Notice that you do not have to
  185.     type in the text to search for again, when you use "Find
  186.     Next", as it is already entered for you.
  187.  
  188.     "Find Next" is the command you use to continue searching
  189.     after you have used the "Find" command. Once you use the
  190.     "Find" command, and your text has been found and hilited,
  191.     pressing "Find" again will only return you to the same spot.
  192.     Instead, you would use the "Find Next" command to continue
  193.     searching on other pages. The "Find" and "Find Next"
  194.     commands find the first instance of the specified text in a
  195.     file.
  196.  
  197.     The "Calendar" button is included because of the large
  198.     numbers of times that I personally have had to leave the
  199.     program to look up days and dates information. Sure, there
  200.     are pop-up, TSR Calendars, but they are sometimes
  201.     inconsistent in their behavior. Notice that "Today" is
  202.     displayed. You can go to the first day of the next month, by
  203.     selecting "Next Month", and to the first day of the previous
  204.     month by selecting "Previous Month". The "Put Calendar Away"
  205.     button will cause the Calendar to be hidden until you next
  206.     request it. It is not a TSR, and does not stay resident in
  207.     memory. Using the "Next Month" command repeatedly takes you
  208.     to the calendars that lay ahead, many years into the future.
  209.  
  210.     The "Find File" feature is also included because of the
  211.     convenience that it offers in not having to leave the
  212.     program. I have found that I can work with files and locate
  213.     items for importing into the database easily with the "Find
  214.     File" button. Notice that the file list presented shows all
  215.     the files that match the search criteria on the specified
  216.     hard drive. Wildcards are allowed, so "*.txt", "record*.*",
  217.     and "datafile.*" are all acceptable entries to search on.
  218.     You can view a file in the list by hiliting the file, and
  219.     then selecting the "View File" button.
  220.  
  221.     The "View Directory Tree" button takes you to a page where
  222.     you can ask the program to read the directories of a
  223.     specified hard drive and then display it in tree format. The
  224.     directory that you hilite can have its files listed by
  225.     pressing the "View Files in Directory" button.  You can
  226.     hilite a file in this listing and then select "View Hilited
  227.     File", to actually view the contents of the text file that
  228.     is hilited.
  229.  
  230.     When in the "File Viewer" page, the [Home] key takes you to
  231.     the top of the file, the [End] key takes you to the end. The
  232.     Up and Down arrows scroll the file, while [PgUp] and [PgDn]
  233.     move the file a screen at a time. The [Enter] key lets you
  234.     see the full path name of the file, and the [View File
  235.     Again] button displays the file once more.
  236.  
  237.     A file utility called "Padcheck.exe" is included to allow you
  238.     to check the integrity of the pad files when needed. The pad
  239.     files write their information to the file when the program is
  240.     closed. If your machine has the power cut-off or if you have to
  241.     reset your computer while still in the program, the odds are good
  242.     that the file you are in has become corrupt. It will behave
  243.     erratically, and most likely not run. The solution to this is
  244.     (1) back-up your files with the pad extension. (2) Use the
  245.     padcheck.exe file to check the integrity of the file. It is
  246.     used in the fashion "padcheck sites.pad", and will tell you if
  247.     the pad file is ok or whether it is corrupt.
  248.  
  249.  
  250. SHAREWARE CONCEPTS
  251.  
  252.     This program is distributed as Shareware.  The shareware
  253.     method of distribution allows you to evaluate a program
  254.     prior to purchasing it. The Internet Pearls Database is not
  255.     free and it is not in the public domain. It is a copyrighted
  256.     product that is protected by U.S. Copyright Law. First time
  257.     users of Internet Pearls DB are granted a license to use the
  258.     program on a trial basis, without cost or obligation, for
  259.     the sole purpose of determining whether or not it meets
  260.     their needs.  Any and all other use after a trial period of
  261.     30 days requires registration to obtain a license for
  262.     continued use.  Non-registered use of Internet Pearls DB
  263.     beyond the trial period is strictly prohibited.
  264.  
  265. LIMITED WARRANTY
  266.  
  267.     SoloTech Software and William E. Hogg make no warranty of
  268.     any kind, express or implied, including without limitation,
  269.     any warranties of merchantability and/or fitness for
  270.     a particular purpose.  SoloTech Software and Wm. Hogg shall
  271.     not be liable for any damages, whether direct, indirect,
  272.     special or consequential arising from the use of, or
  273.     inability to use this program by any user. In no event will
  274.     SoloTech Software and Wm. Hogg be liable to you for any damages,
  275.     including lost profits, lost savings, or other incidental or
  276.     consequential damages arising out of your use or inability
  277.     to use the program, or any claim by any other party, even if
  278.     it has been advised of the possibility of such damages.
  279.  
  280.  HARDWARE/SYSTEM REQUIREMENTS
  281.  
  282.     The following are the system requirements for using Internet Pearls DB:
  283.  
  284.      *  Personal computer:   IBM PC, PC-XT, PC-AT, IBM PS/2, Compaq,
  285.         or 100% compatible system; 386 or 486 recommended.
  286.  
  287.      *  Drives:   Two 5.25", 360K floppy drives; or at least one 3.5",
  288.         720K floppy drive; or a hard disk and at least one floppy drive
  289.         (hard disk recommended).
  290.  
  291.      *  Memory:  640K of DOS memory installed.
  292.  
  293.      *  Display and display adapters:  Any color or monochrome display
  294.         or adapter
  295.  
  296.      *  Operating system: DOS 3.3 or later; DOS 5.0 or 6.2 recommended.
  297.  
  298.      *  Mouse:  Microsoft Mouse or 100% compatible recommended.
  299.  
  300.      *  Printer (optional): HP LaserJet series, IBM Graphics Printer,
  301.         IBM Proprinter, IBM Color Printer, Toshiba P351, Epson FX/MX/LQ,
  302.         Okidata 92/93, Okidata 192/193, Panasonic KX-P4450, Canon LPB-8,
  303.         NEC Pinwriter P6/P7, DEC LA-50, or any printer capable of
  304.         emulating one of the preceding printers.
  305.  
  306.  
  307. *********************************************************************
  308.  
  309.                       COPYRIGHT NOTICE
  310.  
  311.                 Internet Pearls Database v1.0
  312.  
  313.              Copyright (c) 1994 by William Hogg M.D.
  314.                      ALL RIGHTS RESERVED
  315.  
  316.