." DO NOT MODIFY THIS FILE!  It was generated by help2man 1.5.1.2.
.TH DIR 1 "November 1998" "GNU fileutils 4.0" "FSF"
.SH NAME
dir \- list directory contents
.SH SYNOPSIS
.B dir
[\fIOPTION\fR]... [\fIFILE\fR]...
.SH DESCRIPTION
.PP
.\" Add any additional description here
.PP
List information about the FILEs (the current directory by default).
Sort entries alphabetically if none of \fB\-cftuSUX\fR nor \fB\-\-sort\fR.
.TP
\fB\-a\fR, \fB\-\-all\fR
do not hide entries starting with .
.TP
\fB\-A\fR, \fB\-\-almost\-all\fR
do not list implied . and ..
.TP
\fB\-b\fR, \fB\-\-escape\fR
print octal escapes for nongraphic characters
.TP
\fB\-\-block\-size\fR=\fISIZE\fR
use SIZE-byte blocks
.TP
\fB\-B\fR, \fB\-\-ignore\-backups\fR
do not list implied entries ending with ~
.TP
\fB\-c\fR
sort by change time; with \fB\-l\fR: show ctime
.TP
\fB\-C\fR
list entries by columns
.TP
\fB\-\-color\fR[=\fIWHEN\fR]
control whether color is used to distinguish file types.  WHEN may be `never', `always', or `auto'
.TP
\fB\-d\fR, \fB\-\-directory\fR
list directory entries instead of contents
.TP
\fB\-D\fR, \fB\-\-dired\fR
generate output designed for Emacs' dired mode
.TP
\fB\-f\fR
do not sort, enable \fB\-aU\fR, disable \fB\-lst\fR
.TP
\fB\-F\fR, \fB\-\-classify\fR
append indicator (one of */=@|) to entries
.TP
\fB\-\-format\fR=\fIWORD\fR
across \fB\-x\fR, commas \fB\-m\fR, horizontal \fB\-x\fR, long \fB\-l\fR, single-column \fB\-1\fR, verbose \fB\-l\fR, vertical \fB\-C\fR
.TP
\fB\-\-full\-time\fR
list both full date and full time
.TP
\fB\-g\fR
(ignored)
.TP
\fB\-G\fR, \fB\-\-no\-group\fR
inhibit display of group information
.TP
\fB\-h\fR, \fB\-\-human\-readable\fR
print sizes in human readable format (e.g., 1K 234M 2G)
.TP
\fB\-H\fR, \fB\-\-si\fR
likewise, but use powers of 1000 not 1024
.TP
\fB\-\-indicator\-style\fR=\fIWORD\fR
append indicator with style WORD to entry names: none (default), classify (-F), file-type (-p)
.TP
\fB\-i\fR, \fB\-\-inode\fR
print index number of each file
.TP
\fB\-I\fR, \fB\-\-ignore\fR=\fIPATTERN\fR
do not list implied entries matching shell PATTERN
.TP
\fB\-k\fR, \fB\-\-kilobytes\fR
like \fB\-\-block\-size\fR=\fI1024\fR
.TP
\fB\-l\fR
use a long listing format
.TP
\fB\-L\fR, \fB\-\-dereference\fR
list entries pointed to by symbolic links
.TP
\fB\-m\fR
fill width with a comma separated list of entries
.TP
\fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR
list numeric UIDs and GIDs instead of names
.TP
\fB\-N\fR, \fB\-\-literal\fR
print raw entry names (don't treat e.g. control characters specially)
.TP
\fB\-o\fR
use long listing format without group info
.TP
\fB\-p\fR, \fB\-\-file\-type\fR
append indicator (one of /=@|) to entries
.TP
\fB\-q\fR, \fB\-\-hide\-control\-chars\fR
print ? instead of non graphic characters
.TP
\fB\-\-show\-control\-chars\fR
show non graphic characters as-is (default)
.TP
\fB\-Q\fR, \fB\-\-quote\-name\fR
enclose entry names in double quotes
.TP
\fB\-\-quoting\-style\fR=\fIWORD\fR
use quoting style WORD for entry names: literal, shell, shell-always, c, escape
.TP
\fB\-r\fR, \fB\-\-reverse\fR
reverse order while sorting
.TP
\fB\-R\fR, \fB\-\-recursive\fR
list subdirectories recursively
.TP
\fB\-s\fR, \fB\-\-size\fR
print size of each file, in blocks
.TP
\fB\-S\fR
sort by file size
.TP
\fB\-\-sort\fR=\fIWORD\fR
extension \fB\-X\fR, none \fB\-U\fR, size \fB\-S\fR, time \fB\-t\fR, version \fB\-v\fR status \fB\-c\fR, time \fB\-t\fR, atime \fB\-u\fR, access \fB\-u\fR, use \fB\-u\fR
.TP
\fB\-\-time\fR=\fIWORD\fR
show time as WORD instead of modification time: atime, access, use, ctime or status; use specified time as sort key if \fB\-\-sort\fR=\fItime\fR
.TP
\fB\-t\fR
sort by modification time
.TP
\fB\-T\fR, \fB\-\-tabsize\fR=\fICOLS\fR
assume tab stops at each COLS instead of 8
.TP
\fB\-u\fR
sort by last access time; with \fB\-l\fR: show atime
.TP
\fB\-U\fR
do not sort; list entries in directory order
.TP
\fB\-v\fR
sort by version
.TP
\fB\-w\fR, \fB\-\-width\fR=\fICOLS\fR
assume screen width instead of current value
.TP
\fB\-x\fR
list entries by lines instead of by columns
.TP
\fB\-X\fR
sort alphabetically by entry extension
.TP
\fB\-1\fR
list one file per line
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
By default, color is not used to distinguish types of files.  That is
equivalent to using \fB\-\-color\fR=\fInone\fR.  Using the \fB\-\-color\fR option without the
optional WHEN argument is equivalent to using \fB\-\-color\fR=\fIalways\fR.  With
\fB\-\-color\fR=\fIauto\fR, color codes are output only if standard output is connected
to a terminal (tty).
.SH "REPORTING BUGS"
Report bugs to <bug-fileutils@gnu.org>.
.SH "SEE ALSO"
The full documentation for
.B dir
is maintained as a Texinfo manual.  If the
.B info
and
.B dir
programs are properly installed at your site, the command
.IP
.B info dir
.PP
should give you access to the complete manual.