home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util2 / pcbrs101.lzh / BTUT.BRS < prev    next >
Text File  |  1989-10-11  |  49KB  |  1,013 lines
  1.                                <TUTORIAL TOPICS>                                [BR=/I60.62/J22.20/K0.0]
  2.    RETURN TO
  3.    PC-BROWSE HELP[?BR.HLP]
  4.    Introduction            lookup keyword search     Popping Up PC-Browse  
  5.    Areacode                lookup search             Sailboat              
  6.    Cross-References        Lookup-search Files       Searching for Text    
  7.    Hamlet                  Misused                   Searching many files  
  8.    Index Page              Pasting Text              Simple PC-Browse File 
  9.    Loading PC-Browse       PC-Browse Applications    Viewing a File        
  10.  
  11.  
  12.           Use Tab or Arrows to highlight an entry; then press Enter
  13.                                 <INTRODUCTION>
  14. PC-Browse Tutorial
  15.  
  16. First, A Word for People Who Don't Read Manuals 
  17.  
  18. What's that? You never read manuals? Not even if we say, "Pretty please?" Aw, 
  19. c'mon, just the first two sections of the Tutorial. We promise they'll be 
  20. short. Just skip the introduction and read the section What Does PC-Browse Do?  
  21. Then load PC-Browse and your favorite word processor (that's PC-Write, 
  22. right?), and try the examples in the next section, Finding, Viewing, and 
  23. Pasting Text. 
  24.  
  25. Many of the hints, suggestions, and sample uses described in this manual have 
  26. come from people who tested early versions of the product as we developed it; 
  27. we're grateful for their suggestions. In fact, we'd love to hear from you 
  28. about how you're using PC-Browse; drop us a line at Quicksoft. 
  29.  
  30.                              
  31. Now, Back to the Tutorial 
  32.  
  33. Remember your first Swiss Army Knife? Remember looking at all those blades and 
  34. gizmos, trying to figure out each one? Remember, too, how quickly it became 
  35. indispensable? 
  36.  
  37. Sure, there were better knives if you needed to do some serious cutting, and 
  38. real screwdrivers for assembling your bookshelves. But all of your "real" 
  39. tools were bulky. There was the Swiss Army Knife, always ready to work for you 
  40. when you needed to tighten a screw, or cut a loose thread. Likewise, PC-Browse 
  41. is a tool you can always keep on your computer, to help when you need it to 
  42. look at or find a file, or get a directory. 
  43.  
  44. PC-Browse is both a familiar and a completely new type of product. 
  45.  
  46. You've already used many of its functions. Pop-up programs (or TSRs) have been 
  47. around for years. There are a number of find-text-on-my-disk utilities. You 
  48. can use any word processor to view text files and extract portions of them for 
  49. further use; even hypertext, or cross-referenced on-screen information, is 
  50. used for on-line help in a few products. In some ways, there's little new in 
  51. PC-Browse. 
  52.  
  53. What is new is that PC-Browse combines these concepts, with a few more, into a 
  54. handy Swiss Army Knife utility. As with any product, there are two steps to 
  55. learning it: first, figuring out what it does and second, discovering how to 
  56. do it. In this tutorial, you'll learn the "what" and the "how." 
  57.  
  58. This tutorial is divided into the following topics: 
  59.  
  60. √ What Does PC-Browse Do?
  61.  
  62.      An overview of the capabilities of your new Swiss Army Knife. 
  63.  
  64. √ Finding, Viewing, and Pasting Text.
  65.  
  66.      How to use PC-Browse with the text files already on your disk. 
  67.  
  68. √ Using PC-Browse Applications.
  69.  
  70.      A view of more interesting application files, along with an introduction 
  71.      to cross-referenced material (hypertext). 
  72.  
  73. √ Developing Your Own PC-Browse Applications.
  74.  
  75.      How to develop PC-Browse applications for your own use or for 
  76.      distribution to other folks. 
  77.  
  78. What Does PC-Browse Do? 
  79.  
  80. In this tutorial, we'll look at some problems you could solve with PC-Browse: 
  81.  
  82. 1.  How can I find the memo on restructuring I wrote 6 months ago? 
  83.  
  84.        Pop-up PC-Browse and tell it to search the whole disk for, say, 
  85.        "restruct." It will quickly find each file containing the search text, 
  86.        and show you that text in context!  A single keystroke moves from one 
  87.        reference to the next. You can even use multiple windows to keep track 
  88.        of different references. 
  89.  
  90. 2.  What's Mr. Walton's address? 
  91.  
  92.        If you're typing a letter to him, put the cursor on his name and pop up 
  93.        PC-Browse to jump to his page in your address file. PC-Browse can even 
  94.        paste the address right into your letter. 
  95.  
  96. 3.  What's the area code for El Paso? 
  97.  
  98.        Simply pop-up PC-Browse's area code application and ask it to find El 
  99.        Paso. 
  100.  
  101. 4.  Is it correct to say, "What's the affect of this decision?" 
  102.  
  103.        With our sample misused-words application, just put the cursor on 
  104.        "affect" and press the hot key. You'll see how to use "affect" and 
  105.        "effect" correctly. 
  106.  
  107. 5.  What do we charge for part #73241? 
  108.  
  109.        Pop up PC-Browse with your parts list, type in the part number, and you 
  110.        can look it up in a flash! It takes only a few seconds to look up any 
  111.        of thousands of parts. 
  112.  
  113. 6.  How do I add online help to an application or product designed without it? 
  114.  
  115.        You can create a PC-Browse file with an index of help topics on the 
  116.        first page. A user needing help just pops up PC-Browse, uses the arrow 
  117.        or tab keys to select a topic, and then jumps right to it. 
  118.  
  119. 7.  Could I do that with an online procedures manual? 
  120.  
  121.        Of course. You can use PC-Browse's cross-referencing feature 
  122.        (hypertext) to let users explore company procedures and decision-making 
  123.        policies in as much detail as necessary. 
  124.  
  125. We'll answer all seven of these questions in greater detail at the end of the 
  126. tutorial. 
  127.  
  128.  
  129. Finding, Viewing, and Pasting Text 
  130.  
  131. We suggest that you read this section at your computer, with PC-Browse and a 
  132. word processing program loaded. It takes only a few minutes to copy PC-Browse 
  133. to a disk and try out the dozen or so main commands. 
  134.  
  135.                    Press F10 To Go To the Table of Contents
  136.                     Press F4 to return to the previous view
  137.                               <Loading PC-Browse>
  138.  
  139. 1. If you haven't installed PC-Browse on your computer, just copy the 
  140.    following files from your PC-Browse Program diskette to a work disk (if you 
  141.    have a hard disk, put them in a new subdirectory such as \PCBR): 
  142.  
  143.  BR.EXE         ADDRESS           DECISION          HAMLET           QUARTO 
  144.  BR.HLP         AREACODE          GLOSSARY          MISUSED          SAILBOAT 
  145.  
  146. 2. Load PC-Browse from the DOS prompt by typing: 
  147.  
  148.       BR  <Enter> 
  149.  
  150.    If you have a full-color monitor, instead type: 
  151.  
  152.       BR /C  <Enter> 
  153.  
  154.    You'll see the copyright screen, and then the DOS prompt. 
  155.  
  156. 3. Now load your favorite word processor, and create a "scratch" file for 
  157. editing. 
  158.  
  159.    This file is only for practice, as you explore ways in which PC-Browse and 
  160.    other applications can communicate. With a hard disk, start your word 
  161.    processor from the PC-Browse subdirectory if possible (or else give the PC-
  162.    Browse subdirectory path whenever you enter PC-Browse file names during the 
  163.    tutorial). 
  164.  
  165. Remarks 
  166. Like most pop-up programs, PC-Browse works only with text-based programs such 
  167. as PC-Write, Word Perfect, WordStar, Microsoft Word in text mode, etc. PC-
  168. Browse won't pop up over Microsoft Word in graphics mode, other graphic 
  169. programs, or Windows. 
  170.  
  171.                    Press F10 To Go To the Table of Contents
  172.                     Press F4 to return to the previous view
  173.                              <Popping Up PC-Browse>
  174.  
  175. You should be in your word processor, editing a practice file. 
  176.  
  177. 1. Hold down the Shift and Ctrl keys, and press the F1 key. 
  178.  
  179.    We'll refer to this process as "Press Shf Ctl F1". This is the main hot key 
  180.    that pops-up PC-Browse "over" whatever program you're using. PC-Browse 
  181.    covers the top part of your screen. (If you need to change this hot key 
  182.    because another of your programs uses Shf Ctl F1, see the Customizing 
  183.    section.) The initial screen is: 
  184.  
  185.  ┌File:─────────────────────────────────────────Find:cursorword────────────┐
  186.  │                                                                         │
  187.  │                                                                         │
  188.  │                                                                         │
  189.  │                                                                         │
  190.  │                                                                         │
  191.  │                                                                         │
  192.  │                                                                         │
  193.  │                                                                         │
  194.  │                                                                         │
  195.  │                                                                         │
  196.  └Esc:Exit  F1:Help  F6:File  F9:Find──────────────────────────────────────┘
  197.  
  198. 2. To return to your application, simply press the Esc key. 
  199.  
  200.    Your word processor's screen is restored. Now press Shf Ctl F1 again to pop 
  201.    PC-Browse back up. 
  202.  
  203. The basic operation in PC-Browse is file viewing. You can view one file while 
  204. you're working in another. Even with a multiple-window word processor such as 
  205. PC-Write or Microsoft Word, it's easier to keep a file you're referring to in 
  206. PC-Browse and pop it up when you need it. If you're in Lotus 123 and need to 
  207. review the memo that describes your spreadsheet, PC-Browse may be the only way 
  208. to go. 
  209.  
  210.                    Press F10 To Go To the Table of Contents
  211.                     Press F4 to return to the previous view 
  212.                        <Viewing a File> with PC-Browse 
  213.  
  214. 1. Press F6 to select a file. 
  215.  
  216. 2. Type the file name "ADDRESS" and press the Enter key. 
  217.  
  218.    PC-Browse quickly loads the file and displays the first page. 
  219.  
  220. 3. Browse through the file by pressing the PgDn or PgUp keys. 
  221.  
  222.    These keys scroll the file one line at a time, within a page. To scroll 
  223.    faster, a whole window at a time and across pages, press Shf PgDn or Shf 
  224.    PgUp. If you reach the start or end of the file, PC-Browse beeps. Little 
  225.    triangles just above the lower right corner point up or down to show you 
  226.    which direction you can scroll. 
  227.  
  228. 4. Look at the major PC-Browse functions on the menu at the bottom of the 
  229.    window: 
  230.  
  231. │                                                                             │
  232. └ Esc:Exit  F1:Help  F4:Backtrack  F6:File  F7:Paste  F9:Find  F10:First-page─┘
  233.  
  234. 5. Press and hold the Shift key by itself to view another group of functions: 
  235.  
  236. │                                                                             │
  237. └ Esc:Unload         F4:View-Locations      F7:Print ─────────────PgUp/Dn:more┘
  238.  
  239.    Now you've seen both of the PC-Browse menus. This will be easy. There are a 
  240.    few more function key operations, not on these menus. You can use PC-Browse 
  241.    with an alternate pair of menus which show all function keys but with more 
  242.    abbreviated labels (see: Customizing). 
  243.  
  244. 6. Release the shift key to see the Main Menu again. 
  245.  
  246. 7. Press the F1 key to see on-line help. 
  247.  
  248.    You can use PgDn, Shf PgDn, and so on to browse through the help screens. 
  249.    When you're done, press the Esc key (or the F1 key) to return to PC-Browse. 
  250.  
  251. Let's search for Spencer Katt's address in this file. 
  252.  
  253.                    Press F10 To Go To the Table of Contents
  254.                     Press F4 to return to the previous view
  255.                           <Searching for Text> in One File 
  256.  
  257. 1. Press the F9 key to type the Find text. Type: 
  258.  
  259.       katt 
  260.  
  261.    The Find text is the text you're asking PC-Browse to search for. We're 
  262.    searching a single file, ADDRESS, as you can see on the top line of the 
  263.    window. 
  264.  
  265. 2. Press the Grey+ key to begin the search.  
  266.  
  267. You don't have to press the Enter key after typing the Find text. If you do 
  268. press Enter after typing the Find (or the File) text, either Grey+ or a second 
  269. Enter starts the search. The Grey+ key is the darker + key on the right side 
  270. of the keyboard. 
  271.  
  272. PC-Browse finds the right address immediately. Of course, this is a small 
  273. file, but it can search files quite rapidly, even on a basic PC or XT. Mr. 
  274. Katt's address is on the screen, and the word "Katt" is highlighted. 
  275.  
  276. What if this is not the Katt you're looking for? Press Grey+ or Enter to 
  277. continue the search. Since this is the only Katt in the ADDRESS file, PC-
  278. Browse will beep and tell you it couldn't find "katt". 
  279.  
  280. PC-Browse can interact with your host application in two ways. First, when you 
  281. pop it up, the word at the cursor (if any) automatically becomes the Find 
  282. text. Second, you can paste selected text directly into your application, just 
  283. as if you had typed it yourself. 
  284.  
  285. 3. Press Esc to return to your word processor. 
  286.  
  287. 4. Enter "Walton" on a line in your practice file. Leave the cursor just after 
  288.    the "n". 
  289.  
  290. 5. Try to remember the address.  Scratch your head, since you don't know it, 
  291.    unless you've done the Tutorial before! 
  292.  
  293. 6. Press Shf Ctl F1 to pop-up PC-Browse.  The Find text will be the name 
  294.    "walton". 
  295.  
  296. 7. Press Enter or Grey+ to search. PC-Browse finds "Walton" this time.  
  297.  
  298. Let's paste this address into your word-processing practice file. 
  299. See Pasting Text
  300.  
  301.                    Press F10 To Go To the Table of Contents
  302.                     Press F4 to return to the previous view
  303.                       <PASTING TEXT> INTO ANOTHER PROGRAM 
  304.  
  305. 1. Press Esc to return to your word processor, and put the cursor at a place 
  306.    in the document to insert the address. Press Shf Ctl F1 to pop-up PC-Browse 
  307.    again.  
  308.  
  309. 2. Press the F7 key. The Paste Menu appears: 
  310.  
  311. │                                                                            │
  312. └Esc:Cancel F4:Start marking  F5:Marked text  F6:File name  F7:Window F8:Page┘
  313.  
  314. 3. Use the Up and Down Arrow keys to move the cursor to the first line of the 
  315.    address. 
  316.  
  317. 4. Press the F4 key to start marking lines for pasting. 
  318.  
  319. 5. Use the Down Arrow key to extend the marked (highlighted) area through the 
  320.    last line of the address. 
  321.  
  322.    If you didn't start with the right line, simply move the cursor to the 
  323.    correct first line and press F4 again to restart the marking process. 
  324.  
  325. ┌File:address.sam───────────────────────────────Find:walton──────────────────┐
  326. │                                                                            │
  327. │Jack Walton                                                                 │
  328. │1139 73rd Place                                                             │
  329. │Seattle, WA                                                                 │
  330. │                                                                            │
  331. │                                                                            │
  332. │Victoria I. Warshawski                                                      │
  333. │Lake Front Drive                                                            │
  334. │Chicago, IL                                                                 │
  335. │                                                                            │
  336. └Esc:Cancel F4:Start marking  F5:Marked text  F6:File name  F7:Window F8:Page┘
  337.  
  338. 6. Press the F5 key to tell PC-Browse that you want to paste the marked lines. 
  339.  
  340.    PC-Browse asks when you want to paste the text: 
  341.    
  342. │                                                                            │
  343. └Esc:Cancel paste  F9:Paste now  F10:Paste when Paste-hotkey pressed─────────┘
  344.  
  345.    Your word-processor's cursor (since it's the host application, this cursor 
  346.    is not visible) was just after the "n" in "Walton", but you want to paste 
  347.    it to the line below. Press F10 to tell PC-Browse you will press the Shf 
  348.    Ctl F7 key to paste these lines into your application. (You could press F9 
  349.    to paste them after "Walton", and put it on the next line with your word 
  350.    processor.) Pressing F10 (or F9) returns to your word processor. 
  351.  
  352. 7. Move to the next line in your word processing file, make sure you're in 
  353.    "push" or "insert" mode, and press the Shf Ctl F7 hot key. The address is 
  354.    pasted into your file. 
  355.  
  356.    You can also print text if your printer is hooked up (Shf F7 on the Main 
  357.    Menu), or print text to a file (Shf F6 to set the file name, then Shf F7). 
  358.    See Printing and Pasting in the Reference section for more information. 
  359.  
  360. We knew where to look for Mr. Walton's address. What if we don't know what 
  361. file it's in? 
  362.  
  363.                    Press F10 To Go To the Table of Contents
  364.                     Press F4 to return to the previous view
  365.                              <SEARCHING MANY FILES>
  366.  
  367. Searching for Text in Many Files 
  368.                    
  369. 1. Press Shf Ctl F1 to pop-up PC-Browse again. 
  370.  
  371.    This time, we'll search the entire directory (or diskette) for references 
  372.    to "walton". 
  373.  
  374. 2. Press F6 to type a file name. Type *.* and press Enter.  
  375.  
  376.    The "*.*" says to search all files in the current directory. These are the 
  377.    same wild card characters you use with DOS. You could type "?." for all 
  378.    one-character file names or "*.doc" for files with .DOC extensions. Since 
  379.    we haven't specified a particular file and haven't told PC-Browse to search 
  380.    yet, no file is loaded into the PC-Browse window. 
  381.  
  382. 3. Press F9 to type the Find text. Type "walton" and press Grey+ to begin the 
  383.    search. 
  384.  
  385.    This multi-file search can present the results to you in two ways: showing 
  386.    you each file in turn, or showing you a list of files by name. Now PC-
  387.    Browse asks which you would like, with the following prompt: 
  388.  
  389. │                                                                            │ 
  390. └Esc:Cancel  F9:View each match as found  F10:Collect matches and list them──┘ 
  391.  
  392. 4. Press F9 to see each file containing "walton". 
  393.  
  394.    PC-Browse quickly loads and scans each file in turn, looking for the Find 
  395.    text. As it scans a file, it displays the file name at the top of the 
  396.    window. When it finds your text, it displays the file, highlighting the 
  397.    text found. If this is not the reference you were looking for, you could 
  398.    press Enter (or Grey+) again to keep searching. Don't do this quite yet, 
  399.    however. 
  400.  
  401. Before we move to the next section of the Tutorial, we'll describe two other 
  402. features  related to finding text, with suggestions for exploring these 
  403. features on your own. See Exploring on your own.
  404.  
  405.                    Press F10 To Go To the Table of Contents
  406.                     Press F4 to return to the previous view 
  407.                          <EXPLORING> ON YOUR OWN 
  408.  
  409. First, suppose you're not sure this is the "walton" you're looking for. You 
  410. could search for another with the Grey+ or Enter key, but how would you get 
  411. back to this one if you wanted to? PC-Browse offers two ways to do this. The 
  412. first method is to open another PC-Browse window. The second method uses the 
  413. automatic location list. 
  414.  
  415.                            TO OPEN ANOTHER WINDOW
  416.  
  417. 1. Press F2 to Open another window. 
  418.  
  419.    There's room on your screen for two windows (you can set this; see 
  420.    Customizing). PC-Browse copies the current window to the bottom half of the 
  421.    screen, and all activity now occurs in this lower window. The uppper window 
  422.    is "frozen" for now. 
  423.  
  424. 2. Press Enter (or Grey+) to search again in the new window. 
  425.  
  426.    PC-Browse first saves your place (location) in a list. In a few seconds 
  427.    you'll find another reference to "walton". Let's return to the first 
  428.    "walton" you found. 
  429.  
  430. 3. Press F4 to return to the previous location. 
  431.  
  432.    Even if that reference was in a different file, PC-Browse quickly switches 
  433.    back to the first one. It saves your "trail" back to where you started, if 
  434.    it can. When the list gets too long (about ten levels by default) it only 
  435.    saves the most recent locations. 
  436.  
  437. 4. Return to the upper window by pressing Shf F2. 
  438.  
  439.    This closes the lower window. The original text returns to the lower part 
  440.    of the screen. 
  441.  
  442.                               THE LOCATION LIST
  443.  
  444. What if you want to search your entire hard disk for "walton"?  
  445.  
  446. 5. Press F6, type "\*\*.*", and press Enter. 
  447.  
  448.    The "\*\" represents all directories on the disk. We've extended the DOS 
  449.    asterisk convention a bit. Just as "\brs\*.*" tells PC-Browse to search all 
  450.    files in the BRS directory, "\*\*.*" tells PC-Browse to search all files in 
  451.    all directories. 
  452.  
  453.    Press Enter again to start the search. You can also press Grey+ right after 
  454.    typing the File text to start searching immediately. Since the PC-Browse 
  455.    directory, if you created one, is one of the last directories, it may take 
  456.    a while to reach the ADDRESS file. 
  457.  
  458.    PC-Browse asks if you want to see each file containing the search text, or 
  459.    see a list of all such files. If you have more than one disk drive, you can 
  460.    also search multiple drives. For example, "ce:\*\*.*" searches both drives 
  461.    C and E. 
  462.  
  463.                    Press F10 To Go To the Table of Contents
  464.                     Press F4 to return to the previous view
  465.                        USING <PC-BROWSE APPLICATIONS> 
  466.  
  467. PC-Browse comes with a number of sample applications. Some are useful on their 
  468. own; others simply help you explore the various tools of the PC-Browse Swiss 
  469. Army Knife. 
  470.  
  471. We'll start with two "real" applications that you may find useful (see the 
  472. files Areacode and Misused). Then we'll use some of the "demonstration" files
  473. to explore more features, such as hypertext (see the files Hamlet and Sailboat) 
  474. Finally, we'll look more closely at these files so you can learn how to design 
  475. your own applications (see Developing your own PC-Browse Applications). 
  476.  
  477.                    Press F10 To Go To the Table of Contents
  478.                     Press F4 to return to the previous view
  479.                                  <AREACODE>
  480.  
  481. 1. If you haven't already loaded PC-Browse and then your word processor, 
  482.    please do so. Make sure you have a practice file loaded in your word 
  483.    processor. 
  484.  
  485. 2. Pop-up PC-Browse by pressing Shf Ctl F1. 
  486.  
  487. 3. Press F6, type the file name AREACODE, then press Enter. 
  488.  
  489. 4. Press Ctl PgDn and Ctl PgUp to browse through the file page by page. 
  490.  
  491.    Each page has an area code, the state and time zone for that area code, and 
  492.    a list of the major cities in that area. Since this file (like most PC-
  493.    Browse oriented files) is divided into pages, you can look through it 
  494.    quickly with Ctl PgDn. In this file each page  is shorter than the window, 
  495.    but that's not always the case. (You can look at a longer page with the 
  496.    scrolling keys PgUp and PgDn, but they don't skip across pages like the Ctl 
  497.    PgUp and Ctl PgDn keys.) 
  498.  
  499. What's the area code for El Paso?  We need to find El Paso in the AREACODE 
  500. file. 
  501.  
  502. Finding an Area Code for a City 
  503.  
  504. 1. Press F9 and then type "El Paso". 
  505.  
  506.    Previously, we used Grey+ to start a search. However, it searches from your 
  507.    current position in the file to the end. Since you may be in the middle of 
  508.    this file, we need to search from the top. 
  509.  
  510. 2. Press F10 or Shf Grey+ from the Find prompt to search from the start of the 
  511.    file. 
  512.  
  513.    PC-Browse finds El Paso and highlights it. Since the 915 area code covers 
  514.    two time zones, El Paso is noted specifically as being on Mountain Time. 
  515.  
  516. ┌File:areacode──────────────────────────────────Find:El Paso─────────────────┐
  517. │915                                                                         │
  518. │Texas <TX> (CST/MST)                                                        │
  519. │Abilene (CST), El Paso (MST), Midland  (CST), Odessa  (CST)                 │
  520. │San Angelo  (CST), Sweetwater (CST)                                         │
  521. │                                                                            │
  522. │                                                                            │
  523. │                                                                            │
  524. │                                                                            │
  525. │                                                                            │
  526. └ Esc:Exit  F1:Help  F4:Backtrack  F6:File  F7:Paste  F9:Find  F10:First-page┘
  527.  
  528.    Let's try a harder city to spell, such as Hamtramck (near Detroit). 
  529.    Luckily, we don't have to spell the whole word. 
  530.  
  531. 3. Press F9, type "hamt", then press F10 to search from the beginning. 
  532.  
  533.    PC-Browse finds whatever text you type; you're not limited to whole words. 
  534.    You can also use PC-Browse wild cards in the Find text, as described in the 
  535.    Reference section under Using Wild Cards in a Search. 
  536.  
  537.    Note that a city in this area code, Warren, has the same name as a city in 
  538.    another state. The city name is followed by a cross-reference to this other 
  539.    state, with the state abbreviation in a different color (depending on your 
  540.    monitor type). 
  541.  
  542. 4. Press Tab to highlight the cross-reference (to Ohio). 
  543.  
  544.    The Find text changes to the text you highlighted, surrounded by a pair of 
  545.    "funny characters." These characters indicate a cross-reference, or 
  546.    hypertext link. 
  547.  
  548. 5. The Find text is now "oh". Press Enter to search for it. 
  549.  
  550.    PC-Browse finds the first page in the file with OH as the "page title." You 
  551.    can now check the area code for Warren, OH rather than Warren, MI. 
  552.  
  553. Automatic cross-referencing is the heart of the hypertext concept. You select 
  554. text that is specially marked, and then at the press of a key you're whisked 
  555. off to the material referenced by that text. 
  556.  
  557. In PC-Browse terminology, the "OH" that you tabbed to is called the trigger 
  558. keyword, because it can trigger a search for other material. When you pressed 
  559. Enter, PC-Browse jumped to the target keyword of that search, the <OH> on the 
  560. Ohio page. This type of searching is called keyword searching. 
  561.  
  562. 6. Press F4 to return to the page you started the cross-reference from. 
  563.  
  564.    As you jump around a cross-referenced document or group of documents, 
  565.    pursuing ideas and connections, you can always work your way back up the 
  566.    trail you followed. 
  567.  
  568.                    Press F10 To Go To the Table of Contents
  569.                     Press F4 to return to the previous view
  570.                                 <MISUSED>
  571.  
  572. Checking a Commonly Misused Word 
  573.  
  574. 1. Press F6, type the PC-Browse application file name MISUSED, then press 
  575.    Enter. 
  576.  
  577.    This file contains about 100 often misused words, listed in an index in the 
  578.    first page. Each word in this list is the trigger to a page of information 
  579.    about correct and incorrect usage of the word. To get back to this first 
  580.    page at any time, press F10 (or Shf Grey+). 
  581.  
  582. 2. Use Tab and Shf Tab to select words. The Find text reflects each selection. 
  583.  
  584.    Since this list is arranged as a table, you can also use the four Arrow 
  585.    (cursor) keys to move about it. When the trigger words are not in nicely 
  586.    lined-up rows and columns, only Tab and Shf Tab select them. 
  587.  
  588. Let's assume you're writing about Swiss Army Knives and "Their Affect on 
  589. Software Utilities". Should you use "Effect" instead? 
  590.  
  591. 3. Select (with Tab or Arrows) affect (or effect) and press Enter. 
  592.  
  593.    PC-Browse displays a page of information about the use of the words 
  594.    "affect" and "effect". A little reading, and you discover that the correct 
  595.    word here is "effect." 
  596.  
  597. You can also conduct a keyword search by typing in a word directly. 
  598.  
  599. 4. Press F9, type alter, and then (instead of pressing Enter) press F3. This 
  600.    converts the Find text to a trigger keyword and does a keyword search from 
  601.    the start of the file. 
  602.  
  603. Of course, that's a lot of keys to check one word. Now let's see how to call 
  604. PC-Browse directly from your application and check a word with just one 
  605. keystroke. 
  606.  
  607. 5. Press Esc to return to your word processing practice file. 
  608.  
  609.    Assume that you're typing along when you're confronted by the devastating 
  610.    question of using "it's" or "its" in a sentence. You could pop up PC-
  611.    Browse, press F9, type the word, and press F3, or you could pop up PC-
  612.    Browse, point to "its" in the index at the start of the file, and press 
  613.    Enter. But there's an easier way. 
  614.  
  615.    
  616. 6. Type its (or it's) in your word processing practice file. With the cursor 
  617.    still on or just after the word, press Shf Ctl F3. 
  618.  
  619.    PC-Browse pops up and automatically jumps to the page where "its" and 
  620.    "it's" are discussed. The Shf Ctl F3 hot key is simply a shortcut to look 
  621.    something up from your word processor or other program. 
  622.  
  623.                    Press F10 To Go To the Table of Contents
  624.                     Press F4 to return to the previous view
  625.                                   <HAMLET>
  626.  
  627. More Advanced Applications 
  628.  
  629. From here on, the Tutorial is addressed to users who might want to create 
  630. their own PC-Browse files, whether for their own use or for use by others. If 
  631. this doesn't describe you, here's a good point to leave the Tutorial and 
  632. simply begin using PC-Browse. As you work further with the program, feel free 
  633. to turn to the Reference section of the manual to learn more about the 
  634. features we've introduced here. 
  635.                                                      
  636.   "Hyper-Documents" That Span More Than One File 
  637.  
  638. 1. Load the sample PC-Browse file HAMLET. Use the Tab key to mark the trigger 
  639.    keyword "To be..." on the first page, and then press Enter to link to the 
  640.    famous speech. 
  641.  
  642.    This file contains a heavily annotated version of the most famous passage 
  643.    in English-language theatre. Normally when you read Shakespeare, the 
  644.    footnotes are distracting, pulling your eye to the bottom of the page and 
  645.    making it hard to concentrate. Most notes contain only simple definitions 
  646.    of obscure words; notes about the content refer to essays at the back of 
  647.    the book, so you have to flip back and forth. 
  648.  
  649.    Hypertext solves these problems. HAMLET is simply a neutral example of some 
  650.    heavily cross-referenced material. It could be a procedures manual or 
  651.    employee handbook, on-line help specific to a Lotus payroll application, or 
  652.    a genealogy record. 
  653.  
  654. 2. Use Shf PgDn to browse through the speech a bit. When you're done, use Shf 
  655.    Grey+ or F10 to return to the first page, and then Tab to the reference 
  656.    "Quarto Text". 
  657.  
  658.    The so-called First Quarto is the first published version of Shakespeare's 
  659.    Hamlet; it's different, to say the least. Note the word (a file name) in 
  660.    brackets after the reference. This means the cross-reference is in another 
  661.    file. The Find text doesn't show the other file name, but PC-Browse keeps 
  662.    track of it. 
  663.  
  664. ┌File:hamlet────────────────────────────────────Find:≡Quarto TextΩ───────────┐
  665. │of the play.                                                                │
  666. │                                                                            │
  667. │    The text given here of "To be, or not to be" is from the First Folio;   │
  668. │the few significant differences from the later Quartos are noted in the     │
  669. │cross-references.                                                           │
  670. │                                                                            │
  671. │    This famous speech also exists in the First Quarto in a much different  │
  672. │form (see Quarto Text [quarto] for comparison.)                             │
  673. │                                                                            │
  674. │                     (Press F4 to return to previous view)                  │
  675. │                                                                            │
  676. └ Esc:Exit  F1:Help  F4:Backtrack  F6:File  F7:Paste  F9:Find  F10:First-page┘
  677.  
  678. 3. Press Enter to find the target of the cross-reference "Quarto Text". 
  679.  
  680.    PC-Browse automatically switches files. The file name on the top line 
  681.    changes. 
  682.  
  683. 4. Tab to the "To be..." trigger, then press Enter to view this speech as it 
  684.    appeared in 1602. Now Tab to the note on "Marry" to the right of the text. 
  685.  
  686.    The "Marry" trigger also cross-references to another file, but here you 
  687.    can't see the file name. When you build a PC-Browse file, you decide 
  688.    whether a cross-reference shows the file name or not. Here it would have 
  689.    been distracting. In fact, we could have made "marry" in the text itself 
  690.    the trigger, once again hiding the file name. 
  691.  
  692. 5. Press Enter to follow the "Marry" cross-reference into the GLOSSARY file. 
  693.  
  694. 6. Press F4 a few times, backtracking along your reference trail and 
  695.    eventually returning to the HAMLET file. 
  696.  
  697.    If you did some exploring already, the location list may have filled up, so 
  698.    you may not get all the way back. Explore this file on your own, tracing 
  699.    some of the cross-reference trails between the different files. 
  700.  
  701.                    Press F10 To Go To the Table of Contents
  702.                     Press F4 to return to the previous view
  703.                                    <SAILBOAT>
  704.  
  705. "Hyper-Fast" Searching with Lookup Trigger Keywords 
  706.  
  707. So far in this Tutorial, we've been looking at normal text searching and one 
  708. type of PC-Browse keyword search, linear keyword searching. Here we'll look at 
  709. the other type of keyword search, <lookup keyword search>ing. 
  710.  
  711. A <lookup search> is extremely fast; it can search a two megabyte file in under 
  712. 2 seconds on a PC AT. A file designed for lookup searching has several special 
  713. requirements:  the keywords must be unique, and the pages in the file must be 
  714. sorted by keyword. Lookup files are usually created from a database program. 
  715. Common uses include parts lists, customer names, and so on. 
  716.  
  717. 1. Load the PC-Browse file SAILBOAT. 
  718.  
  719.    We have a customer who ordered part 9047; we need to know how much it 
  720.    costs. 
  721.  
  722. 2. Press F9 and type "9047" as the Find text. Press F2 to do a lookup search. 
  723.  
  724.    PC-Browse places special characters around the Find text to turn it into a 
  725.    lookup trigger. A lookup search isn't noticeably faster on a short file 
  726.    such as SAILBOAT. By the time your parts file grows to 100K or so, the 
  727.    speed difference will be obvious. 
  728.  
  729.    Cross-references within the file can also trigger a lookup search. There's 
  730.    one for the part we're looking at, a "Barberhauler Bullet Block w/Becket." 
  731.    It's actually the special trigger characters, not the F2 or F3 key, that 
  732.    indicate a lookup search is appropriate. This parts list is designed for 
  733.    lookup by part number, but it could have used a part name instead. Your 
  734.    database program can create a lookup file for each case. 
  735.  
  736.    You could also search for a part by pressing F9, typing the part number, 
  737.    and pressing F3 to do a linear keyword search. This would not search as 
  738.    quickly, however. You could even press F9, type the part number, and press 
  739.    Grey+ to just search for the number as normal text. This is as slow as a 
  740.    linear search, and it would also find the same number within a phone number 
  741.    or address, not just as a part number. 
  742.  
  743. As you see, from the user's perspective lookup keyword searching is almost the 
  744. same as linear keyword searching. The differences are internal, within the 
  745. file. In the next section, we'll examine these differences. 
  746.  
  747.                    Press F10 To Go To the Table of Contents
  748.                     Press F4 to return to the previous view
  749.                 <Developing Your Own> PC-Browse Applications 
  750.  
  751. In this last section, we'll see how PC-Browse files are created by examining 
  752. them "side-by-side" in your word processor and in PC-Browse. 
  753.  
  754. To follow along in this section, you'll need a word processor that can display 
  755. the ASCII characters between 1 and 31, often called control codes. PC-Write is 
  756. ideal; however, the non-document mode of WordStar also works, as well as 
  757. WordPerfect, Microsoft Word, and most other word processors in their "no-
  758. format" modes. You can build PC-Browse files with any word processor or editor 
  759. that can produce ASCII text; you don't have to use control codes. The files 
  760. we'll examine were built using these control codes. PC-Browse files that use 
  761. control codes are cleaner looking, since the control codes are invisible. 
  762.  
  763.                    Press F10 To Go To the Table of Contents
  764.                     Press F4 to return to the previous view                                                     
  765.                      A <SIMPLE PC-BROWSE FILE>: AREACODE 
  766.  
  767. 1. If you haven't already loaded PC-Browse and then your word processor, 
  768. please do so. 
  769.  
  770.  
  771.    Follow the instructions in the first part of this Tutorial, under Loading 
  772.    PC-Browse. 
  773.  
  774.    
  775. 2. Load the file AREACODE into your word processor. Pop up PC-Browse (Shf Ctl 
  776.    F1) and then press F6 to load AREACODE there, too. 
  777.  
  778.    Some word processors may keep a file open, preventing other programs from 
  779.    using it. PC-Browse loads a file in read-only mode, but your word processor 
  780.    may still have it locked out. In this case, return to DOS and make copies 
  781.    of the files AREACODE, MISUSED, HAMLET, and SAILBOAT under alternate names. 
  782.    Now you can look at one copy of the file in your word processor and another 
  783.    copy in PC-Browse. 
  784.  
  785. 3. Press Esc from PC-Browse to return to your word processor. Note the form 
  786.    feeds separating each PC-Browse page.
  787.  
  788.    Information in a PC-Browse file should be divided into "bite-sized" nuggets 
  789.    for easy digestion by users. PC-Browse can handle pages of any size, but 5 
  790.    to 20 lines, or one window full, is a good size for most application pages. 
  791.    Consider breaking up longer material into two or more pages, connected with 
  792.    hypertext links. 
  793.  
  794. 4. In your word processor, go to the first line of the file and scroll 
  795.    horizontally to the end (In PC-Write, press End. In WordStar, press Ctrl-Q 
  796.    D.) Note the material in brackets that begins [BR=. 
  797.  
  798.    The text in brackets defines the file characteristics for PC-Browse. It 
  799.    looks for [BR= when it loads a file, in the first 160 characters of the 
  800.    first line. We place it out beyond character 80 in our files so that it 
  801.    doesn't show up on the screen and confuse users. The /I, /J, and /K 
  802.    parameters define the characters that delimit trigger and target keywords 
  803.    in this file. 
  804.  
  805.    The /I part gives the first and last character of a target keyword. The 
  806.    target keyword is the text sought during a keyword search (either a linear 
  807.    search or a lookup search). The /I:60.62 says a target keyword is any text 
  808.    that begins with character 60 ( < ) and ends with character 62 ( > ). These 
  809.    characters are called Delimiters. Note the "<NJ>" on the second line of the 
  810.    file; since it's surrounded by angle brackets, "NJ" is a target in this 
  811.    file. The target delimiters can be different in each application; that's 
  812.    why there can be a [BR=  line in each application file. 
  813.  
  814.    
  815.    The /J part gives the delimiters for a linear search-trigger keyword. Here, 
  816.    /J:2.2 says that a linear trigger is any text with a character 2 on both 
  817.    sides of it. (In PC-Write, this appears as <Alt B>; in WordStar, as "^B".) 
  818.    On the fifth line of the file, note the two cross-references, "DE" and 
  819.    "OH", surrounded by these symbols. PC-Browse does not display characters 
  820.    whose ASCII value is less than 32. Therefore they make ideal characters to 
  821.    use for delimiting keywords, since they don't interfere with the text. 
  822.  
  823.    The /K part would give the delimiter for a lookup search-trigger keyword. 
  824.    Here, /K is undefined, since this file isn't designed for lookup searching. 
  825.  
  826.    The various keyword delimiters highlight their keyword on screen. 
  827.    Characters less than 32 that aren't used as delimiters also highlight text 
  828.    on the screen, making them valuable for emphasizing words. You can control 
  829.    both kinds of highlighting (see Customizing). You'll see an example of this 
  830.    when we look at MISUSED. 
  831.  
  832. 5. Pop up PC-Browse to see how this file appears in a PC-Browse window. 
  833.  
  834.    Skip back and forth through the file in PC-Browse and in your word 
  835.    processor to see how it looks in PC-Browse and what's really in the file. 
  836.  
  837.                    Press F10 To Go To the Table of Contents
  838.                     Press F4 to return to the previous view                                                     
  839.                      PC-BROWSE <INDEX PAGE>: MISUSED 
  840.  
  841. 1. Load the file MISUSED into your word processor. Pop up PC-Browse and load 
  842.    MISUSED there, too. In your word processor, find [BR= on the first line of 
  843.    the file. 
  844.  
  845.    The target and trigger keyword delimiters are different here from those 
  846.    used in AREACODE. Also, neither the target nor the trigger delimiters for 
  847.    this file are visible in PC-Browse, because both are less than 32. 
  848.  
  849. 2. Scroll your word processor file down about 20 lines until you come to the 
  850.    page titled "ACCEPT versus EXCEPT". Pop up PC-Browse and press Ctl PgDn 
  851.    from the first page to find this page, too; then press Esc to return to the 
  852.    word processor. 
  853.  
  854.    This page has target keyword delimiters around ACCEPT and EXCEPT at the top 
  855.    as well as general-emphasis "font" characters around the words as used in a 
  856.    sentence. The in-sentence words are neither triggers nor targets; they are 
  857.    just emphasized with the PC-Write bold font, character 2. Some monitors 
  858.    show this emphasis highlighting better than others; pop up PC-Browse 
  859.    briefly to see how it appears on yours. 
  860.  
  861.    Don't be confused by the fact that we used character 2 as a trigger keyword 
  862.    delimiter in the file AREACODE. Each PC-Browse file can have the same 
  863.    delimiters, or every file can use different ones. You can develop a style 
  864.    and stick to it for your applications; we've mixed and matched in ours for 
  865.    demonstration purposes. 
  866.  
  867. 3. Return to the start of the file in both PC-Browse and your word processor. 
  868.    In PC-Browse, all of the columns line up; in PC-Write and some other word 
  869.    processors, they also line up. 
  870.  
  871. The trigger keywords must line up in columns to be selected in PC-Browse with 
  872. the up and down Arrow keys as well as the Tab key. If there is an index page, 
  873. it is normally the first page of the file, but a row-and-column index works on 
  874. any page. 
  875.  
  876.                    Press F10 To Go To the Table of Contents
  877.                     Press F4 to return to the previous view                                                     
  878.                   <CROSS-REFERENCES> TO OTHER FILES: HAMLET 
  879.  
  880. 1. Load HAMLET into your word processor. Pop up PC-Browse and load HAMLET 
  881.    there, too. In your word processor, find the [BR= in the first line. 
  882.  
  883.    This file uses visible delimiters for target keywords (characters 60 and 
  884.    62, the angle brackets) and hidden delimiters for the linear trigger 
  885.    keywords (characters 22 and 20). 
  886.  
  887.    
  888. 2. In your word processor, look at the third paragraph. Note that the trigger 
  889.    keyword "Quarto Text" is followed by a word in brackets. 
  890.  
  891.    The word in brackets is the name of the file that will be loaded and 
  892.    searched when the user Tabs to this trigger and presses Enter to follow the 
  893.    link. 
  894.  
  895.    This cross-reference file name in brackets is visible in PC-Browse. Pop up 
  896.    PC-Browse to confirm this. A bracketed file name must follow the trigger 
  897.    immediately (one space between them is allowed, to keep the screen from 
  898.    looking cluttered). 
  899.  
  900. 3. In your word processor, scroll down about 30 lines to the middle of the 
  901.    soliloquy. Find the trigger keyword "Rub" followed by a word in braces. 
  902.  
  903.    This is also the name of the file to load when the user Tabs to this 
  904.    trigger and presses Enter. Because the file name starts with a question 
  905.    mark, it is invisible in PC-Browse. Pop up PC-Browse to confirm this. 
  906.  
  907. 4. The triggers in parentheses to the right of the soliloquy may not line up 
  908.    in your word processor. Pop up PC-Browse briefly and press Shf PgDn to 
  909.    reach this part of the file; confirm that they are aligned in PC-Browse. 
  910.  
  911.    PC-Write font characters (values 0 to 31) are not displayed in PC-Browse; 
  912.    therefore, they're ignored in counting column positions for alignment. The 
  913.    line with the "Rub" note also has a trigger in the text of the soliloquy. 
  914.    Therefore the "Rub" note may appear to the right of the "Coil" note a few 
  915.    lines below in your word processor, since there are no other triggers on 
  916.    the "Coil" line. 
  917.  
  918.                    Press F10 To Go To the Table of Contents
  919.                     Press F4 to return to the previous view
  920.                       <LOOKUP-SEARCH FILES>: SAILBOAT 
  921.  
  922. 1. Load the file SAILBOAT into your word processor. Pop up PC-Browse and load 
  923.    SAILBOAT there, too. In your word processor, find the "[BR=" text. 
  924.  
  925.    This file uses a visible start-delimiter for targets (character 35, " # ") 
  926.    and hidden delimiters for the lookup triggers (characters 22 and 20). This 
  927.    time there is no linear search-trigger, only a lookup search-trigger. 
  928.  
  929.    The end-delimiter for target keywords in this file, character 8, has a 
  930.    special meaning to PC-Browse. It indicates that a target keyword is ended 
  931.    by any character that is not a letter or a number. So in this file any 
  932.    space, end-of-line, or other non-letter-or-number after the word or number 
  933.    marks the end of the target. In this file, the ending delimiter is usually 
  934.    the end-of-line. 
  935.  
  936.    Here, too, character 2 is used for emphasis on part names and prices. 
  937.  
  938. 2. Look at the second page of this file (part #1012, the shroud pin). 
  939.  
  940.    In a lookup file, each page must contain exactly one target (1012 on this 
  941.    page). It can contain any other information you wish. The targets must also 
  942.    appear in ASCII-sort order (basically alphabetical, with numbers sorting 
  943.    ahead of letters). It is this ordering that makes lookup searching so fast 
  944.    even on huge files. 
  945.  
  946. Summary 
  947.  
  948. That's your guided tour of PC-Browse features. There are a number of features 
  949. we haven't covered, such as more Hot Key shortcuts, search wild cards, 
  950. printing information, and the many customization options. 
  951.  
  952. We started this Tutorial by asking a series of seven questions in the section 
  953. "What does PC-Browse Do". Now we'll give the specific answers: 
  954.  
  955. 1. How can I find the memo on restructuring I wrote 6 months ago? 
  956.  
  957.    Pop up PC-Browse, press F6, type "\*\*.*", and press Enter. Then press F9, 
  958.    type "restruc", and press Grey+ then F9. If it's on your disk, PC-Browse 
  959.    will find it. 
  960.  
  961. 2. What's Mr. Walton's address? 
  962.  
  963.   
  964.    Put the cursor on "Walton" in your word processor. Pop-up PC-Browse, press 
  965.    F6, and load the ADDRESS file. Press Enter or Grey+ to find the address. To 
  966.    paste in the address, press F7, move to the first line of the address, 
  967.    press F4, move to the last line, press F5, and then press F9. 
  968.  
  969.     
  970. 3. What's the area code for El Paso? 
  971.  
  972.    Pop up PC-Browse and press F6 to load the AREACODE application. Then press 
  973.    F9, type  "El Paso", and press Grey+. 
  974.  
  975.     
  976. 4. Is it correct to say, "What's the affect of this decision?" 
  977.  
  978.    Put the cursor on "affect", pop up PC-Browse, press F6, and load the 
  979.    application MISUSED; then press F9, then F3. Read the text of the page PC-
  980.    Browse displays. 
  981.  
  982.     
  983. 5. What do we charge for part #9054? 
  984.  
  985.    Load the SAILBOAT file, press F9, type "9054", and press F2 to do a lookup 
  986.    search for the part number. 
  987.  
  988. 6. How do I add online help to an application or product designed without it? 
  989.  
  990.    Cannibalize a copy of the MISUSED application. Build a table of contents of 
  991.    all the terms you think users might look under; set them up as keyword 
  992.    triggers to help-text pages, as they are in MISUSED. Even if a specific 
  993.    term isn't in the table, users can search for it by typing it at the Find 
  994.    prompt and pressing Enter. You could even build a series of sub-indexes; 
  995.    certain terms in the table of contents could link to another table with 
  996.    additional choices. 
  997.  
  998.    
  999. 7. Could I do that with an online procedures manual or decision tree? 
  1000.  
  1001.    Adapt the sample DECISION file, "What To Do on the Weekend". This is a 
  1002.    computerized decision tree for deciding what to do on a weekend in Seattle. 
  1003.  
  1004. 8. Explore PC-Browse on your own. Modify our sample files to see how they 
  1005.    work. Experiment. 
  1006.  
  1007.    What do you mean, there wasn't a Question 8? Life always gives you a 
  1008.    Question 8 -- "Where do I go from here?" 
  1009.  
  1010.                    Press F10 To Go To the Table of Contents
  1011.                     Press F4 to return to the previous view
  1012.  
  1013.