TSE Pro v4.4 Generated Manual

The above manual was generated from the editor's built-in interactive Help system by using the Hlp2txt tool, and is published here with Semware's permission.

The manual was generated as a list of topics based on TSE's built-in Help's Index. Topics are therefore described alphabetically. With the exception of two minor topics, missing because they do not occur in the Index, the content of the manual is otherwise very complete, containing all topics that formerly occurred in the "The User's Guide" and "The Macro Reference Guide".

The main flaw of this generated manual is missing links, mainly from overview topics to detail topics. So the information is there, but the topics are not linked. This is for example painfully obvious in the "Table of Contents" topic.

Nice feature: Notice that selecting a topic provides its URL in the browser's address bar. We can copy and use that URL to provide a link to the topic from an email or document.

TSE Pro v4.4 Undocumented Features

Version: v0.47

Date: 11 Sep 2021

For: TSE PRo v4.4

This document describes features and errata for TSE Pro v4.4, that are not documented in the built-in Help system.

The document's information is subject to updates and tweaks without notice. Only substantially new information is listed below.

Note: There was a plain text version of this document. It was discontinued, because I do not want to maintain two files with the same information. That said, given TSE's plain text nature, I would understand it if someone wants it back. Email me if you do, and I will see if I can automatically derive a plain text file from the HTML file.

v0.40: Expanded NextChar().

v0.41: Expanded "Searching with Regular Expressions".

v0.42: Added "SyntaxHilite Mode".

v0.43: Added GetToken().

v0.44: Expanded WhenPurged().

v0.45: Added QuotePath().

v0.46: Expanded Hook().

v0.47: Made code snippets uniformly syntax highlighted.

This tool converts a text buffer to an unsaved HTML page including TSE's syntax highlighting.

The result can be used as (a snippet in) a web page.

The result can be also be used in an email, provided that your email client supports the necessary HTML formatting.
This works by saving the generated HTML page, opening it in a web browser, and copying the highlighted text from the web browser into an email.
If an email receiver's email client does not support this highlighting, they still tend to see the text, just not highlighted.

Email clients that have been reported to support this highlighting:

• Outlook
• iOS mail
• Pegasus (if a message wrap option is set)
• eM Client
• Thunderbird

// Example highlighted code snippet
// generated with this tool.
proc Main()
  string  response [10] = ''
  integer number        = 0
  while Ask('Number?', response)
    number = Val(response)
    Warn('The square of'; number;
         'is'; number * number)
  endwhile
end Main

v1.1 Instead of using HTML color names that approximate TSE colors, the generated HTML now uses the exact same hexadecimal color values as TSE itself uses. WYSIWYG!

v1.2 Added a choice whether to generate "style attributes" or "class attributes with a stylesheet" for the HTML colors.

v1.2.1 The documentation was updated with a link to TSE PRO v4.4 Undocumented Features as a practical example of using class attributes with a stylesheet to uniformly highlight code snippets.

This is an "include file" for macro programmers that contains compiler directives and procedures that help us to create "TSE v4.2 and above"-specific macros that are backwards compatible down to TSE v4.0.

It does so by implementing some of the new TSE v4.2 and TSE v4.4 macro COMMANDS as macro PROCEDURES, and by using compiler directives to only use those macro procedures for the TSE versions that do not support the new macro commands yet, and to use the faster macro commands for the TSE versions that do support them.

Additionally this file contains a group of compiler directives that make the compiler give a clear and specific message if someone compiles the macro with a TSE version before TSE v4.0.

Also it adds backwards compatible names for the component bits of the return value of QueryEditState().

TSE commands implemented as procedures:   -   Their procedure versions:

• integer proc isAutoLoaded() - 1.0
• integer proc MkDir (string dir) - 1.0
• integer proc RmDir (string dir) - 1.0
• integer proc StartPgm (string pgm_name, string args, string start_dir, integer startup_flags) - 1.0
• integer proc StrCount (string needle, string haystack) - 1.0
• integer proc StrFind (string needle, string haystack, string options) - 1.0
• integer proc StrFind5 (string needle, string haystack, string options, integer occurrence, var integer found_length) - 1.0
• string proc StrReplace (string needle, string haystack, string replacer, string options) - 1.0
• string proc VersionStr () - 1.1

• integer proc compare_versions(string version1, string version2) - 2.0
• integer proc wurn(string text) - 1.0

v1.7: Added StrCount().

v1.7.1: Bug fix: For Linux WIN32 should be defined as FALSE.

This tool can be used to navigate and gain insight into large recursive lists and program source code.

It accomplishes this by compressing text into a list of lines with a certain maximum indentation, which you can control with the Right and Left keys.

For example, it compresses a shopping / todo / notes list of increasingly indented topics and subtopics into a new list of only the (sub)topic lines, where you control which level of subtopics you want to see.

As another example, programs typically use indentation to clarify their structure.
Top-down this tool works somewhat like TSE's "Function List" menu, but with the added capability that it can then include lines with ever increasing indentation, which gives some insight into the program's structure.
Bottom-up this tool shows lines with the current line's indentation or less, which gives insight into what the current line's place in the program structure is.

This is a tool for macro programmers to determine a buffer's best tab size.

Here tab size means how many SPACE and TAB characters are the most consistently used to increase the indentation of a next line. A TAB character is treated as one SPACE character.

For testing you can run it interactively to create a report of found tab sizes and the determined tab size.

It also comes with a GetTabSize_Test tool, which tests and demonstrates GetTabSize by listing the tab sizes for all text files in a folder, defaulting to your TSE folder.
(Aside: GetTabSize_Test has a neat is_text_file(filename) procedure.)

This TSE extension lets you recover a TSE session after a Windows crash.

A session consists of all its buffers: their content, file-changed state, and binary mode, all as close as possible to as they were at the moment of the crash.

I created this extension because historically all my Windows home PCs have tended to occasionally crash, especially during the summer months.

This extension integrates some basic git functionality into TSE.

It requires that git is pre-installed on the computer and that the Status macro is pre-installed in TSE.

If the current file is in a git directory, then the its git status is shown on the right-hand side of the screen.

In Windows right-clicking the status (or in any OS executing the Git macro) pops up a menu, from which you can do explicit commits and list and open old versions of the current file.

You can configure the extension to automatically do a "git add" or "git add+commit" after each file save.

v1.4
New: Open an old version of the current file by selecting it from a commit list.

v1.4.1
Fixed: Backwards compatibility down to TSE Pro v4.0.

v1.4.2
Fixed: The extension is compatible again with Linux TSE Pro v4.41.43 upwards.
Fixed: Giving temporary files a unique name did not work in Linux.
Partial fix: The git extension aborted on git files on "\\" drives. The extension now treats them as not being git files.

v1.4.3
Fixed: An occasional, random abort if on-file-save was configured.

This tool lists recent files' names into an editable buffer.

It shows the same content as TSE's "File List Recent" menu, but not as an interactive list from which you can pick and open a file, but as an editable buffer.

This tool lists all open files' names into an editable buffer.

More specifically, it creates a new TSE buffer, that contains a sorted list of the same files' and buffers' names that are interactively shown by TSE's "File List Open" menu.

v1.0.1 Gave the new buffer a significant name. Improved the documentation.

This tool encodes (compresses) or decodes (decompresses) the current buffer to a new buffer it creates.

Its main feature is, that it does so solely with TSE's capabilities, i.e. without any dependency on a non-TSE third-party tool.

It is not compatible with with any other compression tool. It is intended as a helper tool for TSE-specific applications.

There was a v0.2 beta release of this tool. Here is what is new in the v1.0 version:

• Changed: After an encoding or decoding error the tool no longer produces a new buffer.
• Changed: Calling the "Huffman" macro (usage 1) no longer names the new buffer it creates, which pulls its behaviour in line with the other three usages.
• Added: If their input buffer is 10,000 or more lines, then encoding and decoding show a progress message.
• Fixed: Encoding plus decoding added an empty line to the end of a non-binary buffer.
• Fixed: No error was given for the fact that the tool cannot encode a buffer with less than two different characters.
• Fixed: No errors were given if the number of encoded and decoded/decodable characters did not match.
• And: Various small tweaks.

This include file provides macro programmers with the get_drive_type() function, which returns a drive's or a file's drive type, like whether it is on a removable disk, local disk, network drive, compact disk or RAM disk.

Because it uses a Windows function it has the same limits as Windows in recognizing drive types. My personal pet peeve is that Windows sees my harddisks and USB drives (not sticks) as the same drive type.

A get_drive_type_test macro is provided to test and demonstrate get_drive_type()'s use. It lists all your drives and their type.

This is an include file for macro programmers, providing them with the FastStrFind() procedure as a much faster (*) alternative to TSE 4.4's built-in StrFind() function.

(*) Qualifier: Much faster in computer terms. Only macros that use StrFind() thousands of times might become faster to us humans by the use of FastStrFind(). I use FastStrFind() to speed up some file conversions.

FastStrFind() is just as fast as StrFind() when searching for a regular expression or a word; it is a lot faster when only using other search options.

A FastStrFind_Test macro is provided to demonstrate FastStrFind()'s use and speed.

This tool asks for a directory and generates a TSE buffer with "rmdir" commands for those directories there that contain no files. Directories containing only empty directories are listed too.

You can examine and edit the resulting TSE buffer, and rename it to a .cmd file to execute it to remove the listed directories.

This extension enables TSE to recognize and edit files for all major Unicode encodings: UTF-8, UTF-16, UTF-32, including their variants; big endian (BE) and little endian (LE), and with or without a byte order mark (BOM).

The Unicode macro requires the Status macro to be installed.

IF you are a user of the EolType macro, then you need to upgrade it to EolType v7. The older EolType versions do not understand the newline characters in the UTF-16 and UTF-32 files we can now edit.

Key features:

• For Unicode characters that have an ANSI equivalent the ANSI character is shown. Typically this already covers the most frequently used Unicode characters that are not ASCII characters:
  € ‚ ƒ „ … † ‡ ˆ ‰ Š ‹ Œ Ž ‘ ’ “ ” • – — ˜ ™ š › œ ž Ÿ ¡ ¢ £ ¤ ¥ ¦ § ¨ © ª « ¬ ­ ® ¯ ° ± ² ³ ´ µ ¶ · ¸ ¹ º » ¼ ½ ¾ ¿ À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ð Ñ Ò Ó Ô Õ Ö × Ø Ù Ú Û Ü Ý Þ ß à á â ã ä å æ ç è é ê ë ì í î ï ð ñ ò ó ô õ ö ÷ ø ù ú û ü ý þ ÿ
• Other Unicode characters are shown as quoted hexadecimal Unicode codepoints, using the DELETE character (shown as a square-like character) as quotes.
• You do not have to remember these hexadecimal codes:
  • The character's Unicode description is shown as a status.
  • You can insert any character into your text by typing part of its Unicode name or description in a shrink-as-you-type list of characters.
• Viewing the current character in its real Unicode form is possible but default disabled because it works imperfectly.
• A file's character encoding (ASCII, ANSI, UTF-8/16/32[BE/LE][+BOM]) is shown as a status.
• You can explicitly change a file's character encoding by right-clicking or pressing [Shift] F10 on the status. Note that this allows you to convert any ASCII, ANSI or Unicode character encoding to any (other) Unicode character encoding.
• Conversions of character encodings are lossless!
• ASCII or ANSI files are semi-automatically upgraded to another character encoding when you type a non-ASCII or non-ANSI character.

Key lacking features:

• It does not display non-ANSI characters graphically. ANSI only fully covers languages like Bahasa Indonesian, Danish, Dutch, English, Finnish, French, German, Hungarian, Icelandic, Italian, Norwegian, Portuguese, Spanish and Swedish.
• It only supports Unicode for the content of files, not for folder or file names.
• Copying and pasting of non-ANSI characters is not supported.

History:

v2.1 - Added compatibility with the Linux TSE beta. Updated the data files to Unicode standard 13.0.0. More direct access to status colour configuration. Three minor bug fixes. Various tweaks.

v2.2 - Allows disabling its incompatibility warning for TSE's Console version. This is handy when the GUI and Console versions of TSE are installed in the same folder and are both used.

v2.3 - Loading a UTF-16 or UTF-32 file is now 3 times faster and saving one is now 4½ times faster. Loading and saving a Unicode file now shows the filename; the conversion progress indicator is shown at a new location. Fixed: Opening a UTF-16 or UTF-32 file added an empty line at the end.

v2.3.1 - Fixed: The progress percentage was only partially displayed when loading and saving a Unicode file containing a byte order mark (BOM).

v2.3.2 - Fixed: Opening a "Unicode" file not ending with a newline caused TSE to hang. "Unicode" between quotes, because in practice this would typically happen when opening some binary files without using the "-b" prefix. I typically open a binary file this way when opening all files in a folder that also contains some binary files.

This tool lists TSE's internal editor version number for one specific file or for all files in a folder.

Fair warning: Even for uber-TSE-nerds it takes an exceptional situation for this tool to be of any practical use.

Context: For different but close TSE releases, the editor and compiler executables and .mac files might still be compatible with each other. This means that macros do not always need to be recompiled for a new release, as is currently already sometimes skipped for .si macros. Whether this is the case is administratively determined by the "internal editor version number" of these executables and .mac files. This tool can list the internal editor version numbers of these files.

This extension makes the use of TSE history lists a lot more efficient.

When in a history list, just start typing a part what you search for to reduce the list to matches with what you typed.

Example 1: This often allows me to only type a file's name without having to supply its folder.

Example 2: By typing "-a" in the history list I can quickly select the previously entered string again that opens all TSE macros.

v1.0.1 fixes the bug, that if you deleted a history entry and without leaving the list immediately tried picking an entry below that, then you got the wrong entry.

This tool shows a list of all files in memory including hidden and system buffers.

You can select a normal file to view it directly, and select a hidden or system buffer to view a copy of its content.

v1.3 recognizes more Semware system buffers and shows a better name for the copy of a selected system and hidden buffer.

This extension will be included in TSE versions released after 23 May 2020. For older TSE versions down to TSE Pro v4.0 you can download it here.

When reopening a file this TSE extension restores the file's previous cursor position.

A regular file is remembered based on its full path and file name.

A temporary file is remembered just based on its file name. This makes it work with tools, that give access to a file outside the local file system by copying the file to an each time differently named temporary subfolder and then call the editor.

The macro is an expanded version of the former TmpState macro, that only remembered cursor positions for temporary files. If you previously installed the TmpState macro, then you are advised to uninstall it in favour of this macro.

v1.4.1 fixes a bug: Cursor positions should not be remembered for TSE's "<unnamed-n>" files.

This macro logs changes in TSE settings.

At any time you can execute the macro for a report of the history of changes in your settings.

It also had the now obsolete functionality, that it could automatically restore our TSE settings after a TSE upgrade. As of Settings v1.3 this obsolete functionality is configurable and default turned off.

As of TSE Pro v4.41.41 TSE releases will themselves retain the same user settings as the Settings macro formerly did.

If enabled again, then this gets automatically restored after a TSE upgrade:

• The configuration settings.
• The window and font position and sizes.
• The descriptions of your own Potpourri macros (*).
• Your own user interface if you had one (* and **).

v1.2 Documented the Settings macro's dependency on using setup.exe for TSE upgrades, if you want Settings to also restore Potpourri descriptions.

v1.3 Default no longer automatically restore TSE settings after a TSE upgrade, because new TSE releases will do that themselves.

This TSE extension allows you to temporarily zoom in and out by using Ctrl MouseWheel up and down, and to go back to the original size by clicking Ctrl MouseWheel.

While zooming, the screen size is kept as much the same as possible.

To make a screen zoom size permanent, use the TSE menu "Options -> Save Current Settings".

Zooming out is limited to where letters (have) become to small to read.

Zooming in is limited to where a screensize of 80 x 25 characters would no longer fit, because that might stop TSE's menus from working.

v1.3 - Allows disabling its incompatibility warning for TSE's Console version.

An implementation of Conway's "Game of Life".

v1.2.1 has no new features. It makes Life compatible with TSE Pro v4.41.38 upwards.

This tool tries to lock access to Windows until a password is re-entered.

It has a screensaver!

v1.0.1 has no new features. It makes ScreenLocker compatible with TSE Pro v4.41.38 upwards.

When executed it draws a Christmassy picture.

A.k.a. an experiment in programmed fine-textured drawing with TSE.

Based on a user's input I have extended its claimed compatibility to also include the Console version of TSE, but be aware that unless you yourself pre-set a large screen size and a small font size, the generated picture will have a too low resolution in the Console version of TSE.

v1.0.2 has no new features. It makes Xmas compatible with TSE Pro v4.41.38 upwards.

This TSE extension enhances TSE by enabling other macros to display extra statuses on the right hand side of the screen, and by enabling them to handle typing and clicking on such a displayed status.

The colour for these statuses, which defaults to the menu colour, can be configured.

The "other macros" should explicitly inform you, that for them to work they require you to install the Status macro first.

v1.2 Added Linux compatibility and some minor improvements, bug fixes and tweaks.

This TSE extension enhances TSE by displaying the lengths of the current line, string and word on the right hand side of the screen.

Which of these lengths you want to see can be configured.

The Lengths macro requires the Status macro to be installed.

v1.1 - Added Linux compatibility. Added direct access to the status colour in the configuration menu.

This extension will be included in TSE versions released after 30 April 2019. For older TSE versions down to TSE Pro v4.0 you can download it here.

Functionality:

• When a Find or Replace hilites one of its matches, then all other matches currently on the screen are hilited too.
• It does so as a side effect to using existing Find and Replace keys without interfering with their functionality.
• It can hilite once, or it can keep hiliting the last search while you continue editing, and stop hiliting when a configured "stop key" is pressed.

Strong points:

• It also hilites during a Replace's (Yes/No/...) prompts.
• You can configure different hiliting colours for the extra matches.
• It hilites a Replace with the Replace search options.

Weak point:

• It only hilites for commands started with a configured key.

v1.1 - Added Linux TSE compatibility. Increased the existing backwards compatibility with TSE 4.0 upwards.

This tool recompiles all macros in TSE's "mac" folder.

With the exception of macros with an ampersand or parentheses in their name. SemWare has one such macro: "find&do".

v1.0.1 Solves a Linux bug.

v1.0.2 Solves a Linux bug in solving the Linux bug :-(.

This TSE extension allows you to assign an editing action to a quickly typed sequence of defined keys or mouseclicks.

It uses a Keys.ui interface definition file in TSE's "mac" folder. Its syntax is like a standard TSE .ui file with some minor restrictions. It does not compile with Macro Compile, but is compiled when you save the file.

For example, I use it in the Windows GUI version of TSE to assign a triple tap of the <.> key to the "…" (ellipsis) character, a triple tap of the <e> key to the "€" (euro) character, a triple tap of the <?> key to the "¿" character, and the tapping of <1></><2> to the "½" character.

Likewise you could for example assign different actions to a double, triple and quadruple tap of the <Home> key.

In Linux TSE it is ideal for typing characters with diacritical marks in the same way Windows does for "international" keyboards. For example, you can enter an "é" by quickly typing the <'> and <e> keys.

More such examples are given in the example Keys.ui file that is included with the macro.

v1.0.1: Solves compile error for the <'> key.

v1.0.2: Adds lots of key definitions in the example file: Especially the diacritics (accented characters) should be a useful addition for Linux TSE Beta v4.41.31 upwards.

For a folder or for a space separated list of folders this tool creates a list of groups of those files, the names of which only differ by a version suffix in the name.

This tool was requested by one user. I created it in the hope that it might have general benefits, but my conclusion is that it does not.

In v2.0 the recognition of versions was rewritten. This was much improved, and is expected to function much better for its requested purpose and type of folders. That said, for general usage it functions slightly better but still poorly.

This power tool searches for a list of search terms in a list of files or in all open files.

v1.0:
No more known bugs, no new features planned: Out of beta.

v1.0.1:
Semware fixed a TSE Linux bug. I fixed BulkFind to no longer work around it. For Linux BulkFind now requires TSE Beta v4.41.24 upwards.

This tool is an TEST and EXAMPLE macro for the epoch_to_datetime() procedure, that given a time zone in hours can convert unix's epoch seconds (seconds since 1 Jan 1970 0:00:00) to a year, day, month, hours, minutes and seconds.

v1.0.1 Bug fix: Apparently only February can have a leap day.

v1.0.2 Bug fix: Apparently November 2019 has no 31st day for 1 second.

This tool asks for a space separated list of folder paths, and creates a new file inside TSE containing a list of the full paths and names of all files in those folders and their subfolders.

v3.0:
Explicitly annotates those top folders and files as "inacessible", that it cannot access because of TSE's 255 character path limit or because a folder or file name is not ANSI compatible. As this implies, the contents of inaccessible folders remain unlisted.

v3.1:
Groups the digits of file sizes.
Now shows the correct size for files larger than 2,147,483,647 bytes for TSE versions from v4.40.95 upwards.

This tool is included in TSE Pro v4.41.37a upwards. For older TSE versions down to TSE Pro v4.0 you can download it here.

Given a marked column block of integers of at most 255 characters wide, this tool will add a line below the block with the sum of the integers.

v1.1 Ignores lines where the column block marks nothing.

This tool can be used as a simple calculator for signed integers of up to 255 characters.

It supports addition, subtraction, multiplication, division, and comparison.

It also contains a separate file for macro programmers, the content of which can be copied as a whole into our own macros to do calculations on big integers.

v1.3 is a finished version.

This TSE extension allows you to use the ampersand ("&") as a menu quick-key.

Included is a test macro to test and demonstrate this functionality.

This is a very niche extension for a very, very specific "problem".

This extension lets macros receive parameters from the command line, without TSE trying to load them as files.

Also included is a macro to test and demonstrate this functionality.

This tool assumes that you want to subtract the lines in the current file case-insensitively from the lines in the previous file, putting the result in a new file.

This tool makes ("mak") one file or all files in a folder read-only ("ro"), or it does the opposite.

Note that the read-only attribute is a very light protection in Windows: It is often and easily ignored. Occasionally it is honoured, which makes it slightly better than no protection at all.

v1.0.1 fixed the bug of the tool stopping on the meta-folders "." and ".." being system or hidden folders.

This tool changes a file's indentation primarily by changing its tab size.

Note that the program name has become 1 letter shorter from version 1.

This macro refuses to work for a file with tab characters. If a file has them, then first use any of the many other solutions to get rid of those pesky things.

Some indentation theory I made up:
Indentation can be tab-size-based or alignment-based.
In natural text tab-size-based indentation is typically used for lists of points or to make a block of text stand out as a block.
In programming tab-size-based indentation is typically used to visually group a sequence of statements as the subject of a condition or iteration by indenting lines one single extra tab-size unit.
Alignment-based indentation however can have any size, including not conforming to any multiple of the current tab-size. Alignment-based indentation is generally used to align the first character of a line with a character on a previous line to visually indicate a semantic similarity between the content at those two positions. A rule of alignment-based indentation is, that between the alignment-indented line and the line of the content it aligns with there can be no lines with a lesser indentation.
Based on this theory this tool (and we) can reasonnably recognize these two types of indentation and differentiate between them.
However, if a text uses tab characters instead of space characters, then we would at the same time have to recognize both alignment types and the tab size. That would be non-trivial.
Luckily the days that computer memory was so expensive that the tab character's disadvantages were acceptable have passed. Modern plain text editors default to inserting the appropriate amount of space characters when we use the tab key.
Therefore I chose for this tool not to cater to tab characters and their users.

v2.0 adds, that (typically in program source code) aligned lines are correctly reindented too.

v2.1 changes no functionality. It adjusts the source file extension from .si back to the standard .s. Also its array implementation was completely rewritten to, while more verbose, to be usable in normal macros.

With this TSE extension you can better see control characters, like null, bell, backspace, tab, line feed, form feed, carriage return, and others.

Better: Default the GUI version of TSE with an ANSI compatible font "hides" control characters by showing them as spaces. The Console version of TSE and e.g. the Terminal font show most control characters as regular characters, which is better but does not differentiate them from those regular characters. This TSE extension always shows all control characters and always makes them recognizable and distinguishable.

Note, that in normal/non-binary mode TSE has stripped carriage returns and line feeds from lines, and what is not there will not be shown. Open a file in binary mode -3 (prefix opening a file with " -b-3 ") to see any carriage returns and line feeds too.

In the TSE menu "ASCII Chart" you see control characters 0, 1, 2, 3 ... 31 also as the column "^@", "^A", "^B", "^C", ..., "^Z", ..., "^_". This TSE extension consistently shows a control character as the second character from that last column in the inverted text colour. This way you can always reference the ASCII Chart for the now visible control characters.

v1.0.1: Improved the documentation.

This TSE extension makes TSE more user-friendly with regard to the case of a file's folder and name.

For Windows it makes TSE show a file's path as it is cased on disk. For example, in Windows TSE has no problem opening "tse\MAC\adjust.s", but by itself it would keep showing "MAC" in upper case.

Its first Linux feature allows you to case-insensitively open a specific folder or file.

Its second Linux feature adds, that if you renamed only a file's case in the editor, then upon saving it to disk the disk file is renamed too, just like in Windows.

I have written and downloaded lots of macros for Windows with upper case letters in their names. My user interface file has lots of ExecMacro commands that reference them. And lots of those macros reference each other with ExecMacro commands. Whether these references were in the same case did not matter, because Windows is case-insensitive.

Now there is a case-sensitive Linux TSE beta.   Oops!   Porting problem!

This tool repairs ExecMacro commands in all opened files that contain an ExecMacro with a differently cased macro name than its disk filename.

Linux-specific example:
In a UI or macro file the command ExecMacro('Adjust') does not work if the macro's disk name is tse/mac/adjust.s .

With this macro you can repair one or all ui and macro files in one go, check its report and unsaved changed files first, and if you are satisfied with the result, then you can save them all and e.g. use the Recompile macro to recompile them all.

ReplaceUnCom emulates TSE's Replace command but only replaces in uncommented text.

v0.2 == v1.0:

- Optimized the comment colour check with a regular expression.

- Added the three ToEOL attributes as comment attributes too.

- Added the check that comment colours must differ from other editing colours.

This tool will be included in TSE versions released after 9 May 2019. For older versions down to TSE Pro v4.0 you can download it here.

This tool is a minor update to SemWare's standard Potpourr macro that implements TSE's Potpourri menu.

This version of the tool only differs in that it accepts macro names of up to 12 characters instead of 8.

This is a TSE extension that enhances TSE's end of line type handling when editing non-Windows files with TSE.

The EolType macro requires the Status macro to be installed.

TSE itself already does a reasonable job of handling end of lines for those non-Windows files that:

• AND exist on disc,
• AND are not empty,
• AND have a correct end of line type.

This macro fills the gaps:

• It also lets you CREATE non-Windows files,
• it adds the correct end of line type to files that were empty,
• it can be configured to repair files with the wrong end of line type,
• it lets you change a file's end of line type.

You might edit non-Windows files for instance:

• on a network drive that is mapped to a Unix, Linux or Mac machine.
• by using a remote-machine-browsing-tool like WinSCP or Total Commander, which you have configured to use TSE as its editor.
• when editing a file you downloaded from the internet.

v6.0.0:
- It was completely rewritten, and has many optimizations and new features, so here are only the major ones.
- It can display a file's (previous and next) end of line type as a status.
- The strings that identify a file's end of line type are now rules, that have search options, may now contain spaces, may now be regular expressions, and may now be provided for all end of line types, including the "As Loaded" pseudo-type.
- Any old configuration from version 5.1 is automatically converted.

v6.0.1: Textual tweaks.

v6.0.2: Small bug fix: Did not supply the callback parameter when calling the Status macro, which went unnoticed because of a bug in the Status macro. This was fixed the Status macro's 1.1.1 version.

v7: Added understanding the newline characters in UTF-16 and UTF-32 files.

This tool creates a new file from the current file, where every line containing a supplied regular expression is put before itself and before every next line that does not contain that regular expression.

Afterwards you can use existing TSE functionality to search all lines in combination with their tag lines, or to sort the now ubiquitous tag lines on their columns.

When you are done you have the option to remove the inserted tag lines with a column block to get the original file format back.

For example, given the file content:
  id=1
  name="Bob"
  street="Main street"
  city="Metropolis"
  id=2
  name="Alice"
  street="Station street"
  city="Gotham"
It can create the new file content:
  id=1 id=1
  id=1 name="Bob"
  id=1 street="Main street"
  id=1 city="Metropolis"
  id=2 id=2
  id=2 name="Alice"
  id=2 street="Station street"
  id=2 city="Gotham"

This tool is included in TSE Pro v4.41.37a upwards. For older TSE versions down to TSE Pro v4.0 you can download it here.

This tool is an alternative to TSE's built-in List() and lList() commands.

As you type the list shrinks to those lines matching what you typed.

It also works as a stand-alone macro or command to dynamically search the current file.

In my humble opinion it is a more useful alternative to TSE's own incremental search functionality.

What you type is interpreted as a TSE regular expression.

v1.0.1 solves the problem of how to supply a list title when using the macro as an include file.

This TSE extension logs all your TSE keystrokes and which file you did them in, default to a Log\Tse\KeyboardLogger folder in your personal folder.

Each TSE session creates a unique logfile YYYYMMDD_HHMMSS_WWWWW.txt based on the start-time of the session.

v1.1.1: Documented that and why KeyboardLogger needs to be installed below CuaMark in TSE's Macro AutoLoad List.

This TSE extension is a near-perfect solution to the problem, that if you access many files at once, and many or all of them have longer lines than TSE's limit, then TSE forces you to press "OK" on a separatete warning for each such file.

With this macro installed you only get a warning for the first such file, after which ALL warnings are disabled, but only for the duration of the current user command.

For instance, if you open a 100 files using the "-a" option and a wildcard character, and you then search them all at once using the "a" search option; then this macro ensures that that you have to press OK at most once on a "Long lines split: ..." warning, even if all 100 files have them.

Out of the box this TSE extension enhances the editing of TSE macro source code by setting its keywords to their default UPPER, lower, and CamelCase as you type.

Its configuration uses the delimiters and the casing of keywords from TSE's syntax hiliting configuration.

For TSE's macro language it can set keyword casing back to its default values if you ever lost them, which unfortunately a hidden TSE feature can trick you into doing.

It can be turned on and off per mapping set of TSE extensions. As this implies it can be enabled for other languages as well.

With one of those other languages in mind; you can configure non-keywords to be UPPER or lower cased.

v6 of this TSE extension does not support all TSE syntax hiliting configuration's delimiters and their options.

Elsewhere on this page there is a BETA v7 version of this TSE extension that only works for TSE Beta v4.41.19 upwards.

This TSE extension does the following:

When you double tap the F1 key when editing a TSE program, then TSE's Help is called for the word at the cursor, otherwise the F1 key works as usual.

1.0.1: Bug fix: It did not work in .ui files.

QuickSort.inc include file

TSE itself is "only" capable of sorting lines by sorting them alphabetically on a marked block of text.

With the help of this include file it is relatively easy to create or modify your own macro to sort lines on any criteria.

All you need to do, is to write a "quicksort_compare" function that accepts two line numbers, and returns -1, 0, or 1 whether you want the first line to be before, whereever or after the second line.

The include file contains a "quicksort(line_from, line_to)" function that by calling your function sorts ALL requested lines.

An example macro QuickSortTest.s is included.

Warning: Later usage showed that TSE runs into irregularly occurring memory problems when quick-sorting large files.

• The directory.
• The type of time-unit: years, months, days, hours, minutes, seconds.
• The positive or negative number of time-units to add.
• Whether to Simulate or Make the changes.

This tool lets you run TSE commands from the Macro Execute menu. From TSE v4.40.25 onwards you can alse run Execute as a macro to apply from from the corresponding Find&Do submenu.

Used from the Macro Execute menu it is great for testing a TSE command, or short sequences thereof.
For example:

Macro Execute: Execute Warn('Hello world at'; GetTimeStr())

You can not download Execute.zip here.

I chose not to duplicate it here, because it has not changed since it was uploaded to SemWare's TSE Pro macro files page.

This SynCase BETA was initially created to address a bug in TSE Beta v4.41.45. That TSE bug is not solved by this TSE extension; that awaits Semware's solution. This BETA does address all of SynCase's own known failings, and should work well with .syn files from before TSE v4.41.45.

Out of the box this TSE extension enhances the editing of TSE macro source code by setting its keywords to their default UPPER, lower, and CamelCase as you type.

Its configuration uses the delimiters and the casing of keywords from TSE's syntax hiliting configuration.

For TSE's macro language it can set keyword casing back to its default values if you ever lost them, which unfortunately a hidden TSE feature can trick you into doing.

It can be turned on and off per mapping set of TSE extensions. As this implies it can be enabled for other languages as well.

With one of those other languages in mind; you can configure non-keywords to be UPPER or lower cased.

New in SynCase v7 is, that it now supports all delimiters and delimiter options from TSE's syntax hiliting configuration.

This TSE extension allows us to open URLs that occur in the text.

This is a very early beta with known imperfections and lots of missing features.

Planned features include: Opening URLs that do not start with "http", opening files, highlighting openable URLs and files in the text, some backwards compatibility, some Linux compatibility.