hobbes.nmsu.edu/2008-06-02_hobbes.nmsu.edu.zip/new/ths_105.zip/th.HLP

OS/2 Help File | 2008-05-19 | 46KB | 1,206 lines

ΓòÉΓòÉΓòÉ 1. TextHelper Introduction ΓòÉΓòÉΓòÉ

General information about TextHelper

TextHelper is simple editor based on the MultiLineEditor class from the IBM
Open Class Library.  The programmer has added some text manipulation functions
and special support for printing on HP Deskjet and Laserjet printers.  If you
do not have a compatible printer, there is also a generic printer option.

Note:  TextHelper should not be used on large files. It should be limited to
       files less than 100K bytes or less than 4000 lines. TextHelper can load
       larger text files, but the overhead of handling the text becomes
       excessive and some functions are disabled.

 TextHelper is not intended to replace any full functioned editor. Its value is
in printing and its text manipulation.

If you have a HP DeskJet or compatible printer it has the ability to print in
Landscape or Portrait mode; on US letter, US legal, and Euro A4 sized paper and
envelope sizes; in 5, 10,12, 16, or 20 characters per inch or proportional; in
3, 4, 5, 6, 8, 10 ,12 lines per inch; 6, 12, or 24 character point size; in
bold or letter quality mode; with or without line numbers; with or without a 3
hole punch margin; and in combinations of those options.

One useful feature of TextHelper is the pseudo-wysiwyg printing.  The following
is an example of how it works.

Remove the hard coded cr-lf pairs with the De-wrap text in editor selection.
The function may be selected from the menu or by pressing the F8 key.

The turn the display line wrap back on by using the Word Wrap selection from
the menu or by pressing the Ctrl+W combination. Adjust the longest line
displayed by changing the Font and the editor window width until the desired
line length is obtained.  This can be checked by the Get lines information
selection from the menu or by pressing the F6 key.

The Font changes only effect the displayed text, they are not sent to the
printer. The font is changed only to change the number of characters in the
displayed line.

Now print using the Print On Selected Printer selection.

Note:  The longest line sent to the printer still needs to be short enough to
       fit on the paper.  Printing in Landscape mode with a smaller printer
       font will allow you to print longer lines. To change the font selection
       sent to the printer you must use the HP DeskJet Compatible Printer
       Options  menu selection.
       Unless the option to Hard code word wrap  is used, the word wrap is not
       saved when or if you save the file.


ΓòÉΓòÉΓòÉ 1.1. Getting Started ΓòÉΓòÉΓòÉ

The INSTALL.CMD file will install TextHelper and create a desktop program icon
and a desktop icon for this help file.

TextHelper has the option to create backups if you Enable Making Backups  and
Enter The Backup Path

I suggest that you enable making backups and enter a backup path. The making of
backups does not take much CPU time, and can save the user a lot of effort.

TextHelper does not save any of the configuration options or the window size
and position unless the Save Settings menu selection is used.


ΓòÉΓòÉΓòÉ 1.2. TextHelper support files ΓòÉΓòÉΓòÉ

TextHelper will search the current or working directory for its support files,
then check the environment setting, then the directory where the executable was
located.

If you wish to have multiple configurations of TextHelper on your desktop, you
will need to select a different working directory for each instance and copy a
TEXTHELP.INI file to that directory.

If you intend to launch TextHelper from the command line, you may wish to set
an envioronment variable so that TextHelper can find its help file and INI
file.  Add the following line to your CONFIG.SYS file.

SET TEXTHELPER=(DRIVE):\(DIRECTORY)

Note:  There must be no space before the equal sign.

Replacing (DRIVE) with the drive letter and (DIRECTORY) with the directory
where you installed TextHelper .


ΓòÉΓòÉΓòÉ 1.3. File ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains selections to load,
save, or print the contents of the edit window.


ΓòÉΓòÉΓòÉ 1.3.1. Open File ΓòÉΓòÉΓòÉ

The Open File selection opens a file dialog box that allows the user to select
or enter a file name to load into the editor.


ΓòÉΓòÉΓòÉ 1.3.2. Recall File ΓòÉΓòÉΓòÉ

The Recall File selection loads the file that was in the editor when the Save
Settings selection was used. This allows the user to quickly load a frequently
accessed file into the editor.


ΓòÉΓòÉΓòÉ 1.3.3. Load Files Opened History ΓòÉΓòÉΓòÉ

The Load Files Opened History selection loads the file named "recall.th" that
contains a history of the files loaded in the editor.  By marking the name of a
file that you want to load and double clicking the Right Mouse Button ,the file
will be loaded into the editor.  The file "recall.th" may be edited to remove
or add file names.


ΓòÉΓòÉΓòÉ 1.3.4. Close File ΓòÉΓòÉΓòÉ

This menu selection closes the file without saving it and clears the editor. If
changes have been made to the file, the user is not warned that the file has
not been saved.


ΓòÉΓòÉΓòÉ 1.3.5. Append File ΓòÉΓòÉΓòÉ

This menu selection opens a File Dialog Box and allows the user to select a
file that will be appended to the contents of the editor.


ΓòÉΓòÉΓòÉ 1.3.6. View ZIP File Contents ΓòÉΓòÉΓòÉ

This menu selection opens a File Dialog Box and allows the user to select a ZIP
file.  Then an external command will run UnZip -v and redirect the output to
the file th_file_list. Then the file will be loaded into the editor.

Note:  UnZip is an Info-ZIP program is not part of TextHelper and must be in
the search path.


ΓòÉΓòÉΓòÉ 1.3.7. Reload Source File ΓòÉΓòÉΓòÉ

This menu selection reloads the file currently loaded in the editor without
opening a File Dialog Box.


ΓòÉΓòÉΓòÉ 1.3.8. Reload Source File with MIME stripping ΓòÉΓòÉΓòÉ

Reload the file that is currently loaded in the editor and translates windows
smart quotes and MIME encoding.


ΓòÉΓòÉΓòÉ 1.3.9. Save - No Dialog Box Prompt ΓòÉΓòÉΓòÉ

Save the file loaded in the editor without displaying a File Dialog Box. If the
file exists, a warning will be displayed.  If the user elects to overwrite the
file and the backup option is enabled, a backup will be made.  A backup count
number will be appended to the file name for each backup of the file.

If the file name is "file.name" and the backup file will be named
"file.name.000" unless that file already exits. If it does then the backup
count number will increment until the file name does not exist in the backup
directory.

If the file "file.name" has been edited and saved five times with the backup
option enabled, the following files will exist in the backup directory.

     file.name.000
     file.name.001
     file.name.002
     file.name.003
     file.name.004

 Note:  The backup option will not work if the backup directory is on a FAT
 formatted drive.


ΓòÉΓòÉΓòÉ 1.3.10. Save As ΓòÉΓòÉΓòÉ

Save the file loaded in the editor, displaying a File Dialog Box and allowing
the user to enter a file name.


ΓòÉΓòÉΓòÉ 1.3.11. Save As Marked ΓòÉΓòÉΓòÉ

If you highlight or mark a descriptive phrase and then select Save As Marked
under the file menu, the marked text will be used as the file name.  This
function is only available in the registered version.

 Under "Options"/"Filename Settings" there are two settings that control how
spaces in the marked text are handled. If you select "Replace Spaces with
Underscore Characters", spaces in the text will be replaced with underscore
characters.  If you select "Leave Spaces in Filename", the spaces will not be
replaced. If there are any characters that should not be used in a filename,
they will be replaced with spaces or underscores.


ΓòÉΓòÉΓòÉ 1.3.12. Print On Selected Printer ΓòÉΓòÉΓòÉ

The Print On Selected Printer selection sends the contents of the editor to the
selected printer.  TextHelper offers pseudo-wysiwyg printing. How the text
wrapped in the edit window is how it will be printed. By changing the size and
typeface of the font used in the edit window and the width of the edit window,
the user can control how the text will be printed.

This is best done by first using the  "De-wrap text in editor" menu selection.
This removes the cr-lf pairs unless there are two sequential cr-lf pairs. There
are two cr-lf pairs at the end of each paragraph. This menu selection turns off
word wrap, so the user must reselect word wrap - the Control+W key combination
is a shortcut to restore word wrap.  Then press the F6 key to get the width of
the longest line. Then by selecting the size of the font used in the editor
window and the width of the edit window the user can determine the longest line
of the text sent to the printer.  The user can then select the desired printer
options to allow the text to be printed correctly.

Note:  The longest line sent to the printer still needs to be short enough to
       fit on the paper.


ΓòÉΓòÉΓòÉ 1.3.13. Print Marked Text On Selected Printer ΓòÉΓòÉΓòÉ

The Print Marked Text On Selected Printer selection sends the text marked in
editor to the selected printer.  TextHelper offers pseudo-wysiwyg printing. How
the text wrapped in the edit window is how it will be printed. By changing the
size and typeface of the font used in the edit window and the width of the edit
window, the user can control how the text will be printed.

This is best done by first using the  "De-wrap text in editor" menu selection.
This removes the cr-lf pairs unless there are two sequential cr-lf pairs. There
are two cr-lf pairs at the end of each paragraph. This menu selection turns off
word wrap, so the user must reselect word wrap - the ControlW+W key combination
is a shortcut to restore word wrap.  Then press the F6 key to get the width of
the longest line. The by selecting the size of the font used in the editor
window and the width of the edit window the user can determine the longest line
of the text sent to the printer.  The user can then select the desired printer
options to allow the text to be printed correctly.

Note:  The longest line sent to the printer still needs to be short enough to
       fit on the paper.


ΓòÉΓòÉΓòÉ 1.3.14. Print Envelope on selected printer ΓòÉΓòÉΓòÉ

This menu selection (when the paper size is set to one of the envelope
selections) causes the text in the editor to be used to address an envelope.
The format of the text is the "From" information, a blank line, and then the
"To" information.  An example address is shown below.

John Q. Public
1234 Anywhere Street
Neptune, Ca.  91209

Donald Hawkinson
2633 8th Avenue
Lindsborg, Kansas 67456-5111
USA

All the user needs to do is set the paper size to one of the envelope
selections and have the addressing information in the editor window.

The "To" information will be printed in small print in the left hand corner of
the envelope.  The blank line will cause the program to skip down several
lines, set the left hand margin, and set the font size. The font size depends
on how many characters are in the longest line of the address.

The "From" information will then be printed with any further blank lines being
treated as blank lines.  If there are more than four lines after the blank line
and the font is set to 5 characters per inch, the address may flow over to a
new page.  To resove this problem pad one of the "To" address lines with spaces
to make it longer than 30 charaters.

It is not necessary to load an envelope in the printer to use this menu
selection.  A regular page may be used to test the output or make a label for a
package.  If you are making a mailing label for a package, you can select the
A5 page option and the Print Envelope option will still be available.


ΓòÉΓòÉΓòÉ 1.3.15. Send reset to selected printer ΓòÉΓòÉΓòÉ

This menu selection should only be available if you do not have the "Generic
printer, not HP DeskJet compatible" option selected.

This command will put a HP Deskjet compatible printer into the default state so
that any programming from the last job sent to the printer will not included in
further printing.


ΓòÉΓòÉΓòÉ 1.3.16. Delete Source File ΓòÉΓòÉΓòÉ

This menu selection will delete the file loaded into the editor.

This includes the contents of the editor and the source file on the hard drive.


ΓòÉΓòÉΓòÉ 1.3.17. Exit ΓòÉΓòÉΓòÉ

This menu selection closes or exits  TextHelper unless the contents of the
editor have not been changed and not saved. If that is the case, the user is
warned that the changes have not been saved and asked to confirm the exit.


ΓòÉΓòÉΓòÉ 1.4. Edit ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains selections for editing
and editor functions.


ΓòÉΓòÉΓòÉ 1.4.1. Cut ΓòÉΓòÉΓòÉ

This selection deletes the text marked in the edit window and puts it in the
OS/2 or eCS clipboard.


ΓòÉΓòÉΓòÉ 1.4.2. Copy ΓòÉΓòÉΓòÉ

This selection copies the text marked in the edit window and puts it in the
OS/2 or eCS clipboard.


ΓòÉΓòÉΓòÉ 1.4.3. Paste ΓòÉΓòÉΓòÉ

This selection copies the text from the OS/2 or eCS clipboard inserts it at the
cursor in the edit window.


ΓòÉΓòÉΓòÉ 1.4.4. Select All ΓòÉΓòÉΓòÉ

This selection marks all the text in the edit window.


ΓòÉΓòÉΓòÉ 1.4.5. Clear All ΓòÉΓòÉΓòÉ

This menu selection closes the file without saving it and clears the editor. If
changes have been made to the file, the user is not warned that the file has
not been saved.


ΓòÉΓòÉΓòÉ 1.4.6. Undo ΓòÉΓòÉΓòÉ

This menu selection will undo some of the changes made in the edit window. The
UNDO function is controlled by the IBM Open Class Library and I do not have any
control over what it will undo.  Do not rely on being able to undo any action.

None of the whole file actions can be undone by the Undo function.


ΓòÉΓòÉΓòÉ 1.4.7. Search ΓòÉΓòÉΓòÉ

This menu selection prompts the user for a search string and then starts the
search when the string has been entered.

The search method used is line oriented and only the first instance of the
search string in each line will be marked.  If the Search Again function is
selected, the search will begin on the next line.

If the wildcard option is checked, only the first character of the line where
the match was found will be marked.


ΓòÉΓòÉΓòÉ 1.4.8. Case sensitivity in the search ΓòÉΓòÉΓòÉ

The menu selection toggles the case sensitivity for the search.


ΓòÉΓòÉΓòÉ 1.4.9. Wildcard(s) in the search pattern ΓòÉΓòÉΓòÉ

The menu selection toggles the use of wildcard(s) in the search pattern. There
are two wildcard characters that are valid when this option is turned on - '?'
and '*'.  The '?' represents a single character and the '*' represents multiple
characters.

When the the wildcard options is enabled, the search pattern is not marked when
a match is found. Only the first character of the line where the pattern was
found is marked.


ΓòÉΓòÉΓòÉ 1.4.10. Search Again ΓòÉΓòÉΓòÉ

This menu selection repeats the search. The F5 key is a shortcut to this menu
selection.


ΓòÉΓòÉΓòÉ 1.4.11. Search Again From Top ΓòÉΓòÉΓòÉ

This menu selection moves the cursor to the top of the file and repeats the
search. The F7 key is a shortcut to this menu selection.


ΓòÉΓòÉΓòÉ 1.4.12. Search and Replace ΓòÉΓòÉΓòÉ

This menu selection prompts the user for a search string and a replacement
string then performs the action on the whole file in the editor. This action
will not be undone by the UNDO menu selection.

The search and replace function uses a different algorithm and will change all
occurrences of the search string.

The text in the editor is treated as one large string for the search and
replace function, and the overhead increases significantly as the file size
increases.


ΓòÉΓòÉΓòÉ 1.4.13. Whole File Operations ΓòÉΓòÉΓòÉ

This submenu exists to reduce the length of the "Edit" menu. The selections in
this submenu are all actions that operate on the contents of the editor by
writing the changed lines to a temporary file and then loading the temporary
file back into the editor.


ΓòÉΓòÉΓòÉ 1.4.13.1. Strip leading ΓòÉΓòÉΓòÉ

This selections in this submenu contain the various options for removing
spaces, numbers, punctuation, and single characters from the start of lines in
the editor.


ΓòÉΓòÉΓòÉ 1.4.13.1.1. Strip leading blanks from text in editor ΓòÉΓòÉΓòÉ

This menu selection strips the leading blanks and tabs from the lines of text
in the editor.


ΓòÉΓòÉΓòÉ 1.4.13.1.2. Strip leading numbers from text in editor ΓòÉΓòÉΓòÉ

This menu selection strips the leading numbers from the lines of text in the
editor. It also strips the any leading spaces in front of the numbers. It also
strips any punctuation after the numbers.


ΓòÉΓòÉΓòÉ 1.4.13.1.3. Strip leading punctuation from text in editor ΓòÉΓòÉΓòÉ

This menu selection strips the leading punctuation from the lines of text in
the editor.


ΓòÉΓòÉΓòÉ 1.4.13.1.4. Strip leading character from text in editor ΓòÉΓòÉΓòÉ

This menu selection strips the leading character from the lines of text in the
editor.


ΓòÉΓòÉΓòÉ 1.4.13.2. Strip trailing blanks from text in editor ΓòÉΓòÉΓòÉ

This menu selection strips the trailing blanks and tabs from the text in the
editor.


ΓòÉΓòÉΓòÉ 1.4.13.3. Strip blank lines from text in editor ΓòÉΓòÉΓòÉ

This menu selection strips blank lines from the text in the editor.


ΓòÉΓòÉΓòÉ 1.4.13.4. Remove multiple spaces from text in editor ΓòÉΓòÉΓòÉ

This menu selection removes multiple spaces from the text in the editor. This
also converts tab charactersand form feeds to single spaces.


ΓòÉΓòÉΓòÉ 1.4.13.5. Translate windows smart quotes & mime encoding from text in editor ΓòÉΓòÉΓòÉ

This menu selection translate windows smart quotes and mime encoding from text
in editor Click on the following URL for an explanation of "smart quotes"

http://www.fourmilab.ch/webtools/demoroniser/

 The URL is for a windows program, but the text does a good job of describing
"smart quotes". The following text was "borrowed from that web page.

You see, "state of the art" Microsoft Office applications sport a nifty feature
called "smart quotes." (Rule of thumb--every time Microsoft use the word
"smart," be on the lookout for something dumb). This feature is on by default
in both Word and PowerPoint, and can be disabled only by finding the little box
buried among the dozens of bewildering option panels these products contain. If
enabled, and you type the string,

"Halt," he cried, "this is the police!"

 "smart quotes" transforms the ASCII quote characters automatically into the
incompatible Microsoft opening and closing quotes. ASCII single and double
quotes are similarly transformed (even though ASCII already contains apostrophe
and single open quote characters), and double hyphens are replaced by the
incompatible em dash symbol. What other horrors occur, I know not. If the user
notices this happening at all, their reaction might be "Thank you
Billy-boy--that looks ever so much nicer," not knowing they've been set up to
look like a moron to folks all over the world.  You see, when you export a
document as text for hand-editing into HTML, or avail yourself of the "Save as
HTML" features in newer versions of Office applications, these incompatible,
Microsoft-specific characters remain in place. When viewed by a user on a
non-Microsoft platform, they will not be displayed properly--most browsers seem
to just drop them, as opposed to including a symbol indicating an undisplayable
character. Hence, the apparently ungrammatical text, which the author of the
page, editing on a Microsoft platform, will never be aware of.

The following is a explanation of the MIME encoding that this menu selection
removes from the text in the editor. The text was borrowed from the following
URL.

http://www.mhonarc.org/~ehood/MIME/2045/rfc2045.html

 MIME Quoted-Printable Content-Transfer-Encoding

 The Quoted-Printable encoding is intended to represent data that largely
consists of octets that correspond to printable characters in the US-ASCII
character set. It encodes the data in such a way that the resulting octets are
unlikely to be modified by mail transport. If the data being encoded are mostly
US-ASCII text, the encoded form of the data remains largely recognizable by
humans. A body which is entirely US-ASCII may also be encoded in
Quoted-Printable to ensure the integrity of the data should the message pass
through a character-translating, and/or line-wrapping gateway.

 In this encoding, octets are to be represented as determined by the following
rules:

 1. (General 8bit representation) Any octet, except a CR or LF that is part of
a CRLF line break of the canonical (standard) form of the data being encoded,
may be represented by an "=" followed by a two digit hexadecimal representation
of the octet's value. The digits of the hexadecimal alphabet, for this purpose,
are "0123456789ABCDEF". Uppercase letters must be used; lowercase letters are
not allowed. Thus, for example, the decimal value 12 (US-ASCII form feed) can
be represented by "=0C", and the decimal value 61 (US-ASCII EQUAL SIGN) can be
represented by "=3D". This rule must be followed except when the following
rules allow an alternative encoding.

 2. (Literal representation) Octets with decimal values of 33 through 60
inclusive, and 62 through 126, inclusive, MAY be represented as the US-ASCII
characters which correspond to those octets (EXCLAMATION POINT through LESS
THAN, and GREATER THAN through TILDE, respectively).

 3. (White Space) Octets with values of 9 and 32 MAY be represented as US-ASCII
TAB (HT) and SPACE characters, respectively, but MUST NOT be so represented at
the end of an encoded line. Any TAB (HT) or SPACE characters on an encoded line
MUST thus be followed on that line by a printable character. In particular, an
"=" at the end of an encoded line, indicating a soft line break (see rule #5)
may follow one or more TAB (HT) or SPACE characters. It follows that an octet
with decimal value 9 or 32 appearing at the end of an encoded line must be
represented according to Rule #1. This rule is necessary because some MTAs
(Message Transport Agents, programs which transport messages from one user to
another, or perform a portion of such transfers) are known to pad lines of text
with SPACEs, and others are known to remove "white space" characters from the
end of a line. Therefore, when decoding a Quoted-Printable body, any trailing
white space on a line must be deleted, as it will necessarily have been added
by intermediate transport agents.

 4. (Line Breaks) A line break in a text body, represented as a CRLF sequence
in the text canonical form, must be represented by a (RFC 822) line break,
which is also a CRLF sequence, in the Quoted-Printable encoding. Since the
canonical representation of media types other than text do not generally
include the representation of line breaks as CRLF sequences, no hard line
breaks (i.e. line breaks that are intended to be meaningful and to be displayed
to the user) can occur in the quoted-printable encoding of such types.
Sequences like "=0D", "=0A", "=0A=0D" and "=0D=0A" will routinely appear in
non-text data represented in quoted-printable, of course.

 Note that many implementations may elect to encode the local representation of
various content types directly rather than converting to canonical form first,
encoding, and then converting back to local representation. In particular, this
may apply to plain text material on systems that use newline conventions other
than a CRLF terminator sequence. Such an implementation optimization is
permissible, but only when the combined canonicalization-encoding step is
equivalent to performing the three steps separately.

 5. (Soft Line Breaks) The Quoted-Printable encoding REQUIRES that encoded
lines be no more than 76 characters long. If longer lines are to be encoded
with the Quoted-Printable encoding, "soft" line breaks must be used. An equal
sign as the last character on a encoded line indicates such a non-significant
("soft") line break in the encoded text.

 Thus if the "raw" form of the line is a single unencoded line that says:

 Now's the time for all folk to come to the aid of their country.

 This can be represented, in the Quoted-Printable encoding, as:

 Now's the time =
for all folk to come=
to the aid of their country.

 This provides a mechanism with which long lines are encoded in such a way as
to be restored by the user agent. The 76 character limit does not count the
trailing CRLF, but counts all other characters, including any equal signs.

 Since the hyphen character ("-") may be represented as itself in the
Quoted-Printable encoding, care must be taken, when encapsulating a
quoted-printable encoded body inside one or more multipart entities, to ensure
that the boundary delimiter does not appear anywhere in the encoded body. (A
good strategy is to choose a boundary that includes a character sequence such
as "=_" which can never appear in a quoted-printable body.


ΓòÉΓòÉΓòÉ 1.4.13.6. De-wrap text in editor ΓòÉΓòÉΓòÉ

This option removes all cr-lf pairs except when there are two pairs together.
This operation also turns off the word wrap funtion of the displayed text. The
word wrap of the displayed text may be turned back on with the Control+W key
combination. The word wrapping may be adjusted by changing the font and the
width of the editor window. Unless the option to Hard code word wrap  is used,
the displayed word wrap is not saved.

Note:  The longest line that can be loaded into TextHelper is 32768 characters.
       If the de-wrapped text contains lines that are 32768 characters or
       longer, the text will not be loaded into the editor.


ΓòÉΓòÉΓòÉ 1.4.13.7. Hard code word wrap ΓòÉΓòÉΓòÉ

This option adds CR-LF pairs to each line in the display window to make the
current word wrap permanent.


ΓòÉΓòÉΓòÉ 1.4.13.8. Strip Forwarding marks ΓòÉΓòÉΓòÉ

This menu selection removes the forwarding marks '>' from the text in the
editor.  This is useful when you get an email that has been forwarded multiple
times, but has some text that you want to save.

The program starts at the 15th character and moves toward the start of the line
looking for a forwarding mark. When a forwarding mark is found, the front of
the line is truncated including the forwarding mark.


ΓòÉΓòÉΓòÉ 1.4.13.9. Reverse text in editor ΓòÉΓòÉΓòÉ

This menu selection reverses the text in the editor.

It has no valid use, but is there because the function was part of the IBM Open
Class Library IString class and the programmer found it entertaining.


ΓòÉΓòÉΓòÉ 1.4.13.10. ROT13 text in editor ΓòÉΓòÉΓòÉ

This option performs a ROT13 on the text in the editor. The characters
"abcdefghihjklm" and "ABCDEFGHIHJKLM" are shifted up by 13 to become
"nopqrstuvwxyz" and "NOPQRSTUVWXYZ". The characters "nopqrstuvwxyz" and
"NOPQRSTUVWXYZ" are shifted down by 13 to become "abcdefghihjklm" and
"ABCDEFGHIHJKLM". Performing a ROT13 on the text twice will result in the
orginal text.

/rot ther'teen/ [Usenet: from "rotate alphabet 13 places"], v. The simple
Caesar-cypher encryption that replaces each English letter with the one 13
places forward or back along the alphabet, so that "The butler did it!" becomes
"Gur ohgyre qvq vg!" Most Usenet news reading and posting programs include a
rot13 feature. It is used to enclose the text in a sealed wrapper that the
reader must choose to open - e.g. for posting things that might offend some
readers, or spoilers. A major advantage of rot13 over rot(N) for other N is
that it is self-inverse, so the same code can be used for encoding and
decoding.

From Wikipedia, the free encyclopedia

ROT13 replaces each letter by its partner 13 characters further along the
alphabet. For example, HELLO becomes URYYB (or, decrypting, URYYB becomes HELLO
again).

ROT13 ("rotate by 13 places", sometimes hyphenated ROT-13) is a simple
Substitution cipher used in online forums as a means of hiding spoilers,
punchlines, puzzle solutions, and offensive materials from the casual glance.
ROT13 has been described as the "Usenet equivalent of a magazine printing the
answer to a quiz upside down". ROT13 is a variation of the Caesar cipher,
developed in ancient Rome.

ROT13 is its own inverse; that is, to undo ROT13, the same algorithm is
applied, so the same action can be used for encoding and decoding. The
algorithm provides no real cryptographic security and is not normally used for
such. It is often cited as a canonical example of weak encryption. ROT13 has
inspired a variety of letter and word games on-line, and is frequently
mentioned in newsgroup conversations.

The cipher is also sometimes known as EBG13 or EBG-13 because "EBG13" is
"ROT13" in ROT13.


ΓòÉΓòÉΓòÉ 1.4.13.11. Center lines in editor on the longest line ΓòÉΓòÉΓòÉ

This option centers all lines of text in the editor. The function looks for the
longest line an then pads the shorter lines with leading spaces.


ΓòÉΓòÉΓòÉ 1.4.14. Miscellaneous ΓòÉΓòÉΓòÉ

This submenu contains functions that do not fit well in other submenus.


ΓòÉΓòÉΓòÉ 1.4.14.1. Get lines information ΓòÉΓòÉΓòÉ

This menu selection counts the number of lines and words in the editor and
finds the longest line, and moves the cursor to the start of that line. The F6
key is a shortcut to this menu selection.

The information reported is affected by the Word Wrap option.

The online information for Print On Selected Printer  has more on how to use
the information reported by this menu selection.


ΓòÉΓòÉΓòÉ 1.4.14.2. Launch Browser with marked URL ΓòÉΓòÉΓòÉ

This menu selection launches a browser with a URL that has been marked in the
editor.  The URL must start with "http". The default browser is FIREFOX.


ΓòÉΓòÉΓòÉ 1.4.14.3. Go to first line ΓòÉΓòÉΓòÉ

This selection will move the cursor to the first line in the editor.


ΓòÉΓòÉΓòÉ 1.4.14.4. Go to last line ΓòÉΓòÉΓòÉ

This selection will move the cursor to the last line in the editor.


ΓòÉΓòÉΓòÉ 1.4.14.5. Go to line number ΓòÉΓòÉΓòÉ

This selection will open a dialog box to prompt the user for a line number and
then the cursor to the line number entered in the dialog.

Note:  If the number entered is greater than the number of lines in the editor,
no error message will be displayed and the cursor will be moved to the last
line.


ΓòÉΓòÉΓòÉ 1.4.14.6. Display current line number ΓòÉΓòÉΓòÉ

This selection will display the current location of the cursor in the
Information Area at the bottom of the edit window. The cursor position
displayed will not be updated as the cursor is moved in the edit window.


ΓòÉΓòÉΓòÉ 1.4.14.7. Insert Timestamp at cursor ΓòÉΓòÉΓòÉ

This menu selection puts a timestamp at the cursor, but has the unfortunate
habit of sometimes truncating the rest of the text in the line.

The timestamp is in 24 hour format.


ΓòÉΓòÉΓòÉ 1.4.14.8. Use marked text to generate password string ΓòÉΓòÉΓòÉ

This menu selection uses the marked text to generate a password string. The
generated password and the original text are appended as the last lines in the
editor. The marked text is reversed and XORed with an internal string that is
68 characters long.  It is then converted into a string of hex characters.  The
resulting string is two times the length of the marked text plus two
characters.


ΓòÉΓòÉΓòÉ 1.4.14.9. Uppercase marked text in editor ΓòÉΓòÉΓòÉ

This menu selection converts the marked text to upper case letters.

It may not be that useful, but the function was part of the IBM Open Class
Library IString class and the programmer found it entertaining.

Note:  This function is limited to the text in a single line and must not
       include the new line characters (which appear as spaces at the end of
       the line). The function will not execute if a carriage return or line
       feed is included in the marked text.


ΓòÉΓòÉΓòÉ 1.4.14.10. Lowercase marked text in editor ΓòÉΓòÉΓòÉ

This menu selection converts the marked text to lower case letters.

It may not be that useful, but the function was part of the IBM Open Class
Library IString class and the programmer found it entertaining.

Note:  This function is limited to the text in a single line and must not
       include the new line characters (which appear as spaces at the end of
       the line). The function will not execute if a carriage return or line
       feed is included in the marked text.


ΓòÉΓòÉΓòÉ 1.4.14.11. Center line in editor ΓòÉΓòÉΓòÉ

This menu selection centers the line where the cursor is located based on the
longest displayed line within the first 60 lines. If word wrap is enabled, the
centering is based on the length of the wrapped line.

It is intended to center a title, but will work on any line.


ΓòÉΓòÉΓòÉ 1.5. Options ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains selections to
configure the editor, display and printer parameters.


ΓòÉΓòÉΓòÉ 1.5.1. Display Options ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains selections to select
the font used, reset the colors and set word wrap on and off.

Colors must set by drag and drop from one of the color palettes.  To set the
text colors, hold down the cntrl key while doing the drag and drop.


ΓòÉΓòÉΓòÉ 1.5.1.1. Font ΓòÉΓòÉΓòÉ

The Font selection opens a standard OS/2 Font dialog box that lets the user
select a new font or change the font size for the displayed results.  This will
allow the selection of any of the installed fonts. This option only changes the
font in the main window. To change the font selection sent to the printer you
must use the HP DeskJet Compatible Printer Options  menu selection.

To change the font for the menubar or the information area below the main
window, use the OS/2 font palette and drag and drop a new font on either area.
The font colors may also be changed be drag and drop if the control key is held
down and the color dropped on the text.

Note:  The font selections are only saved when Save Settings is selected.


ΓòÉΓòÉΓòÉ 1.5.1.2. Reset to default colors ΓòÉΓòÉΓòÉ

The 'Reset to default colors' option restores  TextHelper to the system default
background and foreground colors.

To change the colors on the menubar, main window, or the information area use
the OS/2 color palette and drag and drop a color selection.  When Save Settings
is selected , the current color selections are saved.

Note:  The font colors are reset by this selection.


ΓòÉΓòÉΓòÉ 1.5.1.3. Word Wrap ΓòÉΓòÉΓòÉ

The Word Wrap selection enables or disables the word wrap feature of the editor
window.

Note:  The Word Wrap is a software word wrap and it does not insert hard
       carriage return - line feed  pairs.


ΓòÉΓòÉΓòÉ 1.5.2. Filename Settings ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains selections to
configure the filename,  backup, and default load path options.


ΓòÉΓòÉΓòÉ 1.5.2.1. Replace Spaces with Underscore Characters ΓòÉΓòÉΓòÉ

This menu selection enables the replacing of spaces with underscore characters
when the user has text marked for use as a save filename.

See Save As Marked  for more on how this option is used.


ΓòÉΓòÉΓòÉ 1.5.2.2. Leave Spaces in Filename ΓòÉΓòÉΓòÉ

This menu selection enables the use of spaces when the user has text marked for
use as a save filename.

See Save As Marked  for more on how this option is used.


ΓòÉΓòÉΓòÉ 1.5.2.3. Enter Backup Path ΓòÉΓòÉΓòÉ

This menu selection opens a dialog box for entering the path for backups.

If the file name is "file.name" and the backup file will be named
"file.name.000" unless that file already exits. If it does then the backup
count number will increment until the file name does not exist in the backup
directory.

If the file "file.name" has been edited and saved five times with the backup
option enabled, the following files will exist in the backup directory.

     file.name.000
     file.name.001
     file.name.002
     file.name.003
     file.name.004

 Note:  The backup option will not work if the backup directory is on a FAT
 formatted drive.


ΓòÉΓòÉΓòÉ 1.5.2.4. Enable Making Backups ΓòÉΓòÉΓòÉ

This menu selection enables the backup option. Enter The Backup Path option
does not enable making backups.


ΓòÉΓòÉΓòÉ 1.5.2.5. Enter Default Load Path ΓòÉΓòÉΓòÉ

This menu selection opens a dialog box for entering the default load path.
This is the location that is loaded into the file dialog box when "Open File"
is selected.  This is useful when most of the files loaded into  TextHelper
come from the same location.


ΓòÉΓòÉΓòÉ 1.5.2.6. Enable Use of Default Load Path ΓòÉΓòÉΓòÉ

This menu selection enables the use of the Default Load Path.


ΓòÉΓòÉΓòÉ 1.5.2.7. Enter Browser Name ΓòÉΓòÉΓòÉ

This menu selection enables the user to enter name of the prefered browser.
The browser must be in the search path so that the browser may be started from
the OS/2 or eCS command line. The default is the Firefox browser.


ΓòÉΓòÉΓòÉ 1.5.3. Printer Selection ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains the options for the
destination of the print jobs.


ΓòÉΓòÉΓòÉ 1.5.3.1. PRN  default printer ΓòÉΓòÉΓòÉ

This menu selection selects the PRN  device as the destination for print jobs.
This is the default printer set in the WPS.


ΓòÉΓòÉΓòÉ 1.5.3.2. LPT1 ΓòÉΓòÉΓòÉ

This menu selection selects the LPT1  device as the destination for print jobs.


ΓòÉΓòÉΓòÉ 1.5.3.3. LPT2 ΓòÉΓòÉΓòÉ

This menu selection selects the LPT2  device as the destination for print jobs.


ΓòÉΓòÉΓòÉ 1.5.3.4. LPT3 ΓòÉΓòÉΓòÉ

This menu selection selects the LPT3  device as the destination for print jobs.


ΓòÉΓòÉΓòÉ 1.5.3.5. testPRN ΓòÉΓòÉΓòÉ

This menu selection selects the file  testPRN  as the destination for print
jobs.  This allows the user to see just what would be sent to the printer and
may save paper if the output is not what was wanted.

The file is created in the working directory and may be opened by any file
viewer such as List or any editor including  TextHelper.


ΓòÉΓòÉΓòÉ 1.5.4. Generic printer, not HP DeskJet compatible ΓòÉΓòÉΓòÉ

This menu selection disables the HP DeskJet Options and special programming.


ΓòÉΓòÉΓòÉ 1.5.5. HP DeskJet Compatible Printer Options ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains selections to select
the HP DeskJet Compatible Printer Options.


ΓòÉΓòÉΓòÉ 1.5.5.1. Character Set ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains a list of supported
character or symbol sets.

Note:  The list is the one supported by the HP DeskJet 632c. If you need a
character set that is not listed, contact the author.


ΓòÉΓòÉΓòÉ 1.5.5.1.1. Supported Character Sets ΓòÉΓòÉΓòÉ

One of the supported character or symbol sets.

Note:  The list is the one supported by the HP DeskJet 632c. If you need a
character set that is not listed, contact the author.


ΓòÉΓòÉΓòÉ 1.5.5.2. Printer Font Settings ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains a list of supported
font options.


ΓòÉΓòÉΓòÉ 1.5.5.2.1. Lines per inch ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains a list of supported
lines per inch options.

Lines per inch option

One of the supported lines per inch options


ΓòÉΓòÉΓòÉ 1.5.5.2.2. Characters per inch ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains a list of supported
Characters per inch options and attributes.

Characters per inch option

One of the supported character per inch options in a courier font

Bold option

Adds a bold attribute to the printed characters

Proportional Font

Selects a proportional font that is approximately 14 characters per inch.

Letter Quality Mode

Adds a Letter Quality mode to the printed characters.

Italic Proportional font

Selects an italic proportional font that is approximately 14 characters per
inch.


ΓòÉΓòÉΓòÉ 1.5.5.2.3. Character Point Size ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains a list of supported
character Point Size options.

Default for font

Do not change point size, leave at default size.

Character Point Size Option

One of the supported character point size options.
 6 point is the smallest and used with the 10 or 12 lines per inch option
 12 point is nornal on my printer, but it may not be on other printers
 24 point is the largest and should be used with the 3 or 4 lines per inch
option.


ΓòÉΓòÉΓòÉ 1.5.5.3. Double space lines ΓòÉΓòÉΓòÉ

This menu selection selects the double space line option which adds a blank
line between source lines when printed.


ΓòÉΓòÉΓòÉ 1.5.5.4. Add line numbers ΓòÉΓòÉΓòÉ

This menu selection selects the line number option which adds line number
before source lines when printed.


ΓòÉΓòÉΓòÉ 1.5.5.5. 3 hole punch margin ΓòÉΓòÉΓòÉ

This menu selection selects the 3 hole punch margin option which adds a margin
before source lines when printed.


ΓòÉΓòÉΓòÉ 1.5.5.6. Paper Size ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu that contains a list of supported
paper size options.


ΓòÉΓòÉΓòÉ 1.5.5.6.1. A4 Paper Size ΓòÉΓòÉΓòÉ

This menu selection selects the Euro A4 (210 x 297 mm) paper size option.


ΓòÉΓòÉΓòÉ 1.5.5.6.2. A5 Paper Size ΓòÉΓòÉΓòÉ

This menu selection selects the Euro A5 paper (148 x 210 mm) size option.


ΓòÉΓòÉΓòÉ 1.5.5.6.3. US Letter Paper Size ΓòÉΓòÉΓòÉ

This menu selection selects the US letter paper (8.5 x 11 in) size option.


ΓòÉΓòÉΓòÉ 1.5.5.6.4. US Legal Paper Size ΓòÉΓòÉΓòÉ

This menu selection selects the US legal paper size (8.5 x 14 in) option.


ΓòÉΓòÉΓòÉ 1.5.5.6.5. Envelope - US #10 ΓòÉΓòÉΓòÉ

This menu selection selects the Envelope - US #10 (4.12 x 9.5 in) option.


ΓòÉΓòÉΓòÉ 1.5.5.6.6. Envelope - Euro DL ΓòÉΓòÉΓòÉ

This menu selection selects the Envelope - Euro DL (110 x 220 mm) option.


ΓòÉΓòÉΓòÉ 1.5.5.7. Print Orientation ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu for selecting Portrait or Landscape
print orientation


ΓòÉΓòÉΓòÉ 1.5.5.7.1. Portrait mode ΓòÉΓòÉΓòÉ

This menu selection selects Portrait mode printing.


ΓòÉΓòÉΓòÉ 1.5.5.7.2. Landscape mode ΓòÉΓòÉΓòÉ

This menu selection selects Landscape mode printing.


ΓòÉΓòÉΓòÉ 1.5.5.8. Duplex ΓòÉΓòÉΓòÉ

This menu selection opens a pull-down menu for selecting duplex options


ΓòÉΓòÉΓòÉ 1.5.5.8.1. No Duplex ΓòÉΓòÉΓòÉ

This menu selection selects no duplex mode printing.


ΓòÉΓòÉΓòÉ 1.5.5.8.2. LaserJet Duplex ΓòÉΓòÉΓòÉ

This menu selection selects LaserJet Duplex mode printing.

This option may work for other HP printers or HP PCL compatible printers that
have internal duplex functions.

Note:  The HP DeskJet 632c printer does not have a duplex function, so this
function is untested.


ΓòÉΓòÉΓòÉ 1.5.6. Save Settings ΓòÉΓòÉΓòÉ

This menu selection saves the selected options and the search text if it
exists.

Note:  The settings are saved in a file named  texthelp.ini  that is located in
       the same directory as the executable unless an environment varaible is
       set by a line added to the CONFIG.SYS file.

SET TEXTHELPER = <drive>: \ <path>

This line would allow  TextHelper to be started from any directory and the
settings file to be found.


ΓòÉΓòÉΓòÉ 1.6. New Editor ΓòÉΓòÉΓòÉ

This menu selection opens new copy of  TextHelper.

Note:  The editor is opened with the saved settings, not the settings of the
currently opened copy of  TextHelper.


ΓòÉΓòÉΓòÉ 1.7. Grab Clipboard ΓòÉΓòÉΓòÉ

This menu selection opens new copy of  TextHelper and pastes the contents of
the clipboard into the editor. The new copy of  TextHelper is opened minimized
to reduce desktop clutter.

Note:  If the OS/2 or eCS clipboard is empty or does not contain text, a new
copy of TextHelper is not opened.

Note:  The editor is opened with the saved settings, not the settings of the
currently opened copy of  TextHelper.


ΓòÉΓòÉΓòÉ 1.8. Title ΓòÉΓòÉΓòÉ

This menu selection opens a text dialog for entering a title for easy
identification of the edit window. This title will appear in the OS/2 or eCS
window list. This does not change the file name if a file has been opened in
the editor.


ΓòÉΓòÉΓòÉ 1.9. File List ΓòÉΓòÉΓòÉ

This menu selection opens a submenu for working with a file list.


ΓòÉΓòÉΓòÉ 1.9.1. Select files for file list ΓòÉΓòÉΓòÉ

This menu selection opens a File Dialog for selecting a single file name or
multiple file names to be inserted as text in the edit window.  The file names
will include the drive letter and the complete directory structure.


ΓòÉΓòÉΓòÉ 1.9.2. Use editor contents as template ΓòÉΓòÉΓòÉ

This menu selection copies the current contents of the editor for use as a
command template.  When files are selected via the File List menu option, each
instance of "%s" in the command template will be replaced by a file name. The
command template may be multiple lines.

If the following text is used as the command template.

copy %s

Then the files selected will be applied to the command template and the
following will be inserted in the edit window.

copy L:\IBMCPP\SAMPLES\IOC\TH\ADIALOG4.CPP
copy L:\IBMCPP\SAMPLES\IOC\TH\ADIALOG4.DLG
copy L:\IBMCPP\SAMPLES\IOC\TH\ADIALOG4.HPP
copy L:\IBMCPP\SAMPLES\IOC\TH\adialog4.lst
copy L:\IBMCPP\SAMPLES\IOC\TH\aextent.cpp


ΓòÉΓòÉΓòÉ 1.9.3. Build ZIP file using file list in editor ΓòÉΓòÉΓòÉ

This menu selection checks the current contents of the editor to verify that
each line contains a valid filename. Then a File Dialog Box will open to allow
selection of a drive, directry, and file name for the ZIP file. Then an
external command will be ran to create the ZIP file.

Note:  Zip is an Info-ZIP program is not part of TextHelper and must be in the
search path.