ADIR
----

Format:      ADIR [filespec] [/H] [/W] [/D] [/P] [/S] [/2] [/?]

Purpose:     Displays the names of files on disk in ANSI colors
	     with JANSI or PUT9000 driver.

Use:         The filespec specifies which files are to be listed. If 
        the /H option is given, then hidden files will also be list- 
        ed.

             There are  three formats  of the listing. If the /W op- 
        tion is given, then a 'wide' listing is printed, with sever- 
        al  filenames  output  per line.  Sub-directory names,  file 
        attributes,  and the date and time each file was created are 
        not displayed.  If the /D option is also given, the the sub- 
        directory names will also be listed. The names of sub-direc- 
        tories  are printed  in undercast.  Note that  the /D option 
        must  always  follow the  /W option,  because the  /W option 
        cancels the /D option.

             If  the /W  option is not given, then the filenames are 
        printed with one filename per line, together with the attri- 
        butes, the file size and the date and time at which the file 
        was last  modified. The  attributes are printed as an 'r' if 
        the  file is read-only and an 'h' if the file is hidden (and 
        /H is  given). The  formats in which the dates and times are 
        printed in can be changed (see HELP DATE and HELP TIME).

             If the /2 option is given, the the filenames are print- 
        ed with two filenames per line.
 
             At the top of the list of files, the volume name of the 
        disk and  the name of the directory being listed is display- 
        ed.  At the  bottom, the  number of  files listed, the total 
        number of  bytes in  the files  and the  amount of remaining 
        disk space is printed.

             When  the directory  of a sub-directory is printed, the 
        first two items listed will always be two special sub-direc- 
        tories called  '.' and '..'. These are automatically created 
        when  a new directory is created, and it is these that allow 
        '.' and  '..' to  be given in path names to signify the cur- 
        rent  and parent  directories respectively  (see HELP SYNTAX 
        for a description of paths).

             When printing a number of bytes, the number is truncat- 
        ed and printed as the number of kilobytes if 1K or greater.

             If the  /P option  is given, then the output will pause 
        at the bottom of the screen until a key is pressed.

	     If the  /S option	is given, then	all  sub-directories
	are listed inside of that directory.

Examples:

        ADIR

             All filenames and directory names in the current direc- 
        tory  of the current drive will be printed. This might be as 
        follows:

              Volume in drive A: is MSX-DOS 2
              A-Directory of A:\

             MSXDOS2  SYS r    4096 86-06-19  2:45p
             COMMAND2 COM r   10496 86-06-19  2:46p
             UTILS           <dir>  86-06-19  2:50p
             HELP            <dir>  86-06-19  2:50p
              14K in 2 files   222K free

        The  disk   thus  contains  the  two  MSX-DOS  system  files 
        MSXDOS2.SYS  and COMMAND2.COM,  which are read only, and two 
        directories called UTILS and HELP.

        ADIR B:\HELP/W

             A 'wide'  directory format  has been  requested of  the 
        HELP directory on drive B:. This might be as follows:

              Volume in drive B: is MSX-DOS 2
              A-Directory of B:\HELP

             BUFFERS .HLP    ATTRIB  .HLP    ASSIGN  .HLP
             ATDIR   .HLP    CHDIR   .HLP    CD      .HLP
             SYNTAX  .HLP    ENV     .HLP    BATCH   .HLP
             EDITING .HLP
              25K in 10 files   222K free

        ADIR A:\ /W/D

             A 'wide'  directory format  with a  directory print has 
        been requested of the root-directory on drive A:. This might 
        be as follows:

              Volume in drive A: is MSX-DOS 2
              A-Directory of A:\

             MSXDOS2  SYS    COMMAND2 COM    utils
             help
              14K in 2 files   222K free

        ADIR  HELP/P

             This will list all the files in the HELP directory, and 
        will pause at the end of every screen full.

        ADIR /?

             This will show a short reference manual.
