home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 02a / pc_brow2.zip / BR4.DOC < prev    next >
Text File  |  1989-09-29  |  47KB  |  1,062 lines
  1.     Customizing
  2.  
  3.     You customize PC-Browse by defining parameters. There are two types of
  4.     parameters: File Load Parameters and Startup Parameters. This section
  5.     includes:
  6.  
  7.     *  Descriptions of the parameters
  8.     *  Places you can define parameters
  9.  
  10.  
  11.     Descriptions of the Parameters
  12.  
  13.     Each parameter controls one PC-Browse feature. You only need to define
  14.     a parameter if the default setting of the feature does not fit your
  15.     needs. A parameter consists of:
  16.  
  17.     *  The switch character, "/" (slash)
  18.     *  The letter or number that represents the parameter
  19.     *  A colon (optional)
  20.     *  One or more letters or numbers, separated by periods.
  21.  
  22.     You can put spaces between parameters, but not within a parameter. Here
  23.     are some examples of parameters:
  24.        /A:N.A
  25.        /I:60.62
  26.        /W:7
  27.  
  28.     You can omit any options you don't need in parameters with several
  29.     options. For example, /A:N.N.A  could be written as  /A:..A  since N is
  30.     the default setting.
  31.  
  32.     In each description below, the first line shows the parameter with its
  33.     default value.
  34.  
  35.  
  36.     File Load Parameters
  37.  
  38.     File load parameters define the window length, keyword delimiters,
  39.     print and paste options, and screen colors for a file. You can include
  40.     file load parameters directly in each PC-Browse file. Then, when you
  41.     load a file, it uses the specific parameters for that file. They can
  42.     also be given as startup parameters when you first load PC-Browse.
  43.  
  44.     File load parameters in one file can be defined differently from those
  45.     in the next file. Once the parameter is defined it remains active until
  46.     you load another file that actually changes it (loading a new file per
  47.     se doesn't reset parameters to their default settings).
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                                       - 77 - 
  54.     Window Length Parameter
  55.  
  56.     /W:13
  57.        Sets the number of lines in the PC-Browse window, and therefore how
  58.        many windows can fit on the screen (this is also affected by the
  59.        screen length, parameter Y).  The default of 13 lines allows for two
  60.        windows. The minimum total length is three lines, and the maximum is
  61.        the number of lines on the screen (25, or as set by parameter Y).
  62.        The maximum number of windows is limited for small /W: values, as
  63.        shown below.  Here are some possible choices for a 25 line screen:
  64.  
  65.        /W:13  2 windows of 11 lines  /W:5  5 windows of 3 lines
  66.        /W:9   3 windows of 7 lines   /W:4  6 windows of 2 lines
  67.        /W:7   4 windows of 5 lines   /W:3  8 windows of 1 line
  68.  
  69.     Keyword Delimiter Parameters
  70.  
  71.     Delimiters are the symbols that define text as a target keyword, lookup
  72.     trigger keyword, or linear trigger keyword. A delimiter can be any one
  73.     character, empty (no such keyword defined), or a "non-alpha" code that
  74.     matches any space or character that is not a letter (A to Z, a to z) or
  75.     digit (0 to 9). Characters are defined by their character codes. The
  76.     empty delimiter is code 0; non-alpha is code 8. By default, all
  77.     delimiters are zero, so no keywords are defined. Codes 10, 11, 12, and
  78.     13 cannot be delimiters, except 12 (page break) can be used as a start
  79.     delimiter if the keyword is always the first thing on a page. The
  80.     parameter value is the starting and ending delimiter, separated by a
  81.     period.
  82.  
  83.     /I:0.0
  84.        Defines the target keyword delimiters. There is only one kind of
  85.        target keyword, whether you are doing a linear search or a lookup
  86.        search. To use a lookup search, the two delimiters must be
  87.        different. For example:
  88.  
  89.        /I:60.62      Starting delimiter is "<"; ending delimiter is ">".
  90.  
  91.     /J:0.0
  92.        Defines the linear search-trigger keyword delimiters. Using the
  93.        linear trigger and target keyword allows you to link related text
  94.        for easy retrieval. For example:
  95.  
  96.        /J:47.8       Starting delimiter is " / "; ending is any non-alpha.
  97.  
  98.     /K:0.0
  99.        Defines the lookup search-trigger delimiters. A lookup is a fast
  100.        search of sorted pages. A lookup trigger can also be included in the
  101.        file for linking text. For example:
  102.  
  103.        /K:35.8       Starting delimiter is "#"; ending is any non-alpha.
  104.  
  105.  
  106.                                       - 78 - 
  107.     Print and Paste Parameters
  108.  
  109.     /G:P.P.0
  110.        For printing, tells whether or not to include PC-Write font
  111.        characters, whether to include a final form feed, and what
  112.        end-of-line character to use.
  113.  
  114.        /G:A.x.x      Always print font characters.
  115.        /G:N.x.x      Never print font characters.
  116.        /G:P.x.x      Prompt each time to ask user about font characters
  117.                      (default).
  118.  
  119.        Printing font characters (most codes from 1 to 31) is different than
  120.        printing the text in the font style. Normally you would only include
  121.        font characters if you were printing to a file to be used with
  122.        PC-Write, or a file with embedded printer codes.
  123.  
  124.        /G:x.A.x      Always send a form feed after each print request.
  125.        /G:x.N.x      Never send a form feed after the print request.
  126.        /G:x.P.x      Prompt the user after each print request (default).
  127.  
  128.        For some kinds of files, you may always or never want the form feed.
  129.  
  130.        /G:x.x.13     Sets end-of-line character to carriage return only.
  131.        /G:x.x.32     Sets end-of-line character to a space.
  132.  
  133.        By default, PC-Browse sends a carriage return and line feed to the
  134.        printer at the end of each line. You may want to change this because
  135.        of the way your printer works.
  136.  
  137.     /H:P.N.0
  138.        For pasting, tells whether or not to include PC-Write font
  139.        characters, whether to include a "piping delay", and what
  140.        end-of-line character to use.
  141.  
  142.        /H:A.x.x      Always paste font characters.
  143.        /H:N.x.x      Never paste font characters.
  144.        /H:P.x.x      Prompt each time to ask user about pasting font
  145.                      characters (default).
  146.  
  147.        Normally, you only include font characters (codes 1 to 31) when you
  148.        paste PC-Write text from one file to another.
  149.  
  150.        /H:x.A.x      Always include the piping delay.
  151.        /H:x.N.x      Never include the piping delay (default).
  152.        /H:x.P.x      Prompt each time to ask user about including the
  153.                      piping delay.
  154.  
  155.        The piping delay makes PC-Browse wait until the second request for
  156.        each key from the host program when pasting. This fixes pasting into
  157.        PC-Write versions up to 3.02, and some other programs. PC-Write
  158.  
  159.                                       - 79 - 
  160.        versions 3.03 and up, and PC-Write Lite, work with or without it.
  161.        Some programs work without the delay, but hang if you include it.
  162.  
  163.        /H:x.x.0      Enter keystroke at end-of-line.
  164.        /H:x.x.9      Tab keystroke at end-of-line.
  165.        /H:x.x.32     Space at end-of-line.
  166.  
  167.        You can set the end-of-line character to fit the needs of the
  168.        program you are pasting to. In many database programs Tab moves from
  169.        field to field. In most word processors, a space makes the pasted
  170.        text wrap correctly. The Enter value (0) and Tab value (9) do not
  171.        actually send codes 0 and 9; instead they simulate the pressing of
  172.        these keys.
  173.  
  174.     Screen Attribute Parameters
  175.  
  176.     Screen attributes define the way parts of the PC-Browse window are
  177.     displayed: reversed, underlined, in a color. etc. The parameter has
  178.     three parts, giving values for monochrome, single color, and full color
  179.     displays. Since most people only use one type of monitor, you can enter
  180.     a single value that sets the value for all three (/1:7 is the same as
  181.     /1:7.7.7). To set attributes for a full-color monitor, you must add a
  182.     foreground and a background color to form a complete attribute. Since
  183.     these are file load parameters, each file can use different colors.
  184.     Here are the parts of the PC-Browse window and their default values:
  185.  
  186.     /0:112.112.112   The Window Frame; the single line border surrounding
  187.                      the window.
  188.     /1:9.15.79       The Menu, found along the bottom frame; displays your
  189.                      options.
  190.     /2:7.7.116       General Text; the text from the file you are viewing.
  191.     /3:1.7.126       Font text; text surrounded by PC-Write font
  192.                      characters.
  193.     /4:9.112.127     Target keywords; text surrounded by target keyword
  194.                      delimiters.
  195.     /5:15.15.113     Trigger keywords; text surrounded by linear or lookup
  196.                      delimiters.
  197.     /6:112.120.64    Text found by a normal search, or selected trigger
  198.                      keyword.
  199.     /7:9.120.79      Top line prompt text, for File and Find prompts.
  200.     /8:7.7.126       Help Text; general text when you view the help file.
  201.     /9:1.120.79      Message Text, on the bottom line.
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.                                       - 80 - 
  213.     Screen Attribute Values
  214.  
  215.     Monochrome                  Value    Single Color                 Value
  216.     ---------------------------------    ----------------------------------
  217.     Black                           0    Black                            0
  218.     Underline                       1    Normal (light on dark)           7
  219.     Normal (light on dark)          7    Normal Bright                   15
  220.     Bright underline                9    Reverse (dark on light)        112
  221.     Normal Bright                  15    Reverse Bright                 120
  222.     Reverse (dark on light)       112    Blinking, add                 +128
  223.     Blinking, add                +128
  224.  
  225.     Full Color
  226.     Foreground     Value      Foreground    Value       Background    Value
  227.     --------------------      -------------------       -------------------
  228.     Black              0      Dark Grey         8       Black             0
  229.     Blue               1      Light Blue        9       Blue             16
  230.     Green              2      Light Green      10       Green            32
  231.     Cyan               3      Light Cyan       11       Cyan             48
  232.     Red                4      Light Red        12       Red              64
  233.     Magenta            5      Light Magenta    13       Magenta          80
  234.     Brown              6      Yellow           14       Brown            96
  235.     Light Grey         7      White            15       Light Grey      112
  236.  
  237.     Here are some examples:
  238.  
  239.     /6:9.15.31
  240.        When a search finds the text, it is displayed underlined (9) on a
  241.        monochrome monitor, in bright characters (15) on single color
  242.        composite monitor, and as white letters on a blue background (15 +
  243.        16) on a full color monitor.
  244.  
  245.     /0:7
  246.        The frame of the window will be displayed with normal light-on-dark
  247.        characters on monochrome and single-color composite monitors. Full-
  248.        color monitors will display the frame as light grey on black.
  249.  
  250.  
  251.     Startup Parameters
  252.  
  253.     Startup parameters tell PC-Browse about your computer and allow you to
  254.     define preferences such as window attributes and hot keys. You enter
  255.     these parameters when you load PC-Browse into memory. Do not put them
  256.     into the file load parameter area.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.                                       - 81 - 
  266.     User Preference Parameters
  267.  
  268.     /A:N.N.N
  269.        Sets three options for interacting with PC-Browse.
  270.  
  271.        /A:A.x.x       Full but abbreviated main menu option.
  272.  
  273.        This sets whether you get the abbreviated menu with all function
  274.        keys listed, or the normal main menu with more descriptive key
  275.        names.
  276.  
  277.        /A:x.A.x      Swap PgUp/PgDn keys with Shf PgUp/PgDn keys.
  278.  
  279.        Swaps the PgUp/Dn and Shf PgUp/Dn keys, so PgUp and PgDn scroll by
  280.        screenful.
  281.  
  282.        /A:x.x.A      Swap PgUp and PgDn (also Shf and Ctl versions).
  283.  
  284.        Swaps the direction of the PgUp and PgDn keys (and their Shf'd and
  285.        Ctl'd versions).
  286.  
  287.     /Z:COM.EXE.OBJ.OVL.OVR
  288.  
  289.        This gives file name extensions that PC-Browse doesn't search. If
  290.        you don't want to search a particular database, spreadsheet, etc.
  291.        files, add their extensions to this list. A "+" after the ":" adds
  292.        to the default list; without a "+", this list replaces the default.
  293.        There is a limit of 25 extensions. Note that periods (not commas)
  294.        separate the items.
  295.  
  296.        /Z:+DBL.WKS   Don't search *.DBL or *.WKS files either.
  297.        /Z:COM.EXE    Search all but *.COM and *.EXE files
  298.  
  299.  
  300.     System Parameters
  301.  
  302.     /C  (default is off)
  303.        Turn on color when present; use color attributes.
  304.  
  305.        /C            Use color attributes.
  306.  
  307.     /E  (default is off)
  308.        Tells PC-Browse to use EMS memory, if available. By default it
  309.        doesn't use EMS, since some programs use EMS in non-standard ways.
  310.        PC-Browse can share EMS with most other programs, since it uses EMS
  311.        in standard ways. LIM 3.2 and up is supported. Additional buffers
  312.        set with /X go into EMS, to a maximum of 20K.
  313.  
  314.        /E            Set PC-Browse to use EMS memory.
  315.  
  316.  
  317.  
  318.                                       - 82 - 
  319.     /M  (default is off)
  320.        Tells PC-Browse to run stand-alone. By default, PC-Browse is
  321.        memory-resident, using approximately 60K of memory. When it runs
  322.        stand-alone, you must load the program each time you want it. Needed
  323.        to run programs from PC-Browse, as in a menu system.
  324.  
  325.        /M            Set PC-Browse to run stand-alone.
  326.  
  327.     /X:4096.1024
  328.        Tells PC-Browse how much memory to reserve for the text buffer and
  329.        the location list. A larger text buffer makes searching faster.
  330.        Also, each page in a file used for a lookup search must fit in the
  331.        text buffer. The location list size indicates approximately how many
  332.        location entries can be saved, with about 45 bytes per entry. The
  333.        total of both numbers cannot exceed 36K bytes (less any extra screen
  334.        buffer set with /Y).
  335.  
  336.        /X:6000.1024  Increase text buffer to 6000 bytes.
  337.        /X:4096.2000  Increase location list to 2000 bytes.
  338.  
  339.     /Y:25.80
  340.        If your monitor supports more than 25 lines (many EGAs and VGAs
  341.        offer this option) or more than 80 characters per line, this option
  342.        lets you use the full height. PC-Browse windows are always 80
  343.        columns wide, but it uses the true screen width to save the
  344.        application screen. PC-Browse knows about some 132 column displays
  345.        automatically. Increasing these parameters requires memory (about 4K
  346.        more for a 50-line display), limiting the maximum PC-Browse text
  347.        buffer length (see /X parameter).
  348.  
  349.        /Y:43.80      EGA with 43 line display.
  350.        /Y:50.80      VGA with 50 line display.
  351.        /Y:66.132     Special 66 line by 132 column display.
  352.  
  353.     /B:N.N
  354.        Sets two options for display adapters.
  355.  
  356.        /B:A.x        Remove synchronization, speed up EGA/VGA. Normal video
  357.                      synchronization avoids "snow" on CGA display adapters.
  358.                      If you have an EGA or VGA adapter this option can
  359.                      speed up operation.
  360.        /B:x.A        Remove text mode check, permit non-standard modes.
  361.                      Removes the check for a normal video text mode. If
  362.                      PC-Browse won't pop up with a non-standard or
  363.                      extra-function display adapter, try it. If you get
  364.                      non-textual garbage when PC-Browse pops up, the
  365.                      display is in graphics mode and PC-Browse won't work.
  366.  
  367.  
  368.  
  369.  
  370.  
  371.                                       - 83 - 
  372.     Hot Key Parameters
  373.  
  374.     To avoid conflicts with other programs, or just for personal
  375.     preference, you can redefine the hot key combinations. You may use any
  376.     one key with the Shf, Ctl, and Alt keys. The value is a number from 0
  377.     to 7 for the Shf/Ctl/Alt status, a period, and a number (the scan code)
  378.     for the individual key. Here are the Hot Key parameters and their
  379.     defaults:
  380.  
  381.     /P:3.59   (Shf Ctl F1)   Pop up PC-Browse to the last place viewed.
  382.     /Q:3.60   (Shf Ctl F2)   Pop up and do a lookup search for the word at
  383.                              the cursor.
  384.     /R:3.61   (Shf Ctl F3)   Pop up and do a linear search for the word at
  385.                              the cursor.
  386.     /S:3.65   (Shf Ctl F7)   Paste text into application, if paste is
  387.                              active.
  388.     /T:3.66   (Shf Ctl F8)   Pop up and move to the File text area to do a
  389.                              directory.
  390.     /U:3.67   (Shf Ctl F9)   Pop up and move to the Find text area.
  391.     /V:3.68   (Shf Ctl F10)  Pop up and move to the first page.
  392.  
  393.     Shf/Ctl/Alt keys:
  394.     0   (none)       2   Ctl          4   Alt          6   Ctl Alt
  395.     1   Shf          3   Shf Ctl      5   Shf Alt      7   Shf Ctl Alt
  396.  
  397.     Keyboard Scan Codes:
  398.  
  399.        Key   Code    Key   Code    Key   Code    Key   Code    Key   Code
  400.        ----------    ----------    ----------    ----------    ----------
  401.        Esc    1      E     18      J     36      PtSc  55            76*
  402.        1      2      R     19      K     37      SpBar 57      Rt    77
  403.        2      3      T     20      L     38      F1    59      G+    78
  404.        3      4      Y     21      ;     39      F2    60      End   79
  405.        4      5      U     22      '     40      F3    61      Dn    80
  406.        5      6      I     23      `     41      F4    62      PgDn  81
  407.        6      7      O     24      \     43      F5    63      Ins   82
  408.        7      8      P     25      Z     44      F6    64      Del   83
  409.        8      9      [     26      X     45      F7    65
  410.        9     10      ]     27      C     46      F8    66
  411.        0     11      Rtrn  28      V     47      F9    67
  412.        -     12      A     30      B     48      F10   68
  413.        =     13      S     31      N     49      Hm    71
  414.        Bksp  14      D     32      M     50      Up    72
  415.        Tab   15      F     33      ,     51      PgUp  73
  416.        Q     16      G     34      .     52      G-    74
  417.        W     17      H     35      /     53      Lf    75
  418.  
  419.       * (Code 76 is the center key of the numeric keypad, with NumLock on
  420.         it is the 5 key.)
  421.  
  422.  
  423.  
  424.                                       - 84 - 
  425.     Here are some examples:
  426.  
  427.        /P:4.25       Sets the hot key for popping up to Alt P.
  428.        /U:0.57       Sets the Paste hot key to the space bar (fine as long
  429.                      as you don't ever use spaces. As a rule, don't
  430.                      redefine a hot key as a single keyboard key without
  431.                      one of the shift keys.)
  432.  
  433.     Remarks
  434.     Redefining hot keys can be useful, but you can run into conflicts with
  435.     other programs. Be aware of key combinations used by other programs,
  436.     including other pop-up programs. For example, PC-Write uses Shf Ctl F5 to
  437.     clear the hold area, and Shf Ctl F6 to append a box to the hold area.
  438.  
  439.  
  440.     How to Define Parameters
  441.  
  442.     There are four ways to define parameters. PC-Browse reads them in the
  443.     following order:
  444.  
  445.        1. The control file called BR.DEF
  446.        2. The environment string SET BR=
  447.        3. The command line when you enter the BR command.
  448.        4. Within a text file, in [BR=...] brackets on the first line.
  449.  
  450.  
  451.     Defining Parameters in the BR.DEF File
  452.  
  453.     When you run PC-Browse, it first looks for a file called BR.DEF. This
  454.     file must be in the current directory when you call PC-Browse, or in a
  455.     directory listed in PCBROWSE or PATH environment strings. You can
  456.     create BR.DEF with PC-Write or any text editor. BR.DEF is limited in
  457.     size to the text buffer size, usually 4K.
  458.  
  459.     The main advantage of using BR.DEF is that each parameter can go on a
  460.     separate line. This means you can place comments after the parameters
  461.     to document them. In the other methods, all parameters must be listed
  462.     on the same line.
  463.  
  464.     To define parameters with BR.DEF:
  465.  
  466.     1. Using a text editor or PC-Write, create a file named BR.DEF in the
  467.        directory from which you normally call PC-Browse or in a directory
  468.        in the PATH.
  469.  
  470.     2. Place each parameter definition on its own line. If you want to use
  471.        comments, start each with a left parenthesis. You don't need to end
  472.        them with a right parenthesis. For example, to use a color monitor,
  473.        set the basic pop-up hot key, set the length of the window, and
  474.  
  475.  
  476.  
  477.                                       - 85 - 
  478.        change the color of the text in the window, create a BR.DEF file
  479.        like this:
  480.  
  481.        /C            (use a color monitor
  482.        /P:5.48       (set basic pop-up key to Shf Alt B (B is for Browse)
  483.        /W:7          (set window length to 7 lines; allows 4 windows
  484.        /2:4          (set normal text to black with red
  485.  
  486.  
  487.     Defining Parameters in the Environment
  488.  
  489.     After it checks for a BR.DEF file, PC-Browse checks the computer's
  490.     environment for a BR= string. If PC-Browse finds the same parameter
  491.     defined in both BR.DEF and the environment, the environment setting
  492.     takes precedence.
  493.  
  494.     The environment is an area of memory where DOS holds text parameters.
  495.     You place text into the environment with the DOS SET command. The
  496.     information from the DOS PATH and PROMPT commands is put into the
  497.     environment. There is one restriction; the default environment is
  498.     limited to 160 bytes. If you exceed this, you get the message:
  499.  
  500.        Out of environment space
  501.  
  502.     If you have a long PROMPT (it might look neat, but it eats space) or
  503.     PATH, you can decrease their sizes, leaving more room. If you use DOS
  504.     version 3.1 or later, you can increase the environment (to a maximum of
  505.     32,768 bytes) by adding the SHELL command to your CONFIG.SYS file, as
  506.     follows:
  507.  
  508.        SHELL=c:\command.com /e:# /p
  509.  
  510.     where "c:\command.com" is the command processor and "#" is the new
  511.     size, in bytes. (DOS 3.1 only: /e: is in 16 byte blocks, and you must
  512.     remove all spaces in the line.)
  513.  
  514.     To define parameters in the environment:
  515.  
  516.     *  At the DOS prompt type:
  517.  
  518.        SET BR=/parameter1/parameter2/parameter3/...........
  519.  
  520.        Note that there must be no space between "BR" and the equals sign.
  521.        For example, to set a color monitor, the basic pop-up hot key, the
  522.        window length, and the color of the text in the window, type the
  523.        following at the DOS prompt:
  524.  
  525.        Set BR=/C/P:5.48/W:7/2:4
  526.  
  527.  
  528.  
  529.  
  530.                                       - 86 - 
  531.     Defining Parameters from the Command Line
  532.  
  533.     After PC-Browse checks the environment, it searches the command line
  534.     for parameters. You enter parameters on the command line like you do in
  535.     the environment, all on one line and one right after the other (or
  536.     separated by spaces). Place the parameters after the BR command, and
  537.     after the file name, if any. If there are parameter conflicts with
  538.     either the BR.DEF file or the BR= environment string, the command line
  539.     takes precedence.
  540.  
  541.     To define parameters from the command line:
  542.  
  543.     *  At the DOS prompt, type:
  544.  
  545.        BR filename /parameter1 /parameter2 /parameter3 /.....
  546.  
  547.        where "filename" is the file to load into PC-Browse (optional). For
  548.        example, to load the default file HAMLET, and set a color monitor,
  549.        the basic pop-up hot key, the window length, and the color of the
  550.        text, type the following when loading PC-Browse into:
  551.  
  552.        BR HAMLET /C /P:5.48 /W:7 /2:4
  553.  
  554.  
  555.     Defining Parameters Within a File
  556.  
  557.     Finally, as PC-Browse loads each file, it checks for parameters on the
  558.     first line. You can only define file load parameters in a file, not
  559.     startup parameters. These parameters take precedence over all others. A
  560.     parameter in a file stays set until you load another file with a
  561.     different setting for that parameter. Parameters must occur in the
  562.     first 160 characters of the first line of the file.
  563.  
  564.     To include file load parameters in a file:
  565.  
  566.     *  Anywhere in the first 160 characters of the first line of the file,
  567.        type:
  568.  
  569.        [BR=/parameter1/parameter2/......]
  570.  
  571.        For example, to set the window length type the following on the
  572.        first line of the file:
  573.  
  574.        [BR=/W:7]
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.                                       - 87 - 
  584.     Summary of Parameters
  585.  
  586.     Parameter(default)   Description
  587.     ------------------   --------------------------------------------
  588.     /A:N.N.N             Choose Menu type and PgUp/Dn actions.
  589.     /B:N.N               Video Synchronization and Text Mode check.
  590.     /C (off)             Use Full Color screen attributes.
  591.     /E (off)             Use EMS expanded memory.
  592.     /G:P.P.0             Print: include fonts, form feed, end-of-line char.
  593.     /H:P.N.0             Paste: include fonts, piping delay,end-line char.
  594.     /I:0.0               Target keyword delimiter.
  595.     /J:0.0               Linear search-trigger delimiter.
  596.     /K:0.0               Lookup search-trigger delimiter.
  597.     /M (off)             Run in stand alone mode.
  598.     /P:3.59              Set basic "last page viewed" hot key.
  599.     /Q:3.60              Set "lookup search word at cursor" hot key.
  600.     /R:3.61              Set "linear search word at cursor" hot key.
  601.     /S:3.65              Set "Paste text" hot key.
  602.     /T:3.66              Set "Directory" hot key.
  603.     /U:3.67              Set "Pop up to Find text" hot key.
  604.     /V:3.68              Set "Pop up to first page" hot key.
  605.     /W:13                Set length of window, in lines.
  606.     /X:4096.1024         Set size of text buffer and location list.
  607.     /Y:25.80             Set size of screen display (rows and columns).
  608.     /0:112.112.112       Set screen attribute for the Window Frame.
  609.     /1:9.15.79           Set screen attribute for the Menu.
  610.     /2:7.7.116           Set screen attribute for the General text.
  611.     /3:1.7.126           Set screen attribute for PC-Write font text.
  612.     /4:9.112.127         Set screen attribute for Target keywords.
  613.     /5:15.15.113         Set screen attribute for Trigger keywords.
  614.     /6:112.120.64        Set screen attribute for text found by a search.
  615.     /7:9.120.79          Set screen attribute for File and Find prompts.
  616.     /8:7.7.126           Set screen attribute for Help text.
  617.     /9:1.120.79          Set screen attribute for Message text.
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.                                       - 88 - 
  637.     Appendix
  638.  
  639.  
  640.     Using PC-Browse with other programs
  641.  
  642.     PC-Browse is designed to be as friendly as it can be with other
  643.     application programs and TSR's (memory resident programs). You may load
  644.     PC-Browse first if other TSR's request that they be loaded last (don't
  645.     they all). Conflicts may, however, occur whenever you are using a TSR.
  646.     Sometimes redefining the hot key will resolve the problem, sometimes
  647.     changing the load order will help, and sometimes two programs or a
  648.     combination of programs simply will not work together. Here are the
  649.     conflicts we are aware of:
  650.  
  651.     Novell Network
  652.        Load PC-Browse before network software. Novell must be loaded last.
  653.     Ventura Publisher
  654.        Unload PC-Browse before running Ventura; it needs plenty of memory.
  655.     PC-Tools, version 5.0
  656.        If you use the shell program, load PC-Browse first.
  657.        Works ok with version 5.5.
  658.     Software Carousel
  659.        Don't pop up PC-Browse with left shift key; it blanks the screen.
  660.     TallScreen
  661.        Incompatible with PC-Browse.
  662.     Turbo Lightning v1.00a
  663.        If PC-Browse is loaded first, it won't pop up.
  664.        If PC-Browse is loaded last, it works until Lightning pops up.
  665.     Concurrent DOS v2.0
  666.        Incompatible with PC-Browse.
  667.     Sidekick
  668.        Load PC-Browse first. It pops up over Sidekick, but not reverse.
  669.     InSet
  670.        PC-Browse will pop up over InSet, even in graphics mode.
  671.     Other TSR's in general:
  672.        To avoid possible conflicts within DOS, PC-Browse sets a DOS flag
  673.        to "claim" DOS when it pops up, and checks this flag to be sure DOS
  674.        is free before it pops up itself.  Many other disk-based TSR's do
  675.        the same thing. This means PC-Browse won't pop up over an active
  676.        disk-based TSR, and vice versa.
  677.  
  678.  
  679.     Using PC-Browse with other hardware
  680.  
  681.     Keytronics 5151 Keyboard
  682.        PC-Browse may interpret keys on the separate cursor pad as shifted
  683.        when they are not.  Check with Keytronics for an EPROM upgrade to
  684.        solve this problem.
  685.  
  686.  
  687.  
  688.  
  689.                                       - 89 - 
  690.     About the Program's Author
  691.  
  692.     Steven B. Levy has been programming, on and off, since the late '60s.
  693.     In the "on" periods, he created one of the earliest microcomputer-to-
  694.     typesetting conversion programs. Among the other software he has
  695.     developed are a variety of educational programs for the high school and
  696.     college markets and interactive, computer-based training materials for
  697.     companies ranging from A.I. giants to retail stores. He joined
  698.     Quicksoft as Senior Programmer and Development Manager in 1988. (In the
  699.     "off" times, he was Artistic Director for eight years of an Off-Off-
  700.     Broadway theatre company and played in a bunch of rock-and-roll bands.)
  701.  
  702.  
  703.     Licensing PC-Browse
  704.  
  705.     PC-Browse is shareware. This is an unusual approach to marketing
  706.     software, one we at Quicksoft have used for many years and that works
  707.     well for us and our many customers.
  708.  
  709.     If you have a PC-Browse full registration, printed PC-Browse manual, or
  710.     just a user certificate, you have the right to use the PC-Browse
  711.     software with your own files. If not, we do expect you to pay for the
  712.     use of PC-Browse by purchasing one of these items. Prices are:
  713.  
  714.       Full PC-Browse Registration (include current software, full printed
  715.         manual, PC-Browse user certificate, technical support for one year,
  716.         and our newsletter, Quicknotes, for one year)....$49.00
  717.  
  718.       PC-Browse printed manual and User Certificate......$24.00
  719.  
  720.       PC-Browse user certificate only....................$10.00
  721.  
  722.     We have group and campus licenses available for cases in which multiple
  723.     users in an organization will be using PC-Browse.
  724.  
  725.     If you received PC-Browse with application files from someone else,
  726.     they are responsible for paying for your use of PC-Browse with their
  727.     files. You still need to pay for the use of PC-Browse if you use it
  728.     with your own files.
  729.  
  730.     Assuming you have a copy of the PC-Browse software diskettes, you are
  731.     also encouraged to give copies of these diskettes to other people to
  732.     evaluate PC-Browse, with some restrictions given below.
  733.  
  734.     If you want to distribute PC-Browse with your own information
  735.     (application files), you must get a license from Quicksoft. This is
  736.     only fair, since people receiving your information (your customers,
  737.     clients, employees, students, etc.) are indeed using PC-Browse with
  738.     your information, not just evaluating PC-Browse for their own use.
  739.  
  740.  
  741.  
  742.                                       - 90 - 
  743.     This license is simple, easy to get, and inexpensive. There are three
  744.     payment options:
  745.       1. A one-time fee based on projected use.
  746.       2. A royalty per unit sold or distributed.
  747.       3. A user certificate per person using it.
  748.  
  749.     To order, or for more information call Quicksoft at 1-800-888-8088.
  750.  
  751.     The rules on shareware distribution of PC-Browse are:
  752.  
  753.     1. Please don't copy this printed manual. Purchases of the book pay for
  754.        the software. That's why each book comes with a User Certificate.
  755.  
  756.     2. Please distribute complete, unmodified copies only. The person
  757.        receiving it deserves a full collection of all files. You can
  758.        compress and/or transmit files.
  759.  
  760.     3. Please do not include your own PC-Browse application files (where
  761.        PC-Browse is used in a productive way) unless this use is licensed
  762.        as described above. You may include other types of files when you
  763.        distribute PC-Browse, such as descriptions or tutorials.
  764.  
  765.     4. Please don't distribute copies outside the United States, Canada,
  766.        Australia, and New Zealand. In other countries like Great Britain,
  767.        France, and Germany, PC-Browse is not distributed as shareware.
  768.  
  769.     5. If you're advertising the diskettes, please describe PC-Browse as
  770.        "shareware" and note Quicksoft trademarks "PC-Browse" and
  771.        "Quicksoft".
  772.  
  773.     Quicksoft is a member of the Association of Shareware Professionals
  774.     (ASP). For more information about shareware, you can contact ASP at PO
  775.     Box 5786, Bellevue, WA  98006.
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.                                       - 91 - 
  796.     Glossary
  797.  
  798.     Application File
  799.        A file loaded into PC-Browse used to help people manage information.
  800.     Application Program
  801.        The program running on the computer when PC-Browse pops up, from
  802.        which PC-Browse gets a word to find, and to which PC-Browse can
  803.        paste text.
  804.     ASCII
  805.        American Standard for Computer Information Interchange, a character
  806.        set.
  807.     Bookmark
  808.        A PC-Browse tool for marking your place in a file so you can quickly
  809.        return to it.
  810.     Cross-reference
  811.        See Link.
  812.     Delimiter
  813.        A character used to "flag" text as a type of keyword in the file.
  814.     File Area
  815.        The area on the top frame of the window (left side) where the file
  816.        name or file name pattern to be searched is typed.
  817.     File Load Parameter
  818.        Parameters that define information that applies to a particular
  819.        file. The definitions of file load parameters are kept with each
  820.        file on the first line.
  821.     File Name Pattern
  822.        A combination of text and/or wild card characters that defines which
  823.        files to include in a multi-file search. The file name pattern is
  824.        used in place of a specific file name.
  825.     Find Area
  826.        The area on the top frame of the window where the text to be
  827.        searched for is typed.
  828.     Find Text
  829.        The text that is to be searched for.
  830.     Host Document
  831.        The application software (or DOS) that is running when you activate
  832.        PC-Browse.
  833.     Hot Key
  834.        Key or combination of keys that activates (pops up) a TSR program.
  835.     Hypertext
  836.        Non-linear text; text with links from one point or block to another
  837.        pointer or block (term invented by Ted Nelson).
  838.     Linear Search
  839.        One of the three search methods. Instead of searching for all
  840.        occurrences of text, searches only for text designated as a target
  841.        keyword, through the use of delimiters.
  842.     Link
  843.        A connection between two places in a file or between two files,
  844.        based on a trigger keyword in one place and a target keyword in the
  845.        other place; a cross-reference.
  846.  
  847.  
  848.                                       - 92 - 
  849.     Location List
  850.        A method of remembering each place (location) as you search within a
  851.        file or across files. You can move quickly, back and forth, along
  852.        the list.
  853.     Lookup Search
  854.        One of the three search methods. Like the linear search it only
  855.        looks for text designated as a target keyword. Lookup search can
  856.        only be done on a file sorted alpha-numerically. It is a fast method
  857.        of searching large amounts of information.
  858.     Multi-File Search
  859.        Any search that automatically searches more than one file for the
  860.        find text. Wild card characters are used to build a file name
  861.        pattern in place of a specific file name. PC-Browse then searches
  862.        for all files that match the file name pattern.
  863.     Normal Search
  864.        A search for any and all occurrences of the find text.
  865.     Open
  866.        Creates another window on your screen (assuming space is available).
  867.        The new window will be an exact copy of the current window.
  868.     Parameter
  869.        Defines the way PC-Browse works. See File Load and Startup
  870.        Parameters.
  871.     RAM-resident
  872.        See TSR.
  873.     Shut
  874.        Close the current window and return to the last window opened, or to
  875.        the host document if there is only one window.
  876.     Startup Parameter
  877.        Parameters that define information common to all files.
  878.     Target Keyword
  879.        The delimited text within a file that both a lookup and linear
  880.        search attempt to find.
  881.     Trigger Keyword
  882.        The delimited text within a file that initiates (triggers) a lookup
  883.        or keyword search for the matching target keyword.
  884.     TSR
  885.        Terminate and Stay Resident. A TSR program loaded into your computer
  886.        memory (RAM) remains inactive and invisible until you activate it.
  887.        Also called RAM-resident.
  888.     Wild Card
  889.        A special character that matches or represents another character or
  890.        characters. There are two kinds: file name pattern wild cards and
  891.        text search wild cards.
  892.     Window
  893.        The box that appears over the top of your host document when the hot
  894.        key is pressed. PC-Browse allows for more than one window to be
  895.        visible at a time. The actual number of windows that can be
  896.        displayed depends on the number of lines on the screen and length of
  897.        each window. See also Open and Shut.
  898.  
  899.  
  900.  
  901.                                       - 93 - 
  902.     Index
  903.     entries with * are found in the tutorial section.
  904.  
  905.     43 line display                 83    Find Prompt                   51
  906.     50 line display                 83    Linear                        50
  907.     About this User's Guide          6    Lookup                        50
  908.     Application files                7    Popping up                   12*
  909.     ASCII                           54    Paste                         74
  910.     Attributes                      80    Top of File                   51
  911.     Bksp                             6  How to define parameters        85
  912.     Bookmark                        73  Hypertext                  19*, 65
  913.     BR.DEF                          85    building links                43
  914.     BREF.BRS                         7    Hamlet application           20*
  915.     BTUT.BRS                         7  Index page creating             43
  916.     Case matching                   59  Installation                     7
  917.     Color monitor                   82  Keyword delimiters              78
  918.     Colors                          80  keyword search                  64
  919.     Command line parameters         87    using an index page          19*
  920.     Ctl                              6  LIM memory                      82
  921.     Customizing                     77  Linear search                   64
  922.     Delimiter rules                 33    adding a trigger              35
  923.     Delimiters                      33    building an application       34
  924.     Delimiters care in using        34    defining delimiters           36
  925.     Directory selecting a file      53    delimiters                    78
  926.     Display size                    83  Linking files                   68
  927.     Documentation on disk            7  Loading PC-Browse              11*
  928.     EGA                             83    an application                52
  929.     EMS memory                      82    autoexec.bat                  48
  930.     End-of-line character               Location list                   71
  931.       for pasting                   79    adding manually               72
  932.       for printing                  79    changing size                 83
  933.     Environment                           limit                         72
  934.       defining parameters in        86    move back                     72
  935.       increasing size               86    move forward                  72
  936.     Exit                            49    view entries                  72
  937.     Expanded memory                 82  Lookup search               37, 64
  938.     File load parameters        77, 87    adding a trigger              42
  939.     Font characters                       build file with mail merge    40
  940.       for pasting                   79    defining the parameters       41
  941.       for printing                  79    requirements               37,64
  942.     Foreign characters              61    Sailboat application         22*
  943.     Form feed handling              79    sorting the targets           39
  944.     Function key summary            46    delimiters                    78
  945.     Glossary                        91  Manual Terminology & Notation    6
  946.     Grey+                            6  Memory loading into             47
  947.     Grey-                            6  Menu                        45, 69
  948.     Help                            45    abbreviated                   46
  949.     Hot key                         49    default                       46
  950.       Basic                         49    set style of                  82
  951.       Definition                    84    viewing main menu             45
  952.       Directory                     51  Monitor display size            83
  953.  
  954.                                       - 94 - 
  955.     Multiple file search            62  PCBROWSE=               48, 53, 53
  956.       list files                    62  PgUp/Dn options                 82
  957.       load files                    63  Piping delay                    79
  958.       files not searched            64  Pop up                     12*, 49
  959.     Non-alpha character             33  Print                           73
  960.     Non-ASCII files                 55    PC-Write font characters      75
  961.     Non-document                    54    sending form feeds            75
  962.     Non-resident mode           69, 83    to a file                     76
  963.     Normal search                  58  Program diskette                 7
  964.       multiple files               15*  Reference diskette               7
  965.       one file                     13*  Running other programs          69
  966.       word from another program     58  Sample files using AREACODE    17*
  967.     Parameters                      77  Sample files using HAMLET      20*
  968.       BR.DEF file                   85  Sample files using MISUSED     19*
  969.       color monitor                 82  Sample files using Quarto      21*
  970.       defining  from command line   87  Sample files using SAILBOAT    22*
  971.       defining in environment       86  Screen attributes               80
  972.       EMS memory                    82    values                        81
  973.       end-of-line character paste   79  Screen colors                   80
  974.       end-of-line character print   79  Screen size                     83
  975.       File Load                     77  Scroll
  976.       Files not to search           82    bottom of file                57
  977.       font characters for pasting   79    horizontally                  57
  978.       font characters for printing  79    next trigger                  57
  979.       form feed handling            79    one line                      55
  980.       hot key                       84    one page                      56
  981.       how to define                 85    one window                    56
  982.       keyword delimiters            78    top of file                   57
  983.       linear search delimiters      78  Search keys                     58
  984.       location list size            83  Searching a single file        13*
  985.       lookup search delimiters      78  Searching multiple files   15*, 62
  986.       Menu option                   82  Selecting a file               12*
  987.       monitor display size          83  SET BR=                         86
  988.       PgUp/Dn options               82  SET PCBROWSE=           48, 53, 54
  989.       piping delay                  79  Shf                              6
  990.       screen attributes             80  Shf Ctl F1                      49
  991.       SET BR=                       86  Shf Ctl F2                      50
  992.       stand alone version           83  Shf Ctl F3                      50
  993.       startup                       81  Shf Ctl F7                      74
  994.       summary                       88  Shf Ctl F8                      51
  995.       target keyword delimiters     78  Shf Ctl F9                      51
  996.       text buffer size              83  Shf Ctl F10                     51
  997.       text mode check               83  Sort order                      37
  998.       video synchronization         83  Stand alone version         69, 83
  999.       Window Length                 78  Startup parameters              81
  1000.       file load                     87  Subdirectory-creating            8
  1001.     Paste                           73  Suggested Applications          29
  1002.       end-of-line character         75  Summary of parameters           88
  1003.       into another program          14  Target                     19*, 34
  1004.       marking text                 14*  Target keyword delimiters       78
  1005.       PC-Write font characters      75  Text buffer changing size       83
  1006.  
  1007.                                       - 95 - 
  1008.     Text mode check                 83
  1009.     Trigger                    19*, 34
  1010.     Trigger jump to next            57
  1011.     TSR
  1012.       conflicts with other programs 89
  1013.       definition                    47
  1014.       working with other programs   89
  1015.     Unload                          48
  1016.     Using with other programs       89
  1017.     Using sample file AREACODE     17*
  1018.     Using sample file HAMLET       20*
  1019.     Using sample file MISUSED      19*
  1020.     Using sample file SAILBOAT     22*
  1021.     Using sample QUARTO            21*
  1022.     VGA                             83
  1023.     Video synchronization           83
  1024.     Viewing a File                 12*
  1025.     What is PC-Browse                5
  1026.     Wild card patterns          51, 62
  1027.       multi-file search             15
  1028.       searching                     59
  1029.     Windows
  1030.       length                        78
  1031.       multiple                      70
  1032.       open                     16*, 70
  1033.       reopen                        71
  1034.       shut                          71
  1035.     "Snow"                          83
  1036.     [BR=...                         87
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.                                       - 96 - 
  1061.  
  1062.