robertd@ncoast.UUCP (Rob DeMarco) (09/15/87)
This is ils documentation:
nroff -man ils.man
----cut here----
.TH ILS 1 LOCAL
.SH NAME
.B ils
\- enhanced
.B ls
.SH SYNOPSIS
.B ils
.I "[start options]" "[file/dir/switchable options]"
.SH DESCRIPTION
.B ils
is an enhanced version of
.B ls.
It displays files in
this format:
.B
999 9999 9999 foo.bar
^ ^ ^ ^
.B
lines words char. file
It tells the number of lines, words, and characters of a file,
respectively. A directory displays "
.B <DIR>
" in the middle of
where the lines, words, and characters would be.
This program has "
.B
switchable parameters.
" It also has "
.B
starter parameters.
" The starter
parameters may only appear at the beginning of the command
line. Once it encounters a file or directory, no more starter
parameters will be accepted. Switchable parameters can be set
and unset within the course of the command line.
.B STARTER PARAMETER OPTIONS
.RS 6
.B -80
Display information in 80 column format.
.B -pager n
Display files while pausing every n lines.
WARNING: If used in conjunction with
.B -80
on a 40 column screen, you will not get
the desired result.
.B -silent
Invokes silent mode when
.BR -exec ing
a directory.
.RE
.B SWITCHABLE PARAMETER OPTIONS
.RS 6
.B -contents
For the following directories viewed,
.B ils
will show the
.I
contents
of the directory.
This condition is terminated upon
execution of
.B +contents.
.B +contents
Shuts off the contents switch.
All directories will be displayed
literally.
.B -exec
The following files will be executed and
there status information printed. If it
encounters a directory and
.B -contents
flag is set, it will execute ALL files
in that directory and give status
information.If it is a directory and
the
.B -contents
flag is NOT set or it is
reset by
.B +contents
then it will make
the current directory that directory.
It will also display the directory.
You can filter out the display by
specifying
.B -silent
at the beginning of the
command line. This is useful when
you have several files in a directory
that takes MANY pathnames to reach.
.B +exec
Resets the exec flag.
.RE
As you can see, there many options. These examples should
help you understand them:
.RE 1
$
.B ils
Lists directory.
$
.B ils /bin
Lists /bin directory.
$
.B ils foo.bar
Lists foo.bar file.
$
.B ils foo.bar foo.dir
Lists a file and directory.
$
.B ils -pager 24
Lists directory and pauses every 23 lines.
$
.B ils -pager 24 -80
Lists directory in 24x80 format.
$
.B ils -contents foo.dir
Lists contents of directory foo.dir.
$
.B ils -contents foo.dir +contents dir
Lists contents of foo.dir; lists dir.
$
.B ils -exec a.out
Executes and lists file a.out with status information.
$
.B ils -contents -exec foo.dir
Executes everything in foo.dir and prints status information.
$
.B ils -exec foo.dir [A]* `pwd` "+exec L"
Changes cwd to foo.dir and executes all files beginning with A.
It then changes back `pwd`.It then encounters +exec which
shuts off the exec switch. It will display L normally.
$
.B "ils -silent -exec foo.dir A B +exec [c]*"
Invokes silent mode. When changing to foo.dir , you will not
see a directory listing. It then executes A and B in
that directory and prints status information.Then
.B -exec
flag is shut off. It
.I lists
all files beginning with "c".
.SH
.B BUGS
.RS 6
If you don't have read access to a certain file,
.B ils
will
report an error and go on.
If you start a
.B +switch
before a file,
.B ils
will confuse it for
a file and (most likely) report an error message. Any file
beginning with
.B -
will be ignored.
----cut here----
[> Rd
--
North Coast Computer Resources(ncoast) - 216-781-6201 (or 781-6202)
UUCP:decvax!cwruecmp!ncoast!robertd
Sysop: NEODG (login "sbbs")