List all files in the current checkout. If PATHS is included, only the named files (or their children if directories) are shown.

The ls command is essentially two related commands in one, depending on whether or not the -r option is given. -r selects a specific check-in version to list, in which case -R can be used to select the repository. The fine behavior of the --age, -v, and -t options is altered by the -r option as well, as explained below.

The --age option displays file commit times. Like -r, --age has the side effect of making -t sort by commit time, not modification time.

The -v option provides extra information about each file. Without -r, -v displays the change status, in the manner of the changes command. With -r, -v shows the commit time and size of the checked-in files.

The -t option changes the sort order. Without -t, files are sorted by path and name (case insensitive sort if -r). If neither --age nor -r are used, -t sorts by modification time, otherwise by commit time.

Options:

--age

Show when each file was committed.

-v|--verbose

Provide extra information about each file.

-t

Sort output in time order.

-r VERSION

The specific check-in to list.

-R|--repository REPO

Extract info from repository REPO.

--hash

With -v, verify file status using hashing rather than relying on file sizes and mtimes.

See also: changes, extras, status