home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / QEDIT3C.ZIP / READ.ME < prev    next >
Text File  |  1994-02-25  |  21KB  |  546 lines
  1.             Welcome to the shareware version of QEdit Advanced 3.0!
  2.                    Copyright 1985 - 1994 SemWare Corporation.
  3.                          All rights reserved worldwide.
  4.  
  5. ──────────────────────────────────────────────────────────────────────────────
  6.  
  7.           TABLE OF CONTENTS
  8.  
  9.      0    INTRODUCTION
  10.      I    SEMWARE NEWS
  11.      II   CONTENTS OF QEDIT ADVANCED SHAREWARE DISK
  12.      III  TECHNICAL SUPPORT
  13.      IV   VERSION 3.0 - RELEASE NOTES
  14.  
  15.  
  16. 0    INTRODUCTION
  17. ──────────────────────────────────────────────────────────────────────────────
  18.  
  19. This version of QEdit is NOT public domain or free software, but is being
  20. distributed as "shareware" for EVALUATION PURPOSES ONLY.
  21.  
  22. SemWare grants a limited license to individuals to use this shareware software
  23. for a 30-day evaluation period on a private, non-commercial basis, for the
  24. express purpose of determining whether QEdit is suitable for their needs. At
  25. the end of this 30-day evaluation period, the individual must either purchase
  26. a license from SemWare for continued use of the program, or discontinue using
  27. QEdit.
  28.  
  29. Many hours of work have gone into the development of QEdit - over 10
  30. work-years, as of this version - and that does not include all the time spent
  31. on our users guide/reference manual. In addition, we provide full-time
  32. support, via phone during normal business hours, or mail, fax, or BBS if you
  33. prefer.
  34.  
  35. QEdit is a professionally developed, packaged, and supported product. Our
  36. product has received excellent reviews, and our manual and product support are
  37. highly regarded by our licensed users. We offer discounts on updates to our
  38. registered users, and we regularly incorporate suggested changes into the
  39. product as we are able.
  40.  
  41. The only way we can continue to provide products like QEdit and to offer
  42. outstanding technical support, is to stay in business; and the only way we can
  43. stay in business is for those who use QEdit to purchase a license for it. We
  44. like the shareware concept and would like to stay a part of it. But we can do
  45. so only through paid licenses for QEdit. Please don't take this the wrong way
  46. - you may try QEdit for 30 days (subject to the conditions and restrictions
  47. stated in QEDIT.DOC), under no obligation to pay to use it during that time.
  48. However, if you continue to use it after that 30-day evaluation period, you
  49. must purchase a license to do so. THANKS!
  50.  
  51.  
  52. The QEdit software is owned by SemWare Corporation, or its suppliers, and is
  53. protected by United States copyright laws and international treaty provisions.
  54.  
  55. SemWare is a registered trademark of SemWare Corporation.  All other
  56. trademarks and registered trademarks referenced in this file are the property
  57. of their respective owners.  The QEdit registered trademark is used under
  58. license from Robelle Consulting Ltd.
  59.  
  60. For LICENSE, WARRANTY, U.S. GOVERNMENT RESTRICTED RIGHTS, EXPORT LAW
  61. ASSURANCES, and GOVERNING LAW AND GENERAL PROVISIONS information, see the
  62. printed documentation accompanying this software.
  63.  
  64. Please review the contents of this file before using QEdit.  It contains
  65. helpful information on the operation of QEdit and how to get assistance when
  66. you need it.  The VERSION 3.0 - RELEASE NOTES section includes an explanation
  67. of features and changes in this release not documented in the reference
  68. manual.
  69.  
  70. I    SEMWARE NEWS
  71. ──────────────────────────────────────────────────────────────────────────────
  72.  
  73. QEdit has become widely popular, with over 120,000 licensed customers
  74. throughout the U.S. and in more than 70 countries!
  75.  
  76. QEdit for OS/2 NOW AVAILABLE with HPFS support!  If you want THE FASTEST
  77. editor available for OS/2, give SemWare a call!
  78.  
  79. QEdit TSR AVAILABLE!  For those of you who would like to have access to your
  80. favorite editor at virtually anytime, in the middle of anything else, we at
  81. SemWare are proud to offer you QEdit TSR v3.0. And best of all, if you have
  82. expanded memory (192k minimum) or extended memory (384k minimum), QEdit TSR
  83. will reserve only 9k of DOS memory! See the QEdit reference manual for more
  84. details.
  85.  
  86. QEdit is the winner of the Data Based Advisor Readers Choice Award for best
  87. text/program editor for 1989, 1991 and 1992.  We thank our users for this
  88. vote of confidence and their continued support!
  89.  
  90. There are GERMAN versions available of our QEdit products.  All text
  91. displayed by the program (including the status line!) is in German, and the
  92. reference manual was painstakingly translated by a native German.  For
  93. information on ordering the German version, contact our German distributor,
  94. Manfred Luft, directly:
  95.  
  96.    Manfred Luft SoftWare              CIS:      100016,3715
  97.    Waldstr. 20a                       Internet: 100016.3715@compuserve.com
  98.    D-79194 Gundelfingen
  99.    GERMANY
  100.  
  101.                  within Germany          from the US
  102.     Telephone:    0761-58 05 26       011-49-761-580526
  103.     Fax:          0761-58 05 47       011-49-761-580547
  104.     BBS 1:        0761-58 05 22       011-49-761-580522
  105.     BBS 2:        0761-58 32 70       011-49-761-583270
  106.  
  107.  
  108.  
  109. II   CONTENTS OF QEDIT ADVANCED DISTRIBUTION DISK
  110. ──────────────────────────────────────────────────────────────────────────────
  111.  
  112. File            Description
  113. ────────────    ──────────────────────────────────────────────────────────────
  114.  
  115. Q.EXE           The editor program.  This is the only file required
  116.                 to run QEdit Advanced.
  117.  
  118. QCONFIG.EXE     The configuration program.
  119. QCONFIG.DAT     The standard Keyboard Definition File.
  120. QHELP.TXT       The standard Help text.
  121.  
  122. QMAC.EXE        Macro translator for QEdit.
  123. MACROS.TXT      Sample macros for use with QEdit.
  124.  
  125. QCP.EXE         QEdit compiler helper program.
  126. QCP.DOC         QEdit compiler helper program documentation.
  127. QCP.DAT         A configuration file for QCP.
  128. QCP.TXT         A sample QEdit macro for using with QCP.
  129.  
  130. READ.ME         The file you are currently reading.
  131. QEDIT.DOC       The documentation for the shareware version of QEdit.
  132. HELPME.DOC      Common Questions and Answers regarding QEdit.
  133. QTIPS.DOC       Helpful QEdit tips compiled by SemWare Tech support.
  134. FILE_ID.DIZ     QEdit description for bbs.
  135. VENDOR.DOC      Restrictions/Authorizations for Disk Vendor distribution.
  136. ORDERFRM.DOC    Handy order from.
  137.  
  138. SEMWARE.DOC     Information about additional SemWare products.
  139.  
  140. Notes
  141. ─────
  142.  
  143.  
  144. The ONLY file required to run QEdit is Q.EXE - the others are not required
  145. by the program.
  146.  
  147.  
  148. We DO NOT release patch files for QEdit, under any circumstances. If you
  149. encounter a "patch" file that modifies your Q.EXE file, be aware that it
  150. does not originate from us, and we cannot be responsible for the behavior of
  151. a patched QEdit. The ONLY programs you should use to modify your copy of
  152. Q.EXE, are the QCONFIG and QUPDATE programs that we supply with Q.EXE. We
  153. cannot provide support for copies of QEdit which have been modified by other
  154. third-party programs. Keep this in mind when calling for technical support.
  155.  
  156. Please make sure you read this entire file in order to take full advantage
  157. of the new commands/features in QEdit 3.0.
  158.  
  159.  
  160. III  TECHNICAL SUPPORT
  161. ──────────────────────────────────────────────────────────────────────────────
  162.  
  163. Because of the tremendous popularity of QEdit, we can give technical support
  164. ONLY to licensed, registered QEdit users.  Please have your QEdit SERIAL
  165. NUMBER handy when you call.
  166.  
  167. Please!  Before you call us with a problem, make sure you have read this
  168. entire READ.ME file to determine if it solves your problem.  You should also
  169. review the HELPME.DOC and QTIP.DOC files to see if they answer your question.
  170.  
  171. If you should need to contact us, please provide or have available the
  172. following information:
  173.  
  174.     QEdit version number, date of Q.EXE on the original diskette,
  175.       and serial number
  176.     OS/2 or DOS version
  177.     Computer model
  178.     Amount of RAM
  179.     Whether you are using a hard disk or floppy disk based PC
  180.     The names of any memory-resident programs you have loaded
  181.  
  182.  
  183. You may obtain technical support directly from SemWare as follows:
  184.  
  185. 1. Call our remote electronic bulletin board service.  The board is
  186.    operational 24 hours a day, 7 days a week.  Modem settings are <N81>,
  187.    9600 HST DS, 2400 or 1200 baud.  The BBS number is: (404) 641-8968.
  188.  
  189. 2. CompuServe (GO SEMWARE, Section 6)
  190.  
  191. 3. Send email to:
  192.  
  193.    CIS         75300,2710
  194.    Fido        1:133/314
  195.    EchoNet     50:5020/314
  196.    RIME        ->SemWare   (QEdit or RIME Admin)
  197.                ->330       (QEdit or RIME Admin)
  198.    InterNet    75300.2710@compuserve.com
  199.                or
  200.                tech.support@semware.atl.ga.us
  201.  
  202.    We can also be reached in the SemWare/QEdit echos on the following
  203.    networks:
  204.  
  205.    EchoNet, Fido, Global-Link, ILink, Intellec, MetroLink, PlanoNet, RIME,
  206.    SmartNet, U'NI-net, and W-Net.
  207.  
  208. 4. Send us a Fax: (404) 640-6213
  209.  
  210. 5. Write to us:
  211.  
  212.    SemWare Corporation
  213.    Attn: QEdit Technical Support
  214.    4343 Shallowford Road, Suite C3A
  215.    Marietta, GA  30062-5022  USA
  216.  
  217. 6. Call us directly at SemWare (404) 641-9002. Support hours are 9 am to 5
  218.    pm (ET), Monday through Friday.
  219.  
  220.  
  221. SemWare is committed to supporting registered users.  However, we request
  222. that you reserve telephone support for questions or problems requiring
  223. immediate attention.
  224.  
  225. As always, if you have a suggestion that you think would improve our
  226. product, don't hesitate to let us know.
  227.  
  228.  
  229. IV   VERSION 3.0 - RELEASE NOTES
  230. ──────────────────────────────────────────────────────────────────────────────
  231.  
  232. Important Notes
  233. ───────────────
  234.  
  235. ∙ In order to provide the utmost in reliability, the internal macro format in
  236.   QEdit 3.0 is slightly different than for previous versions.  Because of
  237.   this, macros created in prior versions of QEdit can not be used as is.
  238.  
  239.   To use these macros in QEdit 3.0, simply convert the binary macro to text
  240.   format using your pre-3.0 version of QMAC, and then convert that text macro
  241.   to binary using QMAC 3.0.
  242.  
  243. ∙ The date format supported by QEdit 3.0 is slightly different than in
  244.   previous versions.  In previous versions, the year was in 4-digit format,
  245.   and two spaces were inserted after the date string.
  246.  
  247.   In QEdit 3.0, the year is in 2-digit format, and no extra spaces are
  248.   inserted at the end of the date string.
  249.  
  250. ∙ Multi-line macros are now supported by QCONFIG, in the QCONFIG.DAT file.
  251.   Also, the MacroBegin statement is optional.  Because of these additional
  252.   features, a couple of rules must be followed:
  253.  
  254.   - Key assignments must begin in column 1.
  255.  
  256.   - Lines two and greater of a multi-line macro must start in column 2 or
  257.     greater.
  258.  
  259.   - Text starting in column 1 (other than a comment) is assumed to be the
  260.     start of a key assignment.
  261.  
  262. ∙ To take advantage of the commands assigned to the enhanced keyboard keys
  263.   (^CursorUp, ^CursorDown, f11, f12, etc), the A)dvanced configuration option,
  264.   "Test for presence of enhanced keyboard" must be set to "Y" by the QCONFIG
  265.   program.
  266.  
  267.  
  268. New Features in QEdit 3.0
  269. ─────────────────────────
  270.  
  271. This section summarizes new features available in version 3.0 of QEdit.  For
  272. more detailed information, see the QEdit reference manual.
  273.  
  274. New Commands
  275.  
  276.   Printing commands:
  277.  
  278.     SetPrintDevice - Set print output device.
  279.     SetPrintLineSpacing - Set Line spacing: 1=single, 2=double, ...
  280.     TogglePrintLineNumbers - Toggles printing of line numbers.
  281.     TogglePrintPause - Toggles pauses between printed pages.
  282.  
  283.   Tabs commands:
  284.  
  285.     SetTabType - Set tab type to FIXED, SMART, or VARIABLE.
  286.     SetVarTabStops - Set column positions of variable tab stops.
  287.     SpacesToTabs - Compresses spaces to tabs for the block or file.
  288.     TabsToSpaces - Expands tabs to spaces for the block or file.
  289.     ToggleVarTabs - Toggles VARIABLE tabs on/off.
  290.  
  291.   Sorting commands:
  292.  
  293.     ToggleSortCaseInsensitive - Toggles case sensitive Sort.
  294.     ToggleSortDescending - Toggles descending Sort order.
  295.  
  296.   Macro control commands:
  297.  
  298.     isCurrChar - Tests the value of the current character in the file.
  299.     MacroQuit - Terminates the current macro unconditionally.
  300.     MacroQuitFalse - Terminates the current macro if preceding command
  301.         returned FALSE.
  302.     MacroQuitTrue - Terminates the current macro if preceding command
  303.         returned TRUE.
  304.  
  305.   Other commands:
  306.  
  307.     DelScrBuff - Prompts for named scratch buffer to delete.
  308.     ToggleCenterFinds - Toggles centering found text horizontally in current
  309.         window.
  310.     ToggleShowCurrChar - Toggles showing of hex/decimal value of current
  311.         char on StatusLine.
  312.     AsciiChart - Displays an ASCII chart, optionally allowing insertion of a
  313.         selected character into the file.
  314.  
  315.  
  316. Additions/Changes to Menus
  317.  
  318.     Menus now have dividers that improve the readability of menus with a
  319.     large number of selections.
  320.  
  321.     The menus now include the indicators "..." and "":  "..." identifies
  322.     menu items that issue a prompt when selected; "" identifies menu items
  323.     that display a submenu or pick list when selected.
  324.  
  325.     All menu items that previously toggled a mode, such as "set Autoindent
  326.     off", now show the current mode in square brackets like this:
  327.     "Autoindent   [on ]".  As before, selecting the menu item toggles the
  328.     value.
  329.  
  330.   New menu items:
  331.  
  332.     BLOCK menu:
  333.  
  334.       Ignore case [off]              - invokes ToggleSortCaseInsensitive
  335.       desceNding  [off]              - invokes ToggleSortDescending
  336.  
  337.     SEARCH menu:
  338.  
  339.       goto Line                      - invokes GotoLine
  340.       Goto column                    - invokes GotoColumn
  341.       Match                          - invokes Match
  342.       Center finds [on ]             - invokes ToggleCenterFinds
  343.  
  344.     PRINT menu:
  345.  
  346.       set print line Spacing         - invokes SetPrintLineSpacing
  347.       print line Numbers     [off]   - invokes TogglePrintLineNumbers
  348.       print paUse            [off]   - invokes TogglePrintPause
  349.       set print Device               - invokes SetPrintDevice
  350.  
  351.     EDITING menu:
  352.  
  353.       Centerline                     - invokes CenterLine
  354.       Wrappara                       - invokes WrapPara
  355.  
  356.     OTHER menu:
  357.  
  358.       sHow char value  [off]         - invokes ToggleShowCurrChar
  359.       set tab tYpe                   - invokes SetTabType
  360.       set Variable tab stops         - invokes SetVarTabStops
  361.       eXpand tabs to spaces          - invokes TabsToSpaces
  362.       coMpress spaces to tabs        - invokes SpacesToTabs
  363.       ascii charT                    - invokes AsciiChart
  364.  
  365.  
  366. Macro Enhancements
  367.  
  368.     Note:  Macros created with previous versions of QEdit must be recompiled
  369.            in order for them to work with QEdit 3.0.
  370.  
  371.     QConfig macro space has been increased from 512 to 2048 bytes.
  372.  
  373.     Loadable macro area has been increased from 2048 to 4096 bytes.
  374.  
  375.     Startup macro in QCONFIG.DAT.  This macro is created just as any other
  376.     macro in QCONFIG.DAT, except that it is not bound to a key. Instead, you
  377.     bind this macro to the keyword "main". For example:
  378.  
  379.       main    MacroBegin HorizontalWindow PrevWindow
  380.  
  381.     Macros in QCONFIG.DAT file may now span multiple lines.  Keys MUST begin
  382.     in column one and successive lines MUST be indented by one or more spaces
  383.     or tabs.  Blank lines are ignored.  For example, the above macro could
  384.     also be written:
  385.  
  386.       main    MacroBegin              * Start of macro
  387.                   HorizontalWindow    * Split the screen
  388.                   PrevWindow          * Return to the previous window
  389.  
  390.     Comments may appear at the end of lines containing macro commands, as in
  391.     the example above.
  392.  
  393.     Macros in QCONFIG.DAT may now be assigned to twokeys.
  394.  
  395.     Macros no longer require the MacroBegin, although its use is permitted.
  396.  
  397.  
  398. Other New Features
  399.  
  400.     The maximum line length has been increased from 512 to 1000.
  401.  
  402.     QConfig twokey space has been increased from 192 to 256 bytes.
  403.  
  404.     GetScrbuff, StoreScrbuff, AppendScrbuff, and DelScrbuff will now display
  405.     a pick list of existing scratch buffers to choose from if <Enter> is
  406.     pressed at an empty prompt.
  407.  
  408.     Startup Video Mode option added.  The editor can now be configured to
  409.     come up in the current video mode, or one of the following modes:
  410.     25-line mode, 28-line mode, or 43/50-line mode.  The modes available
  411.     depend on the type of display adapter being used.
  412.  
  413.     The Insert and Overwrite cursor size is now configurable via QConfig
  414.     under the Advanced Options.  Valid values are from 0 to 7, with 0 being
  415.     the smallest possible cursor, and 7 being the largest.
  416.  
  417.     TabsOut behavior changed as follows:
  418.       If TabsOut is ON, spaces are compressed to real tabs when:
  419.         1)  the file is saved, or
  420.         2)  the SpacesToTabs command is invoked.
  421.  
  422.         Note that this is done for each line, each time the file is saved.
  423.  
  424.     New date and time formats.  DateFormat, DateSeparator, TimeFormat, and
  425.     TimeSeparator options added to support multiple date/time formats.  The
  426.     commands InsertDate and InsertTime now recognize the new formats.
  427.  
  428.             DateFormat:     1 - MM-DD-YY            [MON  06-14-93]
  429.                             2 - DD-MM-YY            [MON  14-06-93]
  430.                             3 - YY-MM-DD            [MON  93-06-14]
  431.  
  432.             DateSeparator:  can be any character; defaults to "-"
  433.  
  434.             TimeFormat:     1 - 24-hour             [15:24:18]
  435.                             2 - 12-hour             [03:24 pm]
  436.  
  437.             TimeSeparator:  can be any character; defaults to ":"
  438.  
  439.     A pop-up ASCII chart is available that inserts the selected character
  440.     when the <Enter> key is pressed.  Pressing the <Escape> key exits the
  441.     ASCII chart without placing the character into the file.
  442.  
  443.     In the FileList, files that have been changed are indicated by an "*" in
  444.     the first column of the list.
  445.  
  446.  
  447. New Options Added to QCONFIG.EXE
  448.  
  449.   Under ADVANCED OPTIONS:
  450.  
  451.     Size of cursor in Insert mode [0..7] [4] :
  452.     Size of cursor in overwrite mode [0..7] [1] :
  453.  
  454.     Date format: 1=MM-DD-YY, 2=DD-MM-YY, 3=YY-MM-DD  [1] :
  455.     Character to use to separate the elements of the date  [-] :
  456.     Time format: 1=24-hour, 2=12-hour  [1] :
  457.     Character to use to separate the elements of the time  [:] :
  458.  
  459.     Full path to QEdit files [ ] :
  460.       Identifies the directory where QEdit supplemental files are stored.
  461.  
  462.  
  463.   Under COLORS/SCREEN:
  464.  
  465.     Display hex/decimal values of current character on StatusLine (Y/N)? [N] :
  466.  
  467.     Startup video mode: 0=current, 1=25lines, 2=28lines, 3=43/50lines [0] :
  468.     Startup attribute set: 0=AutoDetect, 1=Monochrome, 2=Color [0] :
  469.     Do you want to configure the mono attribute set (Y/N)? [N] :
  470.     Do you want to configure the color attribute set (Y/N)? [N] :
  471.  
  472.   Under GENERAL OPTIONS:
  473.  
  474.     Should Find and RepeatFind center the found text (Y/N)? [Y] :
  475.  
  476.     Default to case-insensitive sort (Y/N)? [N] :
  477.     Default to descending-order sort (Y/N)? [N] :
  478.  
  479.   Under PRINTER OPTIONS:
  480.  
  481.     Include line number at beginning of each printed line (Y/N)?  [N] :
  482.     Default line spacing: 1=single, 2=double, etc... [1..255]  [1] :
  483.     Should printing pause between pages (Y/N)? [N] :
  484.     Print Device: 0=PRN, 1=LPT1, 2=LPT2, 3=LPT3 [0..3] [0] :
  485.  
  486.   Under TAB SETTINGS:
  487.  
  488.     Default tab type: 0=Fixed, 1=Smart, 2=Variable [0] :
  489.  
  490.     Default Variable Tab stop columns:
  491.      [4 8 16 24 40]
  492.      :
  493.  
  494.  
  495. Commands Available in QEdit Prompt Boxes
  496.  
  497.   The following commands are available in QEdit prompt boxes:
  498.  
  499.     Command                 Forced Key Assignment
  500.     ───────                 ─────────────────────
  501.     BackSpace
  502.     BegLine
  503.     CurrentFilename
  504.     CursorLeft              CursorLeft
  505.     CursorRight             CursorRight
  506.     DelCh
  507.     DelLine
  508.     DelToEol
  509.     EndLine
  510.     Escape                  Escape
  511.     Paste
  512.     Pause
  513.     Return                  Return
  514.     ToggleInsert
  515.  
  516.  
  517. New Standard Key Assignments
  518.  
  519.     ^]  Edit Filename at Cursor (macro)
  520.     @=  Find the next occurrence of the word at the cursor
  521.  
  522.     @f  Pulldown the File menu (macro)
  523.     @p  Pulldown the Print menu (macro)
  524.     @q  Pulldown the Quit menu (macro)
  525.  
  526.  
  527. Miscellaneous Usage Notes
  528.  
  529.   Methods to Speed Up Keyboard Delays:
  530.  
  531.     If you are running DOS 5 or greater, you can use the following DOS
  532.     command:
  533.  
  534.       mode con: rate=32 delay=1
  535.  
  536.     See your DOS reference manual for additional details.
  537.  
  538.  
  539.   Problems with TSR's and QEdit:
  540.  
  541.     If you are having problems with TSR's not popping up over QEdit, try
  542.     setting the option "Test for presence of enhanced keyboard (Y/N)?" to
  543.     "N" (the standard setting).  This option is set via the QCONFIG program,
  544.     under "Advanced options."
  545.  
  546.