home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / qfe_401.zip / QFE.DOC < prev    next >
Text File  |  1989-03-19  |  47KB  |  1,191 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                     +--+ QFE +--+
  8.  
  9.  
  10.  
  11.  
  12.                                The Directory Processor
  13.  
  14.                                          for
  15.  
  16.                                    Qmodem SST 4.0
  17.  
  18.                                      version 4.0
  19.  
  20.  
  21.  
  22.                    QFE(tm) Copyright 1986,1989 Sunflower Systems.
  23.                                 All rights reserved.
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                                       Sunflower Systems
  30.                                                       718 East B Avenue
  31.                    _________                        Hutchinson, KS  67501
  32.              _____|___      |            (tm)           (316)662-4445
  33.           --|         |     |-----------------
  34.             |    _____|___  |  Association of      "QFE" and "The Directory
  35.             |   |         |_|  Shareware           Processor"are trademarks
  36.             |___|    o    |    Professionals       of Sunflower Systems.
  37.           ------|    |    |-------------------
  38.                 |____|____|    MEMBER              The Qfonedit family of
  39.                                                    software is the product
  40.                                                    of Sunflower Systems.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                                     Contents
  54.  
  55.  
  56.  
  57.                Copyrights and Trademarks                             1
  58.  
  59.                Disclaimer                                            1
  60.  
  61.                License                                               1
  62.  
  63.                QFE Support                                           2
  64.  
  65.                Paying for QFE                                        2
  66.  
  67.                What is QFE?                                          3
  68.  
  69.                Keys in QFE and This Manual                           4
  70.  
  71.                A "Quick Start"                                       5
  72.  
  73.                A "Quick Finish"                                      5
  74.  
  75.                Other Ways to Start                                   5
  76.  
  77.                QMODEM.EXE, QMODEM.CNF and QMODEM=                    6
  78.  
  79.                The On-line Help System                               7
  80.  
  81.                Modes in QFE                                          7
  82.  
  83.                Marking and Using Blocks                              8
  84.  
  85.                "Oops" Windows and Worse                              9
  86.  
  87.                QFE Commands                                         10
  88.  
  89.                Duplicating                                          12
  90.  
  91.                Sorting                                              14
  92.  
  93.                Appendix A                                           17
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.                                           i
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.           -----------------------------------------------------------------
  113.  
  114.                               Copyrights and Trademarks
  115.  
  116.           =================================================================
  117.  
  118.           QFE (c) 1986,1989 Sunflower Systems. All rights reserved.
  119.  
  120.           "QFE" and "The Directory Processor" are trademarks of Sunflower
  121.           System.
  122.  
  123.           "Qmodem" is a trademark of The Forbin Project, Inc.
  124.  
  125.  
  126.  
  127.           -----------------------------------------------------------------
  128.  
  129.                                      Disclaimer
  130.  
  131.           =================================================================
  132.  
  133.           QFE is supplied as-is. Sunflower Systems disclaims all warran-
  134.           ties, expressed or implied, including, without limitation, the
  135.           warranties of merchantability and of fitness for any purpose.
  136.           Sunflower Systems assumes no liability for damages, direct or
  137.           consequential, which may result from the use of QFE. Use of QFE
  138.           indicates acceptance of this disclaimer.
  139.  
  140.  
  141.  
  142.           -----------------------------------------------------------------
  143.  
  144.                                        License
  145.  
  146.           =================================================================
  147.  
  148.           QFE is copyrighted Shareware, not public domain, "freeware," or
  149.           anything else that does not have to be paid for.
  150.  
  151.           License is granted to use QFE for a trial period, to determine
  152.           its suitability for the user and his or her system. The "trial
  153.           period" is over when the user has decided whether QFE is useful
  154.           for his or her purposes. If the decision is that QFE is useful,
  155.           the user is expected to pay for it. (See "Paying for QFE,"
  156.           below.)
  157.  
  158.           Some users find that QFE is a great deal of help to them for a
  159.           short while after they obtain it, but that they seldom use it
  160.           afterwards. Those users should note that the duration of QFE's
  161.           usefulness to them is not a factor in the license. I.e., they
  162.           should pay for QFE.
  163.  
  164.           Anyone may distribute copies of QFE and its documentation,
  165.           subject to the following restrictions:
  166.  
  167.  
  168.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  169.  
  170.  
  171.  
  172.                --QFE.EXE, QFE.HLP, QFE.DOC, and QFE_READ.ME must be
  173.                  distributed as a complete package.
  174.                --The contents of QFE.EXE and QFE.HLP must not be modified.
  175.                --The contents of QFE.DOC and QFE_READ.ME must not be
  176.                  modified other than by brief additions such as paragraphs
  177.                  identifying the party distributing the package, etc.
  178.                --No charge may be made for the QFE package without the
  179.                  written permission of Sunflower Systems.
  180.                --No charge may be made for any hardware or software package
  181.                  distributed with QFE without the written permission of
  182.                  Sunflower Systems.
  183.                --An exception to the "no charge" restrictions is that the
  184.                  QFE package may always be distributed with Qmodem under
  185.                  any terms approved by The Forbin Project, Inc., for
  186.                  Qmodem's distribution. However, no additional charge may
  187.                  be made for QFE's distribution beyond that made for
  188.                  Qmodem's distribution.
  189.  
  190.  
  191.  
  192.           -----------------------------------------------------------------
  193.  
  194.                                      QFE Support
  195.  
  196.           =================================================================
  197.  
  198.           QFE is supported on The Forbin Project BBS (check your Qmodem
  199.           documentation for the BBS phone number); in the Qmodem Round
  200.           Table on GEnie; and on CompuServe (73307,3101) in the IBMCOM
  201.           forum.
  202.  
  203.           Sunflower Systems is a member of the Association of Shareware
  204.           Professionals (ASP). ASP wants to make sure that the Shareware
  205.           principle works for you. If you are unable to resolve a
  206.           Shareware-related problem with an ASP member by contacting the
  207.           member directly, ASP may be able to help. The ASP Ombudsman can
  208.           help you resolve a dispute or problem with an ASP member, but
  209.           does not provide technical support for members' products. Please
  210.           write to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006
  211.           or send a CompuServe message via Easyplex to ASP Ombudsman
  212.           70007,3536.
  213.  
  214.  
  215.  
  216.           -----------------------------------------------------------------
  217.  
  218.                                    Paying for QFE
  219.  
  220.           =================================================================
  221.  
  222.           QFE is $15 for a single copy. Paying customers receive a copy of
  223.           the most recent release, on diskette; an individual serial
  224.           number, allowing bypass of some of QFE's prompts and displays;
  225.  
  226.  
  227.  
  228.  
  229.                                           2
  230.  
  231.  
  232.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  233.  
  234.  
  235.  
  236.           mailed notices of major upgrades; and telephone support as-
  237.           available.
  238.  
  239.           Users wishing to pay for QFE using a bank card should order from
  240.           The Public (software) Library. Call them at (800)242-4775 or
  241.           (713)665-7017, or write to PO Box 35705, Houston, TX  77235, for
  242.           details.
  243.  
  244.           See Appendix A for a form to order QFE directly from Sunflower
  245.           Systems. (An unregistered copy of QFE will offer to print out an
  246.           order form at the end of each session.)
  247.  
  248.  
  249.  
  250.           -----------------------------------------------------------------
  251.  
  252.                                     What is QFE?
  253.  
  254.           =================================================================
  255.  
  256.           QFE is a QMODEM.FON processor.
  257.  
  258.           What does that mean? It means that you can operate on your Qmodem
  259.           dialing directory files like you operate on text with a word
  260.           processor: rearrange the entries, change them like you want to.
  261.           You can even process two directory files at the same time,
  262.           copying from each to the other.
  263.  
  264.           In the rest of this manual, we'll refer to Qmodem directory files
  265.           as ".FON files", or just ".FONs", because your Qmodem dialing
  266.           directory files always have the "extension" .FON. We'll refer to
  267.           an individual listing in your .FON file as an "entry."
  268.  
  269.           QFE makes it easy to do a lot of things with your .FON file:
  270.  
  271.                --Clear (erase) entries, leaving just "defaults" for
  272.                  appropriate values.
  273.  
  274.                --Duplicate an entry: copy it, or part of it, to other
  275.                  entries.
  276.  
  277.                --Find the entry which contains a particular word or number.
  278.  
  279.                --Insert blank entries.
  280.  
  281.                --Move entries from one place to another.
  282.  
  283.                --Pack entries, so that the "empty" ones are at the
  284.                  "bottom", and the others are at the "top".
  285.  
  286.                --Sort it.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.                                           3
  294.  
  295.  
  296.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  297.  
  298.  
  299.  
  300.           Of course, QFE also makes it easy to change the contents of any
  301.           entry, operating like a word processor:  You just type new
  302.           information into the entry.
  303.  
  304.           And QFE protects your .FON files:  While a .FON is still in QFE,
  305.           you can undo recent changes. If disk space permits, QFE will
  306.           leave your original .FON files on disk, changing their extensions
  307.           to .BAQ. (The originals don't have their names changed until QFE
  308.           has written the edited files to disk under a temporary name.)
  309.  
  310.  
  311.  
  312.           -----------------------------------------------------------------
  313.  
  314.                              Keys in QFE and This Manual
  315.  
  316.           =================================================================
  317.  
  318.           When run together with the name or number of a key, the words
  319.           Shift, Ctrl, and Alt mean to press the other key while holding
  320.           down a plain Shift key, a Ctrl key, or an Alt key, respectively.
  321.  
  322.           Preceding a number, the letter F means to press the Function key
  323.           which has that number. The F may be preceded by Shift, Ctrl, or
  324.           Alt. FKey and FKeys refer to any Function key.
  325.  
  326.           Esc, Tab, PgUp, PgDn, Home, End, Ins and Del refer to the keys
  327.           which usually have those names on an IBM keyboard. Space refers
  328.           to the space bar.
  329.  
  330.           Up, Down, Left, and Right refer to the cursor control keys which
  331.           move the cursor in those respective directions.
  332.  
  333.           Enter refers to the Enter or Return key.
  334.  
  335.           You never have to type the " or [] characters shown in many
  336.           places in the manual. And it never matters whether you use
  337.           capital letters or lower case ones.
  338.  
  339.           Examples:
  340.  
  341.                AltH means press H while holding down the Alt key.
  342.  
  343.                ShiftTab means press the Tab key while holding down Shift.
  344.  
  345.                CtrlFKey refers to any Function key pressed while holding
  346.                down the Ctrl key.
  347.  
  348.           QFE uses the same cursor movement keys that Qmodem does, with
  349.           some extensions similar to those used in the Borland editors and
  350.           WordStar. ("WordStar" is the trademark of MicroPro Interna-
  351.           tional.) For example, Qmodem and QFE both use PgUp to move the
  352.           cursor an entire page up, but QFE also uses CtrlR for that. See
  353.           the on-line help for full details.
  354.  
  355.  
  356.  
  357.                                           4
  358.  
  359.  
  360.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  361.  
  362.  
  363.  
  364.           -----------------------------------------------------------------
  365.  
  366.                                    A "Quick Start"
  367.  
  368.           =================================================================
  369.  
  370.           The easiest way to start using QFE is to copy the files QFE.EXE
  371.           and QFE.HLP onto the same disk, in the same directory, as
  372.           QMODEM.EXE and QMODEM.FON. Make that disk and directory the
  373.           current one, type QFE and press Enter. QFE should then load
  374.           QMODEM.FON and let you start editing it.
  375.  
  376.           (If you are using an unregistered copy, QFE may prompt you for
  377.           some additional keystrokes before displaying QMODEM.FON.)
  378.  
  379.  
  380.  
  381.           -----------------------------------------------------------------
  382.  
  383.                                   A "Quick Finish"
  384.  
  385.           =================================================================
  386.  
  387.           To leave QFE, type X from "Command Mode." If QFE prompts you to
  388.           save QMODEM.FON, answer yes or no by typing Y or N--or press Esc
  389.           to continue QFE rather leaving it.
  390.  
  391.           (If you are using an unregistered copy, QFE will ask if you wish
  392.           it to print an order form. Type Y or N, as appropriate. Note that
  393.           even after you have QFE print an order form, you will still
  394.           receive this question from your unregistered copy.)
  395.  
  396.  
  397.  
  398.           -----------------------------------------------------------------
  399.  
  400.                                  Other Ways to Start
  401.  
  402.           =================================================================
  403.  
  404.           The general way to command DOS to load and run QFE is to type:
  405.  
  406.                     QFE [parameters] Enter
  407.  
  408.           where "[parameters]" means any or none of these items:
  409.  
  410.                filename       the name (optionally including drive and
  411.                               path) of the .FON file you want to load. (The
  412.                               extension ".FON" is forced onto the
  413.                               filename.)
  414.  
  415.                -B             use "Black and white" regardless of
  416.                               QMODEM.CNF colors or DOS colors
  417.  
  418.  
  419.  
  420.  
  421.                                           5
  422.  
  423.  
  424.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  425.  
  426.  
  427.  
  428.                -C             use default Colors regardless of QMODEM.CNF
  429.                               colors or DOS colors
  430.  
  431.                -S             use Slow screen writes to avoid making "snow"
  432.                               on some video adapters
  433.  
  434.                -Q             be Quiet--don't make beeps
  435.  
  436.           Separate parameters by at least one space between each pair. Type
  437.           them in any order. If you prefer, you can type "/" instead of
  438.           "-".
  439.  
  440.           Some examples of running QFE with parameters:
  441.  
  442.                Run QFE loading BBS.FON from the current directory or the
  443.                Qmodem directory:
  444.  
  445.                     QFE BBS Enter
  446.  
  447.                Run QFE loading BBS.FON from the C:\QM\BB directory, using
  448.                default colors:
  449.  
  450.                     QFE C:\QM\BB\BBS -C Enter
  451.  
  452.                  or
  453.  
  454.                     QFE -C C:\QM\BB\BBS Enter
  455.  
  456.                Run QFE quietly, and suppress screen snow:
  457.  
  458.                     QFE -Q -S Enter
  459.  
  460.  
  461.  
  462.           -----------------------------------------------------------------
  463.  
  464.                          QMODEM.EXE, QMODEM.CNF and QMODEM=
  465.  
  466.           =================================================================
  467.  
  468.           QFE looks for "QMODEM=" in your DOS environment. If found, it is
  469.           used to locate QMODEM.CNF and your .FON file. (See the Qmodem
  470.           users' manual and your DOS manual for more information about
  471.           QMODEM= and the DOS environment.)
  472.  
  473.           If QFE does not find QMODEM=, it searches for QMODEM.EXE by
  474.           looking in the current directory and along the DOS path. (See
  475.           your DOS manual for more information about the DOS path.) Under
  476.           DOS versions 3.X and later, QFE looks in the directory where
  477.           QFE.EXE is.
  478.  
  479.           If QFE finds QMODEM.CNF, it reads your choices for colors, baud
  480.           rate, etc., from that file and uses them to set its own values.
  481.           If it does not find QMODEM.CNF, QFE relies on preset values and
  482.  
  483.  
  484.  
  485.                                           6
  486.  
  487.  
  488.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  489.  
  490.  
  491.  
  492.           rules. For example, in the absence of QMODEM.CNF, QFE sets its
  493.           screen colors based on what was on the screen when you started
  494.           QFE.
  495.  
  496.           In any case, parameters given at start-up override QMODEM.CNF and
  497.           QFE's preset values and rules.
  498.  
  499.  
  500.  
  501.           -----------------------------------------------------------------
  502.  
  503.                                The On-line Help System
  504.  
  505.           =================================================================
  506.  
  507.           Press F1 or AltH to get on-line help with QFE. Press Esc to leave
  508.           the help system.
  509.  
  510.           QFE's help is "context sensitive," meaning that the help text
  511.           display depends on what QFE was doing when you requested help.
  512.           For example, if you press F1 while sorting the .FON, the first
  513.           help screen presented will deal with sorting.
  514.  
  515.           Help text is sometimes too lengthy for display on just one
  516.           screen. Up, Down, PgUp and PgDn will move you through the full
  517.           text.
  518.  
  519.           Every topic in the help system is linked to at least one other.
  520.           From one to six topics are listed at the bottom of the help
  521.           screen. One of them is always highlighted. Pressing Enter leaves
  522.           the currently displayed topic and displays the one that was
  523.           highlighted. Tab, ShiftTab, Right, Left and Space move the
  524.           highlighting from topic to topic.
  525.  
  526.           Help topics also have two links which do not appear in the list
  527.           (unless they duplicate a listed topic). Rather than highlighting,
  528.           these topics are selected with FKeys:  press ShiftF1 for the most
  529.           recently displayed topic, or AltF1 for help about the help system
  530.           itself.
  531.  
  532.           Note that the help text is stored in the file QFE.HLP. On-line
  533.           help is available only if QFE can find, open and read QFE.HLP.
  534.  
  535.  
  536.  
  537.           -----------------------------------------------------------------
  538.  
  539.                                     Modes in QFE
  540.  
  541.           =================================================================
  542.  
  543.           QFE operates in either of two "modes".
  544.  
  545.  
  546.  
  547.  
  548.  
  549.                                           7
  550.  
  551.  
  552.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  553.  
  554.  
  555.  
  556.           In "Command Mode", the letters you type are interpreted as
  557.           commands. For example, typing "S" in Command Mode tells QFE to
  558.           sort. In Command Mode you cannot type in new entries or type
  559.           modifications of existing ones.
  560.  
  561.           In "Edit Mode", the letters you type are taken literally: Typing
  562.           "S" in Edit Mode puts the letter S into the "cursor line" (the
  563.           entry at the cursor location)--if "S" is an acceptable character
  564.           there.
  565.  
  566.           To go from Command Mode to Edit Mode, type R, for Revise, just as
  567.           in Qmodem. To return from Edit Mode to Command Mode, press Esc.
  568.  
  569.           An upper line on the screen will state whether QFE is in Command
  570.           or Edit Mode.
  571.  
  572.           For users who dislike modes, QFE can be operated from Edit Mode
  573.           just as if there were no Command Mode. In Edit Mode, all of the
  574.           commands must be given with the AltKey equivalents of the Command
  575.           Mode keys: Sort would be invoked with AltS rather than just "S".
  576.           However, the rest of this manual and all of the help text ignore
  577.           the use of AltKeys in Edit Mode.
  578.  
  579.  
  580.  
  581.           -----------------------------------------------------------------
  582.  
  583.                               Marking and Using Blocks
  584.  
  585.           =================================================================
  586.  
  587.           Most QFE commands "need" to "know" which entries to operate on.
  588.           Some commands, such as Load and Quit, operate on the entire .FON.
  589.           Others, such as Find, start at the entry after the cursor line.
  590.  
  591.           Commands which need to be "told" which entries to operate on get
  592.           that information from "marking" of "blocks" of entries. Marked
  593.           entries usually appear in a different color than unmarked ones,
  594.           and always have the Qmodem marking character to their left.
  595.  
  596.           To mark a block, move the cursor to the "first" entry in the
  597.           intended block. (The first entry is the one with the lowest entry
  598.           number.) Press F3. Move the cursor to the "last" entry (the one
  599.           with the highest entry number) in the intended block. Press F4.
  600.  
  601.           To mark the entire .FON as one block, just press F6.
  602.  
  603.           When a block is marked, an upper line on the screen will say that
  604.           marks are "on" and which are the first and last marked entries.
  605.  
  606.           When marks are on, pressing F3 makes the cursor line the new
  607.           first line in the block; pressing F4 makes the cursor line the
  608.           new last line. The existing marks will be extended, truncated, or
  609.  
  610.  
  611.  
  612.  
  613.                                           8
  614.  
  615.  
  616.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  617.  
  618.  
  619.  
  620.           cleared as required; you will see the displayed entries marked or
  621.           unmarked accordingly.
  622.  
  623.           To unmark a block, removing the marking characters and restoring
  624.           normal colors, press F2.
  625.  
  626.           Some QFE commands need to know both a marked block and some other
  627.           entry. For example, the Move command moves a marked block to the
  628.           cursor line. Thus, to move the block you must first mark it, then
  629.           move the cursor to the intended destination, then give the Move
  630.           command.
  631.  
  632.           Some other commands act on a block if one is marked, but act on
  633.           the cursor line alone if not. For example, the Clear command
  634.           erases the entries in a marked block, but it erases only the
  635.           cursor line if no block is marked.
  636.  
  637.           If a marked block comprises only complete pages (pages where the
  638.           marked entries include both the page's "top" entry and its
  639.           "bottom" one), and more than one such page, some commands will
  640.           prompt whether to operate on the entire block as a unit, or on a
  641.           page by page basis. Type P for page, B for block, or Esc to quit
  642.           the prompt without performing the operation. If the command is
  643.           performed by page, all entries will stay on their original pages;
  644.           if by block, some entries may be moved to different pages than
  645.           their original ones.
  646.  
  647.  
  648.  
  649.           -----------------------------------------------------------------
  650.  
  651.                               "Oops" Windows and Worse
  652.  
  653.           =================================================================
  654.  
  655.           If QFE cannot carry out a command, it will open an "oops window",
  656.           explaining its problem and possibly suggesting how to fix the
  657.           problem.
  658.  
  659.           Suggestions for better oops windows are always welcome.
  660.  
  661.           You may, under very unusual circumstances, be presented with a
  662.           window announcing "an embarrassing, terminal failure". That does
  663.           not mean that your disk is threatened, or that your .FON file is
  664.           in danger. It means that the QFE programmer did not foresee some
  665.           problem that arose. QFE will not save your .FON file if a
  666.           terminal failure occurs. However, all that will be lost will be
  667.           the changes made in that session. Nothing on the disk will be
  668.           changed.
  669.  
  670.           A terminal failure leaves some information on the screen, with a
  671.           request to report it. Please record that information. (Press
  672.           ShiftPrtSc to copy it to your printer, if possible.) If you
  673.           report the information, together with a copy of your AUTOEXEC.BAT
  674.  
  675.  
  676.  
  677.                                           9
  678.  
  679.  
  680.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  681.  
  682.  
  683.  
  684.           and CONFIG.SYS files and any other relevant information, it may
  685.           be possible to avoid that failure in future QFE releases. And you
  686.           will receive the programmer's nearly undying (but embarrassed)
  687.           thanks.
  688.  
  689.  
  690.  
  691.           -----------------------------------------------------------------
  692.  
  693.                                     QFE Commands
  694.  
  695.           =================================================================
  696.  
  697.           Unless noted otherwise, QFE commands are given by typing a letter
  698.           from the command name, while in Command Mode. In this section,
  699.           the letter to be typed is capitalized in the command name.
  700.  
  701.           Again: Repeat a Find command, starting at the entry after the
  702.           cursor line. You must have previously done a Find command to do
  703.           an Again command.
  704.  
  705.           Clear: Erase the entries in a marked block; erase the cursor line
  706.           if no block is marked. Erasing a line clears the Name, Number,
  707.           and Script fields to all blanks, and sets other fields to default
  708.           values.
  709.  
  710.           Duplicate: Copy selected fields from the cursor line to all
  711.           entries in a marked block. (Duplicate is explained in more detail
  712.           in a later section.)
  713.  
  714.           Exchange: Exchange the entries in a marked block with those in an
  715.           equal-sized block starting at the cursor line. The cursor line
  716.           must not be within the marked block, and must not be too close to
  717.           the end of the .FON for the exchange to occur.
  718.  
  719.           Find: Locate an entry containing values you specify.  If a match
  720.           is located, the entry with the match will become the cursor line,
  721.           and the screen will display the field where the match occurred.
  722.           Find and Again start with the entry after the cursor line, so
  723.           they cannot operate with the cursor on the last line of the .FON.
  724.           They search all fields--not just Name and Number.
  725.  
  726.           Insert: Replace the entries in a marked block with "blank"
  727.           entries; replace the cursor line with a blank entry if no block
  728.           is marked.  Blank entries look like those produced by the Clear
  729.           command, with all blanks in the Name, Number, and Script fields.
  730.           The entries in the marked block, or the cursor line, are actually
  731.           moved "down" (toward the higher-numbered end of the .FON) during
  732.           an insert; blank lines from farther down are moved into the
  733.           vacated places. No entries are lost during an insert. If there
  734.           are not enough blank entries farther down, an oops window will
  735.           open.
  736.  
  737.  
  738.  
  739.  
  740.  
  741.                                          10
  742.  
  743.  
  744.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  745.  
  746.  
  747.  
  748.           Kopy: Copy the entries from a marked block in one .FON to another
  749.           .FON, starting at the cursor line of the second .FON. QFE must
  750.           have two .FONs loaded at once for Kopy to work. The block is
  751.           copied from the .FON which is not displayed to the .FON which is.
  752.           The entries in the displayed .FON are lost, overwritten by the
  753.           copied ones. If only one .FON is loaded, or the cursor is too
  754.           near the end of the displayed .FON, an oops window will open.
  755.  
  756.           Load new .FON: Load another .FON file, optionally quitting (and
  757.           possibly saving) the currently displayed one. QFE will prompt for
  758.           name of a file to load. Edit the displayed name and press Enter
  759.           to load the new .FON, or Esc to leave the prompt without loading
  760.           it. QFE will ask whether to keep the currently displayed .FON.
  761.           Note that QFE can have two .FONs loaded at once, but no more. If
  762.           you already have two .FONs loaded, you must quit one of them in
  763.           order to load a new one. See the section on "eXit QFE" for a
  764.           discussion of saving .FON files.
  765.  
  766.           Move: Move the entries in a marked block to a new location which
  767.           starts at the cursor line. Such a move rearranges more entries
  768.           than just those in the marked block; the results are sometimes
  769.           not what was intended. See the section on Undo.
  770.  
  771.           Other info: Switch between display of the Number through the
  772.           Script fields, and display of the Password through the D fields.
  773.  
  774.           Pack: Move the blank entries in a marked block to its bottom
  775.           (nearer the highest numbered entry), moving the rest of the
  776.           entries to its top.
  777.  
  778.           Quit .FON: Quit the currently displayed .FON, optionally saving
  779.           changes to disk. Do not confuse "Quit" with "eXit QFE": Quit will
  780.           leave you in QFE, editing the remaining .FON. You can only quit a
  781.           .FON if two of them are loaded; otherwise an oops window will
  782.           open. The primary purpose of Quit is to make more RAM available
  783.           by freeing that used for the currently displayed .FON file. See
  784.           the section on "eXit QFE" for a discussion of saving .FON files.
  785.  
  786.           Revise: Change from Command Mode to Edit Mode. (To return from
  787.           Edit Mode to Command Mode, press Esc. See the section on "Modes
  788.           in QFE".) While in Edit Mode you can revise entries as you might
  789.           with a word processor. Cursor keys and other keys act as you
  790.           probably expect. See the on-line help for specific details.
  791.  
  792.           Sort: Sort the entries in a marked block. The sort can be made on
  793.           up to eight fields. Each field may be individually selected to be
  794.           sorted in either order: ascending or descending. (Sort is
  795.           explained in more detail in a later section.)
  796.  
  797.           Undo: Undo restores the .FON file, the display and various other
  798.           things, to a previous state. Note that Undo is invoked with
  799.           CtrlU, as in Qmodem, rather than just the letter U. Undo is only
  800.           available if QFE currently has one or more "internal backups"
  801.           stored. If Undo is available, the displayed command list will
  802.  
  803.  
  804.  
  805.                                          11
  806.  
  807.  
  808.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  809.  
  810.  
  811.  
  812.           include "^U" to the left of "Undo", and the number of available
  813.           backups to the right. If Undo is not available, only the word
  814.           "Undo" will appear in the list. QFE tries to make an internal
  815.           backup before executing any command which modifies the .FON. For
  816.           example, QFE tries to make a backup before doing a sort, but not
  817.           before turning marks on or loading a new .FON file. Whether QFE
  818.           can make an internal backup, and how many are available, depends
  819.           on available RAM. QFE will make and keep as many internal backups
  820.           as available RAM permits. When RAM is required for other purposes
  821.           (such as loading a new .FON file, performing a sort, or making a
  822.           current internal backup), QFE disposes of the oldest backups,
  823.           until sufficient RAM is available or all backups have been
  824.           disposed of. You may see the displayed number of available
  825.           backups decrease--or disappear--when you have not commanded Undo.
  826.  
  827.           sWitch .FONs: Change the display from the currently displayed
  828.           .FON to the one not displayed. QFE must have two .FONs loaded for
  829.           sWitch to operate.
  830.  
  831.           eXit QFE: Return to DOS, optionally saving the currently loaded
  832.           .FON files. Before saving and/or returning to DOS, QFE will
  833.           prompt to be sure you want to exit. Answer Y to return to DOS, or
  834.           N or Esc to continue in QFE. Note that QFE will not prompt to
  835.           save a file if it is sure that no changes have been made. If QFE
  836.           does prompt, answer Y to save the file, N to exit without saving,
  837.           or Esc to continue in QFE without saving the file or returning to
  838.           DOS.
  839.  
  840.  
  841.  
  842.           -----------------------------------------------------------------
  843.  
  844.                                      Duplicating
  845.  
  846.           =================================================================
  847.  
  848.           Duplicate is a general purpose copy command. Although Duplicate
  849.           may appear complex at first, it is easily mastered and allows any
  850.           fields in one entry to be copied over a marked block.
  851.  
  852.           Uses for Duplicate include changing baud rates en masse, deleting
  853.           passwords, reassigning script files, etc.
  854.  
  855.           To prepare for duplication, select one entry to serve as the
  856.           master from which the duplicates will be made. Edit it so that
  857.           the fields of interest contain what you want. (You may need to go
  858.           into Edit Mode to do this.) Don't worry about the other fields--
  859.           only the fields you select will be duplicated.
  860.  
  861.           When the master entry is ready, and a block is marked, press D in
  862.           Command Mode. (Note that the master entry may be within the
  863.           marked block.)
  864.  
  865.  
  866.  
  867.  
  868.  
  869.                                          12
  870.  
  871.  
  872.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  873.  
  874.  
  875.  
  876.           The Duplicate window will open, showing all of the fields from
  877.           the master entry. It will look something like this, with the Name
  878.           field highlighted:
  879.  
  880.                  +============== Duplicate an Entry ==============+
  881.                  |                                                |
  882.                  |  Name                                          |
  883.                  |  Forbin Project--Home of Qmodem                |
  884.                  |                                                |
  885.                  |  Number              COM         Script        |
  886.                  |       1 319 233 6157  2400-8-N-1 FORBIN.SCR    |
  887.                  |                                                |
  888.                  |  Password        LastCall Total P D            |
  889.                  |  brouhaha        07-04-88   590 Z F            |
  890.                  |                                                |
  891.                  +================================================+
  892.  
  893.           Pick the fields which you do not want to copy, using Tab and
  894.           ShiftTab to move the highlighting from field to field. When a
  895.           field is highlighted, you can prevent it from being copied by
  896.           pressing AltB (for Blank). The field contents will be replaced by
  897.           a series of # characters. The # characters will not be copied
  898.           over the block; instead, Duplicate will leave the "blanked"
  899.           fields untouched.
  900.  
  901.           If a field is blanked, but you wish to duplicate it, highlight it
  902.           and press AltB again. The contents from the master entry's field
  903.           will be restored.
  904.  
  905.           When you have selected all fields which are to be blanked, and
  906.           only the fields you want to duplicate are left, press F10.
  907.  
  908.           If you decide to close the Duplicate window without doing the
  909.           copy, press Esc rather than F10.
  910.  
  911.           Suppose you were copying a .FON file for a friend who had a 1200
  912.           baud modem. One way to do that is to use Duplicate to blank the
  913.           private fields or those which might just be wrong for your
  914.           friend, like this: copy the Name, Number, Protocol and Duplex
  915.           fields as they are; blank the Script, Password and LastCall
  916.           fields; set the COM field to 1200-8-N-1, and zero the Total
  917.           field.
  918.  
  919.           To do this:  Mark the entire .FON using F6. Press R to enter Edit
  920.           mode.  Edit one entry so that the COM, Script, Password, LastCall
  921.           and Total fields are like you want them. That will be your master
  922.           entry. Press Esc to return to Command Mode. Press D to bring up
  923.           the Duplicate window. Use Tab and/or ShiftTab to move to the
  924.           Name, Number, P and D fields. In each one of those, press AltB to
  925.           fill the field with #.
  926.  
  927.           Here's how the Duplicate window would look:
  928.  
  929.  
  930.  
  931.  
  932.  
  933.                                          13
  934.  
  935.  
  936.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  937.  
  938.  
  939.  
  940.                  +============== Duplicate an Entry ==============+
  941.                  |                                                |
  942.                  |  Name                                          |
  943.                  |  ###########################                   |
  944.                  |                                                |
  945.                  |  Number              COM         Script        |
  946.                  |  ###################  1200-8-N-1               |
  947.                  |                                                |
  948.                  |  Password        LastCall Total P D            |
  949.                  |                               0 # #            |
  950.                  |                                                |
  951.                  +================================================+
  952.  
  953.           Then press F10.
  954.  
  955.           That's all there is to it. Does it seem like quite a lot? Well,
  956.           you will find that Duplicate quickly becomes easy to use. If
  957.           needed, on-line help fully explains this command.
  958.  
  959.  
  960.  
  961.           -----------------------------------------------------------------
  962.  
  963.                                        Sorting
  964.  
  965.           =================================================================
  966.  
  967.           QFE's Sort is the most powerful and general .FON file sorting
  968.           feature available anywhere.
  969.  
  970.           To Sort a marked block, press S in Command Mode. The Sort window
  971.           will open, showing the fields on which the sort can be made and
  972.           the two directions. If you have previously sorted during a
  973.           session, the window will display values from the most recent
  974.           sort. The Sort window will look something like this:
  975.  
  976.                           +===== Select Sort Fields ======+
  977.                           |                               |
  978.                           |                  Asc  Des     |
  979.                           |    Name                       |
  980.                           |    Number                     |
  981.                           |      Area Code                |
  982.                           |      Exchange                 |
  983.                           |    Baud                       |
  984.                           |    Total Calls                |
  985.                           |    Last Call                  |
  986.                           |    Script                     |
  987.                           |    Password                   |
  988.                           |                               |
  989.                           +===============================+
  990.  
  991.           The first time the Sort window opens, the cursor will be on the
  992.           Name line, in the Asc column. The Enter, Tab, ShiftTab and Space
  993.  
  994.  
  995.  
  996.  
  997.                                          14
  998.  
  999.  
  1000.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  1001.  
  1002.  
  1003.  
  1004.           keys, as well as the cursor keys, will move the cursor among the
  1005.           lines and columns.
  1006.  
  1007.           To select a field for sorting, move the cursor to the line that
  1008.           field is on. Put the cursor in the Asc column if you want that
  1009.           field to be sorted in ascending order (where 'A' comes before
  1010.           'Z'), or the Des column to sort in descending order. When you
  1011.           have the cursor in the right place, type a number from 1 to 8.
  1012.           Field number 1 would be the most important one in the sort; a
  1013.           field numbered 8 would be the least. (Don't worry about skipping
  1014.           a number or using the same number twice. QFE will fix it.)
  1015.  
  1016.           If you decide not to sort on a field which has already been
  1017.           numbered, move the cursor to that number and type a space.
  1018.  
  1019.           Notice how the Area Code and Exchange fields are indented under
  1020.           the Number field. Sorting on Number includes the contents of the
  1021.           entire Number field, so sorting on Area Code and/or Exchange
  1022.           would be redundant. Similarly, sorting on Area Code and/or
  1023.           Exchange could be messed up if also sorted on Number. QFE won't
  1024.           let you choose Number unless both Area Code and Exchange
  1025.           selections are blank, and it won't let you choose either of them
  1026.           unless the Number selection is blank.
  1027.  
  1028.           When you have selected all the fields for the sort, press F10. If
  1029.           you decide to leave the Sort window without performing the sort,
  1030.           press Esc.
  1031.  
  1032.           Suppose you wanted sort a .FON file so that entries with the
  1033.           highest baud rate were first in the file, followed by those with
  1034.           the next highest baud rate, and so on to the entries with the
  1035.           lowest baud rate. You might also want the entries grouped by area
  1036.           code within the baud groups, and by name within the area code
  1037.           groups.
  1038.  
  1039.           To do this:  Press F6 to mark the entire .FON. In Command Mode,
  1040.           press S to open the sort window. In any sequence, move the cursor
  1041.           to put the number 1 across from Baud, under Des; the number 2
  1042.           across from Area Code, under Asc; and the number 3 across from
  1043.           Name, under Asc. If the Sort window displays fields number higher
  1044.           than 3, then either ignore them (as irrelevant to your sort), or
  1045.           else move the cursor to them and type a space.
  1046.  
  1047.           Here's how the Sort window would look:
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.                                          15
  1062.  
  1063.  
  1064.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  1065.  
  1066.  
  1067.  
  1068.                           +===== Select Sort Fields ======+
  1069.                           |                               |
  1070.                           |                  Asc  Des     |
  1071.                           |    Name           3           |
  1072.                           |    Number                     |
  1073.                           |      Area Code    2           |
  1074.                           |      Exchange                 |
  1075.                           |    Baud                1      |
  1076.                           |    Total Calls                |
  1077.                           |    Last Call                  |
  1078.                           |    Script                     |
  1079.                           |    Password                   |
  1080.                           |                               |
  1081.                           +===============================+
  1082.  
  1083.           Press F10 to start the sort.
  1084.  
  1085.           At the "Page or Block" prompt, press B to treat the entire .FON
  1086.           as a single block.
  1087.  
  1088.           Sorts by Area Code and/or Exchange only work properly if you
  1089.           maintain the numbers in a particular format. If the number
  1090.           "1-900-555-1212" were entered just like that, with the "1212" in
  1091.           the four rightmost columns in the Number field, then QFE's Sort
  1092.           would interpret "900" as the Area Code and "555" as the Exchange,
  1093.           just as it should. The format "19005551212", however, would not
  1094.           be interpreted correctly.
  1095.  
  1096.           QFE expects numbers to be in the general format
  1097.  
  1098.                          xxxxxxxAAAxEEExxxxx
  1099.  
  1100.           where "AAA" is the Area Code, "EEE" is the Exchange, and "xxxx"
  1101.           can be anything.
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.                                          16
  1126.  
  1127.  
  1128.                       +-+ QFE v. 4.0 -- for Qmodem SST 4.0 +-+
  1129.  
  1130.  
  1131.  
  1132.           -----------------------------------------------------------------
  1133.  
  1134.                                      Appendix A
  1135.  
  1136.           =================================================================
  1137.  
  1138.           Number #FOR
  1139.  
  1140.                                 QFE 4.01 Registration
  1141.  
  1142.           QFE is $15 per copy, shipped prepaid on diskette in the US or to
  1143.           Canada. Orders from other countries require an additional $5 for
  1144.           shipping. Purchase orders (written) are accepted only from
  1145.           government agencies and schools. (There is a $5 surcharge for
  1146.           invoiced orders.) Payment must be in US dollars. Except for
  1147.           bankcard orders (see next paragraph) or American Express money
  1148.           orders, payment must be in cash or with instruments drawn on US
  1149.           institutions. (Payment in US funds with instruments drawn on
  1150.           foreign institutions will not be accepted.)
  1151.  
  1152.           QFE may be ordered from The Public (Software) Library at
  1153.           (800)242-4775 (orders only) or (713)665-7017 (orders or
  1154.           information), PO Box 35705, Houston, TX  77235-5705. The Public
  1155.           (Software) Library accepts MasterCard and Visa.
  1156.  
  1157.                                   Sunflower Systems
  1158.                                   718 East B Avenue
  1159.                                 Hutchinson, KS  67501
  1160.                                     (316)662-4445
  1161.  
  1162.           Name & Title : ..................................................
  1163.  
  1164.                          ..................................................
  1165.  
  1166.           Address I    : ..................................................
  1167.  
  1168.           Address II   : ..................................................
  1169.            
  1170.           City, ST zip : ..................................................
  1171.  
  1172.           Telephone    : ..................................................
  1173.  
  1174.           For corporate registration, the name and title should be those of
  1175.           the person to be notified of updates, etc.
  1176.  
  1177.           Source of your copy of QFE : ....................................
  1178.  
  1179.           Remarks : .......................................................
  1180.  
  1181.           .................................................................
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.                                          17
  1190.  
  1191.