TITLE .
TITLE is to be used only for real huge Sources. Consider it as some 'Chapter' concept in a book, not as a paragraph concept. TITLE is not at all designed for Modular programming style organization.
If a TITLE division is only for a couple of lines, it is not considered, and is merged with the previous TITLE part, so that the Editor's view could, at least, be of one Screen height.
The TITLE features purpose is to solve some problems one might encounter when, for example, wanting to save one third of a huge Source. Then, the Copy/Paste operation would be a true pain in the ass. Also, on slow Computers, the Source Editor may become a bit slow, with Sources above 1 Mega size.
Once a Source is divided in TITLEs, a Tabbed Control is made visible, each time you move the mouse on the StatusBar, at the bottom, that enables you with instant selection of the TITLE part to be edited.
TITLE syntax is:
TITLE TitleName
It must be stated exactly this way, beginning at the first row of a line, upper case required for TITLE, one space before the Title-name, all alone on a line. Zero flexibility, because we need full speed there, in order to give no penality to a huge Source without TITLE.
Once a Source is divided in as many parts by TITLE statements, the Editor behaves in a slightly different manner:
[Ctrl] [PgUp/PgDown] apply upon the Partial source (no longer upon the full Source).
All KeyBoard moves are limited to the activated Part.
The Vertical ScrollBar (if activated), concerns the partial Source too, and so does the Status Bar.
All the Search features (Search Box / Right-Click / Tree View / ...) work the same as they did with a non-enTitled Source. This is to say that there is no problem for moving all along the real Source out of the KeyBoard moves limitations. Once a jump has been done by a Search feature, the activated Part is the new accessed one.
[Ctrl] [S], instead of saving the full Source opens a Dialog offering the choice between Full and Part savings. If Full-Saving is chosen, as in Non-enTitled Sources, the asm saved File name is the current File Name. If Partial-Source-Saving is choosen, the asm saved File name is the one of the Current activated Part.
If the first line of an enTitled Source is not a TITLE Line, the Routine that builds the TITLEs Table, adds a default 'Top' one, in order to allow the Tab selection of this first Source Part, that, without this, it would be impossible to access.
One given Source may have up to 50 TITLEs.
For Memory saving, the size of each TITLE Part is arbitrarily limited to 500_000 Bytes. While dividing a huge Source in Parts with TITLEs, if you raise the TITLE Tab (by moving the Mouse Cursor down to the StatusBar area), you will see a MessageBox telling you the Name of the Part which is too large to fit..
~~~~~~~