fbt/sbase
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
e5d8efb32f
sbase/ls.1

100 lines
2.2 KiB
Groff
Raw Normal View History

Use ISO-date-format in manpages The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org.
2015-10-08 15:15:08 +00:00
.Dd 2015-10-08
remove sbase-VERSION from man page, fix sponge.1 date
2015-01-31 13:20:02 +00:00
.Dt LS 1
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install
2015-01-31 19:37:03 +00:00
.Os sbase
ls: Implement -c and update manpage Update usage + README as well. Apparently some of the options ( -H and -L) had already been implemented but not reflected in the program usage line.
2015-01-20 16:50:37 +00:00
.Sh NAME
.Nm ls
.Nd list directory contents
.Sh SYNOPSIS
add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff.
2015-01-30 20:17:58 +00:00
.Nm
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1.
2015-03-27 16:22:48 +00:00
.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
ls: Implement -c and update manpage Update usage + README as well. Apparently some of the options ( -H and -L) had already been implemented but not reflected in the program usage line.
2015-01-20 16:50:37 +00:00
.Op Ar file ...
.Sh DESCRIPTION
.Nm
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 22:37:31 +00:00
lists each given file, and the contents of each given directory.
If no files are given the current directory is listed.
ls: Implement -c and update manpage Update usage + README as well. Apparently some of the options ( -H and -L) had already been implemented but not reflected in the program usage line.
2015-01-20 16:50:37 +00:00
.Sh OPTIONS
.Bl -tag -width Ds
Add ls -A implementation Thanks joshua@cubesolving.com!
2015-02-21 09:30:08 +00:00
.It Fl A
List all entries except for '.' and '..'.
ls: Implement -c and update manpage Update usage + README as well. Apparently some of the options ( -H and -L) had already been implemented but not reflected in the program usage line.
2015-01-20 16:50:37 +00:00
.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
ls: add support for -p
2015-02-19 18:48:15 +00:00
Append a file type indicator to all special files.
ls: add -f and -S options
2015-03-18 18:26:42 +00:00
.It Fl f
Like
.Fl U
but turns on
.Fl a
and disables
.Fl r ,
.Fl S
and
.Fl t .
ls: Implement -c and update manpage Update usage + README as well. Apparently some of the options ( -H and -L) had already been implemented but not reflected in the program usage line.
2015-01-20 16:50:37 +00:00
.It Fl H
List information about the targets of symbolic links specified on the command
ls: Handle symlinks to directories properly Also, implement the -H and -L options.
2014-12-08 01:33:52 +00:00
line instead of the links themselves.
ls: Implement -c and update manpage Update usage + README as well. Apparently some of the options ( -H and -L) had already been implemented but not reflected in the program usage line.
2015-01-20 16:50:37 +00:00
.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
ls: Handle symlinks to directories properly Also, implement the -H and -L options.
2014-12-08 01:33:52 +00:00
themselves.
ls: Implement -c and update manpage Update usage + README as well. Apparently some of the options ( -H and -L) had already been implemented but not reflected in the program usage line.
2015-01-20 16:50:37 +00:00
.It Fl l
List detailed information about each file, including their type, permissions,
ls: handle character/block files in long format Although major() and minor() are not POSIX, we don't want to have macros there so we rely on their implementation by the target system.
2015-10-04 11:10:28 +00:00
links, owner, group, size or major and minor numbers if the file is a
character/block device, and last file status/modification time.
ls: add -n option
2015-02-22 11:55:38 +00:00
.It Fl n
List detailed information about each file, including their type, permissions,
ls: handle character/block files in long format Although major() and minor() are not POSIX, we don't want to have macros there so we rely on their implementation by the target system.
2015-10-04 11:10:28 +00:00
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
ls: add -n option
2015-02-22 11:55:38 +00:00
numeric IDs.
ls: add support for -p
2015-02-19 18:48:15 +00:00
.It Fl p
Append a file type indicator to directories.
Add q-flag to ls(1) of course, UTF-8-aware. ;)
2015-02-17 17:59:01 +00:00
.It Fl q
Replace non-printable characters in filenames with '?'.
ls: add support for -R flag
2015-02-21 10:45:15 +00:00
.It Fl R
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 22:37:31 +00:00
List directory content recursively.
The
ls: Clarify that -1 is set implicitly when -R is used
2015-02-21 11:47:37 +00:00
.Fl 1
flag is set implicitly.
ls: Implement -c and update manpage Update usage + README as well. Apparently some of the options ( -H and -L) had already been implemented but not reflected in the program usage line.
2015-01-20 16:50:37 +00:00
.It Fl r
Reverse the sort order.
ls: add -f and -S options
2015-03-18 18:26:42 +00:00
.It Fl S
Sort files by size (in decreasing order).
ls: Implement -c and update manpage Update usage + README as well. Apparently some of the options ( -H and -L) had already been implemented but not reflected in the program usage line.
2015-01-20 16:50:37 +00:00
.It Fl t
Sort files by last file status/modification time instead of by name.
.It Fl U
Keep the list unsorted.
Implement -u support for ls(1)
2015-02-18 16:29:46 +00:00
.It Fl u
Use file's last access time instead of last modification time for
sorting or printing.
ls: Implement -c and update manpage Update usage + README as well. Apparently some of the options ( -H and -L) had already been implemented but not reflected in the program usage line.
2015-01-20 16:50:37 +00:00
.El
.Sh SEE ALSO
.Xr stat 2
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1.
2015-03-27 16:22:48 +00:00
.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.
Reference in New Issue Copy Permalink