home *** CD-ROM | disk | FTP | other *** search
/ Shareware Gold 1 / The_Golden_ROM_Series_-_Shareware_Gold_Volume_1_Number_11_-_SK_89-301_-_1989.iso / BBS / LIB023.ARC / QFONEDIT.DOC < prev    next >
Text File  |  1988-01-01  |  41KB  |  891 lines

  1.  
  2.  
  3.  
  4.                     QFONEDIT--THE QMODEM PHONE DIRECTORY EDITOR
  5.  
  6.                                    Version 3.00
  7.  
  8.                          (C)1985, 1986, 1987 Karl Brendel
  9.  
  10.  
  11.  
  12.  
  13.           Qfonedit, a copyrighted product, is a trademark of Karl
  14.           Brendel. License to use Qfonedit is granted without charge,
  15.           subject to the restrictions listed below. License to copy and
  16.           distribute Qfonedit and its documentation is also granted
  17.           without charge, subject to the same restrictions.
  18.  
  19.           To register Qfonedit, or to inquire about marketing, site
  20.           licensing, or any other matters regarding Qfonedit, please
  21.           contact:
  22.  
  23.                                    Karl Brendel
  24.                                  718 East B Avenue
  25.                                Hutchinson, KS  67501
  26.  
  27.           The restrictions:
  28.  
  29.             1. Copies of Qfonedit must contain this license information,
  30.           the copyright and trademark notices, and the warranty
  31.           disclaimers in full.
  32.             2. Copies of Qfonedit may not be sold without the written
  33.           permission of the author. However, except for the "enhanced"
  34.           version of Qfonedit, users' groups and bona fide not-for-
  35.           profit organizations may distribute Qfonedit and charge a
  36.           nominal amount (not to exceed $10) for materials, shipping and
  37.           handling, without written permission. (Only Karl Brendel may
  38.           distribute the enhanced version.) Such distribution must
  39.           include a statement that fees collected by the distributor are
  40.           not paid to Karl Brendel, are not in lieu of registration, and
  41.           do not grant license beyond that specified in this manual.
  42.           (Satisfying restriction 1 satisfies this restriction as well.)
  43.             3. Commercial users of Qfonedit must register and pay for
  44.           their copies of Qfonedit within 30 days of first use or their
  45.           license is withdrawn.
  46.             4. Users of Qfonedit must accept this disclaimer of
  47.           warranty: "Qfonedit is supplied as-is. The author disclaims
  48.           all warranties, expressed or implied, including, without
  49.           limitation, the warranties of merchantability and of fitness
  50.           for any purpose. The author assumes no liability for damages,
  51.           direct or consequential, which may result from the use of
  52.           Qfonedit."
  53.  
  54.           Qmodem is a trademark of John Friel III and the Forbin
  55.           Project. Turbo Pascal is the trademark of Borland
  56.           International. WordStar is the trademark of MicroPro. MS-DOS
  57.           is the trademark of MicroSoft Corporation; the term "DOS" used
  58.           here may refer to MS-DOS or to IBM's Disk Operating System.
  59.           DESQview is the trademark of Quarterdeck Office System.
  60.           TopView is the trademark of IBM.
  61.  
  62.  
  63.  
  64.  
  65.                                    Qfonedit 3.00
  66.  
  67.                                  Table of Contents
  68.  
  69.  
  70.             1. Qfonedit:  What It Does ............................... 1
  71.  
  72.             2. Starting Qfonedit ..................................... 1
  73.  
  74.             3. Qfonedit Keys ......................................... 2
  75.  
  76.             4. Qfonedit Prompts ...................................... 3
  77.  
  78.             5. Stopping Qfonedit ..................................... 4
  79.  
  80.             6. The Main Menu ......................................... 4
  81.  
  82.             7. The Editor ............................................ 5
  83.  
  84.             8. Marking Blocks in the Editor .......................... 6
  85.  
  86.             9. Other Routines ........................................ 6
  87.  
  88.            10. Configuring Qfonedit .................................. 9
  89.  
  90.            11. Registration and Support of Qfonedit ................. 10
  91.  
  92.            12. My Thanks to ......................................... 12
  93.  
  94.            Appendix A:  WordStar/Turbo Keys in Qfonedit ............. 13
  95.  
  96.            Appendix B:  Block Specifications ........................ 14
  97.  
  98.            Appendix C:  TopView and DESQview ........................ 15
  99.  
  100.  
  101.  
  102.           Qfonedit: The Qmodem Phone Directory Editor             Page 1
  103.  
  104.  
  105.           1. Qfonedit:  What It Does
  106.  
  107.           Qfonedit is designed to be your all-purpose Qmodem directory
  108.           maintenance utility.
  109.  
  110.           You may not need Qfonedit. If your entire dialing directory
  111.           fits on one display page, you can probably maintain it more
  112.           easily within Qmodem--but if that isn't the case, you should
  113.           take Qfonedit now! The first few uses will show you that you
  114.           needed it.
  115.  
  116.           Qfonedit operates on your fon file (the term used here for
  117.           your Qmodem directory file, which may be named QMODEM.FON or
  118.           anything else) to allow you to view all entries, sort them in
  119.           several fashions, rearrange, insert or delete them quickly in
  120.           arbitrary ways, reset the default parameters en masse, insert
  121.           blank lines, print the directory to disk, delete your
  122.           passwords, search for names, or edit the entries a full page
  123.           at a time.
  124.  
  125.           Qfonedit allows you to configure several of its features,
  126.           including varying or eliminating its sound effects and
  127.           choosing whether to work from a menu. At your option, Qfonedit
  128.           will read communication parameters and screen colors from
  129.           Qmodem, or allow you to set them directly.
  130.  
  131.           The enhanced version of Qfonedit (available to registered
  132.           users at no additional charge) is able to save configuration
  133.           information in a file for restoration of your configuration
  134.           choices whenever it runs. It also features on-line help for
  135.           most functions.
  136.  
  137.           Qfonedit can find your fon file down any path which you
  138.           have provided in configuring it, and will prompt for a new
  139.           path if its search fails. Floppy disk users will be pleased to
  140.           realize that they do not have to keep the Qmodem files and the
  141.           Qfonedit files all on one disk.
  142.  
  143.           Qfonedit requires an IBM PC or close compatible, with DOS 2.0
  144.           or later, and at least 170k of available RAM.
  145.  
  146.  
  147.  
  148.           2. Starting Qfonedit
  149.  
  150.           Place the files QFONEDIT.COM, QFONEDIT.000 and QFONEDIT.001
  151.           (and QFONEDIT.HLP and QFONEDIT.CNF, if you are using the
  152.           enhanced version) all in the same subdirectory. Make that disk
  153.           the logged disk and that subdirectory the current directory.
  154.           From the DOS prompt, simply command QFONEDIT. Example:
  155.  
  156.                             C>QFONEDIT
  157.  
  158.  
  159.  
  160.           Qfonedit: The Qmodem Phone Directory Editor             Page 2
  161.  
  162.  
  163.           You may also start QFONEDIT and give it the name of your fon
  164.           file, including drive and path if not the logged drive and
  165.           current directory. (If you do this, you must provide the file
  166.           name, even if it is QMODEM.FON.) Example:
  167.  
  168.                             C>QFONEDIT A:\QDIR\SPECIAL.FON
  169.  
  170.           In order to function, Qfonedit must be able to find the fon
  171.           file and the overlay files QFONEDIT.000 and QFONEDIT.001. If
  172.           unable to do so, Qfonedit will halt with an error message.
  173.  
  174.           If the enhanced version of Qfonedit is able to find the file
  175.           QFONEDIT.CNF, it will check to see if a special path to the
  176.           phone directory has been configured. If so, and a file name
  177.           was not entered as shown in the example above, Qfonedit will
  178.           look at the end of that path for the file QMODEM.FON. If
  179.           unable to find QMODEM.FON there, Qfonedit will look in the
  180.           current directory on the logged drive. If unable to find
  181.           QMODEM.FON, Qfonedit will halt with an error message.
  182.  
  183.           If enhanced Qfonedit does find the file QFONEDIT.CNF, it will
  184.           use the values in that file to set screen colors, sound
  185.           effects, default communication parameters, etc. If unable to
  186.           find the configuration file, enhanced Qfonedit will attempt to
  187.           create a new one with its standard default values. If unable
  188.           to create the new configuration file, enhanced Qfonedit will
  189.           give you a chance to attempt the save again or to continue
  190.           without it.
  191.  
  192.           As Qfonedit goes thru its start-up procedure, it will display
  193.           its progress in a status window. It will pause briefly to
  194.           "allow" you to read the license information. Pressing any key
  195.           will cut the pause short. Starting Qfonedit with /f on the
  196.           command line will eliminate the pause:
  197.  
  198.                             C>QFONEDIT /F
  199.  
  200.           After the pause, Qfonedit will display the Main Menu and the
  201.           Editor screen and await further command.
  202.  
  203.  
  204.  
  205.           3. Qfonedit Keys
  206.  
  207.           Thruout this manual, Ctrl will be used to indicate the
  208.           "control key", likely marked Ctrl on your keyboard. A term
  209.           such as "CtrlX" will mean "holding down the control key while
  210.           pressing the X key". Likewise, Alt will mean the "alternate
  211.           shift key", probably marked Alt on your keyboard, and "AltX"
  212.           will mean "holding down the alternate shift key while pressing
  213.           the X key". FX will mean the function key numbered X; eg, F1
  214.           is the function key number 1.
  215.  
  216.  
  217.  
  218.           Qfonedit: The Qmodem Phone Directory Editor             Page 3
  219.  
  220.  
  221.           Qfonedit makes consistent use of keys everywhere except in the
  222.           Editor and the configuration routines. The Editor's use of
  223.           keys is described in the section on the Editor. The use of
  224.           keys in the configuration routines follows the lead of the
  225.           Qmodem program QINSTALL.COM.
  226.  
  227.           Qfonedit command keys are "hot": when you press them, an action
  228.           occurs without the need to press Enter.
  229.  
  230.           If you press a key that has no meaning to Qfonedit in its then-
  231.           current context, the computer will beep; otherwise, you will
  232.           hear a click. You may think of the beep as an error signal,
  233.           and the click as a success signal. (Beeps and clicks can be
  234.           changed or turned off in the configuration routines.)
  235.  
  236.           Qfonedit is never sensitive to letter case. Pressing "C" will
  237.           have the same result as pressing "c".
  238.           Qfonedit is not case sensitive. Pressing "C" will has the same
  239.           effect as pressing "c".
  240.  
  241.           Pressing Esc (the Escape key) may return you to the previous
  242.           menu, or from the Main Menu to the Editor. Esc is active in
  243.           most instances when Qfonedit is awaiting input.
  244.  
  245.           The PgDn and PgUp keys will display the other pages just as
  246.           they do in Qmodem.
  247.  
  248.           Pressing O (AltO in the Editor), when both a menu and a page
  249.           of the fon file are displayed, will toggle contents of the fon
  250.           file display, just as it does in Qmodem. In the same
  251.           situations, pressing U (AltU in the Editor) will "undo"
  252.           previous actions.
  253.  
  254.           When editing, whether in the Editor or when providing input
  255.           such as file names, paths, etc., Qfonedit recognizes many of
  256.           the Ctrl key combinations used in WordStar and in the Turbo
  257.           Pascal editor. The use of such key combinations is
  258.           summarized in an appendix.
  259.  
  260.           In the enhanced, registered version of Qfonedit, on-line help
  261.           is generally accessible by pressing the F1 key.
  262.  
  263.  
  264.  
  265.           4. Qfonedit Prompts
  266.  
  267.           When Qfonedit prompts for a yes or no response, press the Y or
  268.           N key, or the Enter key. Usually a default response will be
  269.           displayed at the cursor--the default is accepted with the
  270.           Enter key. (At many prompts, pressing Esc will exit from the
  271.           prompt and return to a previous menu.) A common use of the
  272.           yes/no prompt is the "Go? Y" prompt, which precedes execution
  273.           of commands which will alter the fon file. Pressing Y or Enter
  274.           will cause the command to execute; pressing N will prevent it.
  275.  
  276.  
  277.  
  278.           Qfonedit: The Qmodem Phone Directory Editor             Page 4
  279.  
  280.  
  281.           The Go prompt may be turned off in configuration. If Go is
  282.           turned off, all Qmodem commands which would prompt "Go Y?"
  283.           will execute without it.
  284.  
  285.           When Qfonedit prompts for a line or page number, no default
  286.           value is available for the initial prompt. If there is a
  287.           second prompt, as for a second line number, the response to
  288.           the first prompt is used as a default value. (Again, pressing
  289.           Esc will usually exit from the prompt and return to a previous
  290.           menu.)
  291.  
  292.           When Qfonedit prompts for a string input, such as a file name
  293.           or a search string, a default value may be displayed. If so,
  294.           that value may be accepted by pressing Enter, or the value may
  295.           be edited or replaced entirely. The editing process is similar
  296.           to that of the Qmodem file allocation windows, except that a
  297.           larger set of editing keys--such as the cursor keys--is
  298.           available than in Qmodem.
  299.  
  300.  
  301.  
  302.           5. Stopping Qfonedit
  303.  
  304.           From the Main Menu, pressing Q will stop Qfonedit and return to
  305.           DOS. You will be prompted to insure that you do wish to exit
  306.           Qfonedit. (This prompt may be turned off in configuration.)
  307.  
  308.           If you made changes to the fon file, you will be prompted to
  309.           save it. If you save the fon file, you will be prompted to save
  310.           the old file with the extension .BAQ. If you choose to save
  311.           the old file, and a .BAQ file already exists, you will be
  312.           prompted whether to save it with the extension .OLD.
  313.  
  314.           During configuration, you may specify which save prompts you
  315.           wish to be given and which actions you wish to take without
  316.           prompting.
  317.  
  318.  
  319.  
  320.           6. The Main Menu
  321.  
  322.           The Main Menu shows a list of Qfonedit commands and the key
  323.           which must be pressed to activate each command. Upon pressing
  324.           a valid command key, the indicated routine will run. Upon
  325.           completing the routine, control will return to the Main Menu,
  326.           unless Qfonedit has been configured to operate from the
  327.           Editor.
  328.  
  329.           Operating from the Editor allows the experienced user to
  330.           bypass the Main Menu, both when calling and when returning
  331.           from a routine.  All commands which may be given from the Main
  332.           Menu may be given from the Editor by holding down the Alt key
  333.           while pressing the key which would be used in the Main Menu.
  334.           For example, when in the Main Menu, pressing S calls the Sort
  335.  
  336.  
  337.  
  338.           Qfonedit: The Qmodem Phone Directory Editor             Page 5
  339.  
  340.  
  341.           routine. When in the Editor, pressing AltS calls the Sort
  342.           routine. At the end of the routine, control transfers to the
  343.           Main Menu, unless the choice is made in configuration to
  344.           return to the Editor instead.
  345.  
  346.           The routines available from the Main Menu are all discussed in
  347.           one later section, except for the Editor, which is discussed
  348.           in the next section.
  349.  
  350.  
  351.  
  352.           7. The Editor
  353.  
  354.           When in the Editor, the lower portion of the screen will
  355.           contain either a brief reminder of keys used in editing, or a
  356.           list of the Alt keys used to invoke other routines. (See "The
  357.           Main Menu" for a discussion of Alt keys in the Editor.) Which
  358.           display is shown depends on whether Qfonedit is configured to
  359.           return to the Editor or to the Main Menu.
  360.  
  361.           PgUp and PgDn will change the displayed page. The cursor row
  362.           and column will be preserved from page to page, and while
  363.           executing other routines. (The exception is the Locate
  364.           routine, which may change page, row, and column.) AltO will
  365.           toggle the display of alternate information in the right-hand
  366.           columns. AltU will attempt Undo. F1 or Esc will pop up the
  367.           Main Menu.
  368.  
  369.           The cursor may be moved all over the displayed page with the
  370.           normal IBM-type cursor keys, the Enter key, tab, shift-tab,
  371.           Home and End. In some of the displayed fields, editing can use
  372.           the Del, Ins, CtrlEnd (erase to the end of the field) and
  373.           backspace keys.
  374.  
  375.           The normal cursor mode for editing is "overwrite"--the
  376.           character you type will replace that previously at the same
  377.           location. In some fields, Ins will toggle between overwrite
  378.           and insert modes. When in insert mode, the cursor will be
  379.           thicker, to remind you of the mode. The mode will return to
  380.           overwrite when the cursor passes the end of the field, or a
  381.           cursor control key or PgUp or PgDn changes the cursor
  382.           location.
  383.  
  384.           The Editor will refuse to accept key input which it recognizes
  385.           as meaningless to Qmodem or to DOS. For example, you cannot
  386.           use the Editor to specify communication parameters of 8-E-3.
  387.           You can do something such as make total connects be "12 34",
  388.           but after you save the fon file, you will find that the total
  389.           connects are "1234", without the internal space. (Not all
  390.           errors are caught in the Editor. Some are trapped in fon file
  391.           file processing when the file is saved.)
  392.  
  393.  
  394.  
  395.           Qfonedit: The Qmodem Phone Directory Editor             Page 6
  396.  
  397.  
  398.           8. Marking Blocks in the Editor
  399.  
  400.           While in the Editor, blocks of lines may be "marked". Other
  401.           Qfonedit routines can operate on marked blocks without having
  402.           to be given page or line numbers to describe them. (Eg.: In
  403.           the Clear routine, choosing to clear by Lines leads to two
  404.           prompts for line numbers. If those lines were the top and
  405.           bottom of a marked block, the choice to clear Marked would
  406.           eliminate the need for those prompts.) The next section covers
  407.           the way in which each routine uses marked blocks.
  408.  
  409.           To mark a block, use PgUp, PgDn and the cursor control keys to
  410.           put the cursor on the first line of the block. Press F3. Move
  411.           the cursor to the last line of the block. Press F4. To mark
  412.           the cursor line, press F6.
  413.  
  414.           A marked line appears in a color which should contrast with
  415.           unmarked lines. (The color of marked lines may be chosen in
  416.           configuration.)
  417.  
  418.           Only one block may be marked at a time. The cursor line,
  419.           however, may be marked separately, whether it is contained
  420.           within a marked block or not. The cursor line is marked by
  421.           changing the color of only the line number. If the cursor is
  422.           within a marked block, the line number takes on the normal,
  423.           unmarked color, to set it off from the marked lines around it.
  424.  
  425.           To turn off the marking, so that all lines are displayed in
  426.           the unmarked color, press F5. If lines have been marked, but
  427.           the marking has been turned off, it may be turned on by again
  428.           pressing F5 .
  429.  
  430.           When marking is turned off, the other Qfonedit routines will
  431.           not be able to use the marked block feature.
  432.  
  433.  
  434.  
  435.           9. Other Routines
  436.  
  437.           The Main Menu resembles:
  438.  
  439.           =
  440.                         C - Clear         P - Print
  441.                         D - Defaults      Q - Quit
  442.                         E - Edit          R - Register
  443.                         F - conFig        S - Sort
  444.                         I - Insert        T - Tidyup
  445.                         L - Locate        U - Undo
  446.                         M - Move          W - passWord
  447.                         N - New .fon      X - eXchange
  448.                         O - Other info
  449.  
  450.                                    Choice
  451.           =
  452.  
  453.  
  454.  
  455.           Qfonedit: The Qmodem Phone Directory Editor             Page 7
  456.  
  457.  
  458.           (Thruout this manual, the = character denotes the top or
  459.           bottom of a picture of the screen.)
  460.  
  461.           "Clear" sets a block to "empty line" values: default values
  462.           for Speed, Data Bits, Parity, Stop Bits, Protocol and Echo,
  463.           spaces everywhere else. Clear operates from one line thru
  464.           another, or from one page thru another, or from the start thru
  465.           the end of a marked block.
  466.  
  467.           "Defaults" sets certain fields in a block to default values:
  468.           Speed, Data Bits, Parity, Stop Bits, Protocol and Echo. You
  469.           may choose whether to act on all lines in the block, or only
  470.           "empty lines" (those having all blanks in Name and Number
  471.           fields). You may also choose to act only on the Speed field,
  472.           and leave the others alone. Defaults operates on the entire
  473.           fon file, or from one line thru another, or from one page thru
  474.           another, or from the start thru the end of a marked block.
  475.  
  476.           "conFigure" allows you to specify many of Qfonedit's operating
  477.           features. It is discussed more fully in the next section.
  478.  
  479.           "Insert" blanks lines in front of a target line (the
  480.           cursor line, if it is marked). What is actually done is that
  481.           empty lines from further into the fon file (lines with higher
  482.           numbers) are moved to the target position, and other lines are
  483.           moved "up" into their places. If there are not enough empty
  484.           lines available to accomplish the insert, you will be
  485.           informed.
  486.  
  487.           "Locate" searches the Name field in a block for a match to
  488.           an input string. The search is insensitive to case (SMITH is
  489.           the same as Smith). Trailing blanks are discarded, but leading
  490.           ones are not (" Smith " matches " SMITH" but not "SMITH "). If
  491.           a match is found, the page on which it occurs is displayed and
  492.           the line on which it occurs is marked as the cursor line. If a
  493.           return is made to the Editor without otherwise changing the
  494.           display, the Editor's cursor will be in the first column on
  495.           the marked line. Subsequent matches may be attempted on the
  496.           same block and string with the Next command. Locate searches
  497.           the entire file, or from one line thru another, or from one
  498.           page thru another, or from the start thru the end of a marked
  499.           block.
  500.  
  501.           "Move" moves a block from one location to another in front
  502.           of (with lower line numbers than) a target. If the target is
  503.           the last line or last page of the fon file, the option is
  504.           given to make the chosen lines be the last in the file. Move
  505.           moves from one line thru another to in front of a target line,
  506.           or from one page thru another to in front of a target page, or
  507.           from the start thru the end of a marked block to in front of
  508.           the marked cursor line.
  509.  
  510.  
  511.  
  512.           Qfonedit: The Qmodem Phone Directory Editor             Page 8
  513.  
  514.  
  515.           "New" loads a different fon file. If changes have been
  516.           made in the current file, the configured prompts will be given
  517.           for saving it. This is an easy, if ungraceful, way to save the
  518.           current fon file, at the expense of reading it back in after
  519.           the save.
  520.  
  521.           "Print" "prints" a block to a disk file. You may choose to
  522.           print all lines, or only non-empty lines. The current display
  523.           will determine the contents of the print file: if Number,
  524.           etc., are displayed, they will be in the print file;
  525.           otherwise, Password, etc. will be. If the range is defined by
  526.           Page, then headers will be included ahead of every page in the
  527.           print file; otherwise, only one header will be provided for
  528.           the entire file. The print file may be edited with any text
  529.           editor or word processor which can read a "plain ASCII" or
  530.           "text" file, or it may be printed from the DOS command line
  531.           with a command such as:
  532.  
  533.                             C>COPY QMODEM.PRN PRN
  534.  
  535.           (Of course, your printer must be ready to print when you issue
  536.           that command.) Print operates on the entire fon file as one
  537.           block, or the entire fon file page by page, or from one line
  538.           thru another, or from one page thru another, or from the start
  539.           thru the end of a marked block.
  540.  
  541.           "Quit" terminates Qfonedit, making any configured prompts for
  542.           quitting and file saving.
  543.  
  544.           "Register" displays Qfonedit licensing and registration
  545.           information, and offers to print a form for registering and
  546.           for ordering the enhanced version.
  547.  
  548.           "Sort" sorts a block on the Name field, the Number field or
  549.           numeric subfields, the Speed field, the Last Connect field,
  550.           and the Total Calls field, or any combination of those fields,
  551.           in any mixture of ascending and descending order. The sort is
  552.           insensitive to case, just as the Locate search is. Search
  553.           operates on the entire fon file as one block, or the entire
  554.           fon file page by page, or from one line thru another, or from
  555.           one page thru another, or from the start thru the end of a
  556.           marked block.
  557.  
  558.           "Tidyup" packs the entries in a block into its low-numbered
  559.           lines. The rest of the block will be filled out by empty
  560.           lines. Tidyup operates on the entire fon file as one block, or
  561.           the entire fon file page by page, or from one line thru
  562.           another, or from one page thru another, or from the start thru
  563.           the end of a marked block.
  564.  
  565.           "Undo" returns the fon file to the more recent of two states:
  566.           the state at initial loading of the file, or at entry into the
  567.           last routine which modified the fon file. (See below.) Only
  568.  
  569.  
  570.  
  571.           Qfonedit: The Qmodem Phone Directory Editor             Page 9
  572.  
  573.  
  574.           one level of Undo is provided. An attempt to Undo a second
  575.           level will cause display of an error message.
  576.  
  577.           "passWord" clears the password field in a block. (This is
  578.           handy if you wish to give away a copy of your fon file without
  579.           compromising your passwords.) Password operates the entire
  580.           file, or from one line thru another, or from one page thru
  581.           another, or from the start thru the end of a marked block.
  582.  
  583.           "eXchange" trades the location of one block and another. (If
  584.           the two blocks overlap, only portions of the blocks will
  585.           actually be moved, and no lines will be lost.) Exchange
  586.           trades the location of one line and another, or one page and
  587.           another, or by "range": An example of an exchange by range is
  588.           "eXchange 5 lines starting at line 11 with those starting at
  589.           line 21." Exchange also operates on a marked block as a range:
  590.           from the start thru the end of a marked block are exchanged
  591.           with the same number of lines starting at the marked cursor
  592.           line.
  593.  
  594.  
  595.  
  596.           10. Configuring Qfonedit
  597.  
  598.           Choosing F (for conFig) from the Main Menu brings up the
  599.           Configuration Menu.
  600.  
  601.           The Configuration Menu resembles:
  602.  
  603.           =
  604.           Configuration for Qfonedit(tm) v3.0
  605.  
  606.                    1) Screen and menu colors
  607.                    2) Communication parameters
  608.                    3) Path definition
  609.                    4) Prompts
  610.                    5) Sounds
  611.                    6) Miscellaneous Options
  612.                    S) Save configuration and return to Qfonedit
  613.                    X) Return to Qfonedit without saving configuration
  614.  
  615.           Option >
  616.           =
  617.  
  618.           Indicate your selection by pressing the number or letter shown
  619.           to the left of the description.
  620.  
  621.           Configuration Menu choices are:
  622.  
  623.                   1) Screen and menu colors: Select foreground, back-
  624.                   ground and border colors just as they are selected in
  625.                   QINSTALL. As an option, Qfonedit can attempt to read
  626.                   the screen and menu colors from the file QMODEM.CNF.
  627.  
  628.  
  629.  
  630.           Qfonedit: The Qmodem Phone Directory Editor            Page 10
  631.  
  632.  
  633.                   2) Communication parameters: Select default speed,
  634.                   parity, data bits, stop bits, protocol and echo. The
  635.                   selected settings will be used whenever you command
  636.                   Clear or Defaults from the Main Menu. Here, also,
  637.                   Qfonedit can attempt to read the parameters from the
  638.                   file QMODEM.CNF.
  639.  
  640.                   3) Path definition: Specify a drive and path down
  641.                   which Qfonedit should look for the fon file. (If you
  642.                   enter a path and filename on the DOS command line,
  643.                   that will be checked first.) (Path definition is
  644.                   useful only with enhanced Qfonedit.
  645.  
  646.                   4) Prompts: Specify which prompts will be given when
  647.                   leaving Qfonedit and saving the fon file, and/or which
  648.                   actions will be taken without prompting.
  649.  
  650.                   5) Sounds: Specify whether Beeps and Clicks (key-
  651.                   clicks) are turned on or off. Select the length and
  652.                   pitch of the Beeps and Clicks and hear a sample of
  653.                   the selection. (When pressing F2 or F4 to hear the
  654.                   sample, you may first hear a Click--if Clicks are
  655.                   turned on. After a brief pause, the selected Beep or
  656.                   Click will be demonstrated.)
  657.  
  658.                   6) Miscellaneous Options: Specify whether routines
  659.                   return to the Main Menu or to the Editor. Specify
  660.                   whether Qfonedit should check and wait for a video
  661.                   retrace signal (preventing visual "snow" on IBM color
  662.                   graphics adapters and clones) or do screen display
  663.                   without awaiting the retrace (vastly speeding up
  664.                   display).
  665.  
  666.                   S) Save configuration and return to Qfonedit: The
  667.                   enhanced version of Qfonedit can save configuration
  668.                   information in the file QFONEDIT.CNF and restore that
  669.                   configuration whenever Qfonedit is run.
  670.  
  671.                   X) Return to Qfonedit without saving configuration
  672.  
  673.           Note that changes in configuration are effective immediately.
  674.           The new configuration will not be saved on disk unless you
  675.           have the enhanced version and choose S). Changes in
  676.           communication parameters will not be apparent in your phone
  677.           directory unless you choose Defaults and/or Clear from the
  678.           Main Menu.
  679.  
  680.  
  681.  
  682.           11. Registration and Support of Qfonedit
  683.  
  684.           You are probably familiar with the arguments in favor of user-
  685.           supported software: It allows you to try before you buy,
  686.           encourage creative programming, avoid paying the costs
  687.  
  688.  
  689.  
  690.           Qfonedit: The Qmodem Phone Directory Editor            Page 11
  691.  
  692.  
  693.           associated with commercial marketing, even use a program
  694.           legally without ever compensating the author. (You wouldn't do
  695.           that, would you?)
  696.  
  697.           If you have not paid for Qmodem, please do that now.
  698.  
  699.           After you have paid for Qmodem, if you find Qfonedit to be
  700.           useful or interesting enough, please pay $10.00 for it. You
  701.           will earn my appreciation, as well as having the feeling that
  702.           you have furthered the development of affordable software.
  703.           (Please note: If you paid anybody but me anything for this
  704.           program, I did not get any of the money.)
  705.  
  706.           When paying, please choose Register from the Main Menu or
  707.           Editor, and let Qfonedit print out a registration form for
  708.           you. The form will provide enough information for me to let
  709.           you know about future major releases, and satisfy my lawyer
  710.           that I'm not giving away the store just because I distribute
  711.           on bulletin boards, etc.
  712.  
  713.           As this manual has mentioned several times, an enhanced
  714.           version of Qfonedit is available to registered users. Your
  715.           copy of the enhanced version may be had with no additional
  716.           charge if you will send me a 5.25" diskette. If you wish, you
  717.           may send additional money rather than a diskette. If you
  718.           provide the diskette, please format it, use a reusable mailer,
  719.           and include an addressed label and return postage. If you
  720.           prefer for me to provide the diskette, mailer, etc., please
  721.           send $5.
  722.  
  723.           Whether you pay or not, please pass this package along to
  724.           anyone else who has a use or desire for it.
  725.  
  726.           Payments and hard-copy messages may be sent to:
  727.  
  728.                                    Karl Brendel
  729.                                  718 East B Avenue
  730.                                Hutchinson, KS  67501
  731.  
  732.           Questions, bug reports, anything suitable for modem
  733.           communication, are most likely to reach me at these bulletin
  734.           boards:
  735.  
  736.                       Forbin Project PCBoard    319 233 6157
  737.                       Fargo RBBS                701 293 5973
  738.                       Atlantic Palisades Magpie 718 238 7855
  739.                       Tamiami BBS (PCBoard)     813 793 2392
  740.                       Sleepy Hollow PCBoard     213 859 9334
  741.                       Software Society PCBoard  201 729 7410
  742.  
  743.           You may also contact me on CompuServe (ID 73307,3101). I try
  744.           to call the listed bulletin boards on a weekly basis, and
  745.           CompuServe twice a week. Additionally, I support Qfonedit by
  746.           voice phone when that is really needed.
  747.  
  748.  
  749.  
  750.           Qfonedit: The Qmodem Phone Directory Editor            Page 12
  751.  
  752.  
  753.           12. My Thanks to...
  754.  
  755.             John Friel III, author of Qmodem
  756.             Dave Baldwin, author of TDebug and TDebug+
  757.             TurboPower Software, creators and marketers of great
  758.               programming tools.
  759.             Keith Shafer, for the file TURSORT.PAS
  760.             Tenenbaum and Augenstein, authors of "Data Structures Using
  761.               Pascal"
  762.             Jim Everingham, author of The Window Manager (Can someone
  763.               tell me where Jim is? I owe him some money.)
  764.             Marshall Brain and Bela Lubkin, renowned programmers
  765.             Marty Moleski, a stimulating conferee
  766.             Sammy Mitchell, another stimulating thinker, a great
  767.               programmer, and a good friend
  768.             Philippe Kahn and Borland International
  769.             NCRA, the National Cooperative Refinery Association, my
  770.               employer
  771.  
  772.  
  773.  
  774.           Qfonedit: The Qmodem Phone Directory Editor            Page 13
  775.  
  776.  
  777.           Appendix A:  WordStar/Turbo Keys in Qfonedit
  778.  
  779.           Because I use the Turbo Pascal editor a great deal, it has
  780.           often been convenient for me to configure other programs to
  781.           use "Turbo keys" whenever possible. The Turbo Pascal editor
  782.           key combinations, in turn, are based on the WordStar word
  783.           processor. I have included several Turbo key combinations in
  784.           Qfonedit, altho they do not show up on the menus.
  785.  
  786.           The IBM-style keys and their equivalent Turbo key combinations
  787.           are:
  788.  
  789.  
  790.                            CursorUp........CtrlE
  791.                            CursorDown......CtrlX
  792.                            CursorRight.....CtrlD
  793.                            CursorLeft......CtrlS
  794.                            PgUp............CtrlR
  795.                            PgDn............CtrlC
  796.                            Home............CtrlT
  797.                            End.............CtrlB
  798.                            Ins.............CtrlV
  799.                            Del.............CtrlG
  800.                            CtrlEnd.........CtrlY
  801.                            Tab.............CtrlI or CtrlF
  802.                            Shift Tab.......CtrlA
  803.                            F3..............CtrlK-CtrlB
  804.                            F4..............CtrlK-CtrlK
  805.                            F5..............CtrlK-CtrlH
  806.  
  807.           Note that not all of the key combinations are "standard" Turbo
  808.           keys. Some of these operate by field rather than by word or by
  809.           line, so CtrlF moves to the start of the next field and CtrlA
  810.           moves to the start of the current or previous field.
  811.  
  812.           Most two-key combinations are not supported, so CtrlY
  813.           functions like Turbo's CtrlQ-CtrlY combination, CtrlT like
  814.           CtrlQ-CtrlR, etc.
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.           Qfonedit: The Qmodem Phone Directory Editor            Page 14
  822.  
  823.  
  824.           Appendix B:  Block Specifications
  825.  
  826.           The means to specify blocks of lines for the various operations are:
  827.  
  828.                     Global                Line/Lines            Range
  829.                            Global by Page            Page/Pages       Marked
  830.  
  831.           Clear       X                   from/thru  from/thru          X
  832.           Defaults    X                                                 X
  833.           Locate      X                   from/thru  from/thru          X
  834.           Move                            from/thru  from/thru          X
  835.           Print       X          X        from/thru  from/thru          X
  836.           Sort        X          X        from/thru  from/thru          X
  837.           Tidyup      X          X        from/thru  from/thru          X
  838.           passWord    X          X                                      X
  839.           eXchange                        line&line  page&page    X     X
  840.  
  841.           "from/thru" indicates that the prompts will be for "From
  842.           Line:" (or "Page") and "Thru Line:" (or "Page").
  843.  
  844.           "line&line" indicates that the prompts will be "Line:" and
  845.           "and Line:". "page&page" indicates similar prompts for page.
  846.  
  847.           "Global by Page" means that each page is operated on
  848.           separately, but all pages are operated on. Lines will not be
  849.           moved from page to page.
  850.  
  851.           Additionally, Defaults requires that a specification be made
  852.           of "Empty lines" or all lines.
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.           Qfonedit: The Qmodem Phone Directory Editor            Page 15
  860.  
  861.  
  862.           Appendix C:  TopView and DESQview
  863.  
  864.           Qfonedit will run under TopView, "in a window". In order to
  865.           install Qfonedit under TopView, select "Add a Program to Menu"
  866.           from the opening TopView menu. From the "Select a Program"
  867.           menu, select "Other". When prompted, provide the path to the
  868.           directory in which Qfonedit resides. Then when prompted,
  869.           provide the "Program Title"--the name TopView will use in
  870.           listing Qfonedit on the opening menu--and the "Program Name"--
  871.           QFONEDIT.COM. For "Memory Requirements", type 196. After you
  872.           hit Enter, TopView will return to the opening menu. There,
  873.           select "Change Program Info" and then select Qfonedit. Edit
  874.           the screen to change the following information to what is
  875.           shown here:
  876.  
  877.                   Data Files Location = [ dr:path to QMODEM.FON ]
  878.  
  879.                   Program writes directly to screen : n
  880.  
  881.                   Program accesses system keyboard buffer : n
  882.  
  883.                   Program runs only in the foreground : n
  884.  
  885.                   Program uses math coprocessor : n
  886.  
  887.           I am told that the techniques which enable Qfonedit to run in
  888.           a TopView window should also enable it to run in a window
  889.           under DESQview.
  890.  
  891.