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 -------------------