This plain text file (UTF-8) describes some features of TSE Pro v4.4 that are not documented in the built-in Help system.

All existing topics are subject to updates and tweaks without notice. Only new topics are listed below.

v0.18:
Added _QUIET_.

v0.19:
Added PressKey(), PushKey(), and PushKeyStr().

v0.20:
Added CmpiStr() and MacroStackAvail().

v0.21:
Added GetTime() and Sort().

v0.22:
Added GetClockTicks() and NoOp().

v0.23:
Added Lower(), Upper() and Flip().

v0.24:
Added StrCount().

v0.25:
Added #if, #if, #ifdef, #ifndef, #ifexist, #ifnexist.

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 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.

Extends TSE with the ability to edit all major Unicode formats; UTF-8, UTF-16, UTF-32, and variants thereof; big endian (BE), 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 block) 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.
• Previewing a non-ANSI character is possible but default disabled because it works imperfectly.
• A file's character code format (ASCII, ANSI, UTF-8/16/32[BE/LE][+BOM]) is shown as a status.
• You can explicitly change a file's character code format by right-clicking or pressing [Shift] F10 on the status. Note that this allows you to convert any of the known formats to any (other) Unicode format.
• Conversions of well-formed character encodings are lossless!
• ASCII or ANSI files are semi-automatically upgraded to another character code format when you start using non-ASCII or non-ANSI characters.

Key lacking features:

• It does not display non-ANSI characters graphically. ANSI covers (originally) Western-European languages.
• 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 Linux compatibility. Updated the data files to Unicode standard 13.0.0. More direct access to status colour configuration. Three minor bug fixes. Various tweaks.

This TSE exttension 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 TSE extension will be included in TSE versions released after 30 April 2019. For older TSE versions down to TSE 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 automatically by the extension.

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 tapping <1><1><2><2> to the "½" character.

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

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.

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().

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

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

v1.0.1 Solves a Linux bug.

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 is not generally useful.

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 folders in general it functions better but still poorly.

This 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 has 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.

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.

Included is a test 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 spaces, then we would at the same time have to determine the tab size too. The combination of those two is not 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.
And 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 make them stand out from regular text. This TSE extension shows all control characters and always makes them stand out.

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 extension makes the TSE history lists a lot easier to use.

Just start typing what you search for to reduce a history list to all its matches.

This TSE extension finally mitigates the problem, that a TSE upgrade overwrites most of our TSE settings.

This macro logs changes in TSE settings. It can restore those settings and some other stuff when it detects a TSE upgrade.

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

Some details:

• When you upgrade TSE, ideally with setup.exe, it automatically restores many TSE settings:
  • 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 (*) (**).
• It automatically logs changes of your TSE settings.
  • When executed it creates a nice report of the history of those changes.

v1.1 Compensates for a TSE bug in TSE v4.41.16 - v4.41.17.
The TSE bug in TSE menu terminology: "Write settings to ASCII file" writes a "Max History Entries" above 32767 as a negative number. Internally this setting is called "MaxHistorySize". When this macro is used to restore TSE settings, then it now replaces a negative MaxHistorySize with 32767.

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

Hlp2txt generates a readable help file from TSE's built-in Help system.

The help file can be generated in 4 text formats:

• PLAIN - Plain text, without any formatting or special codes. It can be viewed with TSE.
• HTML - This format is great for viewing the resulting document in a browser. The text is thoroughly hyperlinked: Wherever a topic is referenced in the text, selecting the reference will take you to the topic.
• WORD - This format is HTML without hyperlinks, and with Word-specific things added: a .doc extension, extra headers for subtopics from which Word can create an index, Word-specific embellishment-tips. A document generated in this text format can be embellished with Word into a very professional looking printable manual.
• GENERIC - This format is HTML without hyperlinks and without Word additions. It is intended for other applications that can print HTML documents.

The help file can now be generated in 3 character code formats:

• UTF-8 - The default for the HTML, Word and Generic text formats.
• ASCII - The default for plain text when you use an ANSI font like Courier New.
• OEM - The default for plain text when you use an OEM font like Terminal.

Generating UTF-8 does NOT require the Unicode macro. Hlp2txt adapts to its presence and absence: If the Unicode macro is active, then Hlp2txt generates quoted Unicode codepoints for non-ANSI characters, otherwise it generates UTF-8 character bytes.

Changes in v2.5:
Fixed: If the user had their own <Grey +> key definition instead of SemWare's default one, then a mostly empty document was generated.
Reindented the source code from tabsize 3 to 2.
Reduced backwards compatibility to TSE Pro v4.0.
Added automatically determining TSE Pro's version for v4.0 and v4.2 too.
Added a selection screen to select the character code format to generate.
Added capability to generate the file in the UTF-8 character code format.
Fixed: Determining the TSE version did not work for the console version of TSE Pro v4.0.
Removed the underlining from HTML links.
Added compatibility with the beta version of Linux TSE.

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.

Potpourr

A minor update to SemWare's standard Potpourr macro that implements TSE's Potpourri menu.

This version of the macro will be included in TSE releases occurring after 9 May 2019. For older versions of TSE back to v4.0 you can download it here.

This version of the macro 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.

And after that you can remove the inserted tag lines with a column block to get the original file format back.

For example, given the file content:
  id
  name
  street
  city
It can create the new file content:
  id id
  id name
  id street
  id city

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.

When opening a file again this TSE extension remembers the cursor position from previously viewing the file. It does this both for temporary and regular files.

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

A temporary file is remembered just based on its file name. The latter is to address that tools often recreate what is actually the same file each subsequent time under a different temporary folder.

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

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 you are forced 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.

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.

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

This is a major version change, making the installation for its main purpose very simple, but no longer supporting TSE versions before TSE Pro 4.0.

Keywords are not cased when they occur in comments or quotes.

It cases keywords for the current line as you type, and optionally for the whole file when you execute the macro.

A nice addition to this new macro version is, that the default for how keywords are cased is for about 75% determined either by how they are cased in the Help topics of your specific TSE version or by which keywords are defined as constants in the syntax hiliting configuration of your specific TSE version. And you can generate this default again if you ever change to another or even a future TSE version.

Optionally you can reconfigure a lot of details, and you can configure other languages as well.

• 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 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.