home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / tse2jr4.zip / READ.ME < prev    next >
Text File  |  1997-02-21  |  21KB  |  530 lines
  1.              The SemWare Editor Junior/2 (TSE Jr/2) - version 4.0
  2.                   Copyright 1985 - 1997 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 TSE JR/2 SHAREWARE DISK
  12.      III  TECHNICAL SUPPORT
  13.      IV   VERSION 4.0 - RELEASE NOTES
  14.      V    OS/2 SPECIFIC NOTES
  15.  
  16.  
  17. 0    INTRODUCTION
  18. ──────────────────────────────────────────────────────────────────────────────
  19.  
  20. This version of TSE Jr/2 is NOT public domain or free software, but is being
  21. distributed as "shareware" for EVALUATION PURPOSES ONLY.
  22.  
  23. SemWare grants a limited license to individuals to use this shareware software
  24. for a 30-day evaluation period on a private, non-commercial basis, for the
  25. express purpose of determining whether TSE Jr/2 is suitable for their needs. At
  26. the end of this 30-day evaluation period, the individual must either purchase
  27. a license from SemWare for continued use of the program, or discontinue using
  28. TSE Jr/2.
  29.  
  30. Many hours of work have gone into the development of TSE Jr - over 11
  31. work-years, as of this version - and that does not include all the time spent
  32. on our users guide/reference manual. In addition, we provide full-time
  33. support, via phone during normal business hours, or mail, or fax, if you
  34. prefer.
  35.  
  36. The only way we can continue to provide products like TSE Jr/2 and to offer
  37. outstanding technical support, is to stay in business; and the only way we can
  38. stay in business is for those who use TSE Jr/2 to purchase a license for it.
  39. We like the shareware concept and would like to stay a part of it. But we can
  40. do so only through paid licenses for TSE Jr/2.  Please don't take this the
  41. wrong way - you may try TSE Jr/2 for 30 days (subject to the conditions and
  42. restrictions stated in TSEJR2.DOC), under no obligation to pay to use it
  43. during that time. However, if you continue to use it after that 30-day
  44. evaluation period, you must purchase a license to do so. THANKS!
  45.  
  46. The SemWare Editor Junior software is owned by SemWare Corporation, or its
  47. suppliers, and is protected by United States copyright laws and international
  48. treaty provisions.
  49.  
  50. SemWare is a registered trademark of SemWare Corporation.  All other
  51. trademarks and registered trademarks referenced in this file are the property
  52. of their respective owners.
  53.  
  54. For LICENSE, WARRANTY, U.S. GOVERNMENT RESTRICTED RIGHTS, EXPORT LAW
  55. ASSURANCES, and GOVERNING LAW AND GENERAL PROVISIONS information, see the
  56. documentation accompanying this software.
  57.  
  58.  
  59. I    SEMWARE NEWS
  60. ──────────────────────────────────────────────────────────────────────────────
  61.  
  62. The SemWare Editor (in both its Professional and Junior versions) has over
  63. 130,000 licensed customers throughout the U.S. and in more than 95 countries!
  64.  
  65. The SemWare Editor Junior for OS/2 is available with Long Filename and
  66. Extended Attribute support.
  67.  
  68. The SemWare Editor Junior / Mem-Res is AVAILABLE!  For those who would like
  69. to have access to an editor at virtually anytime, in the middle of anything
  70. else, we offer a memory-resident version of The SemWare Editor Junior.  And
  71. best of all, if you have expanded memory (192k minimum) or extended memory
  72. (384k minimum), the memory resident version will require only 9k of DOS
  73. memory!  See the reference manual for more details.
  74.  
  75. TSE Jr. is the winner of the Data Based Advisor Readers Choice Award for best
  76. text/program editor for 1989, 1991 and 1992, and received an honorable mention
  77. in 1994.  We thank our users for this vote of confidence and continued
  78. support!
  79.  
  80. There are GERMAN versions available of The SemWare Editor products.  All text
  81. displayed by the program (including the StatusLine!) is in German, and the
  82. reference manual was painstakingly translated by a native German.  For
  83. information on ordering the German version, contact our German distributor,
  84. Manfred Luft, directly:
  85.  
  86.    Manfred Luft SoftWare              CIS:      100016,3715
  87.    Waldstr. 20a                       Internet: 100016.3715@compuserve.com
  88.    D-79194 Gundelfingen
  89.    GERMANY
  90.  
  91.                  within Germany          from the US
  92.     Telephone:    0761-58 05 26       011-49-761-580526
  93.     Fax:          0761-58 05 47       011-49-761-580547
  94.     BBS:          0761-58 05 22       011-49-761-580522
  95.  
  96.  
  97. II   CONTENTS OF TSE JR/2 DISTRIBUTION DISK
  98. ──────────────────────────────────────────────────────────────────────────────
  99.  
  100. File            Description
  101. ────────────    ──────────────────────────────────────────────────────────────
  102.  
  103. Q.EXE           The editor program.  This is the only file required
  104.                 to run TSE Jr/2.
  105.  
  106. QCONFIG.EXE     The configuration program.
  107. QCONFIG.DAT     The standard Keyboard Definition File.
  108. QHELP.TXT       The standard Help text.
  109.  
  110. READ.ME         The file you are currently reading.
  111. TSEJR2.DOC      The documentation for the shareware version of TSE Jr/2.
  112. MACRO.DOC       Macro Reference guide.
  113. MACROS.TXT      Sample macros for use with The SemWare Editor Junior.
  114. HELPME.DOC      Common Questions and Answers regarding TSE Jr/2.
  115. QTIPS.DOC       Helpful TSE Jr/2 tips compiled by SemWare Tech support.
  116. FILE_ID.DIZ     TSE Jr/2 description for bbs.
  117. VENDOR.DOC      Restrictions/Authorizations for Disk Vendor distribution.
  118. ORDERFRM.DOC    Handy order from.
  119. KBFAST.EXE      Utility to speed up keyboard response.
  120.  
  121.  
  122. Notes
  123. ─────
  124.  
  125. The ONLY file required to run TSE Jr/2 is Q.EXE - the others are not required by
  126. the program.
  127.  
  128.  
  129. III  TECHNICAL SUPPORT
  130. ──────────────────────────────────────────────────────────────────────────────
  131.  
  132. We can give technical support ONLY to licensed, registered users. Please have
  133. your SERIAL NUMBER handy when you call.
  134.  
  135. Please!  Before you call us with a problem, make sure you have read this
  136. entire READ.ME file to determine if it solves your problem.  If you should
  137. need to contact us, please provide or have available the following
  138. information:
  139.  
  140.   - The SemWare Editor Junior Version number and Serial number
  141.   - OS/2, Windows, and DOS versions
  142.   - Computer model
  143.   - Amount of RAM
  144.   - The names of any memory-resident programs you have loaded
  145.  
  146. You may obtain technical support directly from SemWare via any of the
  147. following:
  148.  
  149. 1. Internet
  150.  
  151.    FTP         ftp.semware.com
  152.    WWW         http://www.semware.com
  153.  
  154. 2. Send email to:
  155.  
  156.    InterNet    tech.support@semware.com
  157.    CIS         75300,2710
  158.  
  159.    On InterNet, we now have full FTP access so that macros, tips, demos, and
  160.    many other utilities can be downloaded.  We are building TSE-specific
  161.    mailing lists that will allow us to deliver future product information
  162.    directly to your email mailbox.
  163.  
  164. 3. CompuServe (GO SEMWARE, Section 6)
  165.  
  166. 4. Send us a Fax: (770) 640-6213
  167.  
  168. 5. Write to us:
  169.  
  170.    SemWare Corporation
  171.    Attn: TSE Jr/2 Technical Support
  172.    4343 Shallowford Road, Suite C3A
  173.    Marietta, GA  30062-5022  USA
  174.  
  175. 6. Call us directly at SemWare (770) 641-9002. Support hours are 9 am to 5 pm
  176.    (ET), Monday through Friday.
  177.  
  178. SemWare is committed to supporting registered users.  However, we request that
  179. you reserve telephone support for questions or problems requiring immediate
  180. attention.
  181.  
  182. As always, if you have a suggestion that you think would improve our products,
  183. do not hesitate to let us know about it.
  184.  
  185.  
  186. IV   VERSION 4.0 - RELEASE NOTES
  187. ──────────────────────────────────────────────────────────────────────────────
  188.  
  189. Important Notes
  190. ───────────────
  191.  
  192. ∙ Multi-line macros are supported by QCONFIG, in the QCONFIG.DAT file. Also,
  193.   the MacroBegin statement is optional.  Because of these additional features,
  194.   a couple of rules must be followed:
  195.  
  196.   - Key assignments must begin in column 1.
  197.  
  198.   - Lines two and greater of a multi-line macro must start in column 2 or
  199.     greater.
  200.  
  201.   - Text starting in column 1 (other than a comment) is assumed to be the
  202.     start of a key assignment.
  203.  
  204. ∙ To take advantage of the commands assigned to the enhanced keyboard keys
  205.   (^CursorUp, ^CursorDown, f11, f12, etc), the A)dvanced configuration option,
  206.   "Test for presence of enhanced keyboard" must be set to "Y" by the QCONFIG
  207.   program.
  208.  
  209.  
  210. New Features in TSE Jr/2 4.0
  211. ────────────────────────────
  212.  
  213. ■ Integrated Mouse Support
  214.  
  215.   Mouse support is now built-in, so QM.COM is no longer needed.
  216.  
  217.   QConfig: (under Advanced Options)
  218.  
  219.     Enable mouse processing (Y/N)? [Y] : Y
  220.         You must have a mouse driver loaded to use the mouse. (This option is
  221.         not necessary with the OS/2 version)
  222.  
  223.     Left-handed mouse (Y/N)? [N] : N
  224.         Swaps the outside buttons on the mouse.
  225.  
  226.     Mouse hold time (in 1/18th sec) [1..36]  [9] : 9
  227.         This is the number of clock-ticks (1/18th of a second) in which the
  228.         mouse button must be down to be considered "HELD".
  229.  
  230.     Mouse repeat-delay factor [0..32767]  [600] : 600
  231.         This is a machine dependent value that can be adjusted to speed up or
  232.         slow down the repeat rate of the mouse buttons.
  233.  
  234.     NOTE: You must also set the "Display Boxed" option (under Colors/screen)
  235.         to TRUE, to enable scroll-bars on the editing windows.
  236.  
  237.   Left-Click on top line of the screen invokes the MainMenu
  238.  
  239.   In text area of current window:
  240.         Double-Left-Click marks the word
  241.         Triple-Left-Click marks the line
  242.         Click-Drag mouse to mark character block
  243.         Hold Alt-key while click-drag to mark a line block
  244.         Hold Ctrl-key while click-drag to mark a column block
  245.         Right-Click invokes the "Mouse Menu"
  246.  
  247.   Resize windows by click-drag on StatusLine.
  248.  
  249. ■ MouseMenu  <Ctrl F10>
  250.   Pops up a menu of Block-related commands.  This command provides access to
  251.   a list of Block-related commands for easy selection using a mouse.  If the
  252.   mouse is not used, this menu can still be accessed by pressing <Ctrl F10>.
  253.  
  254.   The commands available are:
  255.  
  256.        ┌────────── Mouse Menu ──────────┐
  257.        │ Cut                            │
  258.        │ Copy                           │
  259.        │ Paste                          │
  260.        │ Paste Over                     │
  261.        │ UnMark                         │
  262.        ├────────────────────────────────┤
  263.        │ Copy to Windows Clipboard      │
  264.        │ Paste from Windows Clipboard   │
  265.        ├────────────────────────────────┤
  266.        │ Copy Block                     │
  267.        │ Copy Over Block                │
  268.        │ Move Block                     │
  269.        │ Delete Block                   │
  270.        ├────────────────────────────────┤
  271.        │ Fill Block                     │
  272.        │ Sort                           │
  273.        ├────────────────────────────────┤
  274.        │ Upper                          │
  275.        │ Lower                          │
  276.        │ Flip                           │
  277.        └────────────────────────────────┘
  278.  
  279.  
  280. ■ WinClipCopy, WinClipPaste
  281.   These two new commands allow The SemWare Editor Junior to access the
  282.   Microsoft Windows or the OS/2 Clipboard.  WinClipCopy will copy the current
  283.   block to the Windows or OS/2 Clipboard, and WinClipPaste will paste the
  284.   contents of the Windows or OS/2 Clipboard into the file at the current
  285.   cursor location.
  286.  
  287. ■ DirTree <Esc><F><I>
  288.   This command displays a pick list of all the drives on your system, along
  289.   with a directory tree for the current drive. To switch to a different
  290.   directory, move the cursor bar to the desired entry in the tree, and press
  291.   <Enter>.  To change to a different drive, move the cursor bar to the
  292.   desired drive, and press <Enter>.  The selected drive becomes the current
  293.   drive, and the directory tree for that drive is displayed in the pick list.
  294.  
  295. ■ LocateFile <Esc><F><A>
  296.   This command searches an entire drive for a specified filename.  A list of
  297.   all matching filenames is displayed, allowing you to select an appropriate
  298.   file to edit.
  299.  
  300.   When you execute this command, it prompts you for the filename for which to
  301.   search.  A complete name or an ambiguous name (with DOS wildcard
  302.   characters) can be specified.  By default, the current drive is searched.
  303.   However, a different drive can be searched by prefacing the filename with
  304.   the drive name (such as, d:foo).  The default or specified drive is then
  305.   searched, and all matching filenames are displayed in a pick list.  To
  306.   select the desired file to edit, position the cursor bar on that filename
  307.   in the pick list, and press <Enter>.
  308.  
  309. If you assign DirTree or LocateFile to a key, you can execute these commands
  310. within any file-related prompt, such as "File(s) to edit:".
  311.  
  312. ■ CUA-style block marking
  313.   QConfig options:
  314.     Use CUA-style (shift cursor) block marking (Y/N)? [Y] :
  315.         When ON, shifted keypad keys will perform CUA-style block marking
  316.         commands.
  317.  
  318.     Should Blocks remain marked after CUA marking (Y/N)? [N] :
  319.         Determines whether a block marked using the CUA-style marking keys
  320.         will remain marked after you type a non-CUA-style block marking or
  321.         command key.
  322.  
  323.   Commands:
  324.     ToggleCUAMarking
  325.         Interactively toggles CUA-style block marking mode.
  326.  
  327.     SetCUAMarking
  328.         Interactively turn ON CUA-style block marking mode.
  329.  
  330.     NOTE: CUA-style block marking mode only activates the shifted cursor
  331.         keys.  If you wish to have the Cut, Copy, and Paste commands tied to
  332.         the CUA keys, #del, ^ins, and #ins, you will need to manually modify
  333.         your QCONFIG.DAT file to make the appropriate assignments.
  334.  
  335. ■ IncrementalSearch <Ctrl I>
  336.   This is a specialized search command.  It causes the editor to begin
  337.   searching for a string while you type. As you enter each new character, the
  338.   editor attempts to locate a string in the text that matches the incremented
  339.   search string.
  340.  
  341.   As you type characters, a case-insensitive, forward search is performed,
  342.   beginning at the text position where the cursor was located when you
  343.   invoked IncrementalSearch.  As each matching string is found, the string is
  344.   highlighted in the text.
  345.  
  346. ■ New Find and FindReplace options:
  347.   These options are placed in the "Options:" prompt, not in the search string
  348.   prompt.
  349.  
  350.       [^] Anchor the search string to the beginning of the line (or Block, if
  351.           the [L] option is also selected).
  352.       [$] Anchor the search string to the end of the line (or Block, if the
  353.           [L] option is also selected).
  354.  
  355. ■ Synchronized Scrolling
  356.   ToggleSyncScroll <Ctrl O><Y>
  357.   This command switches Synchronized Scrolling mode ON and OFF.  If switched
  358.   ON, and there are multiple windows on the screen, all other windows will be
  359.   scrolled when the current window is scrolled.  When Synchronized Scrolling
  360.   mode is ON, an "S" appears on the StatusLine.
  361.  
  362. ■ MaximizeWindow <Ctrl O><M>
  363.   This command causes the current window to be made as large as possible, by
  364.   making all other windows as small as possible.
  365.  
  366. ■ NextEqualIndent, PrevEqualIndent
  367.   These commands move the cursor to the next or previous line (as
  368.   appropriate) whose text starts in the same column as the current line. If
  369.   the current line is blank, the cursor moves to the next or previous blank
  370.   line.
  371.  
  372. ■ SwapChars
  373.   This command will swap the character at the cursor position with the
  374.   character preceding the cursor.  The cursor column position does not
  375.   change.
  376.  
  377. ■ SwapWords
  378.   This command will swap the word in which the cursor is positioned with the
  379.   previous word on the current line.  Any "non-word" characters between the
  380.   affected words are preserved.
  381.  
  382. ■ SwapLines  <Ctrl F2> or <Esc><E><P>
  383.   This command will swap the current line with the line immediately following
  384.   it.  The cursor does not change its position relative to the screen.
  385.  
  386. ■ isWord
  387.   Returns TRUE if the character at the cursor position in the file is in the
  388.   current word set.  See the AltWordSet command for more information on word
  389.   sets.
  390.  
  391. ■ SetPrintAddFF
  392. ■ TogglePrintAddFF
  393.   Toggles (ON or OFF) the option to automatically send a formfeed character
  394.   to the printer at the end of each print operation.
  395.  
  396. ■ SetVGA28
  397. ■ ToggleVGA28
  398.   Toggles a VGA monitor between 25-line and 28-line mode.  This command has
  399.   no effect if the video card is not a VGA type.
  400.  
  401. ■ SetPromptForEAs
  402. ■ TogglePromptForEAs
  403.   Toggles (ON and OFF) prompting by the editor for a .TYPE EA when saving a
  404.   file that does not currently have any Extended Attributes assigned. This
  405.   includes newly-created files, and existing files without Extended
  406.   Attributes.  If ON, the editor prompts you for a .TYPE EA when you save a
  407.   file that has no Extended Attributes assigned.  If OFF, the editor does not
  408.   prompt for a .TYPE EA.
  409.  
  410. ■ GotoFirstLine and GotoLastLine
  411.   Positions the cursor on the beginning line, or the last line of the current
  412.   file.  The column position is not changed.
  413.  
  414. ■ Some additional commands:
  415.  
  416.   - SetBakups           Sets ON file Backup mode.
  417.  
  418.   - SetBoxDraw          Sets ON Box Drawing mode.
  419.  
  420.   - SetCenterFinds      Sets ON Find centering (to center found text, located
  421.                         by the Find and FindReplace commands, vertically on
  422.                         the screen).
  423.  
  424.   - SetEnterMatching    Sets ON EnterMatching mode.
  425.  
  426.   - SetSwap             Sets ON the option to swap to EMS or Disk when the
  427.                         Shell and DOS commands are executed.  (This command
  428.                         is NOT available in the memory-resident or OS/2
  429.                         versions.)
  430.  
  431.   - SetTabsExpand       Sets ON Physical Tab Expansion mode.
  432.  
  433.   - SetTabsOut          Sets ON Tabs Out mode.
  434.  
  435. ■ The AsciiChart will now highlight the character under the cursor.  If the
  436.   cursor is on or past the end of line, then the first character in the chart
  437.   (ASCII 0) will be highlighted.
  438.  
  439. ■ The Match command will now find matching "<" and ">" characters.
  440.  
  441. ■ The BegFile and EndFile commands will now keep the cursor in the same
  442.   column if a column block is in progress.
  443.  
  444. ■ New SwapPath which includes path as well as drive for swapping.
  445.   In QConfig, instead of just a swap drive, you can now specify a complete
  446.   path for swapping.
  447.  
  448. ■ Added the characters 'ü' (129) through 'Ñ' (165) to both the DefaultWordSet
  449.   and the AltWordSet.
  450.  
  451. ■ Maximum line length increased to 2032.
  452.  
  453. ■ Help text now compressed to allow more text for help screen.
  454.   The QuickHelp command will still only display one screen full.  But the
  455.   compression should allow you to put more info into the larger screen modes
  456.   (such as 50-line mode).
  457.  
  458. ■ New method of searching for macros.
  459.   When a macro is loaded, the editor searches in the following places:
  460.  
  461.             Current directory
  462.             "Supplemental Files Path" from QConfig
  463.             Directory from which editor was loaded
  464.  
  465. ■ CopyBlock command works in prompts.
  466.   CopyBlock MUST be the only command assigned to the desired key.
  467.  
  468. ■ Two new attributes:
  469.  
  470.   Menu Quick Letter           - this is the letter to press to select the
  471.                                 menu item
  472.   Menu Select Quick Letter    - this is the quick letter of the currently
  473.                                 selected menu item
  474.  
  475. ■ New keys now available: (from the keypad)
  476.  
  477.   NOTE: Any assignments to these keys are ignored when the CUA-style block
  478.         marking option is ON.  The CUA-style block marking can be set in
  479.         QConfig.
  480.  
  481.             grey/
  482.             #1
  483.             #2
  484.             #3
  485.             #4
  486.             #6
  487.             #7
  488.             #8
  489.             #9
  490.  
  491.  
  492. Miscellaneous Usage Notes
  493. ─────────────────────────
  494.  
  495.   Methods to Speed Up Keyboard Delays:
  496.  
  497.   Run the included KBFAST.EXE utility.
  498.  
  499.  
  500.  
  501. V    OS/2 SPECIFIC NOTES
  502. ──────────────────────────────────────────────────────────────────────────────
  503.  
  504. ■ Rules for forming HPFS/long filenames:
  505.  
  506.   From the OS/2 command line, and the built-in EditFile command:
  507.     Since the editor can load multiple files from either of these prompts,
  508.     the space character is used as a delimiter.  In order to load a file
  509.     that has spaces as part of its name, double quotes must be used. If
  510.     double quotes are not used, the editor will consider spaces delimiters,
  511.     and possibly load multiple files.
  512.  
  513.     Example:
  514.  
  515.       q file1 "my file" file2
  516.  
  517.       The editor will load three files: file1, my file, and file2.
  518.  
  519.       q file1 my file file2
  520.  
  521.       The editor will load four files: file1, my, file, and file2.
  522.  
  523.   All other file-related prompts:
  524.     Since other file-related prompts accept only a single file name, double
  525.     quotes are not required for filenames containing spaces.  The only time
  526.     double quotes are required in these prompts is when the filename begins
  527.     or ends in spaces.
  528.  
  529.  
  530.