Home » CEEFAX disks » telesoftware12.adl » 13-01-89/Ftext\DOC

13-01-89/Ftext\DOC

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » CEEFAX disks » telesoftware12.adl
Filename: 13-01-89/Ftext\DOC
Read OK:
File size: 09FF bytes
Load address: 0000
Exec address: FFFFFFFF
File contents
                               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!

00000000  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000010  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 46  |               F|
00000020  54 45 58 54 2e 45 58 45  0d 0a 20 20 20 20 20 20  |TEXT.EXE..      |
00000030  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000040  20 20 20 20 20 20 62 79  20 44 61 76 69 64 20 46  |      by David F|
00000050  6f 73 74 65 72 0d 0a 0d  0a 46 54 45 58 54 20 69  |oster....FTEXT i|
00000060  73 20 61 20 70 72 6f 67  72 61 6d 20 74 6f 20 64  |s a program to d|
00000070  69 73 70 6c 61 79 20 74  68 65 20 74 65 78 74 20  |isplay the text |
00000080  69 6e 20 61 6e 79 20 66  69 6c 65 2e 20 54 68 65  |in any file. The|
00000090  20 6d 61 69 6e 20 75 73  65 20 69 73 20 74 6f 0d  | main use is to.|
000000a0  0a 76 69 65 77 20 61 6e  79 20 74 65 78 74 20 69  |.view any text i|
000000b0  6e 20 70 72 6f 67 72 61  6d 20 66 69 6c 65 73 2e  |n program files.|
000000c0  0d 0a 0d 0a 46 54 45 58  54 20 77 61 73 20 63 72  |....FTEXT was cr|
000000d0  65 61 74 65 64 20 61 73  20 61 20 72 65 73 75 6c  |eated as a resul|
000000e0  74 20 6f 66 20 61 20 70  72 6f 67 72 61 6d 20 61  |t of a program a|
000000f0  70 70 65 61 72 69 6e 67  20 6f 6e 20 61 20 62 75  |ppearing on a bu|
00000100  6c 6c 65 74 69 6e 0d 0a  62 6f 61 72 64 20 61 73  |lletin..board as|
00000110  20 50 75 62 6c 69 63 20  44 6f 6d 61 69 6e 20 73  | Public Domain s|
00000120  6f 66 74 77 61 72 65 20  77 68 65 6e 20 69 74 20  |oftware when it |
00000130  61 63 74 75 61 6c 6c 79  20 63 6f 6e 74 61 69 6e  |actually contain|
00000140  65 64 20 43 6f 70 79 72  69 67 68 74 0d 0a 6d 65  |ed Copyright..me|
00000150  73 73 61 67 65 73 2e 20  54 68 65 20 70 65 72 73  |ssages. The pers|
00000160  6f 6e 20 77 68 6f 20 75  70 6c 6f 61 64 65 64 20  |on who uploaded |
00000170  74 68 65 20 70 72 6f 67  72 61 6d 20 74 68 6f 75  |the program thou|
00000180  67 68 74 20 69 74 20 77  61 73 20 50 44 20 62 65  |ght it was PD be|
00000190  63 61 75 73 65 0d 0a 6e  6f 20 43 6f 70 79 72 69  |cause..no Copyri|
000001a0  67 68 74 20 6d 65 73 73  61 67 65 20 77 61 73 20  |ght message was |
000001b0  64 69 73 70 6c 61 79 65  64 20 77 68 65 6e 20 74  |displayed when t|
000001c0  68 65 20 70 72 6f 67 72  61 6d 20 77 61 73 20 72  |he program was r|
000001d0  75 6e 2e 20 46 54 45 58  54 20 77 69 6c 6c 0d 0a  |un. FTEXT will..|
000001e0  64 69 73 70 6c 61 79 20  61 6e 79 20 73 75 63 68  |display any such|
000001f0  20 6d 65 73 73 61 67 65  73 20 68 69 64 64 65 6e  | messages hidden|
00000200  20 69 6e 20 61 20 66 69  6c 65 2e 20 57 68 69 6c  | in a file. Whil|
00000210  73 74 20 74 68 65 20 6c  61 63 6b 20 6f 66 20 61  |st the lack of a|
00000220  6e 79 20 73 75 63 68 0d  0a 6d 65 73 73 61 67 65  |ny such..message|
00000230  20 69 73 20 6e 6f 20 67  75 61 72 61 6e 74 65 65  | is no guarantee|
00000240  20 74 68 61 74 20 61 20  70 72 6f 67 72 61 6d 20  | that a program |
00000250  69 73 20 50 44 20 61 6e  64 20 70 72 6f 67 72 61  |is PD and progra|
00000260  6d 73 20 73 68 6f 75 6c  64 20 6e 65 76 65 72 0d  |ms should never.|
00000270  0a 62 65 20 75 70 6c 6f  61 64 65 64 20 74 6f 20  |.be uploaded to |
00000280  61 20 42 42 20 75 6e 6c  65 73 73 20 74 68 65 79  |a BB unless they|
00000290  20 61 72 65 20 6b 6e 6f  77 6e 20 6e 6f 74 20 74  | are known not t|
000002a0  6f 20 62 65 20 63 6f 70  79 72 69 67 68 74 65 64  |o be copyrighted|
000002b0  2c 20 46 54 45 58 54 0d  0a 77 69 6c 6c 20 71 75  |, FTEXT..will qu|
000002c0  69 63 6b 6c 79 20 65 6c  69 6d 69 6e 61 74 65 20  |ickly eliminate |
000002d0  6d 61 6e 79 20 61 62 6f  75 74 20 77 68 69 63 68  |many about which|
000002e0  20 74 68 65 72 65 20 69  73 20 64 6f 75 62 74 2e  | there is doubt.|
000002f0  0d 0a 0d 0a 49 74 20 69  73 20 61 6c 73 6f 20 69  |....It is also i|
00000300  6e 74 65 72 65 73 74 69  6e 67 20 74 6f 20 73 65  |nteresting to se|
00000310  65 20 74 68 65 20 6d 65  73 73 61 67 65 73 20 69  |e the messages i|
00000320  6e 20 61 20 70 72 6f 67  72 61 6d 20 61 6e 64 20  |n a program and |
00000330  73 6f 6d 65 74 69 6d 65  73 0d 0a 65 76 65 6e 20  |sometimes..even |
00000340  6e 65 77 20 6f 72 20 75  6e 64 6f 63 75 6d 65 6e  |new or undocumen|
00000350  74 65 64 20 66 65 61 74  75 72 65 73 20 6d 61 79  |ted features may|
00000360  20 62 65 20 64 69 73 63  6f 76 65 72 65 64 21 0d  | be discovered!.|
00000370  0a 0d 0a 44 45 53 43 52  49 50 54 49 4f 4e 0d 0a  |...DESCRIPTION..|
00000380  0d 0a 46 54 45 58 54 20  77 69 6c 6c 20 6f 6e 6c  |..FTEXT will onl|
00000390  79 20 64 69 73 70 6c 61  79 20 70 72 69 6e 74 61  |y display printa|
000003a0  62 6c 65 20 41 53 43 49  49 20 63 68 61 72 61 63  |ble ASCII charac|
000003b0  74 65 72 73 20 69 6e 20  74 68 65 20 72 61 6e 67  |ters in the rang|
000003c0  65 20 33 32 2d 31 32 37  2e 0d 0a 42 79 20 64 65  |e 32-127...By de|
000003d0  66 61 75 6c 74 20 61 6c  6c 20 73 74 72 69 6e 67  |fault all string|
000003e0  73 20 6f 66 20 6c 65 73  73 20 74 68 61 6e 20 34  |s of less than 4|
000003f0  20 63 68 61 72 61 63 74  65 72 73 20 61 72 65 20  | characters are |
00000400  64 69 73 63 61 72 64 65  64 2c 20 77 68 69 63 68  |discarded, which|
00000410  0d 0a 65 6c 69 6d 69 6e  61 74 65 73 20 61 20 6c  |..eliminates a l|
00000420  6f 74 20 6f 66 20 74 68  65 20 70 72 6f 67 72 61  |ot of the progra|
00000430  6d 20 27 67 61 72 62 61  67 65 27 2c 20 61 6c 74  |m 'garbage', alt|
00000440  68 6f 75 67 68 20 74 68  65 20 6d 69 6e 69 6d 75  |hough the minimu|
00000450  6d 20 6c 65 6e 67 74 68  0d 0a 63 61 6e 20 62 65  |m length..can be|
00000460  20 63 68 61 6e 67 65 64  20 74 6f 20 61 6e 79 20  | changed to any |
00000470  76 61 6c 75 65 20 75 70  20 74 6f 20 31 32 38 20  |value up to 128 |
00000480  63 68 61 72 61 63 74 65  72 73 2e 20 41 20 73 74  |characters. A st|
00000490  72 69 6e 67 20 69 73 0d  0a 63 6f 6e 73 69 64 65  |ring is..conside|
000004a0  72 65 64 20 74 6f 20 62  65 20 61 6e 79 20 20 63  |red to be any  c|
000004b0  6f 6e 74 69 6e 75 6f 75  73 20 67 72 6f 75 70 20  |ontinuous group |
000004c0  6f 66 20 41 53 43 49 49  20 63 68 61 72 61 63 74  |of ASCII charact|
000004d0  65 72 73 20 62 79 20 46  54 45 58 54 2e 0d 0a 4c  |ers by FTEXT...L|
000004e0  65 61 64 69 6e 67 20 73  70 61 63 65 73 20 61 74  |eading spaces at|
000004f0  20 74 68 65 20 73 74 61  72 74 20 6f 66 20 61 20  | the start of a |
00000500  73 74 72 69 6e 67 20 61  72 65 20 61 6c 77 61 79  |string are alway|
00000510  73 20 64 69 73 63 61 72  64 65 64 20 61 6e 64 20  |s discarded and |
00000520  65 61 63 68 0d 0a 73 74  72 69 6e 67 20 73 74 61  |each..string sta|
00000530  72 74 73 20 6f 6e 20 61  20 6e 65 77 20 6c 69 6e  |rts on a new lin|
00000540  65 2e 20 4f 70 74 69 6f  6e 61 6c 6c 79 2c 20 74  |e. Optionally, t|
00000550  68 65 20 64 69 73 70 6c  61 79 20 6d 61 79 20 62  |he display may b|
00000560  65 20 70 61 75 73 65 64  0d 0a 61 66 74 65 72 20  |e paused..after |
00000570  65 61 63 68 20 73 63 72  65 65 6e 20 69 73 20 64  |each screen is d|
00000580  69 73 70 6c 61 79 65 64  2e 0d 0a 0d 0a 53 59 4e  |isplayed.....SYN|
00000590  54 41 58 0d 0a 0d 0a 20  20 20 20 46 54 45 58 54  |TAX....    FTEXT|
000005a0  20 3c 66 69 6c 65 73 70  65 63 3e 20 28 2f 50 29  | <filespec> (/P)|
000005b0  20 28 2f 4d 6e 29 0d 0a  0d 0a 3c 66 69 6c 65 73  | (/Mn)....<files|
000005c0  70 65 63 3e 20 69 73 20  74 68 65 20 6e 61 6d 65  |pec> is the name|
000005d0  20 6f 66 20 74 68 65 20  66 69 6c 65 20 74 6f 20  | of the file to |
000005e0  62 65 20 65 78 61 6d 69  6e 65 64 20 61 6e 64 20  |be examined and |
000005f0  6d 61 79 20 63 6f 6e 74  61 69 6e 20 61 0d 0a 20  |may contain a.. |
00000600  20 20 20 20 20 20 20 20  20 20 64 72 69 76 65 20  |          drive |
00000610  6c 65 74 74 65 72 20 61  6e 64 2f 6f 72 20 64 69  |letter and/or di|
00000620  72 65 63 74 6f 72 79 20  70 61 74 68 2e 0d 0a 0d  |rectory path....|
00000630  0a 2f 50 20 20 20 20 20  20 20 20 20 69 73 20 6f  |./P         is o|
00000640  70 74 69 6f 6e 61 6c 20  61 6e 64 20 63 61 75 73  |ptional and caus|
00000650  65 73 20 74 68 65 20 64  69 73 70 6c 61 79 20 74  |es the display t|
00000660  6f 20 70 61 75 73 65 20  61 66 74 65 72 20 65 61  |o pause after ea|
00000670  63 68 0d 0a 20 20 20 20  20 20 20 20 20 20 20 73  |ch..           s|
00000680  63 72 65 65 6e 66 75 6c  2e 0d 0a 0d 0a 2f 4d 6e  |creenful...../Mn|
00000690  20 20 20 20 20 20 20 20  69 73 20 6f 70 74 69 6f  |        is optio|
000006a0  6e 61 6c 20 61 6e 64 20  64 65 74 65 72 6d 69 6e  |nal and determin|
000006b0  65 73 20 74 68 65 20 6d  69 6e 69 6d 75 6d 20 73  |es the minimum s|
000006c0  69 7a 65 20 6f 66 20 74  65 78 74 20 74 68 61 74  |ize of text that|
000006d0  20 77 69 6c 6c 0d 0a 20  20 20 20 20 20 20 20 20  | will..         |
000006e0  20 20 62 65 20 64 69 73  70 6c 61 79 65 64 2c 20  |  be displayed, |
000006f0  77 68 65 72 65 20 27 6e  27 20 69 73 20 61 20 6e  |where 'n' is a n|
00000700  75 6d 62 65 72 20 62 65  74 77 65 65 6e 20 31 20  |umber between 1 |
00000710  61 6e 64 20 31 32 38 2e  0d 0a 0d 0a 45 58 41 4d  |and 128.....EXAM|
00000720  50 4c 45 53 0d 0a 0d 0a  20 20 20 20 46 54 45 58  |PLES....    FTEX|
00000730  54 20 4d 59 50 52 4f 47  2e 45 58 45 20 2f 4d 31  |T MYPROG.EXE /M1|
00000740  35 0d 0a 0d 0a 77 69 6c  6c 20 64 69 73 70 6c 61  |5....will displa|
00000750  79 20 61 6c 6c 20 73 74  72 69 6e 67 73 20 6f 66  |y all strings of|
00000760  20 41 53 43 49 49 20 63  68 61 72 61 63 74 65 72  | ASCII character|
00000770  73 20 6f 66 20 31 35 20  6f 72 20 6d 6f 72 65 20  |s of 15 or more |
00000780  63 68 61 72 61 63 74 65  72 73 0d 0a 6c 65 6e 67  |characters..leng|
00000790  74 68 20 69 6e 20 74 68  65 20 66 69 6c 65 20 63  |th in the file c|
000007a0  61 6c 6c 65 64 20 27 4d  59 50 52 4f 47 2e 45 58  |alled 'MYPROG.EX|
000007b0  45 27 2e 0d 0a 0d 0a 20  20 20 20 46 54 45 58 54  |E'.....    FTEXT|
000007c0  20 41 3a 5c 4d 59 44 49  52 5c 4d 59 50 52 4f 47  | A:\MYDIR\MYPROG|
000007d0  2e 45 58 45 20 2f 50 0d  0a 0d 0a 77 69 6c 6c 20  |.EXE /P....will |
000007e0  64 69 73 70 6c 61 79 20  61 6c 6c 20 73 74 72 69  |display all stri|
000007f0  6e 67 73 20 6f 66 20 34  20 6f 72 20 6d 6f 72 65  |ngs of 4 or more|
00000800  20 63 68 61 72 61 63 74  65 72 73 2c 20 70 61 75  | characters, pau|
00000810  73 69 6e 67 20 61 66 74  65 72 20 74 68 65 0d 0a  |sing after the..|
00000820  64 69 73 70 6c 61 79 20  6f 66 20 65 61 63 68 20  |display of each |
00000830  73 63 72 65 65 6e 66 75  6c 2e 20 41 66 74 65 72  |screenful. After|
00000840  20 65 61 63 68 20 73 63  72 65 65 6e 2c 20 79 6f  | each screen, yo|
00000850  75 20 6d 61 79 20 70 72  65 73 73 20 4d 20 66 6f  |u may press M fo|
00000860  72 20 4d 6f 72 65 2c 0d  0a 6f 72 20 51 20 74 6f  |r More,..or Q to|
00000870  20 51 75 69 74 2e 0d 0a  0d 0a 20 20 20 20 46 54  | Quit.....    FT|
00000880  45 58 54 20 4d 59 50 52  4f 47 2e 45 58 45 20 3e  |EXT MYPROG.EXE >|
00000890  4e 45 57 46 49 4c 45 0d  0a 0d 0a 77 69 6c 6c 20  |NEWFILE....will |
000008a0  73 65 6e 64 20 61 20 6c  69 73 74 20 6f 66 20 61  |send a list of a|
000008b0  6c 6c 20 41 53 43 49 49  20 73 74 72 69 6e 67 73  |ll ASCII strings|
000008c0  20 69 6e 20 27 4d 59 50  52 4f 47 2e 45 58 45 27  | in 'MYPROG.EXE'|
000008d0  20 74 6f 20 61 20 66 69  6c 65 20 63 61 6c 6c 65  | to a file calle|
000008e0  64 0d 0a 27 4e 45 57 46  49 4c 45 27 2e 20 54 68  |d..'NEWFILE'. Th|
000008f0  69 73 20 6d 61 6b 65 73  20 75 73 65 20 6f 66 20  |is makes use of |
00000900  74 68 65 20 4d 53 2d 44  4f 53 20 72 65 2d 64 69  |the MS-DOS re-di|
00000910  72 65 63 74 69 6f 6e 20  66 61 63 69 6c 69 74 79  |rection facility|
00000920  2c 20 75 73 69 6e 67 0d  0a 27 3e 27 20 74 6f 20  |, using..'>' to |
00000930  72 65 2d 64 69 72 65 63  74 20 74 68 65 20 6f 75  |re-direct the ou|
00000940  74 70 75 74 20 74 6f 20  61 20 66 69 6c 65 2e 20  |tput to a file. |
00000950  44 6f 20 6e 6f 74 20 75  73 65 20 74 68 65 20 2f  |Do not use the /|
00000960  50 20 73 77 69 74 63 68  20 77 68 65 6e 0d 0a 64  |P switch when..d|
00000970  6f 69 6e 67 20 74 68 69  73 2c 20 6f 72 20 74 68  |oing this, or th|
00000980  65 20 70 72 6f 67 72 61  6d 20 77 69 6c 6c 20 61  |e program will a|
00000990  70 70 65 61 72 20 74 6f  20 27 68 61 6e 67 27 20  |ppear to 'hang' |
000009a0  61 73 20 69 74 20 77 61  69 74 73 20 66 6f 72 20  |as it waits for |
000009b0  79 6f 75 20 74 6f 0d 0a  70 72 65 73 73 20 27 4d  |you to..press 'M|
000009c0  20 66 6f 72 20 4d 6f 72  65 27 20 69 6e 20 61 6e  | for More' in an|
000009d0  73 77 65 72 20 74 6f 20  74 68 65 20 6d 65 73 73  |swer to the mess|
000009e0  61 67 65 20 79 6f 75 20  77 6f 6e 27 74 20 73 65  |age you won't se|
000009f0  65 20 64 69 73 70 6c 61  79 65 64 21 0d 0a 1a     |e displayed!...|
000009ff
13-01-89/Ftext\DOC.m0
13-01-89/Ftext\DOC.m1
13-01-89/Ftext\DOC.m2
13-01-89/Ftext\DOC.m4
13-01-89/Ftext\DOC.m5