Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP
Path: utzoo!mnetor!uunet!husc6!necntc!ncoast!allbery
From: robertd@ncoast.UUCP (Rob DeMarco)
Newsgroups: comp.sources.misc
Subject: ils manual pages
Message-ID: <4525@ncoast.UUCP>
Date: Mon, 14-Sep-87 21:13:30 EDT
Article-I.D.: ncoast.4525
Posted: Mon Sep 14 21:13:30 1987
Date-Received: Wed, 16-Sep-87 02:18:25 EDT
Sender: allbery@ncoast.UUCP
Organization: Cleveland Public Access UN*X, Cleveland, Oh
Lines: 220
Approved: allbery@ncoast.UUCP
X-Archive: comp.sources.misc/8709/8


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")