Welcome to The SemWare(R) Editor Professional - version 2.5

The SemWare Editor (or TSE, as affectionately named by our beta testers) is
licensed, commercial software.  Please help us stay in business by respecting
our copyright and keeping this version private.

Is this a borrowed copy of the software?  If so, then please purchase a
license for your own use.  TSE has taken many work years, and hundreds of
thousands of dollars, to develop and produce.  Yet, TSE is very reasonably
priced, and we also offer attractive multi-user licensing to companies, and
to government and educational institutions.

Please review the contents of this file before using TSE.  It contains
helpful information on the operation of TSE and how to get assistance when
needed.

ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
þ  SemWare News
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

The SemWare Editor (in both its Professional and Junior versions) is
extremely popular, with over 130,000 licensed customers throughout the U.S.
and in more than 95 countries!

The SemWare Editor Junior for OS/2 is available with Long Filename and
Extended Attribute support!  If you want THE FASTEST editor available for
OS/2, give SemWare a call!!

The SemWare Editor Junior / Mem-Res AVAILABLE!  For those of you who would
like to have access to your favorite editor at virtually anytime, in the
middle of anything else, we at SemWare are proud to offer you a memory
resident version of The SemWare Editor Junior.  And best of all, if you have
expanded memory (192k minimum) or extended memory (384k minimum), the memory
resident version will require only 9k of DOS memory!  See the reference
manual for more details.

TSE is the winner of the Data Based Advisor Readers Choice Award for best
text/program editor for 1989, 1991 and 1992, and received an honorable
mention in 1994.  We thank our users for this vote of confidence and
continued support!

There are GERMAN versions available of The SemWare Editor products.  All text
displayed by the program (including the StatusLine!) is in German, and the
reference manual was painstakingly translated by a native German.  For
information on ordering the German version, contact our German distributor,
Manfred Luft, directly:

   Manfred Luft SoftWare              CIS:      100016,3715
   Waldstr. 20a                       Internet: 100016.3715@compuserve.com
   D-79194 Gundelfingen
   GERMANY

                 within Germany          from the US
    Telephone:    0761-58 05 26       011-49-761-580526
    Fax:          0761-58 05 47       011-49-761-580547
    BBS 1:        0761-58 05 22       011-49-761-580522

ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
þ  Updating from TSE 2.0
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

See the WHATSNEW.DOC file located in the TSE\ subdirectory for information
about converting your current setup.  This file also contains a list of
changes from TSE 2.0 to TSE Pro 2.5

ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
þ  Additional Features not mentioned in the online Help
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

   On the Potpourri:

    LdFList - allows you to load a list of files into the editor.

    ReplaceF - allows you to reload (or replace) the current file.

    QuickXit - Brief/Emacs style quick exit.  Allows you to abandon all files
    even if changed, or to save all files before quitting.

    ShowCurr - allows you to show the ascii and hex values of the cursor
    character on the StatusLine.

    State - allows you to save/restore the editors state, including loaded
    files, windows, bookmarks, and selected options.

    WordCnt - allows you to count the number of words in a file or block.

   Additional Commands:

    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    integer CheckDefaultExt(string ext)

    Returns non-zero if the passed extension is in the default extension
    list. Otherwise, zero (FALSE) is returned.

    Notes:

        The leading period is not required on the passed extension.

    Example:

        if CheckDefaultExt("bat")
            Message("bat is a default extension")
        else
            Message("bat is not a default extension")
        endif


    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    integer GetVideoInfo()

    Returns the current video mode number, and whether the video is EGA, VGA
    or other.

    example:

        integer b, video_type, video_mode

        b = GetVideoInfo()
        video_type = HiByte(b)
        video_mode = LoByte(b)

    notes:

        video_type 1 is an EGA, 2 is an VGA.


    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    integer lDos(string cmd, string cmdline [, integer flags])

    ù cmd is the command to pass to DOS.

    ù cmdline is the command line to pass to cmd.

    ù flags is an optional integer value.  Valid flags are:

        _DONT_CLEAR_    - do not clear the editing screen
        _DONT_PROMPT_   - do not prompt "Press a key to continue"
        _TEE_           - show the output onscreen, regardless if the
                          output is redirected.
        _RETURN_CODE_   - trap the commands return code, so that it can
                          be returned via DosIOResult().

    Examples:


    The implementation of the editor's Shell() command is:

        lDos(GetEnvStr("COMSPEC"), "")

    The implementation of the editor's Dos() command is:

        lDos(GetEnvStr("COMSPEC"), " /c " + cmdline)

    To create a shell that has a 4k environment space:

        lDos(GetEnvStr("COMSPEC"), " /e:4096")

    notes:

        The passed command (cmd) should include the complete path, as DOS
        will not search for it.


    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    ListFooter(string text)

    Use as a replacement for WindowFooter().

    See WindowFooter() in help file for more information.

    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    ListHeader(string text)

    Use in conjunction with ListFooter()

    See WindowFooter() in help file for more information.

    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    LoadStartupMacros()

    Loads any macros found in tseload.dat, and runs the tsestart.mac if
    found.  This should be executed once, in the .ui file's WhenLoaded()
    procedure.


    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    integer lShowEntryScreen()

    A low-level version of the ShowEntryScreen() command, this version
    simply displays the entry screen, and returns to the caller.

    Returns zero (FALSE) if the entry screen could not be re-displayed.


    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    integer MatchFilenames(string fn, string mask)

    Returns non-zero if fn matches mask; otherwise, zero (FALSE) is
    returned.

    Examples:

        MatchFilenames("abcdef", "abc*")        // returns non-zero (MATCH)
        MatchFilenames("abcdef", "x*")          // returns zero (FALSE)
        MatchFilenames("e.exe", "?.exe")        // returns non-zero (MATCH)
        MatchFilenames("anyname", "*.*")        // returns non-zero (MATCH)


    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    SignOn()

    Displays the editor's signon screen.


    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    Unknown()

    Provides a no-operation command.  Handy as a place-holder when you need
    to do something that causes the editor to run a command, but you do not
    want the command to do anything.

    This is also useful if you need to over-ride a key assignment.


    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

   Changes to Commands:

    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    integer ChangeCurrFilename([string fn [, integer flags]])

    The ChangeCurrFilename() command supports additional flag values.

    ù flags:

        _DONT_EXPAND_   - Do not do an ExpandPath() on fn, but accept it as
                          is.

        _OVERWRITE_     - Change the buffer name even if a file by that name
                          exists on disk.


    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    integer EditFile(string fn [, integer flags])

    The EditFile() command supports an additional flag value of
    _FROM_CMDLINE_.  When passed, the editor assumes that he is called to
    with the DOS command line.  The editor can use this to determine whether
    to load or prompt for ambiguous filenames, as determined by the
    LoadWildFromDos and LoadWildFromInside editor variables.  See the TSE.UI
    WhenLoaded() procedure for example usage.


   Additional Variables:

    ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    BufferFlags

    Returns information about the current buffer, as a bit-mapped flag.  Can
    only be Queried, can not be set.

    Values can be (multiple values may exist):


      _READONLY_LOCKING_ (multiuser version only) File is Read only locked
      _HANDLE_LOCKING_   (multiuser version only) File is handle locked
      _CANT_LOCK_        (multiuser version only) File could not be locked
      _NEWFILE_          A new (non-existing) file
      _LOADED_           File is loaded into the editor
      _PARTIAL_FILE_     Entire file could not be loaded into the editor




   In .ui files, the WhenPurged() procedure, if it exists, is called when
    the editor is terminating, just before the _ON_ABANDON_EDITOR_ hook is
    called.

   Color Syntax highlighting, provided by a macro developed by Ian Campbell.
    Run the Colors macro to initiate it.  See the files MAC\COLOR\COLORS.DOC
    and MAC\COLOR\CUSTOM.DOC for more information.

   A Projects system, provided by a macro developed by Ian Campbell.  Run
    the Projects macro to initiate it.  See the file MAC\PROJECTS.S for
    additional information.

ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
þ  The Documentation Files
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

  DOC\INDENT.DOC        - Explains Language Indenting and Template support.

  DOC\HOOKS.DOC         - How to use Event Hooks in TSE macros.

  DOC\BINARY.DOC        - Information on binary support for TSE macros.

  DOC\QED2TSE.DOC        - Notes on converting from QEdit to TSE.

  MAC\COLOR\COLORS.DOC  - Documentation for the COLORS macro.

  MAC\COLOR\CUSTOM.DOC  - Customization documentation for the COLORS macro.

ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
þ  Availability of Updated Supplemental Files
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

As macros and other supplemental files are updated, they will become
available on our ftp/www site, bulletin board service and CompuServe.  For
access information, see the Technical Support section below.

Many TSE users call these services to ask questions, chat with other TSE
users, and exchange macros that they have written.  Many of the popular TSE
macros were spawned from ideas that users have exchanged on the BBS.

ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
þ  Technical Support
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

If you should need to contact us, please provide or have available the
following information:

  - TSE Pro version number and serial number
  - DOS version, and Windows and/or OS/2 version as appropriate
  - Computer model
  - Amount of RAM
  - The names of any memory-resident programs you have loaded

You may obtain technical support directly from SemWare via any of the
following:

   InterNet

    tech.support@semware.com

    Visit our WWW page at:  http://www.semware.com
    Visit our ftp site at:  ftp.semware.com

    To join the TSE-Pro mailing list, send a message to:
    tsepro.add@semware.com

   Other email:

    CIS         75300,2710
    Fido        1:133/314
    RIME        ->SemWare   (QEdit or RIME Admin)
                  ->330       (QEdit or RIME Admin)

    We can also be reached in the SemWare/QEdit echoes on the following
    networks:

    Fido, ILink, Intellec, MetroLink, FringeNet, U'NI-net, and W-Net.

   CompuServe (GO SEMWARE, Section 6)

   Call our remote electronic bulletin board service.  The board is
    operational 24 hours a day, 7 days a week.  Modem settings are <N81>,
    14.4K bps.  The BBS number is: (770) 641-8968.

   Send us a Fax: (770) 640-6213

   Write to us:

    SemWare Corporation
    Attn: TSE Pro Technical Support
    4343 Shallowford Road, Suite C3A
    Marietta, GA  30062-5022  USA

   Call us directly at SemWare (770) 641-9002. Support hours are 9 am to 5
    pm (ET), Monday through Friday.

We request that you reserve telephone support for questions or problems
requiring immediate attention.

If you have a suggestion that you think would improve our products, do not
hesitate to let us know about it.

ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
þ  Incompatibilities
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

   During beta testing several problems were reported with the Kensington
    mouse driver, version 4.  All of the known incompatibilities with TSE
    have been fixed.  If you have any problems using TSE with the Kensington
    mouse drivers contact Kensington Microware Limited.

   Many mouse drivers do not support 132 column mode properly.  One that we
    have verified that _does_ support it properly is the Microsoft mouse
    driver, version 9.

   TSE uses a special keyboard driver, that allows many additional
    assignable keys (such as CtrlAlt, CtrlShift, AltShift and ShiftShift
    combinations of many keys). However, because of the variety in
    quality of other keyboard drivers, this sometimes causes problem.
    Known problem systems include:

      PC-MOS (from the Software Link)
      Tandy 1000 machines.

    If your keyboard behaves erratically when you use TSE, turn the option
    "Use Extended Keyboard Driver" off via the following menu path:
    <f10>->Options->Full Configuration->Keyboard/Mouse Options.  Note that
    disabling the TSE extended keyboard driver will also remove the
    availability of the additional assignable keys.

