TOOLKIT\FTEXT.DOC  ·  DOC  ·  2.5 KB  ·  1988-12-01  ·  from PersonalComputing_Dec-1988
                               FTEXT.EXE
                            by David Foster

FTEXT is a program to display the text in any file. The main use is to
view any text in program files.

FTEXT was created as a result of a program appearing on a bulletin
board as Public Domain software when it actually contained Copyright
messages. The person who uploaded the program thought it was PD because
no Copyright message was displayed when the program was run. FTEXT will
display any such messages hidden in a file. Whilst the lack of any such
message is no guarantee that a program is PD and programs should never
be uploaded to a BB unless they are known not to be copyrighted, FTEXT
will quickly eliminate many about which there is doubt.

It is also interesting to see the messages in a program and sometimes
even new or undocumented features may be discovered!

DESCRIPTION

FTEXT will only display printable ASCII characters in the range 32-127.
By default all strings of less than 4 characters are discarded, which
eliminates a lot of the program 'garbage', although the minimum length
can be changed to any value up to 128 characters. A string is
considered to be any  continuous group of ASCII characters by FTEXT.
Leading spaces at the start of a string are always discarded and each
string starts on a new line. Optionally, the display may be paused
after each screen is displayed.

SYNTAX

    FTEXT <filespec> (/P) (/Mn)

<filespec> is the name of the file to be examined and may contain a
           drive letter and/or directory path.

/P         is optional and causes the display to pause after each
           screenful.

/Mn        is optional and determines the minimum size of text that will
           be displayed, where 'n' is a number between 1 and 128.

EXAMPLES

    FTEXT MYPROG.EXE /M15

will display all strings of ASCII characters of 15 or more characters
length in the file called 'MYPROG.EXE'.

    FTEXT A:\MYDIR\MYPROG.EXE /P

will display all strings of 4 or more characters, pausing after the
display of each screenful. After each screen, you may press M for More,
or Q to Quit.

    FTEXT MYPROG.EXE >NEWFILE

will send a list of all ASCII strings in 'MYPROG.EXE' to a file called
'NEWFILE'. This makes use of the MS-DOS re-direction facility, using
'>' to re-direct the output to a file. Do not use the /P switch when
doing this, or the program will appear to 'hang' as it waits for you to
press 'M for More' in answer to the message you won't see displayed!