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

99 lines
2.2 KiB
Groff
Raw Normal View History

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
.Dd March 27, 2015
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 mandoc warnings - sort references in SEE ALSO section to section number, name. - cols.1: proper order of sections. - wrap lines to max 79 column length.
2015-01-31 13:43:27 +00:00
lists each given file, and the contents of each given directory. If no files
add ls; simpler pwd
2011-05-26 03:01:20 +00:00
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
ls: Clarify that -1 is set implicitly when -R is used
2015-02-21 11:47:37 +00:00
List directory content recursively. The
.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