Changeset View
Changeset View
Standalone View
Standalone View
bin/ls/ls.1
Show All 26 Lines | |||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" @(#)ls.1 8.7 (Berkeley) 7/29/94 | .\" @(#)ls.1 8.7 (Berkeley) 7/29/94 | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd August 31, 2020 | .Dd July 11, 2022 | ||||
.Dt LS 1 | .Dt LS 1 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm ls | .Nm ls | ||||
.Nd list directory contents | .Nd list directory contents | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1\&, | .Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuvwxy1\&, | ||||
.Op Fl -color Ns = Ns Ar when | .Op Fl -color Ns = Ns Ar when | ||||
.Op Fl D Ar format | .Op Fl D Ar format | ||||
.Op Ar | .Op Ar | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
For each operand that names a | For each operand that names a | ||||
.Ar file | .Ar file | ||||
of a type other than | of a type other than | ||||
directory, | directory, | ||||
▲ Show 20 Lines • Show All 342 Lines • ▼ Show 20 Lines | |||||
same modification timestamp. | same modification timestamp. | ||||
.It Fl u | .It Fl u | ||||
Use time of last access, | Use time of last access, | ||||
instead of time of last modification | instead of time of last modification | ||||
of the file for sorting | of the file for sorting | ||||
.Pq Fl t | .Pq Fl t | ||||
or printing | or printing | ||||
.Pq Fl l . | .Pq Fl l . | ||||
.It Fl v | |||||
Sort by natural ordering (using | |||||
.Xr strverscmp 3 | |||||
instead of | |||||
.Xr strcoll 3 | |||||
as the comparison function). | |||||
pauamma_gundo.com: I'd explain here instead, perhaps with examples. Sending the reader to library manual pages… | |||||
obiwac_gmail.comAuthorUnsubmitted Done Inline ActionsGotcha, that makes sense obiwac_gmail.com: Gotcha, that makes sense | |||||
.It Fl w | .It Fl w | ||||
Force raw printing of non-printable characters. | Force raw printing of non-printable characters. | ||||
This is the default | This is the default | ||||
when output is not to a terminal. | when output is not to a terminal. | ||||
This option is not defined in | This option is not defined in | ||||
.St -p1003.1-2001 . | .St -p1003.1-2001 . | ||||
.It Fl x | .It Fl x | ||||
The same as | The same as | ||||
▲ Show 20 Lines • Show All 487 Lines • ▼ Show 20 Lines | |||||
.Fl o , | .Fl o , | ||||
the | the | ||||
.Nm | .Nm | ||||
utility conforms to | utility conforms to | ||||
.St -p1003.1-2001 | .St -p1003.1-2001 | ||||
and | and | ||||
.St -p1003.1-2008 . | .St -p1003.1-2008 . | ||||
The options | The options | ||||
.Fl B , D , G , I , T , U , W , Z , b , h , w , y | .Fl B , D , G , I , T , U , W , Z , b , h , v , w , y | ||||
and | and | ||||
.Fl , | .Fl , | ||||
are non-standard extensions. | are non-standard extensions. | ||||
.Pp | .Pp | ||||
The ACL support is compatible with | The ACL support is compatible with | ||||
.Tn IEEE | .Tn IEEE | ||||
Std\~1003.2c | Std\~1003.2c | ||||
.Pq Dq Tn POSIX Ns .2c | .Pq Dq Tn POSIX Ns .2c | ||||
Show All 23 Lines |
I'd explain here instead, perhaps with examples. Sending the reader to library manual pages they may not be able to puzzle out easily or at all will only discourage them.