home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / editors / qedit215.arj / READ.ME < prev    next >
Text File  |  1991-09-04  |  20KB  |  532 lines
  1. Welcome to the shareware version of QEdit Advanced 2.15!
  2. Copyright 1985 - 1991 by Applied Systems Technologies, Inc.
  3.  
  4. This version of QEdit is NOT public domain or free software, but is
  5. being distributed as "shareware" for EVALUATION PURPOSES ONLY.
  6.  
  7. The QEdit Advanced software is owned by Applied Systems Technologies,
  8. Inc. (doing business under the tradename SemWare) or its suppliers and
  9. is protected by United States copyright laws and international treaty
  10. provisions. SemWare and QEdit are registered trademarks of Applied
  11. Systems Technologies, Inc.
  12.  
  13. For LICENSE (including Usage and Distribution Restrictions), WARRANTY,
  14. and U.S. GOVERNMENT RESTRICTED RIGHTS information, see file QEDIT.DOC.
  15.  
  16. SemWare grants a limited license to individuals to use this shareware
  17. software for a 30-day evaluation period on a private, non-commercial
  18. basis, for the express purpose of determining whether QEdit is suitable
  19. for their needs. At the end of this 30-day evaluation period, the
  20. individual must either purchase a license from SemWare for continued use
  21. of the program, or discontinue using QEdit.
  22.  
  23. Many hours of work have gone into the development of QEdit - over 10
  24. work-years, as of this version - and that does not include all the time
  25. spent on our users guide/reference manual. In addition, we provide
  26. full-time support, via phone during normal business hours, or mail, fax,
  27. or BBS if you prefer.
  28.  
  29. QEdit is a professionally developed, packaged, and supported product.
  30. Our product has received excellent reviews, and our manual and product
  31. support are highly regarded by our licensed users. We offer discounts on
  32. updates to our registered users, and we regularly incorporate suggested
  33. changes into the product as we are able.
  34.  
  35. The only way we can continue to provide products like QEdit and to offer
  36. outstanding technical support, is to stay in business; and the only way
  37. we can stay in business is for those who use QEdit to purchase a license
  38. for it. We like the shareware concept and would like to stay a part of
  39. it. But we can do so only through paid licenses for QEdit. Please don't
  40. take this the wrong way - you may try QEdit for 30 days (subject to the
  41. conditions and restricitons stated in QEDIT.DOC), under no obligation to
  42. pay to use it during that time. However, if you continue to use it after
  43. that 30-day evaluation period, you must purchase a license to do so.
  44. THANKS!
  45.  
  46.  
  47. QEDIT NEWS:
  48. -----------
  49.  
  50. We now have over 90,000 licensed users of QEdit products, worldwide!
  51.  
  52.  
  53. QEdit TSR NOW AVIALABLE!  For those of you who would like to have access
  54. to your favorite editor at virtually anytime, in the middle of anything
  55. else, we at SemWare are proud to offer you QEdit TSR v1.1. And best of
  56. all, if you have expanded memory (192k minimum) or extended memory (384k
  57. minimum), QEdit TSR will reserve only 9k of DOS memory! See QEDITTSR.DOC
  58. for more details.
  59.  
  60.  
  61. QEdit for OS/2 NOW AVAILABLE.  If you want THE FASTEST editor available
  62. for OS/2, give SemWare a call!
  63.  
  64.  
  65. QEdit is the winner of the Data Based Advisor Readers Choice Award for
  66. best text/program editor of 1989. We thank our users for this vote of
  67. confidence and their continued support!
  68.  
  69.  
  70. There is now a GERMAN VERSION of QEdit available.  All text displayed by
  71. the program (including the status line!) is in German, and the reference
  72. manual was painstakingly translated by a native German.  For information
  73. on ordering the German version you can give SemWare a call.  OR if you
  74. prefer, you can call our German distributor, Manfred Luft, directly:
  75.  
  76.       within Germany              from the US
  77.   VOICE:     0761-580526       011-49-761-580526
  78.   FAX:       0761-580547       011-49-761-580547
  79.   BBS:       0761-580522       011-49-761-580522
  80. ========================================================================
  81.  
  82.  
  83. TABLE OF CONTENTS
  84. =================
  85.  
  86. I    Contents of QEdit Advanced Shareware Disk
  87. II   Technical Support
  88. III  Version 2.15 - Release Notes - August, 1991
  89. IV   Version 2.10 - Release Notes - February, 1990
  90.  
  91.  
  92. I    CONTENTS OF QEDIT ADVANCED SHAREWARE DISK
  93. ==============================================
  94.  
  95. File            Description
  96. ------------    --------------------------------------------------------
  97.  
  98. Q.EXE           The editor program.  This is the only file required to
  99.                 run QEdit Advanced.
  100.  
  101. QCONFIG.EXE     The configuration program.
  102. QCONFIG.DAT     The default Keyboard Definition File.
  103. QHELP.TXT       The default Help text.
  104. QEDIT.DOC       The documentation for the shareware version of QEdit,
  105.                 including LICENSE and WARRANTY information.
  106. ORDERFRM.DOC    Handy order from.
  107. READ.ME         The file you are currently reading.
  108. QEDITTSR.DOC    Release notes about the new TSR version of QEdit.
  109. VENDOR.DOC      Restrictions/Authorizations for Disk Vendor distribution.
  110.  
  111. Additional files and utilities are provided when you purchase a licensed
  112. copy of QEdit Advanced. These include: An upgrade program, that will
  113. allow you to upgrade your configuration options from QEdit v2.07,
  114. v2.07A, v2.08 or v2.10 to v2.15, PAINLESSLY; an external mouse driver
  115. for QEdit; a macro "compiler" that will translate macros from text to
  116. binary format; and additional keyboard configuration files.
  117.  
  118. Also, the LICENSED version does not include the opening and closing
  119. shareware reminder screens.
  120.  
  121. The LICENSED version also comes with an indexed, spiral-bound reference
  122. manual.  NOTE: Because of file size limitations, the documentation
  123. (QEDIT.DOC) included in this shareware package does not include the
  124. index. This allows us to include all the shareware files on a single
  125. 360K disk.
  126.  
  127. If you find any other than the 9 files listed here, then you know this
  128. is not the official shareware distribution diskette and/or archive
  129. distributed by SemWare.
  130.  
  131. Notes
  132. -----
  133.  
  134. Other product names are trademarks or registered trademarks of their
  135. respective holders.
  136.  
  137. The ONLY file required to run QEdit is Q.EXE - the others are not
  138. required or used by the program.
  139.  
  140. QEdit comes pre-configured to work on a large range of monitors. Because
  141. of this, the default colors are set up for a monochrome system. If you
  142. have a color system and would like to edit in color, then run the
  143. configuration program (QCONFIG), select the C)olors/screen options, and
  144. change the default colors. Following is a sample set of color
  145. configuration settings that you might like to try:
  146.  
  147.   New attribute for Blocked Text:  [127] : 127          (White on Grey)
  148.   New attribute for Error msgs:  [112] : 112            (Black on Grey)
  149.   New attribute for Text Area:  [27] : 27               (Cyan on Blue)
  150.   New attribute for Status Line:  [112] : 112           (Black on Grey)
  151.   New attribute for Cursor Line:  [30] : 30             (Yellow on Blue)
  152.   New attribute for Messages:  [15] : 15                (White on Black)
  153.   New attribute for Hi-lited items:  [9] : 9            (Blue on Black)
  154.   New attribute for EOF line/indicator:  [15] : 15      (White on Black)
  155.   New attribute for Help screen:  [112] : 112           (Black on Grey)
  156.   New attribute for Box borders:  [112] : 112           (Black on Grey)
  157.   New attribute for PopUp windows:  [112] : 112         (Black on Grey)
  158.   New attribute for Menu items:  [112] : 112            (Black on Grey)
  159.   New attribute for Selected Menu items:  [15] : 15     (White on Black)
  160.  
  161. We DO NOT release patch files for QEdit, under any circumstances. If you
  162. encounter a "patch" file that modifies your Q.EXE file, be aware that it
  163. does not originate from us, and we cannot be responsible for the
  164. behavior of a patched QEdit. The ONLY program you should use to modify
  165. your copy of Q.EXE, is the QCONFIG program that we supply with Q.EXE. We
  166. cannot provide support for copies of QEdit which have been modified by
  167. other third-party programs. Keep this in mind also when calling for
  168. technical support.
  169.  
  170. Please make sure you read this entire file in order to take full
  171. advantage of the new commands/features in QEdit.
  172.  
  173.  
  174. II   TECHNICAL SUPPORT
  175. ======================
  176.  
  177. Due to the tremendous popularity of QEdit, we can give technical support
  178. ONLY to licensed, registered QEdit users.  Please have your serial
  179. number handy when you call.
  180.  
  181. Please!  Before you call us with a problem, make sure you have read this
  182. entire READ.ME file to determine if it solves your problem. If you
  183. should need to contact us, please provide or have available the
  184. following information:
  185.  
  186.   QEdit version number, date of Q.EXE from the original diskette, and
  187.    serial number
  188.   DOS version
  189.   Computer model
  190.   Amount of RAM
  191.   Whether you are using a hard disk or floppy disk based PC
  192.   The names of any memory-resident programs you have loaded
  193.  
  194.  
  195. You may obtain technical support directly from SemWare as follows:
  196.  
  197. 1. Call our remote electronic bulletin board service. The board is
  198.    operational 24 hours a day, 7 days a week.  Modem settings are <N81>,
  199.    9600 HST, 2400 or 1200 baud. The telephone number is: (404) 641-8968.
  200.  
  201. 2. Write us at:
  202.  
  203.    SemWare
  204.    Technical Support
  205.    4343 Shallowford Rd., Suite C3A
  206.    Marietta, GA  30062-5022
  207.  
  208. 3. Send Compuserve E-Mail to userid 71520,67
  209.  
  210. 4. Call us directly at SemWare, (404) 641-9002. Support hours are 9 am
  211.    to 5 pm (ET), Monday through Friday.
  212.  
  213. 5. Send us a Fax: (404) 640-6213
  214.  
  215. SemWare is committed to supporting registered users.  However, we
  216. request that you reserve telephone support only for questions or
  217. problems requiring immediate attention.
  218.  
  219. As always, if you have a suggestion that you think would improve our
  220. product, don't hesitate to let us know.
  221.  
  222. By the way, SemWare has grown!  We now have ten full-time people on
  223. staff to help serve you better, and we have also moved to larger
  224. facilities.
  225.  
  226.  
  227. III  VERSION 2.15 - RELEASE NOTES - AUGUST, 1991
  228. ================================================
  229.  
  230. New Commands in QEdit Advanced 2.15 (See explanations later in this file)
  231. -------------------------------------------------------------------------
  232. AsciiChart
  233. FirstNonWhite
  234. ListFiles
  235. RestoreSettings
  236. SaveSettings
  237. SetAutoIndentMode
  238. SetInsMode
  239. SetScreenOff
  240. SetScreenOn
  241. SetSoundOff
  242. SetSoundOn
  243. SetWordWrapMode
  244. isBegLine
  245. isCursorInBlock
  246. isEmptyLine
  247. isEndLine
  248. isFirstLine
  249. isLastLine
  250.  
  251.  
  252. Additions to the Menus (command names are in []):
  253. -------------------------------------------------
  254.  
  255. File menu:
  256.   "lisT"          - invokes the new [ListFiles] command
  257. Block menu:
  258.   "copyOver"      - invokes the [CopyOverBlock] command
  259.   "Fill"          - invokes [FillBlock] command
  260.   "Sort"          - invokes the [Sort] (block) command (a column
  261.                      block must be marked)
  262. Macro menu:
  263.   "Execute scrap" - invokes the [ExecuteScrap] (macro) command
  264. Other menu:
  265.   "ascii charT"   - invokes the new [AsciiChart] command
  266.  
  267.  
  268. General Commands:
  269. -----------------
  270.  
  271. [AsciiChart]
  272.  
  273.  Displays a scrollable ASCII chart on the screen.
  274.  
  275. [ListFiles]
  276.  
  277.  Displays a list of the currently loaded files. To switch to another
  278.  file, move the cursor to the appropriate file and press <Enter>. To
  279.  keep editing the current file, press <Escape>.
  280.  
  281. [FirstNonWhite]
  282.  
  283.  Intended as a replacement and/or supplement to the [BegLine] command.
  284.  Places the cursor at the first non-white character on the line, or
  285.  column 1 if the line doesn't have any non-white characters. "White"
  286.  characters are tabs or spaces. A useful macro would be:
  287.  
  288.       Home MacroBegin BegLine JTrue done: FirstNonWhite done:
  289.  
  290.  (Explanation: If already at the start of a line, go to the first
  291.  non-white character on the line; otherwise, if not already at the start
  292.  of a line, go to the start of the line.
  293.  
  294. Advanced Macro Commands:
  295. ------------------------
  296.  
  297. The following new commands are intended for QEdit macro writers, to make
  298. certain kinds of macros easier to write.
  299.  
  300. - This group of macro commands force the indicated mode or setting. If
  301.   the setting was already in that condition, they set QEdit's result
  302.   code to TRUE; otherwise, they set it to FALSE.
  303.  
  304.   In many cases, macros can behave differently based on the currently
  305.   set QEdit modes.  The following 3 new commands give you some control
  306.   in establishing the proper environment so that your macro will always
  307.   work as intended.
  308.  
  309.   [SetInsMode]
  310.  
  311.    Sets Insert mode on. To set Insert mode off (that is, set overwrite
  312.    mode on), do the following:
  313.         SetInsMode ToggleInsert
  314.  
  315.   [SetAutoIndentMode]
  316.  
  317.    Sets AutoIndent mode on. To set AutoIndent mode off, do the
  318.    following:
  319.         SetAutoIndentMode ToggleIndent
  320.  
  321.   [SetWordWrapMode]
  322.  
  323.    Sets WordWrap mode on. To set WordWrap mode off, do the following:
  324.         SetWordWrapMode ToggleWordWrap
  325.  
  326.  
  327. - The [Find] command sounds a tone when the search string cannot be
  328.   found. This can be irritating in a long-running macro, that may
  329.   possibly execute hundreds of finds that fail. The following commands
  330.   allow you to selectively turn the sound on and off.
  331.  
  332.     [SetSoundOn]
  333.  
  334.      Sets sound on.
  335.  
  336.     [SetSoundOff]
  337.  
  338.      Sets sound off.
  339.  
  340.  
  341. - Most macros execute dozens of QEdit commands, possibly hundreds of
  342.   times. This can cause the screen to flash rapidly as the macro runs.
  343.   Not only is this somewhat disconcerting to watch, it actully slows
  344.   down the speed of some macros. The following commands allow you to
  345.   temporarily suspend or resume screen updating, while a macro is
  346.   running.
  347.  
  348.   [SetScreenOn]
  349.  
  350.    Turns screen updating on.
  351.  
  352.   [SetScreenOff]
  353.  
  354.    Turns screen updating off. You must turn screen updating back on
  355.    before your macro prompts for input, or if there is some output from
  356.    the macro that you want displayed on the screen.
  357.  
  358.    NOTE: QEdit will AUTOMATICALLY turn screen updating back on when the
  359.    macro is finished executing. Thus, it is not necessary to issue the
  360.    SetScreenOff command at the end of the macro.
  361.  
  362.  
  363. - Many times, it would be nice for a macro to force a few settings, do
  364.   its assigned task, and then restore the original settings. The
  365.   following commands allow you to do just that. Note that each time
  366.   [SaveSettings] is executed, the previous settings saved with
  367.   [SaveSettings] are overwritten.
  368.  
  369.   [SaveSettings]
  370.  
  371.    Saves the current settings of: Insert, AutoIndent, WordWrap, Sound,
  372.    and Screen Updating.
  373.  
  374.   [RestoreSettings]
  375.  
  376.    Restores the saved settings, listed above.
  377.  
  378.  
  379. - The following commands set QEdit's result code to TRUE or FALSE based
  380.   on the condition being tested. These commands make certain types of
  381.   macro tests easier and reliable.
  382.  
  383.   [isBegLine]
  384.  
  385.    Returns TRUE if the cursor is at column 1; otherwise, FALSE is
  386.    returned.
  387.  
  388.   [isEndLine]
  389.  
  390.    Returns TRUE if the cursor is past the last non-white character on
  391.    the current line; otherwise, FALSE is returned, including the case
  392.    when the cursor is on an empty line.
  393.  
  394.   [isEmptyLine]
  395.  
  396.    Returns TRUE if the current line is empty or contains only white
  397.    space; otherwise, FALSE is returned.
  398.  
  399.   [isLastLine]
  400.  
  401.    Returns TRUE if the cursor is on the last line of the currently
  402.    edited file; otherwise, FALSE is returned.
  403.  
  404.   [isFirstLine]
  405.  
  406.    Returns TRUE if the cursor is on the first line of the currently
  407.    edited file; otherwise, FALSE is returned.
  408.  
  409.   [isCursorInBlock]
  410.  
  411.    Returns TRUE if the cursor is inside a marked block; otherwise, FALSE
  412.    is returned.
  413.  
  414.  
  415. - In order to tie a few of these concepts together, we present a simple
  416.   macro to delete all the blank lines in a marked block. The cursor
  417.   should be at the beginning of the block when the macro is invoked.
  418.  
  419.    shift f9 MacroBegin
  420.              SetScreenOff                  * turn off screen for speed
  421.      begin:  isCursorInBlock jFalse done:  * exit if not in block
  422.              isEmptyLine     jFalse next:  * skip if not empty line
  423.              isLastLine      jTrue  last:  * special handling for last line
  424.              DelLine         jump  begin:  * delete empty lines
  425.      next:   CursorDown      jTrue begin:  * try next line
  426.              jump done:                    *
  427.      last:   DelLine                       * delete the last line
  428.      done:                                 * that's all, folks!
  429.  
  430.  
  431. IV   VERSION 2.10 - RELEASE NOTES - FEBRUARY, 1990
  432. ==================================================
  433.  
  434. See Appendix E in the documentation (QEDIT.DOC) for complete details
  435. regarding changes made in version 2.10. Following are highlights of
  436. those changes.
  437.  
  438. QCONFIG:
  439. --------
  440.  
  441. Deletions:
  442.  
  443.  "go to line number" configuration option has been removed. This has
  444.  been replaced with a command line option. See page E-11 in QEDIT.DOC.
  445.  
  446. Additions:
  447.  
  448.  See pages E-13 - E-14 in QEDIT.DOC.
  449.  
  450. QEdit Changes:
  451. --------------
  452.  
  453. See pages E-2 - E-3, E-5 - E-12 in QEDIT.DOC.
  454.  
  455. Major additions include:
  456.  
  457.  -Swapping on the [DOS] and [Shell] commands.
  458.  
  459.  -Prompt indicator once in the shell.
  460.  
  461.  -Column blocks can now be deleted [DeleteBlock] <Alt G>, printed
  462.   [PrintBlock] <Esc><PB>, and written [WriteBlock] <Alt W> to disk.
  463.  
  464.  -[TabRt]/[TabLt] when pressed while the cursor is inside a marked block
  465.   and insert mode is on, can optionally shift the entire block by the
  466.   current cursor tab width. This is a configurable option, and is off by
  467.   default.
  468.  
  469.  -Find/Replace command changes:
  470.  
  471.    "L" option added to [Find], [FindReplace].  Limits the
  472.    Find/FindReplace to the currently marked block.  If the cursor is
  473.    outside the marked block, or the "G" option is also selected, the
  474.    search starts at the beginning of the block. Otherwise, the search
  475.    starts at the current cursor position inside the block.
  476.  
  477.    "G" option in [Find], [FindReplace] now works as it does in WordStar
  478.    and the Borland editors; i.e., it starts the search at the beginning
  479.    of the file.
  480.  
  481.    In [FindReplace] you can now enter a number to limit the number of
  482.    replaces.
  483.  
  484.    The find string is now highlighted after a successful find.
  485.  
  486.    You can press <^Break> to halt a repeated command and/or macro, and
  487.    to halt a long [FindReplace].
  488.  
  489.    "U" is a synonym for "I" (ignore case) in the Find/Replace options.
  490.  
  491.  -Conditional logic added to the macro language. See page E-12 in
  492.   QEDIT.DOC.
  493.  
  494. New Commands:
  495. -------------
  496.  
  497. CenterLine          <^OT>
  498. FillBlock           <^KL>
  499. JFalse
  500. JTrue
  501. Jump
  502. RepeatCmd           <^QQ>
  503. SetPrintBotMargin   <ESC><P><O>
  504. SetPrintTopMargin   <ESC><P><T>
  505. ToggleSwap          <ESC><O><S>
  506.  
  507. See pages E-5 - E-8 and E-12 in QEDIT.DOC for reference information.
  508.  
  509.  
  510. Additional Notes:
  511. -----------------
  512.  
  513. If you are having problems with TSR's not popping up over QEdit, try
  514. turning enhanced keyboard testing off, in the A)dvanced options of
  515. QCONFIG.EXE. See page 2-5 in QEDIT.DOC for additional information.
  516.  
  517. Handy macro:
  518.  
  519. With the [FillBlock] command, you can now use the following macro to
  520. move a block, and blank fill the space used by the block, instead of the
  521. text closing in around the block. The macro assumes a block is already
  522. marked.  The block will be [Cut] to the clipboard or system scrap
  523. buffer.  You can then insert the block where you like by pressing the
  524. [Paste] key <Grey *>:
  525.  
  526.   f10 MacroBegin GotoBlockBeg Cut Paste FillBlock ' ' Return UnmarkBlock
  527.  
  528.   Choose a key (<f10> in the above example), and assign this macro to it
  529.   in the QCONFIG.DAT file. Then run QCONFIG (select the Keys option,
  530.   enter the name of your QCONFIG.DAT file, and Save your changes). You
  531.   now have a "copy with wipe" command!
  532.