home *** CD-ROM | disk | FTP | other *** search
/ The CIA World Factbook 1992 / k3bimage.iso / sel / 11 / 0010 / read.me < prev    next >
Encoding:
Text File  |  1991-12-02  |  18.0 KB  |  496 lines
  1.                 Welcome to QEdit Advanced - version 2.1
  2.  
  3. Please review the contents of this file before using QEdit.  It contains
  4. helpful information on the operation of QEdit and how to get assistance
  5. when you need it.  The Release Notes for version 2.1 (section 3) contain
  6. an explanation of all features and changes in this release and some
  7. additional features not documented in the 2.1 addendum.
  8.  
  9. Late-breaking news:
  10. ------------------------------------------------------------------------
  11. QEdit TSR is now available!  For those of you who would like to have
  12. access to your favorite editor at virtually anytime, in the middle of
  13. anything else, we at SemWare are proud to offer you QEdit TSR v1.1.
  14. Please call SemWare for details.
  15.  
  16. ------------------------------------------------------------------------
  17. QEdit is the winner of the Data Based Advisor Reader's Choice Award for
  18. best text or program editor of 1989.  We thank our users for this vote
  19. of confidence and their continued support!
  20.  
  21. ------------------------------------------------------------------------
  22. QEdit for OS/2 is now available.  If you'd like to have THE FASTEST
  23. editor available for OS/2, give SemWare a call!
  24.  
  25. ------------------------------------------------------------------------
  26. There is now a special German version of QEdit available.  It is based
  27. on version 2.1 of QEdit.  All text displayed by the program (including
  28. the status line!) is in German;  plus the reference manual was
  29. painstakingly translated by a native German.  For information on
  30. ordering the German version you can give SemWare a call, or if you
  31. prefer, you can call our German distributor directly at: 49-761-87419.
  32. Ask to speak to Manfred Luft.
  33.  
  34. ------------------------------------------------------------------------
  35.  
  36. Contents
  37. --------
  38.  
  39.     I   Contents of QEdit Distribution Disk
  40.     II  Technical Support
  41.     III Version 2.1 - Release Notes - February, 1990
  42.     IV  Various Keyboard Definition Files Supplied
  43.  
  44.  
  45.  
  46. I   Contents of QEdit Distribution Disk
  47. ---------------------------------------
  48.  
  49.     File            Description
  50.     ------------    ----------------------------------------------------
  51.  
  52.     Q.EXE           The editor program.  This is the only file required
  53.                     to run QEdit.
  54.  
  55.     QCONFIG.EXE     The configuration program.
  56.     QCONFIG.DAT     The default Keyboard Definition File.
  57.     QHELP.TXT       The default Help text.
  58.     READ.ME         The file you are currently reading.
  59.  
  60.       Keyboard Definition Files for the following editors are provided:
  61.  
  62.     QCONFIG.B       Brief 2.1
  63.     QCONFIG.NE      Norton Editor 1.3
  64.     QCONFIG.PE2     PE II
  65.     QCONFIG.WP      WordPerfect 5
  66.     QCONFIG.WS      WordStar 3.3 / SideKick 1.5
  67.  
  68.       Help files for the above:
  69.  
  70.     QHELP.NE
  71.     QHELP.PE2
  72.     QHELP.WP
  73.     QHELP.WS
  74.  
  75.     QUPDATE.EXE     Will copy the configuration information from QEdit
  76.                     versions 2.07 ,2.07A, or 2.08 to 2.1.  Just run
  77.                     QUPDATE and follow the prompts. If you are NOT
  78.                     upgrading from 2.07, 2.07A or 2.1, you don't need
  79.                     this file.
  80.  
  81.     QDISK.EXE       Run QDISK to obtain the amount of available memory
  82.                     and space on the current drive.
  83.  
  84.     SHOWKEY.EXE     Displays the scancode for extended keys.
  85.     CHUNKER.EXE     Splits large files into chunks for editing by QEdit.
  86.                     Will also merge these chunks back into a single
  87.                     file.
  88.  
  89.     ATKYFAST.COM    This program will speed up the keyboard response
  90.                     time on AT and 386 style computers.  It is NOT a
  91.                     TSR.  Just type ATKYFAST.  Note that this program
  92.                     will not work on all clones, but it will not cause
  93.                     any problems on them either.
  94.  
  95.     QMAC.EXE        Macro translator for QEdit.
  96.     QMAC.DOC        Macro translator documentation.
  97.  
  98.     The following files are courtesy of Karl Brendel, author of QFonEdit
  99.     and ProFonEdit.
  100.  
  101.     MACROS.MIS      Sample macros.
  102.     MACROS.PAS      Sample macros for Pascal programming.
  103.  
  104.     The following files are courtesy of Jerry Houston.
  105.  
  106.     QM.COM          Mouse driver for QEdit.
  107.     QM.DOC          Mouse driver documentation.
  108.  
  109.  
  110.     Notes
  111.     -----
  112.  
  113.     Other product names are trademarks or registered trademarks of their
  114.     respective holders.
  115.  
  116.     The ONLY file required to run QEdit is Q.EXE - the others are not
  117.     required or used by the program.
  118.  
  119.     QEdit comes pre-configured to work on a large range of monitors.
  120.     Because of this, the default colors are set up for a monochrome
  121.     system. If you have a color system and would like to edit in color,
  122.     then run the configuration program (QCONFIG), select the
  123.     C)olors/screen options, and change the default colors.
  124.  
  125.     NOTE:  We do NOT release patch files for QEdit, under any
  126.            circumstances. We release only fully-executable files.  If
  127.            you encounter a "patch" or "modification" file that modifies
  128.            your Q.EXE file, be aware that it does not originate from us,
  129.            and we cannot be responsible for the behavior of a patched
  130.            QEdit.  The only program you should use to modify your copy
  131.            of Q.EXE, is the QCONFIG program that came with it. Keep this
  132.            in mind when calling for technical support.
  133.  
  134.     Please, make sure you read this entire file to take full advantage
  135.     of the new commands/features in QEdit.
  136.  
  137.  
  138. II  Technical Support
  139. ---------------------
  140.  
  141. Due to the tremendous popularity of QEdit, we can give technical support
  142. ONLY to registered QEdit users.  Please have your QEdit SERIAL NUMBER
  143. handy when you call.
  144.  
  145.     Please!  Before you call us with a problem, make sure you have read
  146.     this entire READ.ME file to determine if it solves your problem.  If
  147.     you should have to contact us, please provide or have available the
  148.     following information:
  149.  
  150.         QEdit version number, date of Q.EXE on the original diskette,
  151.           and serial number
  152.         DOS version
  153.         Computer model
  154.         Amount of RAM
  155.         Whether you are using a hard disk or floppy disk based PC
  156.         The names of any memory-resident programs you have loaded
  157.  
  158.  
  159.     You may obtain technical support directly from SemWare as follows:
  160.  
  161.         1.  Call our remote electronic bulletin board service.  The
  162.             board is operational 24 hours a day, 7 days a week.  Modem
  163.             settings are <N81>, 9600 HST, 2400 or 1200 baud.  The
  164.             telephone number is: (404) 641-8968.
  165.  
  166.         2.  Write us at: (We've moved!)
  167.  
  168.                          SemWare
  169.                          Technical Support
  170.                          4343 Shallowford Rd., Suite C-3
  171.                          Marietta, GA  30062-5003
  172.  
  173.         3.  Send Compuserve E-Mail to userid 71520,67
  174.  
  175.         4.  Call us directly at SemWare, (404) 641-9002. Support hours
  176.             are 9 am to 5 pm (ET), Monday through Friday.
  177.  
  178.         5.  Send us a Fax at: (404) 640-6213
  179.  
  180.     SemWare is committed to supporting registered users.  However, we
  181.     request that you reserve telephone support only for questions or
  182.     problems requiring immediate attention.
  183.  
  184.     As always, if you have a suggestion that you think would improve our
  185.     product, don't hesitate to let us know.
  186.  
  187.     By the way, SemWare has grown!  We now have eight full-time people
  188.     on staff to help serve you better, and we have also moved to larger
  189.     facilities.
  190.  
  191. III Version 2.1 - Release Notes - February, 1990
  192. ------------------------------------------------
  193.  
  194. 2.1 summary of changes:
  195. -----------------------
  196.  
  197. QCONFIG:
  198. --------
  199.  
  200.  Deletions:
  201.  
  202.    "number of rows on physical screen option" has been removed.  QEdit
  203.    now retrieves this information from the bios data area, so this option
  204.    is no longer needed.
  205.  
  206.    "go to line number on command line option" has been removed. This has
  207.    been replaced with a command line option.
  208.  
  209.  Additions:
  210.  
  211.   Under Advanced options:
  212.  
  213.     "Swap to Expanded memory or DISK on Dos and Shell commands?"
  214.     "Drive to use for disk swapping [A..Z] *=default-drive ?"
  215.     "Should the editor restore the starting drive/dir on program exit?"
  216.     "Should the editor change the DOS PROMPT during a shell?"
  217.     "Should [TabRt]/[TabLt] be allowed to shift an entire block?"
  218.  
  219.   Under general options:
  220.  
  221.     "Do you want the bell to sound on warning messages and missed
  222.     searches?"
  223.  
  224.   Under printer options:
  225.  
  226.     "Default top margin for printing [0..100]?"
  227.     "Default bottom margin for printing [0..100]?"
  228.  
  229. QEdit CHANGES:
  230. --------------
  231.  
  232. New command line option:
  233.  
  234.   -n command line option.  For example:
  235.      q filename -n36
  236.   goes to line 36 in filename after initial load.
  237.  
  238. Operational changes:
  239.  
  240.   The [Dos] and [Shell] commands can now optionally swap QEdit out to
  241.   disk or EMS leaving only a 2k kernel in memory, thus allowing much
  242.   more memory for running memory-hungry programs from QEdit, especially
  243.   compilers.  This option is configurable via QCONFIG as well as
  244.   interactively using the [ToggleSwap] command, found on the "Other"
  245.   pulldown menu.
  246.  
  247.   Once in the shell, QEdit will optionally append "[QE]" to the DOS
  248.   prompt string, provided that:
  249.  
  250.   1) You have defined the prompt environment variable.
  251.   2) There is enough space left in the environment.
  252.   3) You have set the "Change DOS PROMPT during a Shell" option to
  253.      [Y]es.  See QCONFIG, under Advanced options.
  254.  
  255.   If you have NOT defined the prompt environment variable, then we
  256.   suggest you do so.  It is helpful with DOS command line operations in
  257.   general. A suggested prompt is (this should go in your AUTOEXEC.BAT
  258.   file):
  259.  
  260.   set prompt=$p $t $g
  261.  
  262.   If you do have a prompt string defined, but you do not get the "[QE]"
  263.   prompt in the QEdit shell, add the following to your AUTOEXEC.BAT:
  264.  
  265.   set x=x
  266.  
  267.   ----------------------------------------------------------------------
  268.  
  269.   Column blocks can now be deleted [DeleteBlock] <Alt G>, printed
  270.   [PrintBlock] <Esc><PB>, and written [WriteBlock] <Alt W> to disk.
  271.  
  272.   [TabRt]/[TabLt] when pressed while the cursor is inside a marked
  273.   block and insert mode is on, shifts the entire block by the current
  274.   cursor tab width.
  275.  
  276.   The window resize command allows up and down movement, instead of only
  277.   up or only down.
  278.  
  279.   .cpp, .hpp, .cxx, .hxx have been added to the list of valid C Mode
  280.   file extensions.
  281.  
  282.   Prompt boxes show prompt strings in the block attribute while they
  283.   will be overwritten when a character is typed; once a character or
  284.   editing key has been typed, prompt strings revert back to their
  285.   default color.
  286.  
  287.   [CurrentFilename] is now available outside of prompt boxes. In
  288.   previous versions, the [CurrentFilename] command was active only
  289.   during a QEdit prompt box.  This command now functions while editing,
  290.   too.
  291.  
  292. Find/Replace command changes:
  293.  
  294.   "L" option added to [Find], [FindReplace].  Limits the
  295.   Find/FindReplace to the currently marked block.  If the cursor is
  296.   outside the marked block, or the "G" option is also selected, the
  297.   search starts at the beginning of the block.  Otherwise, the search
  298.   starts at the current cursor position inside the block.
  299.  
  300.   "G" option in [Find], [FindReplace] now works as it does in WordStar
  301.   and the Borland editors; i.e., it starts the search at the beginning
  302.   of the file.
  303.  
  304.   In [FindReplace] you can now enter a number to limit the number of
  305.   replaces.
  306.  
  307.   The find string is now highlighted after a successful find.
  308.  
  309.   You can press <^Break> to halt a repeated command and/or macro, and to
  310.   halt a long [FindReplace].
  311.  
  312. New commands:
  313. -------------
  314.  
  315. Summary list:
  316.  
  317. CenterLine                      <^OT>
  318. FillBlock                       <^KL>
  319. JFalse
  320. JTrue
  321. Jump
  322. RepeatCmd                       <^QQ>
  323. SetPrintBotMargin               <ESC><P><O>
  324. SetPrintTopMargin               <ESC><P><T>
  325. ToggleSwap                      <ESC><O><S>
  326.  
  327. Detailed list:
  328.  
  329.   [CenterLine]                  <^OT>
  330.  
  331.   If the cursor is inside a column block, the lines encompassed by the
  332.   block are centered using the left and right columns of the block as
  333.   the margins.
  334.  
  335.   If the cursor is inside a line block, the lines encompassed by the
  336.   block are centered using column 1 and the right margin as the margins.
  337.  
  338.   Otherwise, the line the cursor is on is centered, using column 1 and
  339.   the right margin as the margins.
  340.  
  341.   [FillBlock]                   <^KL>
  342.  
  343.   The user is prompted for a character with which to fill the block.
  344.   With this command, you can now use the following macro to move a
  345.   block, and blank fill the space used by the block, instead of the
  346.   text closing in around the block.  The macro assumes a block is
  347.   already marked.  The block will be [Cut] to the clipboard or system
  348.   scrap buffer.  You can then insert the block where you like by
  349.   pressing the [Paste] key <Grey *>:
  350.  
  351.   f10 MacroBegin GotoBlockBeg Cut Paste FillBlock ' ' Return UnmarkBlock
  352.  
  353.   Choose a key (<f10> in the above example), and assign this macro to it
  354.   in the QCONFIG.DAT file. Run QCONFIG, configure the keyboard, and you
  355.   now have a "copy with wipe" command!
  356.  
  357.   [JTrue], [JFalse] and [Jump] commands.
  358.  
  359.   These commands are intended for macro use. All QEdit commands set an
  360.   internal QEdit result code of "True" if they executed successfully, or
  361.   "False" if they did not.  The [JTrue] and [JFalse] commands can be
  362.   used to take advantage of that fact. [Jump] is just an unconditional
  363.   jump. You can also define labels for branching, in the format
  364.   "label:". The maximum label length is 15 characters.  For Example:
  365.  
  366.   A command to delete from the cursor position to the beginning of the
  367.   line, assigned to the f10 key:
  368.  
  369.   f10 MacroBegin
  370.       begin:
  371.         CursorLeft
  372.         JFalse done:
  373.         DelCh
  374.         Jump begin:
  375.       done:
  376.  
  377.   This MUST all occur on ONE LINE in your QCONFIG.DAT file.
  378.  
  379.   [RepeatCmd]                   <^QQ>
  380.  
  381.   Repeats the last executed command and/or macro "n" times.  You are
  382.   prompted for "n".  You can stop the repeating at any time by pressing
  383.   the <^Break> key.  If the result code from the command is FALSE, or if
  384.   a result code from any of the commands in the macro is FALSE,
  385.   repetition halts.
  386.  
  387.   [SetPrintTopMargin]           <ESC><P><T>
  388.   [SetPrintBotMargin]           <ESC><P><O>
  389.  
  390.   Set the top and bottom margins used when printing.  If QEdit's print
  391.   page size is set to 0, these commands have no effect.
  392.  
  393.   [ToggleSwap]                  <ESC><O><S>
  394.  
  395.   Toggles Expanded memory/Disk swapping for the [Dos] and [Shell]
  396.   commands.  This option can also be set via QCONFIG.
  397.  
  398. IV  Various Keyboard Definition Files Supplied
  399. ----------------------------------------------
  400.  
  401. DESCRIPTION
  402. -----------
  403. QEdit has an extraordinary capacity for customization.  Almost every key
  404. on the keyboard can be assigned to any command, to achieve any sort of
  405. configuration the user might desire.
  406.  
  407. In particular, users switching from another editor to QEdit can install
  408. QEdit to "emulate" the other editor.  This decreases the amount of time
  409. spent learning QEdit.
  410.  
  411. However, setting up the configuration file to emulate another editor can
  412. take a fair amount of time.  We have provided a collection of
  413. ready-to-use keyboard definition files, to simplify the task of making
  414. QEdit work like a variety of other editors and word processors.
  415.  
  416. Both a keyboard definition file (QCONFIG.*) and a help file (QHELP.*)
  417. are supplied for most of the emulations, allowing you to configure both
  418. your keyboard definition and help screen.
  419.  
  420.  
  421. CONTENTS
  422. --------
  423. The following keyboard emulations are provided:
  424.  
  425.      Brief
  426.           QCONFIG.B
  427.  
  428.      Norton Editor 1.3c
  429.           QCONFIG.NE
  430.           QHELP.NE
  431.  
  432.      Personal Editor II (IBM)
  433.           QCONFIG.PE2
  434.           QHELP.PE2
  435.  
  436.      WordPerfect 4.2/5.0
  437.           QCONFIG.WP
  438.           QHELP.WP
  439.  
  440.      WordStar 3.3 (& SideKick/Borland Environments)
  441.           QCONFIG.WS
  442.           QHELP.WS
  443.  
  444.  
  445. INSTRUCTIONS
  446. ------------
  447. It is strongly recommended that, after choosing your emulation, you
  448. print out all the files associated with it.  There are two reasons for
  449. doing this.
  450.  
  451. First, by reading the keyboard definition file, you can see where each
  452. and every key on the keyboard is assigned, as well as the various notes
  453. and comments included inside.
  454.  
  455. Second, several of the keyboard definition files include instructions on
  456. how to answer the other questions and prompts within the configuration
  457. program to best emulate that editor.  You will need a print-out of this
  458. information to refer to while running the QEdit configuration program
  459. (QCONFIG.EXE)
  460.  
  461. Looking at the various help files may also give you some ideas for
  462. formatting a good help screen, if you decide to customize your own.
  463.  
  464. Follow these steps to install the desired keyboard definition:
  465.  
  466.      1.  Put your chosen keyboard definition and help files (e.g.,
  467.          QCONFIG.WS and QHELP.WS) in the same directory with Q.EXE and
  468.          QCONFIG.EXE.
  469.  
  470.      2.  Run QCONFIG, by simply entering the following from your QEdit
  471.          directory: QCONFIG<Enter><Enter>
  472.  
  473.      3.  Select "K" from the configuration program menu to install
  474.          K)eys. When prompted, enter the name of the desired keyboard
  475.          definition file (e.g., QCONFIG.WS).
  476.  
  477.      4.  Select "H" from the configuration program menu to install
  478.          H)elp. When prompted, enter the name of the appropriate help
  479.          file (e.g., QHELP.WS).
  480.  
  481.      5.  If your keyboard definition file has comments indicating
  482.          appropriate settings for other QCONFIG options, select those
  483.          menu options and set them as required, or to your preference.
  484.  
  485.      6.  Press "S" to S)ave your modified Q.EXE to disk.
  486.  
  487.  
  488. And that's it!  You should now be ready to go, with a version of QEdit
  489. that will act "just like" your former editor.
  490.  
  491. ACKNOWLEDGEMENTS
  492. ----------------
  493. Several of these files were originally submitted by QEdit users on
  494. SemWare's BBS. Thanks to Randy Wallin, Steve Lynch, Tim Farley, and many
  495. others for their input.
  496.