UTILS\TV.DOC ·
DOC ·
5.6 KB ·
1980-01-01 ·
from PCPlus_Issue-19_Apr-1988
TV HELP.... Some information on using TEXTVIEW
----------------------------------------------
TEXTVIEW is a utility intended to facilitate the accessing of text
information held on disks. Commands are available to load text files, move
up and down through the text using the Home, End, PgUp, PgDn and cursor
keys, find text and so on. These commands will be discussed in more detail
further on. TEXTVIEW can be activated in three ways:
1> By typing TV at the DOS prompt. This loads TEXTVIEW without loading any
text files. The commands available are displayed on the bottom line of
the display and the logical next step would be to use the L(oad) command
to load a text file to be viewed.
2> By typing TV filename at the DOS prompt. This loads TEXTVIEW and at
the same time loads the text file designated by 'filename' . Filename
can be any legal DOS drive / path / filename identifier.
3> By typing TV filename /R . This loads TEXTVIEW and then loads the
designated file which should be of a special format as will be described
shortly. The /R parameter tells TV to use the designated file as a
chapter index file allowing up to 16 seperate text files on one disk to
be read as a form of electronic book. You are probably reading this text
file after accessing it in this way.
TV COMMAND KEYS
---------------
The following keys are used to access TV's commands;
H = HELP. This displays a brief description of TV's commands.
Q = QUIT. Used to leave TV and return to DOS. Pressing Esc will have the
same result.
L = LOAD. Used to load text files into TV. After pressing L you will be
prompted for a filename. This can be any legal DOS drive / path /
filename specifier up to a length of 64 characters. TV will then
attempt to load the specified file. If any difficulty is experienced
an error message will be displayed. WARNING!! Well two actually.
Firstly TV will not load files longer than about 60K. This is mostly
due to the way Pascal ( The language used to write TV ) deals with
data. Secondly, if you try to load non-text files such as COM, EXE or
non-ASCII BAS files unpredictable results will be experienced.
F = FIND. Use this command to find a string of text within the currently
loaded text file. After pressing F you will be prompted to enter a
string of text up to 64 characters long. TV will then attempt to find
the first match in the text file and display the text from that point
on. The first occurence ( if found ) will therefore be on the top line
of the display. No account is taken of case so 'example' would be
considered as a match for 'EXAMPLE'.
N = NEXT. This command attempts to find further matches for a previously
succesful FIND command.
W = WORDSTAR. This command toggles on and off interpretation of the 8th.
bit of each byte. With the 8th. bit enabled all 256 IBM characters
may be displayed includint the 128 graphics characters above ASCII 127.
With the 8th. bit disabled, Wordstar text files which use the 8th. bit
to indicate internal formatting functions, may be displayed. The
current status of the 8th. bit is displayed on the top line of the
display. A WS here means the 8th. bit is disabled. The default setting
is the 8th. bit enabled.
/W If this parameter is included in the command line TEXTVIEW is loaded
with the 8th. bit disabled. This parameter is only allowed if a
filename or a chapter index filename is given.
Home. Pressing the Home key will display text from the beginning of the
current text file.
End. This will display the last 'page' of the current text file.
PgUp. Moves the text display back one 'page'.
PgDn. Moves the display forward one 'page'.
Cursor Up ( 8 ). Moves the display back one line.
Cursor Down ( 2 ). Moves the display forward one line.
I = INDEX. This command key is only available if TV is currently running a
chapter index file ( to be explained shortly ). If available, pressing
I will return you to the chapter index screen allowing you to choose
from one of the text files included.
CHAPTER INDEX FILES.
--------------------
This specially formatted file allows TV to operate as a form of electronic
book, giving access to up to 16 seperate text files on one disk. The files
can be given any filename but an extension of .idx makes them easier to
spot in a directory listing. TV will use the chapter file as an index if
the /R parameter is included in the DOS command i.e. TV chapter.idx /R.
The chapter file itself must hold two types of information.
1> The title of the 'book' which includes the subsequently declared chapter
text files. The title can be up to 32 characters long but it must be the
very first line of the index file followed by a carriage return.
2> The name of the chapter text files. Up to 16 of these are allowed.
They must be given in the form of disk filename, followed by a carriage
return, and then a chapter heading ( up to 64 characters ) followed by a
carriage return. If this seems confusing use TV to load the chapter.idx
file which is probably running this text file. Alternatively if you are
running the TV demo file use I to return to the index and load the
chapter file from there.
------------------ Peter Grove 1987 -------------------