


     MORE(U1)             LS-DOS 6 - Utilities 1              MORE(U1)



     Name
          MORE - Displays the contents of a file one screen at a time.

     Syntax
          more [ -cdflsurw!?h ] [ -n ] [ +linenumber ] [ +/pattern ]
          [ wildspec ][ :drivespec ]... [< file | device ]
          [>[>] file | device ] [ ; next command ]

     Description
          More acts as a filter that allows text to be viewed one
          screen at a time.  By default, more pauses when the screen
          has been filled with text. More then displays the "--More--"
          command prompt at the bottom of the screen.  If the user
          presses <SPACE>, another page (screen full) of text is
          displayed.  Pressing <ENTER> causes the next line of text to
          be displayed.  The number of lines of text displayed when
          these keys are pressed is adjustable.  There are numerous
          other commands available at the --More-- prompt, and these
          are described below.

          More can accept multiple files at once.  When a wildspec is
          specified, all files that match the wildspec will be
          displayed.  If a drivespec is specified, only files on that
          particular drive or drives will be displayed.  If the
          drivespec and wildspec are both omitted, more will read data
          from standard-in device (normally the keyboard) and displays
          the data that is read.  The output of more can also be
          redirected out to a device or a file.

          More accepts several options.  Options are usually specified
          by single characters, and they may be entered in upper or
          lowercase.  Options are always preceded by a hyphen (a "-").
          If you are specifying multiple options, you can specify the
          options in any of these formats:
                -a -b -c   or   -abc   or   -a -bc   or  -ab -c

          The options are:

          -c   Each page of text is displayed by starting at the top
               of the screen and erasing the old text on each line
               just before new text is placed on that line.  By
               default, more scrolls the text from the previous page
               up so that it disappears off the top of the screen, and
               the new text is added at the bottom.


          -d   The --More-- prompt will also display brief a help
               message each time it is displayed.  This is useful with
               users who are unfamiliar with more.  Note that "?" can
               be pressed at the --More-- prompt to receive help at
               all times.




     Page 1                                             May 15th, 1993






     MORE(U1)             LS-DOS 6 - Utilities 1              MORE(U1)



          -f   This option instructs more to count logical lines
               instead of screen lines.  If all the lines of text are
               shorter than 81 lines, you will not be able to see a
               difference.  This option is useful if the file contains
               backspace or control-character sequences that might
               confuse more about the true length of lines in the
               file.


          -l   CONTROL-L will not be treated as a special character.
               By default, a CONTROL-L causes the --More-- prompt to
               be displayed immediately, just as though the end of the
               current page had been reached.


          -s   When specified, duplicate blank lines are not
               displayed. For example, if a file contains three blank
               lines in a row, only one blank line will be displayed.
               This is useful for looking at documents that are
               formatted for printing and have multiple blank lines at
               the top and bottom of each page.


          -u   Normally more displays text that is underlined in
               reverse video.  This option disables this translation.


          -r   This option causes control characters to be displayed
               as a caret ("^") and a letter.  For example, CONTROL-C
               would be displayed as ^C.  By default, more ignores
               non-carriage control characters.


          -w   A warning message will be displayed when all files have
               been displayed and more is about to exit.  This is
               useful when more is invoked from another program or
               batch file that might clear the screen before the
               contents can be read.  The prompt "--No More--" waits
               for the user to press a key before more exits.


          -!   Causes more to ignore any default settings that are
               specified in the DEFAULTS/MAD file.  More will also
               ignore any options that are specified to the left of
               the -! option.  Note that the DEFAULTS/MAD file is
               accessed even if the -! option is specified.


          -? or -h
               Displays the help message.





     Page 2                                             May 15th, 1993






     MORE(U1)             LS-DOS 6 - Utilities 1              MORE(U1)



          -n   n is an integer that specifies the number of lines that
               more will display per page instead of the default.  If
               the number is larger than 23, some lines will scroll
               off the screen before the --More-- prompt is displayed.


          +linenumber
               When specified, more skips this many lines in the first
               file specified before it begins to display the file
               contents.


          +/pattern
               When specified, more will search through the first file
               that is specified looking for the pattern.  When the
               pattern is found, more will begin displaying the file
               at that point.  More displays up to four lines in front
               of the point where the match occurs to provide some
               context.

               If the pattern is not found, the message "Pattern not
               found" is displayed.  If a filename was specified to
               more, more repositions to the beginning of the current
               file after the search fails.  If more was reading from
               the standard input or from a redirected file, more
               remains positioned at the end of the file.

               Patterns may include all types of wildcards.  Wildcards
               are discussed in the wildspec documentation, below.
               You may also place an uparrow (^) at the start of the
               pattern.  The uparrow means that the pattern must match
               text at the start of lines in the file.  For example,
               if the pattern was "^ine":
                     This line would not match the pattern,
                     ine But this line would.

               By default, the pattern will match text anywhere in a
               line.

               The pattern is case-sensitive, so upper and lowercase
               characters must match the pattern exactly.  The pattern
               can specify upper or lowercase for certain characters
               if needed by using ranges.

               Multiple patterns can also be specified by placing
               <CLEAR><SPACE> character between each pattern.  For
               example the pattern ABC<CLEAR><SPACE>xyz  would locate
               any occurrence of the sequence "ABC" or the sequence
               "xyz".






     Page 3                                             May 15th, 1993






     MORE(U1)             LS-DOS 6 - Utilities 1              MORE(U1)



          wildspec
               A wildspec specifies one or more files that are to be
               examined in alphabetical order.  A wildspec may contain
               none or more of the following wildcard characters:

               *     The * matches zero or more characters in the
                     specified position.  For example, the wildspec
                     A*Z will match any of the following filenames:
                                      AZ          ABZ
                                    ABCDEFGZ    ABC/XYZ
                     Note that unlike a LS-DOS/TRSDOS 6 partspec(L),
                     the filename and extension are treated as a
                     single unit.  A single * will match files with
                     and without extensions.

               %     The % matches exactly one character.  So A%C
                     matches:
                                      ABC         AXC
                     The file AC will not match the A%C pattern.

               [ ]   Ranges specify multiple characters that may
                     appear in a given position in the filenames being
                     tested.  There are two formats that can be
                     combined:
                     [abc]     These specific characters are
                               acceptable in this position in the
                               filename.  So A[BC5]D would match:
                               ABD            ACD                 A5D

                     [b-e]     The characters in this ASCII range are
                               acceptable in this position in the
                               filename.  A[E-J]X matches:
                               AEX            AFX                 AGX
                               AHX            AIX                 AJX
                               Numbers can also be included in ranges,
                               but the first value of the range must
                               always have a lower ASCII value than
                               the second value.
                     [!...]    The ! excludes all files that match
                               characters in this position.  So
                               A[!DKP]D will match all filenames that
                               start with an "A", end with a "D", and
                               the second character is any character
                               except "D", "K", or "P".

                     Combinations of ranges are also allowed.
                     A[1-3ABD]X would allow these filenames:
                                A1X         A2X         A3X
                                AAX         ABX         ADX

               Any lowercase characters in the wildspec are converted
               to uppercase before the comparison is performed.



     Page 4                                             May 15th, 1993






     MORE(U1)             LS-DOS 6 - Utilities 1              MORE(U1)



          :drivespec
               The drivespec specifies one or more logical drives that
               should be scanned for files that match the file
               wildspec.  The % and * will examine all enabled drives.
               A range can also be used.  For example, :[2-47] will
               search for files on drives 2, 3, 4 and 7.

               If the drivespec is not specified and a wildspec is,
               all drives are searched for files that match the file
               wildspec and all files that match will be displayed.
               So if the command more sample/txt is used and the file
               SAMPLE/TXT exists on four different logical drives, all
               four files will be displayed.


          < file | device
               If a file or device is specified, more will read the
               data from the file or device until the end-of-file is
               detected or an error occurs.  This is known as
               redirected input.  For example, if you specify < *KI or
               do not specify a wildspec, characters will be read from
               the keyboard until <BREAK> is pressed.  These
               characters will not be echoed.

               Redirected input will override any wildspecs that are
               specified.


          >[>] file | device
               By specifying a file or device, the output is sent to
               the specified file or device instead of the display.
               This is known as redirected output.  For example, the
               command more a*:5 > all/a:0 places the contents of the
               files from logical drive 5 with names that start with
               the letter 'a' in the file ALL/A:0.  If >> is used, the
               output will be appended to any existing contents of the
               file.  Filespecs for redirection may not specify a
               password.


          ; next command
               After more completes, the remainder of the command line
               is executed as a second command.  The command more
               x:1;date will display the contents of the specified
               file, and then the date will be displayed.


          <SHIFT>@
               When pressed during output to the display, the output
               will pause.  Pressing any other key resumes output.
               Pressing this key is ignored when output is redirected.




     Page 5                                             May 15th, 1993






     MORE(U1)             LS-DOS 6 - Utilities 1              MORE(U1)



         --More-- Prompt Commands


               When the --More-- prompt is displayed, numerous
               commands can be specified.  These allow you to skip to
               the next file, skip further down the current file, even
               search for a particular string within the file.  With
               the exception of the "/" command, no characters are
               echoed while the command is being entered.

               Some of the commands optionally accept a decimal value
               i.


          [i]<SPACE>
               When the <SPACE> key is pressed, another screen worth
               of information is displayed.  By default, 22 new lines
               are displayed each time so that one line from the
               previous screen will remain in the screen.  If a
               decimal value is specified, it will set the number of
               lines that are displayed each time the <SPACE> key is
               pressed from now on.


          [i]<ENTER>
               This command causes one more line of the file to be
               displayed.  If a number is specified, it changes the
               number of lines the <ENTER> key displays.  The command
               7<ENTER> causes the <ENTER> to display seven more lines
               each time it is pressed.


          [i]<CTRL-D>
               Similar to the <SPACE> key, except that 11 more lines
               are displayed.  This default can be changed by
               specifying a new value.


          [i]s The specified number of lines are skipped and then a
               new page of text is displayed.  For example if the --
               More-- prompt pauses at line 23 of a file and you type
               500s, the listing will resume at line 524.


          [i]f This skips forward in the file by the specified number
               of screens of text.


          [i]/pattern
               Searches forward in the current file looking for a line
               that contains text that matches the pattern.  Wildcards
               and the uparrow (^) can be used in the pattern.



     Page 6                                             May 15th, 1993






     MORE(U1)             LS-DOS 6 - Utilities 1              MORE(U1)



               Multiple patterns can also be used (see +/pattern for
               an example).  When a line is found that matches the
               pattern, the listing resumes four lines above the line
               containing the match.  If the search started fewer than
               four lines from the location where a match to the
               pattern is found, all the intervening lines are
               displayed.

               If a decimal value is specified, more will search for
               the nth occurrence of the specified pattern.

               If the pattern cannot be found, more will display the
               error "Pattern not found".  If more was reading from a
               file, it will reposition to the location in the file
               that more was at when the search was started.  If more
               was reading from a standard input (*SI) or a redirected
               input and the pattern could not be found, more will
               terminate when the end of the input data is reached.


          [i]n When the n command is specified, more will start a
               search using the last pattern that was specified with
               the / command.  A decimal value will cause the search
               to look for the nth occurrence of the pattern.


          =    Will display the current line number.  All --More--
               commands are accepted even though the --More-- prompt
               isn't visible.  To redisplay the --More-- prompt, press
               <BACKSPACE> or any other invalid character.


          .    Causes more to repeat the last command that accessed
               the file.


          q    Causes more to exit, regardless of how many more files
               are to be displayed.  more exits with a "no error"
               condition.  Any additional commands specified on the
               more command line are not executed.


          <BREAK>
               Like the q command, more will exit.  More exits with an
               abort error condition and will not execute any
               additional commands on the more command line.









     Page 7                                             May 15th, 1993






     MORE(U1)             LS-DOS 6 - Utilities 1              MORE(U1)



         The following commands are not available when reading from a
         streaming device.  This includes reading from standard in or
         from a redirected file.

           '   More positions back to where the last search started.
               For example, if you used the / command to search for
               something and the wrong search string was specified,
               the ' command will back up to the place in the file you
               were at when the last search started.


          :f   Displays the current filename and line number.  Similar
               to the = command.


          [i]:n
               Advances to the next file when multiple files are
               specified.  If there are no more files, more exits
               (unless the -w option was specified).  If a number is
               specified, the specified number of files are skipped.
               If the command MORE A B C D was used and in the middle
               of reading file A you gave the command 2:n, more would
               skip to the file named C.  By default, :n goes forward
               to the very next file.


          [i]:p
               Moves to the previous file when multiple files are
               specified.  If there are no previous files, more goes
               to the first file specified.  If a number is provided,
               more skips back that number of files.  The command 0:p
               goes to the start of the current file.  By default, :p
               goes back one file.



     Files
          More reads the DEFAULTS/MAD file and uses any default
          options that are specified there.  For example, if you
          wanted more to always display control characters, the
          following entry in the DEFAULTS/MAD file would do this:
                      MORE -R
          Options in the DEFAULTS/MAD file are ignored if the -!
          option is specified on the command line.











     Page 8                                             May 15th, 1993






     MORE(U1)             LS-DOS 6 - Utilities 1              MORE(U1)



          You may make copies of more with different names.  When
          examining the DEFAULTS/MAD file, the name used to invoke the
          program will be used to locate the default entries.  For
          example, if you made copies of MORE/CMD and named them
          SHOW/CMD and VIEW/CMD, you could add the following lines to
          the DEFAULTS/MAD file:
                      SHOW -R
                      VIEW -S
          When show is run, any non-carriage control characters in the
          files would be displayed as ^character, and view would
          eliminate excessive blank lines in the files it displays.


          If you need more information on more(U1) or if you want to
          obtain the LDOS 5.3 version, please write to M.A.D.
          Software, P.O. Box 331323, Ft. Worth Texas, 76163.  Please
          include a Self-Addressed-Stamped-Envelope when requesting
          information.
          ------
          306182



































     Page 9                                             May 15th, 1993



