

                                  XVIEW v1.10

                          A text file viewing utility

                      Copyright(c) 1989 James C. Dunavant

      --------------------------------------------------------------------
      From the legal department:

      This document and the program it describes are copyrighted by the
      author.  The program is distributed by the "shareware" concept. This
      means that if you like the program and intend to use it, you are
      requested to register your use of the program with the author. See the
      registration form at the end of this document. You are free to make
      copies of the program and distribute it so long as you meet the
      following requirements:

      1) The program must be accompanied by this documentation and both
         MUST NOT BE ALTERED in any way.  If you received XVIEW in an
         archived format, a good idea would be to distribute it in the
         same way.  If you want to add your own notes, put that in a
         separate file.

      2) You must not receive any compensation ($$$) for your distri-
         bution of XVIEW.  In other words, don't sell it.  It is not
         for sell.  The exception to this would be the normal copying
         fees associated with user group club libraries, access time
         on BBS's, and similar such activity.

      3) XVIEW must not be included as a freebie along with a packaged
         commercial product.  XVIEW is NOT freeware.  It is shareware.
         If you wish to distribute XVIEW with a commercial product,
         contact the author at the address given at the end of this
         document.

      OK, now that we've got that settled, let me say that I encourage
      you to make copies of the program and give it away to your friends,
      associates, alien beings from outer space, and anyone you think
      might find it useful.  Upload it to your favorite BBS's, national
      networks, and don't forget your user group library.  This is how
      shareware distribution works.  The more it's passed around the
      better.

      I also encourage you to register your use of XVIEW so that you may
      receive notification of future upgrades and bug fixes.  See the
      registration form at the end of this document.

      More from the legal department:

      IN NO EVENT WILL THE AUTHOR, HIS DOG OR HIS LAWN MOWER BE LIABLE FOR
      DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES RESULTING FROM
      THE USE OR THE INABILITY TO USE THE ABOVE MENTIONED PROGRAM AND THIS
      DOCUMENTATION.   SOLE RESPONSIBILITY  FOR THE USE OF THE PROGRAM AND
      DOCUMENTATION LIES WITH THAT OF THE POSSESSOR.

      Some planets in the Universe do not allow a limitation of incidental
      or consequential damages, so the above limitations may not apply to
      you, if you are from another planet.
      --------------------------------------------------------------------


      ] INTRODUCTION [

      XVIEW is a utility for viewing disk based text files.  Often when you
      receive public domain, shareware, and even commercial programs there
      will be text files on the distribution disks that you will need or
      want to read.  MS-DOS provides a way to do this using:

           A> TYPE <filename>

      This is fine if you can read really fast.  A better way would be:

           A> TYPE <filename> | MORE

      This is fine too, but it is clumsy at best.   A third way would be:

           A> TYPE <filename> >PRN
                     or
           A> PRINT <filename>

      This is OK for short files, but do you want to send a 200K file to your
      printer when all you wanted to do was see what was in the silly thing?


      In Steps XVIEW:

      OK, so there are about a million text files viewers out there.  I've
      got maybe ten or so laying around.  However, it seems that text file
      viewers come in two categories: 1) They are too simple, and 2) they
      are too complex.  I would expect a file viewer to at least provide
      a search function (many don't), but I don't want to learn 200 com-
      mands either.

      The idea behind XVIEW is to provide an easy way to view text files
      without a lot of commands to learn, but also provide enough power
      so that it becomes more than just a simple viewer. By the way,
      the name XVIEW derives from "eXtra VIEW."

      Here is a brief run down of the features in XVIEW:

      1) The ability to display text files on your computer screen with
         easy to learn (intuitive) movement command keys.

      2) A directory function that allows you to travel anywhere within
         your file system without having to exit XVIEW just to load
         another file.

      3) A fast search function with wildcard and word only options.

      4) A print function that will print the current view, a marked
         block, or the entire file formatted into numbered pages.

      5) A save function that allows you to clip parts of a file and
         save under a new name, including appending to a previous clip.

      6) Minor editing functions such as reducing blanks lines and
         reformating a marked block.

      If you have a hard disk installed in your system, a good place
      to put XVIEW would be in the directory where you keep your
      external DOS commands.  Assuming this directory is in the
      current PATH, then XVIEW will always be available when you need
      it.


      ] SYSTEM REQUIREMENTS [

      You must have an IBM computer or 100% compatible.  Your display
      adapter must be MDA, HGA, CGA, EGA, MCGA or VGA compatible, which in-
      cludes just about anything you might have.  You must be running MS-DOS
      2.0 or later.

      XVIEW was designed on an AT compatible using a VGA display adapter.
      The program is written in Turbo C 2.0.  If you do a hex dump of the
      XVIEW.EXE file, you'll see Borland's copyright notice in there some-
      where.

      XVIEW looks much better if you are using a color display, but it
      will detect if you are using a monochrome display and adapt itself
      for monochrome output.


      ] STARTING OUT [

      Let's assume that you are logged onto your A: drive.  You'll see the
      ever present,

      A>

      prompt waiting for you to type something.

      The command line syntax for XVIEW is:

      XVIEW [<filespec>]

      The square brackets indicate that the specified argument is optional.
      The angle brackets indicate that the argument specified within is
      required.  Hmm, seems contradictory doesn't it?  (Hey, I didn't invent
      this system.)  Actually what this is telling you is that XVIEW can
      be loaded without any arguments, but if you do give an argument it
      must be a filespec.  Filespec?  That's computer talk for the name of
      a file which may include a path telling DOS where to find the file.
      Examples are:

      A> XVIEW c:\mydir\myfile

      and

      A> XVIEW myfile

      In either case you have told DOS to load XVIEW off the disk in drive A: 
      (or from the current PATH) and told XVIEW to load the file "myfile." In 
      the first case you told XVIEW that the file is on drive C: in a 
      subdirectory called "mydir." In the second case XVIEW assumes the file 
      is in the current directory of drive A:. 

      If none of this makes sense, time to get out your DOS manual.

      OK, let's run XVIEW giving it a filename to load.  Just type,

      A> XVIEW XVIEW.DOC  <Enter>

      Here XVIEW will load "XVIEW.DOC."  That's the file you are
      reading now.  After the file is loaded you are presented with the
      first view (first 23 lines in the file).  We will cover what to
      do next in the next section.  But first let's load XVIEW without
      a filespec.  Just type at the prompt,

      A> XVIEW <Enter>

      (Of course, don't type the "A>" and <Enter> means the Enter or
      Return key.)

      When XVIEW is loaded without a filespec it sends you directly to
      the directory screen and expects you to select a file from the
      given list to load.  We will discuss this later.  But for now
      let's assume you have a text file already loaded.



      ] HOW TO GET FROM WHERE YOU'RE AT TO SOMEWHERE ELSE [

      OK, you've got a file loaded.

      At the top of the screen you will see something like:

      XVIEW.DOC   SEG:01  SEARCH:|  LINE:451        Tue Jan 03 21:50:14 1989

      This is an information line which (going from left to right) tells you:

      1) The name of the file you have loaded.

      2) The segment number of the loaded file.  More about this later.

      3) The search direction.  The vertical bar will be an up or down arrow.

      4) The number of the current top line of the view.

      5) The date and time so you'll know if you're burning midnight oil and
         on what date you did so.

      At the bottom of the screen you will see:

      [                              ] |/| PgUp PgDn Home End F1-Help Alt-Quit

      The space between the square brackets is a message bar.  From time to
      time XVIEW will issue various messages to you depending on what you are
      doing.

      The remainder of the line should be self-explanatory but we'll step
      through it anyway:

      |/|:  The vertical bars will be an up arrow and a down arrow.  These
            represent the up and down cursor keys.  As you might expect,
            hitting the down cursor key will move you down (or forward)
            through the file one line at a time.  The up cursor key will move
            you up (or backward) one line at a time.  To some this might
            seem counterintuitive (the down key causes your display view to
            move UP and vice versa).  Think of it this way: the display area
            is a window into your file.  Hitting the down key moves the
            window down through the file.  The up key moves the window up
            through the file.  NOTE: there is no left or right cursor key
            command.  As of this release of XVIEW, wordwrap is automatic.
            Any lines that are too long to fit in 80 columns will be wrapped
            to the next line without breaking a word in half.  This cannot
            be turned off.

      PgDn: This key will move you forward through the file one full page.
            A page is defined as the length of a view (23 lines).

      PgUp: This is the same as PgDn except it moves you backward.

      Home: This key will return you to the top of the loaded file or file
            segment.

      End:  This key moves you to the end of the file or file segment.

      F1:   It is such common practice to use the F1 key as a Help key that
            I would suggest to keyboard manufacturers that it be labeled
            F1/Help.  In any case, hitting this key brings up a help window
            which gives a summary of the command keys.

      Alt-Quit:  This is how you quit XVIEW.  A window will pop up asking
       (Alt-Q)   if you really want to quit.  Hit Y if you do, else hit N.
                 Note that XVIEW is polite enough to reset your logged drive
                 and current directory to what it was when you first loaded
                 XVIEW.



      ] THE COMMAND KEYS [

      Commands keys are divided into six categories.  We will now discuss
      each category in detail.

      1) FILE   -  Alt-L: This is the load new file command.  An input window
                          will pop up asking for the filespec of the file
                          you wish to load.  Enter the filespec and hit
                          Enter.  If XVIEW can't find the file specified the
                          message "Can't find file" will be displayed on the
                          message bar.  Otherwise the file will be loaded.
                          XVIEW will try to load the entire file into memory
                          using all available memory in your system.  If it
                          can't, it will load as much as it can and the
                          message "File truncated" will flash on the message
                          bar.

                   Alt-N: This is the load next segment command.  If the file
                          loaded was truncated, using this command will cause
                          XVIEW to load the next file segment.  The SEG:
                          count as it appears on the info bar will be incre-
                          mented by one.

                   Alt-P: This is the load previous segment command.  If the
                          file loaded was truncated, using this command will
                          cause XVIEW to load the previous segment.  The SEG:
                          count will be decremented by one.

                          NOTE: The segment count can only go as high as 99.
                                If the segment count is 99 and you try to
                                load the next segment XVIEW will refuse be-
                                cause its segment marker buffer is full.  In
                                practice 99 segments should be more than
                                enough, allowing you to read files several
                                megabytes in length depending on the amount
                                of free memory in your system.

                          NOTE: When using the movement commands, a window
                                may pop up asking you if you wish to load
                                the NEXT or PREVIOUS segment.  For example,
                                if you are at present viewing the first seg-
                                ment of a file and hit End to view the last
                                page and then hit the cursor down key, a
                                window will pop up asking if you wish to load
                                the next segment.  Hit Y if you do.

                   Alt-D: This is the view/change directory command.  This
                          command will clear the view display and a neatly
                          organized listing of the current directory will
                          be displayed.  At the top of the screen the current
                          logged drive and current directory path will be
                          shown.  Below this is the directory box.  The
                          first entry will be highlighted.  Directory entries
                          come in two types: file entries and "dir" entries.
                          Directory entries will always appear first and can
                          be identified by the word "dir" under the "Ext"
                          column.  The name of the directory will appear
                          under the "File" column.  If your current direc-
                          tory is a subdirectory the first entry will have
                          the name "[parent]" under the File column.  If you
                          hit Enter when [parent] is highlighted, the current
                          directory will be set to the parent directory and
                          the files in that directory will be shown.  If
                          other dir entries are shown and you move the high-
                          light (using the up/down cursor keys) to a dir
                          entry and hit Enter, the current directory will be
                          set to that subdirectory.  The previous directory
                          then becomes the parent.  By moving the highlight
                          over dir entries and hitting Enter you are able to
                          climb the directory tree of the current logged
                          drive.

                          To change  your logged drive, hit the right cursor
                          key.  The drive box to the right of the directory
                          box contains the drives available on your system.
                          Move the highlight to the drive you wish to log
                          onto and hit Enter.  The directory box will then
                          show the files in the current directory for that
                          drive.  Note that if your system does not contain
                          a B: drive, the B: drive will still be listed but
                          shown as "B: = A:."  This means that XVIEW will
                          treat drive B: as drive A:.  Hit the left cursor
                          key to move back to the directory box.  You can
                          then move about the directory tree of the new
                          drive as explained above.

                          _____

                          NOTE: You may notice that XVIEW lists mores drives
                          than you know you have.  For instance,  XVIEW may
                          list drives A: through D: when all you have are
                          two floppys (A: and B:) and a harddrive (C:). The
                          reason for this is that MS-DOS maintains a variable
                          by the name of LASTDRIVE.  This variable is set to
                          a letter value (i.e., LASTDRIVE=E) in your
                          CONFIG.SYS file.  This variable tells MS-DOS how
                          many drives it will recognize in your system. If
                          the LASTDRIVE variable is not set in your CONFIG.SYS
                          file, then it defaults to E:.  The value of this
                          variable is always one letter value higher than the
                          actual last drive in your system.  Thus if XVIEW is
                          listing drives A: through D: in the drive box, this
                          is because of the default LASTDRIVE=E.  It does not
                          hurt the performance of XVIEW if an invalid drive
                          is listed because MD-DOS will simply choose a valid
                          drive (such as A: or C:) if you try to log onto a
                          non-existing drive.

                                To prevent XVIEW from listing non-existing
                          drives you can set the LASTDRIVE variable to a
                          letter value that is one greater than your actual
                          last drive.  For example, is you have one or two
                          floppys (A: and B:) and one harddrive (C:) you
                          should include the line:

                          LASTDRIVE=D

                          in your CONFIG.SYS file.  If you do not have a
                          CONFIG.SYS file, then create one with the above
                          line and put it in the root directory or your
                          boot disk.

                          _____

                          To load a text file into XVIEW, move the directory
                          box highlight over the file you wish to load and
                          hit Enter.  XVIEW will look at the extension of
                          the filename and if it sees an EXE, COM, BIN,
                          OBJ or ARC it will refuse to load the file
                          because it knows (or thinks) the file is a binary
                          file.  XVIEW is not designed to read binary files.
                          A binary file is defined as any file that is not
                          a text file.  If the filename does not contain the
                          above extensions (more may be added in a future
                          release), XVIEW will load the file.  While loading,
                          XVIEW will look for binary characters and if it
                          sees a high proportion it will pop up a window
                          suggesting that the file is binary and ask if you
                          wish to continue.  A good idea is to hit N and
                          abort the load.  Loading a binary file will result
                          in nonsense characters being displayed, a slow
                          loading time (because it is trying to wordwrap a
                          binary file) and possibly crashing your system.
                          Once a text file is loaded, you will automatically
                          leave the directory display and the first view of
                          the file will be on your display.

                          Note that if you have called up a directory for
                          a given drive and then change the disk in that
                          drive, the currently displayed directory will
                          not be valid and attempting to load a file from
                          that directory list will result in an error.  When
                          you change disks, you must re-select the drive so
                          a valid list will be shown.  To do this, hit the
                          right cursor key and then hit Enter or Return.
                          This forces XVIEW to update the directory list to
                          that of the currently mounted disk.

                          Normally, you will use the up and down cursor keys
                          to move the highlight over the item you wish to
                          select.  The list will scroll up or down depending
                          on the direction you are moving the highlight and
                          the length of the list.  If the directory list is
                          long, you can use the Page Up and Page Down keys
                          to move through the list more quickly.

                          If you do not wish to load a file just hit Esc
                          and you will be returned to the main display with
                          the current file still in memory.  Sometimes you
                          may wish to use the Alt-D command just to change
                          the current directory and/or drive.  This can be
                          useful if you are clipping parts of a file and
                          wish to save in a different directory/drive.  Or
                          maybe you just want to see what you have in your
                          file system.

                          NOTE: If you started XVIEW without a filespec
                                argument (and therefore have no file loaded),
                                pressing Esc will exit the program.  You
                                cannot get to the main display unless a file
                                is loaded, which would be a silly thing to
                                do anyway.

      2) SEARCH -  Alt-S: This is the search with case sensitive command.
                          A window will pop up asking you for the search
                          string (text) you wish to look for.  Just enter
                          the string and hit Enter and the search will be-
                          gin.  The info bar at the top of the screen will
                          show the direction of the search by placing an
                          up or down arrow next to the word SEARCH:  If the
                          arrow points down you will search forward in the
                          file.  If the arrow points up you will search
                          backwards in the file.  You can change the search
                          direction at anytime with the Alt-T command dis-
                          cussed below.

                          The search function responds to two special char-
                          acters. They are:

                          ? - This is the wildcard character.  When this
                              character is in the search string it will
                              match any character in the file.  For example,

                              ?il?

                              will find all occurrences of any four characters
                              whose middle two characters are "il."  Thus
                              this search string will find "file" and
                              "will" (and also "filename" and "willful").

                          | - This is the word only flag.  If this character
                              is the first character in the search string,
                              XVIEW will only find occurrences that are
                              separate words. A word is defined as a sequence
                              of characters that are bounded by:

                              1) The beginning of a line.
                              2) The end of a line.
                              3) White space.
                              4) Punctuation (non-alphanumeric) characters.
                              5) Any combination of the above.

                              Thus the search string "|file" will find "file"
                              but not "filename."

                              The ? and | characters can be used together.
                              Thus "|?il?" will find "file" or "will" as
                              separate words, but not "filename."

                          If the file you have loaded was truncated and the
                          search string is not found you will be asked if
                          you wish to search the next or previous segment
                          depending on which direction you are searching.

                   Alt-I: This command is the same as Alt-S, except that
                          the search will be case insensitive.  Thus if the
                          search string is "file" you will find "File" or
                          "FILE" as well.  Otherwise it behaves exactly as
                          described above for the Alt-S command.

                   Alt-R: This command repeats the previous search using
                          the conditions already set (such as case sensi-
                          tivity, wildcard, or word only conditions).  When
                          you use Alt-S or Alt-I the search function will
                          find the next occurrence of the specified string
                          and then stop.  Alt-R will continue the search.
                          You can, however, change the search direction as
                          described below.

                   Alt-T: This command toggles the search direction.  When
                          you hit Alt-T the arrow next to the SEARCH: on
                          the info bar will reverse itself.  You can use
                          this command even if you have already called up
                          the input string window.


      3) PRINT  - Ctrl-V: This command dumps the contents of the current view
                          to your printer.  A view is defined as what you see
                          on your screen (minus the info and command bars,
                          of course).  XVIEW will use the printer port you
                          set with the Ctrl-F command described below.

                  Ctrl-B: If you have marked a block as described below, this
                          command will dump the block to your printer using
                          the setup established with the Ctrl-F command.

                  Ctrl-E: Use this command to dump the entire contents of the
                          loaded file to your printer.  As with Ctrl-B XVIEW
                          will use the information established with the
                          Ctrl-F command.  If the loaded file is segmented,
                          you will be asked if you wish to continue the
                          printout across segment boundaries.  XVIEW is
                          smart enough to do this while maintaining the
                          format information set with Ctrl-F.

                  Ctrl-F: This command allows you to tell XVIEW how you want
                          a file or marked block to be printed.  This command
                          will call up a window with the various options
                          shown.  The options will be set to their default
                          values or the values you previously set.  To change
                          an option, hit the key listed next to that option.
                          Note: these options are only effective for the
                          Ctrl-B and Ctrl-E commands.

                          The options are:

                          H) Header: When you hit H, an input window will pop
                             up allowing you to enter a header string that
                             will be printed at the top of each page on print-
                             out.  Often the file you have loaded will have
                             a left margin offset (no characters to the left
                             of column 6 for instance).  In this case you may
                             wish to give the header string the same offset.
                             You do this by preceding the header string with
                             the desired number of spaces necessary to obtain
                             the offset. For example:

                             "     My File Documentation"

                          U) Underline header?:  This will be set to Yes or
                             No.  When the input window pops up, you can
                             enter just 'y' or 'n' to set this parameter.
                             XVIEW only looks at the first letter of your
                             response.   If you select Yes, the header string
                             and page number will be underlined.  If the
                             header string is preceded by spaces (see H
                             above) the underline will not start until the
                             first non-space character of the header string
                             is reached.  Note that if you have not given
                             a header string and underline and page number-
                             ing is turned on (see P below) then the under-
                             line will start at column 1.  Your best bet is
                             to turn underline off if you have not given a
                             header string.

                          P) Page number start: This is the page number that
                             XVIEW will use for the first page of your print-
                             out.  If you set it to 10 then the first page
                             will be numbered 10 and the next 11, etc.  Valid
                             page starts range from 0-9999.  If you set page
                             start to 0, the header string, underline and
                             page number will NOT be printed on the first
                             page of your printout.  However, the second
                             page will print the header string and underline
                             (assuming they are turned on) and the page
                             number will be 2.  In other words, setting page
                             start to 0 will suppress the header print on
                             the first page of your printout.  This is the
                             default.  If you set page start to -1 (or any
                             number less than 0) page numbering will be
                             turned off.   Note that if page numbering is
                             turned off, the header string (if it exists)
                             and the underline (if turned on) will be printed
                             on every page.

                          T) Top margin:  This defines where the first line
                             of each page will be placed.  The header itself
                             will always be on line 4.  The minimum value
                             for top margin is 6.

                          B) Bottom margin: This defines the last line loca-
                             tion for each page on printout.  The maximum
                             value is 66.  XVIEW assumes that you have your
                             printer set for 66 lines per page, although it
                             won't hurt if you do not.  You'll just have a
                             larger than expected bottom margin offset in
                             this case.

                          L) Printer port to use: This may be LPT1, LPT2, or
                             LPT3.  Be sure to select a valid port (one that
                             exists and has a printer connected to it) or
                             XVIEW will rudely complain.  If you are using
                             a serial printer, you may need to use the DOS
                             Mode command to redirect printer output to
                             your serial port.  You've probably already
                             done this, I would expect.

                          W) Wait for sheet feed: Set this to Yes if you are
                             not using tractor fed paper.  XVIEW will prompt
                             you to insert a new sheet at the end of each
                             page.   Note that depending on the size of the
                             buffer in your printer, you may receive this
                             prompt long before your printer actually stops
                             printing.

                          Note that when you use the Ctrl-B or Ctrl-E command
                          you can abort the printout by hitting the Esc key.
                          XVIEW sends a reset command to your printer which
                          causes it to stop immediately.  This also has the
                          unfortunate effect of resetting the top of form to
                          wherever the print head happens to be.  You will
                          need to reset this before beginning another print.


      4) BLOCK  - Ctrl-A: Use this command to mark the start of a block.
                          The desired start position must be within the
                          current view.  When you hit Ctrl-A two markers
                          will appear at the top of the current view.  Use
                          the up and down cursor keys to select the  desired
                          position and hit Enter.  The line will be high-
                          lighted.

                  Ctrl-Z: This command marks the end of a block.  The desired
                          end point must be within the current view.  As with
                          Ctrl-A, two markers will appear.  Use the cursor
                          keys to select the end mark and hit Enter.  All
                          lines between the start and end of the block will
                          be highlighted whenever they are part of the cur-
                          rent view.

                  Ctrl-H: Use this command to remove the marks set by Ctrl-A
                          and Ctrl-Z.  This causes the marked block to no
                          longer be highlighted.

                          NOTE: If you use the Ctrl-A command to mark a new
                          block when a block is already marked, the previous
                          marked block will be unmarked and unhighlighted.
                          XVIEW does not allow multiple blocks to be marked
                          (which would only confused those commands that act
                          on marked blocks).

                  Ctrl-R: This command reformats a marked block.  Its action
                          is similar to reformating a paragraph in a word
                          processor.  It may seem odd to have such a facility
                          in a file viewer, but I have included it because
                          of the way some text based files are written.  When
                          loading a file into XVIEW you will notice that
                          some sections
                          of the text have lines that seem to end too quickly
                          within a block (just like "some sections" above).
                          This happens because the author allowed the offending
                          line to run passed column 80.  XVIEW with its auto-
                          matic wordwrap facility dutifully wraps the line
                          around to the next line and then runs smack dab
                          into the CR/LF line terminator that convinces it
                          this is truly the end of the line so it starts
                          another line.  The Ctrl-R command allows you to
                          fix this mishap.

                          To use this command, first mark the start and end
                          of the misshapened block using the Ctrl-A and
                          Ctrl-Z commands and then hit Ctrl-R.  At this point
                          XVIEW needs to know where the left margin should
                          be.  A solid line with an up arrow will appear at
                          the bottom of the current view.  Using the up and
                          down cursor keys move the solid line to a con-
                          venient location and then use the left and right
                          cursor keys to position the up arrow at the column
                          position where you want the left margin to be.  A
                          good place for that would be the current left
                          margin of the block.  Now hit Enter, and in no time
                          at all the block will be reformated.

                          Use this command with caution!  Make sure the block
                          in one that can be reasonably reformated.  A little
                          common sense will give good results.

                          NOTE: If you try to reformat an extremely large
                                block, you run the risk of receiving an
                                out of memory error.  This could result in
                                the loss of the marked block.  Limit your
                                reformating to paragraphs of reasonable
                                length.  If you find a document with a
                                paragraph 30 pages long then write the
                                author a nasty letter.  To see how much
                                memory you have available to reformat, hit
                                Alt-M as described below.


      5) MISC   -  Here we begin a section of miscellaneous commands.

                   Alt-8: Retain high bit.  This command instructs XVIEW to
                          load files as 8-bit bytes.  In other words files
                          loaded will retain the high order bit in each byte
                          that is read.  This is the mode you should use on
                          most files.  This mode allows you to see the full
                          range of the IBM character set (ASCII values 32
                          through 255).  You should not use this mode when
                          loading WordStar files, as WordStar sets the high
                          bit on many normal ASCII characters as formating
                          information, which is why we have the next command
                          This mode is the default.

                   Alt-7: Strip high bit.  In this mode XVIEW still reads
                          files as 8-bit bytes, but it strips away the
                          high bit forcing all character values to have a
                          value less than 128 which is the normal ASCII
                          character set.  You should use this mode when
                          loading WordStar files.  When this mode is se-
                          lected you will be asked if you wish to strip the
                          high bits from the file at present in memory.  If
                          you have just loaded a WordStar file and are
                          seeing a lot of funny characters on screen, answer
                          with 'Y'.   This mode defaults to off.

                   Alt-Z: In MS-DOS, the end of file (EOF) marker for text
                          files is the CTRL-Z character.  A program reading
                          in text mode will stop reading as soon as it sees
                          this character.  XVIEW reads files in binary mode.
                          This means that it will keep on reading past the
                          CTRL-Z character if CTRL-Z checking is turned off.
                          When CTRL-Z checking is turned on, it will stop
                          reading  as soon as it sees CTRL-Z.  The Alt-Z
                          commands toggle CTRL-Z checking on and off.  Why
                          would you want to toggle CTRL-Z checking off?
                          Well, many programs that create text files, write
                          additional information beyond the CTRL-Z character.
                          Turning CTRL-Z checking off allows you to see this
                          information.  However, what you see might not make
                          much sense.  You'll see a lot of smiling faces and
                          other weird characters, so this feature is not
                          very useful.  A future release of XVIEW will pro-
                          bably switch to a hex dump at this point. In the
                          mean time try it on some files, qawk at the funny
                          characters, and then never use it again.  The de-
                          fault is CTRL-Z checking on.

                   Alt-B: This command goes through the file in memory and
                          reduces the blank lines that appear between blocks
                          to a maximum of one line.  This can be useful if
                          you get tired of scrolling through a lot of blank
                          lines, or you wish to save paper when you send
                          the file to your printer.

                   Alt-M: This command reports the amount of free memory
                          in your system.  XVIEW will use all of available
                          memory when loading a file, except for about
                          20 kilobytes it reserves for other uses (such as
                          reformating).  If this command reports about 20K
                          free, then you know you are using ALL of the
                          memory in your system.  This will be the case
                          if you get a "File truncated" message after
                          loading a file.

      6) SAVE   -  Alt-K: This command will save the file in memory to disk.
                          You may wish to do this if you have altered the
                          file in any way.  You will be prompted for a file-
                          name to save with.  If the filename you choose
                          already  exists, you will be warned and given a
                          chance to back out.  The best bet is to back out
                          and choose another name.

                   Alt-A: This command is used for saving file segments that
                          have been altered.  This command does not warn you
                          if the file already exists because its purpose is to
                          append the new segment onto a previously saved
                          segment front to back.  The best procedure is to
                          save the first segment using the Alt-K command
                          (so you will be warned if a file by that name
                          already exists) and use Alt-A to append succeeding
                          segments to the first.

                   Alt-J: This command is useful for saving a marked block
                          to disk.  You may wish to extract (or clip) part
                          of a file and save it to disk for other uses. You
                          marked the block with the Ctrl-A and Ctrl-Z
                          commands discussed above.

                   Alt-E: Use this command to append additional clips to the
                          file created with Alt-J.  Using these two commands
                          allow you to build your own special reference
                          files derived from a larger documentation file.

                          NOTE: XVIEW checks the free space available on
                                the target drive (which may be different
                                from the currently logged drive) and
                                refuses to save if enough space is not
                                available.

                          WARNING:  BE VERY CAREFUL WHEN SAVING A MARKED
                                    BLOCK TO DISK.  IF YOU USE THE SAME
                                    FILENAME AS THE ORIGINAL COMPLETE FILE,
                                    THE ORIGINAL WILL BE LOST!

                   Alt-F: This commands reports the amount of free space
                          available on your currently logged drive.


      Well, this ends the command summary.  Here are some more notes you
      should consider.

      1) Editing within an input window:  Anytime a window pops up
         asking you to enter text there are several command keys to
         aid you as follows:

         a)  Cursor left: As the name implies, this will move the cursor
                          left within the window.

         b) Cursor right: You guessed it, this moves the cursor right.

         c)       Delete: This key deletes the character under the cursor
                          and pulls characters to the right of the cursor
                          left.

         d)  <-Backspace: This key deletes the character to the left of the
                          cursor and pulls characters to the right left.

         e)         Home: This key moves the cursor to the home (left)
                          position.

         f)          End: This key moves the cursor to the end of the line.

         g)       Ctrl-X: This command erases the entire line and homes the
                          cursor.

         NOTE: Window input is always in insert mode, meaning that if you
               type characters in the middle of a line, characters to the
               right of the cursor will be pushed right.  The Insert key
               has no affect.  If you don't like this please write and tell
               me about it.  If enough people request it I'll incorporate
               an overstrike mode into the next release of XVIEW.

      2) As of this release of XVIEW, wordwrap is automatic and cannot be
         turned off.  This was done primarily because XVIEW was designed
         for reading documentation files.  If you think this is a serious
         shortcoming, by all means write me and tell me so.  If enough
         people write, I'll change this in a future release of XVIEW.

      3) Occasionally you will see some funny characters scattered
         through out a file.  Examples are: (can't be seen on paper.)

         A) the IBM character for formfeed--->
         B) the IBM character for backspace-->
         C) the IBM character for Return----->


         The formfeed (FF) character is usually intended for output to
         your printer. It means "move the print head to the top of the next
         sheet" or "eject a sheet."  On some computer terminals it might
         also mean "clear the screen and home the cursor."  If the file
         you are viewing contains this character then you have good reason
         to believe that the file has already been formatted for your
         printer and it might be best to print the file (in full) by
         using "TYPE <filespec> >PRN" or "PRINT <filespec>."  XVIEW ignores
         this character in its print routines.

         The backspace (BS) character(s) causes your printer to backspace
         over the previous character(s) and allows for printer independent
         effects such as:

         BACKSPACEBACKSPACE

         On paper this will cause the word "BACKSPACE" to be printed twice
         at the same position, thus giving a bold effect.

         The Return or Enter character (CR) is the ASCII code decimal 13.
         This is the code you send to your terminal when you hit the Enter
         or Return key.  MS-DOS also does a linefeed at this point so the
         cursor moves not only to the beginning of the line but also to
         the next line down.  When sent to the printer, it causes the
         print head to move to the beginning of the line but does not
         do a linefeed.  (Some printers may automatically add a linefeed
         at this point depending on how you've got your printer set.)
         MS-DOS normally expects lines to be terminated with a CR/LF
         pair.  Authors will sometimes place a lone CR code at the
         end of a line to force the printer to print over the same line
         again.  This allows printer independent effects such as:

         _________
         underline

         or

         BOLD
         BOLD

         These effects will only be visible on paper.

         XVIEW does not ignore the CR or BS characters.  Instead XVIEW
         carries out the author's intentions.

      4) XVIEW assumes the usual printer configuration of 66 lines
         per page.  Unless you have gone to the trouble to set it
         differently, it is probably already set for 66 lines.  It
         is possible that a previous program has set your printer
         to something other than 66 lines.  In this case you should
         reset your printer.  Turning it off and then on will do the
         trick, if it doesn't have a reset button.   Note that if
         your printer is set for more than 66 lines, no harm will be
         done but your bottom margin offset will seem a little large.

      5) Tab characters in a file can be a problem.  XVIEW assumes that
         tabs are set at even stops across the page.  When XVIEW en-
         counters a tab character it calculates the next tab stop and
         pads the file with spaces to reach the tab stop.  XVIEW uses
         stops set at column 5, 10, 15, etc.  Some editors use an
         optimal fill approach with tabs.  In other words, if a line
         has leading white space, the editor will fill the leading
         space with tabs and spaces in such a way as to use the least
         number of characters while ignoring the notion of tab stops.
         The Turbo C editor does this when in Fill mode, which is why
         I never use Fill mode.  This approach confuses programs which
         expect evenly spaced tabs, such as the DOS TYPE command and
         XVIEW.  If a file you are viewing seems to be disorganized,
         then you can be sure that either the author had a little
         too much to drink or he was using an editor that has an odd
         notion of tabs.

      -----------------------------------------------------------------

      [ The following section is the registration form.  Block it off ]
      [ with the Ctrl-A and Ctrl-Z commands and then send it to your  ]
      [ printer with the Ctrl-B command.                              ]

      -----------------------------------------------------------------
                                REGISTRATION

          The registration fee is $10.00 and should be remitted to:

                             James C. Dunavant
                            717 NE 5th  Terrace
                           Gainesville, FL 32601

          Registration entitles you to received notification of future
          upgrades and bug fixes of XVIEW.

      NAME _______________________________________ DATE _______________

      ADDRESS _________________________________________________________

      CITY ______________________ STATE ___________ ZIPCODE ___________

      PHONE (____)__________________    XVIEW VERSION # _______________

      WHERE DID YOU GET XVIEW? ________________________________________

      WHAT BRAND OF COMPUTER ARE YOU USING? ___________________________

      WHAT CLASS OF COMPUTER (PC/XT/AT/PS/2)? _________________________

      MS-DOS/PC-DOS VERSION YOU ARE USING _____________________________

      YOUR COMMENTS ARE WELCOME: ______________________________________

      _________________________________________________________________

      _________________________________________________________________

      _________________________________________________________________

      _________________________________________________________________

      _________________________________________________________________

      _________________________________________________________________

      _________________________________________________________________

      _________________________________________________________________

      _________________________________________________________________

      _________________________________________________________________

      Please marked the outside of your envelope "XVIEW registration"
      so I'll know what it's all about.

      -end of form-

      ------------------------------------------------------------------

      [ This section is for bug reports.  If you have discovered a bug ]
      [ please complete the following report and send it to me so that ]
      [ I can remove the bug.  If you are a registered user you will   ]
      [ receive an updated version of XVIEW as soon as it is fixed.    ]
      [ Please try to duplicate the bug and describe in detail just    ]
      [ how the bug reared it ugly head.                               ]

      __________________________________________________________________

                             --   BUG REPORT   --

      YOUR NAME _______________________________ DATE ___________________

      ADDRESS __________________________________________________________

      CITY ____________________________ STATE ______ ZIPCODE ___________

      XVIEW VERSION # __________   PHONE (_____)________________________

      COMPUTER BRAND AND CLASS _________________________________________

      MS-DOS/PC-DOS VERSION YOU ARE USING ______ MEMORY INSTALLED _____K

      NUMBER OF FLOPPY DRIVES AND FORMAT _______________________________

      HARD DRIVES INSTALLED AND CAPACITY _______________________________

      TYPE OF VIDEO CARD AND VIDEO MONITOR _____________________________

      DETAILED DESCRIPTION OF BUG ______________________________________

      __________________________________________________________________

      __________________________________________________________________

      __________________________________________________________________

      __________________________________________________________________

      __________________________________________________________________

      __________________________________________________________________

      __________________________________________________________________

      __________________________________________________________________

      __________________________________________________________________
      Please continue on reverse side of sheet if needed.

      Send to:    James C. Dunavant
                  717 NE 5th Terrace
                  Gainesville, FL 32601

     Please enclose a self-addressed stamped envelope if you expect an
     immediate reply.  Registered users will receive a free update as
     soon as it is ready.  Please marked the outside of your envelope
     "XVIEW bug report" so I'll know what it's all about.

     Thanks for the bug report!

     -end of form-