mirror of
git://git.suckless.org/sbase
synced 2026-01-26 13:43:17 +00:00
a0998d0252
From ed5e4d34a16436a37c0e084666fcfb77cc4859c3 Mon Sep 17 00:00:00 2001 From: Hiltjo Posthuma <hiltjo@codemadness.org> Date: Thu, 31 Jul 2025 14:42:59 +0200 Subject: [PATCH 4/4] improve man pages and some warnings. Checking for warnings: mandoc -Tlint *.1 - Swap .St -p1003.1-2013 macro with text: mdoc does not support this macro and some texts were changed, like commit d4dfd42d3580ad36bedfdc5b8924ff6683981f53 - Typo fixes: exeption -> exception. - xargs.1: document -P extension. - sed.1: remove use of .Pp of .Ss. - Wrap lines to less than 80 characters and use a new sentence for each line. - find.1: Xr reference C library functions.
97 lines
2.2 KiB
Groff
97 lines
2.2 KiB
Groff
.Dd October 8, 2015
|
|
.Dt LS 1
|
|
.Os sbase
|
|
.Sh NAME
|
|
.Nm ls
|
|
.Nd list directory contents
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl iqr
|
|
.Op Fl ln
|
|
.Op Fl A | a
|
|
.Op Fl 1
|
|
.Op Fl h | F | p
|
|
.Op Fl H | L
|
|
.Op Fl R | d
|
|
.Op Fl S | f | t | U
|
|
.Op Fl c | u
|
|
.Op Ar file ...
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
lists each given file, and the contents of each given directory.
|
|
If no files are given the current directory is listed.
|
|
.Sh OPTIONS
|
|
.Bl -tag -width Ds
|
|
.It Fl A
|
|
List all entries except for '.' and '..'.
|
|
.It Fl a
|
|
Show hidden files (those beginning with '.').
|
|
.It Fl c
|
|
Use time file's status was last changed instead of last
|
|
modification time for sorting or printing.
|
|
.It Fl d
|
|
List directories themselves, not their contents.
|
|
.It Fl F
|
|
Append a file type indicator to all special files.
|
|
.It Fl f
|
|
Like
|
|
.Fl U
|
|
but turns on
|
|
.Fl a
|
|
and disables
|
|
.Fl r ,
|
|
.Fl S
|
|
and
|
|
.Fl t .
|
|
.It Fl H
|
|
List information about the targets of symbolic links specified on the command
|
|
line instead of the links themselves.
|
|
.It Fl h
|
|
Show filesizes in human\-readable format.
|
|
.It Fl i
|
|
Print the index number of each file.
|
|
.It Fl L
|
|
List information about the targets of symbolic links instead of the links
|
|
themselves.
|
|
.It Fl l
|
|
List detailed information about each file, including their type, permissions,
|
|
links, owner, group, size or major and minor numbers if the file is a
|
|
character/block device, and last file status/modification time.
|
|
.It Fl n
|
|
List detailed information about each file, including their type, permissions,
|
|
links, owner, group, size or major and minor numbers if the file is a
|
|
character/block device, and last file status/modification time, but with
|
|
numeric IDs.
|
|
.It Fl p
|
|
Append a file type indicator to directories.
|
|
.It Fl q
|
|
Replace non-printable characters in filenames with '?'.
|
|
.It Fl R
|
|
List directory content recursively.
|
|
The
|
|
.Fl 1
|
|
flag is set implicitly.
|
|
.It Fl r
|
|
Reverse the sort order.
|
|
.It Fl S
|
|
Sort files by size (in decreasing order).
|
|
.It Fl t
|
|
Sort files by last file status/modification time instead of by name.
|
|
.It Fl U
|
|
Keep the list unsorted.
|
|
.It Fl u
|
|
Use file's last access time instead of last modification time for
|
|
sorting or printing.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr stat 2
|
|
.Sh STANDARDS
|
|
POSIX.1-2013.
|
|
Except for the
|
|
.Op Fl Ckmpsx
|
|
flags.
|
|
.Pp
|
|
The
|
|
.Op Fl hU
|
|
flags are an extension to that specification.
|