mirror of
git://git.suckless.org/sbase
synced 2025-03-19 17:46:01 +00:00
d458fa2c7b
When viewing sbase's man pages the date displayed at the bottom is
the current date rather than the date entered in the <program>.1
file.
According to this:
https://mandoc.bsd.lv/mdoc/details/date.html
The traditional man date format used by sbase (.Dd year-month-day)
is no longer recommended and no longer supported by GNU troff or
Heirloom Docs and as a result the current date is displayed instead.
Although this format is still accepted by mandoc for backward
compatibility.
For portability it states the standard mdoc date format should be
used instead: .Dd month day, year
I applied the following patch to sbase's last commit b30fb56 and
it fixes the issue.
100 lines
2.2 KiB
Groff
100 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
|
|
The
|
|
.Nm
|
|
utility is compliant with the
|
|
.St -p1003.1-2013
|
|
specification except from the
|
|
.Op Fl Ckmpsx
|
|
flags.
|
|
.Pp
|
|
The
|
|
.Op Fl hU
|
|
flags are an extension to that specification.
|