summaryrefslogtreecommitdiffstats
path: root/system/Sl/Sl.1
blob: 2bf8b8e26c6b4138cd898e34a40bb12d3518d5ee (plain)
.\" Man page generated from reStructuredText.
.
.TH SL 1 "2020-11-13" "1.1.3" "SlackBuilds.org"
.SH NAME
Sl \- ls with enhancements
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\" RST source for Sl(1) man page. Convert with:
.
.\" rst2man.py Sl.rst > Sl.1
.
.\" rst2man.py comes from the SBo development/docutils package.
.
.SH SYNOPSIS
.sp
Sl [\fB\-1\fP] [\fB\-a\fP] [\fB\-atime\fP] [\fB\-only\fP] [\fB\-startup\fP] \fIstartup\-file\fP [\fB\-width\fP] \fIterminal\-width\fP [\fB\-log\fP] [\fB\-version\fP]
.SH SBO NOTE
.sp
\fBSl\fP may also be run as \fBsl\fP, unless \fIgames/sl\fP is installed. The
documentation here uses the lowercase version of the name.
.SH DESCRIPTION
.sp
sl takes the most common use of Unix ls, to display the files in a
directory compactly in multiple columns, and makes it substantially
more useful.
.sp
sl groups files by purpose so you can mentally organize many files
quickly; for instance, it collects HTML and PHP files together, as
opposed to leaving them mixed up with supporting images, CSS, and
JavaScript. sl points out interesting files, which include those that
have been recently modified, read relatively recently, are relatively
large, have warnings, or need to be checked in to or out of version
control.
.sp
sl is also aesthetically pleasing due to attention to layout and
filtering as well as limiting color and text annotations to salient
information.
.SH OPTIONS
.INDENT 0.0
.TP
.B \fB\-1\fP
Single column output (same as ls)
.TP
.B \fB\-a\fP
Show hidden (dot) files (same as ls)
.TP
.B \fB\-atime\fP
Use access time instead of modification time, for marking "recent" files.
.TP
.B \fB\-only\fP
Don\(aqt show summary (e.g. "6 files, 11K") at the end of the output
.TP
.B \fB\-startup\fP \fIfile.tcl\fP
Use this startup file instead of \fI~/.sl.tcl\fP\&.
.TP
.B \fB\-width\fP \fIterminal\-width\fP
Assume the terminal is this many columns wide. Default is to query the
terminal via \fBstty(1)\fP, or the \fB$COLUMNS\fP environment variable.
.TP
.B \fB\-log\fP
Print some debugging info (probably only useful if you\(aqre hacking sl\(aqs code)
.TP
.B \fB\-version\fP
Output version number
.UNINDENT
.SH FILES
.INDENT 0.0
.TP
.B \fB~/.sl.tcl\fP
Startup file. See /usr/doc/Sl\-1.1.3/sl.tcl.example.
.UNINDENT
.SH COPYRIGHT
.sp
sl is licensed under the GNU Public License version 3.
.SH AUTHORS
.sp
sl was written by Tom Phelps.
.sp
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
.SH SEE ALSO
.sp
The complete documentation: /usr/doc/Sl\-1.1.3/README.upstream
.\" Generated by docutils manpage writer.
.