HELP LS                                          John Williams, Nov 1992

    _______<ENTER> ls [ -_____flags ] [ _________filenames ]

This command provides a Ved interface to the Unix __ls command, for
listing directories. The output of the __ls command is displayed in a
temporary Ved file, whose name is 'ls ' followed by that of the
directory being listed.

_______<ENTER> ls works just like the Unix __ls, except that by default only one
filename is listed on each line of the output file. You can get a multi-
column directory listing by using the -C flag, like this:

    _______<ENTER> ls -C

You can use any of the standard Unix __ls options, for example, the
command:

    _______<ENTER> ls -lt foo

will list all the files in the directory ___foo in long format, with the
most recently modified at the top of the output file. The full set of
options to __ls are described in the Unix manual pages for __ls, which you
can read without leaving Poplog by doing _______<ENTER> man ls.

Please note that the _______<ENTER> ls command is only available on Unix-based
Poplog systems. The VMS equivalent is _______<ENTER> dir.


Examining the listed files and directories
------------------------------------------

Any line of output from the Unix __ls command that is just a single file
or directory name will be converted by Ved into a `hot link' to that
file or directory. Activating the link (by positioning the text cursor
and typing ESC-h, or with the mouse in Xved) will cause the file to be
edited, or the directory to be listed. In the latter case the new
directory listing is inserted into the current listing (indented two
columns to the right).

Users of Xved on a colour monitor will notice that hot links to
files are coloured blue, and hot links to directories are coloured
green.


Related Files
-------------

____HELP * _____SHELL            General introduction to Unix for Poplog users
____HELP * _____PURGE            Ved utility for purging and deleting files

___LIB * ______VED_LS            Source code for the _______<ENTER> ls command
___MAN * __LS                Unix manual pages for __ls
____HELP * ___MAN              Documents the _______<ENTER> man command


--- _____________C.all/help/ls
--- _________Copyright __________University __of ______Sussex _____1996. ___All ______rights _________reserved.
