==============================================================================
LN  Version 1.3							   May 23 1994
==============================================================================


DESCRIPTION

ln(1) creates symbolic links or copies the original file if you don't use
the `s' or `t' option of ln(1).  A template type (specified with the `t'
option of ln(1)) is treated as a file name if it contains a slash, colon or
dot.  Template files will be searched first in the current working directory
and then in the directories listed in the environment variable `DPATH'.  The
directories `/usr/lib' and `/usr/local/lib' will be visited if this variable
is not set.  A template type constructs a file name of the form `ln.<type>'
and such a file name will not be searched in the current working directory
-- got it?


TEMPLATE FILES

ln.exec: Template file for links to executables.

ln.pack: Template file for executing compressed files.  It is assumed that
the program is packed with gzip(1), because this is the best compressing
utility known at present.


EXAMPLES

This command creates a symbolic link from `bar' to `foo':

	ln -s foo bar

Note: Symbolic links make no sense if you have no file system supporting it.
Thus, you have to use a template file for executables until IBM releases the
code of its drivers and a hacker changes it to support this feature.  The
recommended command for linking executables for now is:

	ln -t exec foo.exe bar.exe

You can prepare gzip'ed programs with the following two commands (the `t'
option does not imply the `s' option, but a combination is possible):

	gzip -9 hack.exe
	ln -t pack hack.exe.gz hack.exe


THINGS TO KNOW

As it is the nature of symbolic links, they must be updated if the file a
link is pointing to was moved.  All links created with this ln(1) preserve
the read and write permission of the original file.  Final note: doing hard
links is not very (disk space) efficient with OS/2.

The binaries of ln(1) were compiled with GNU CC 2.6.3 and the emx kit version
0.9a by Eberhard Mattes.  Thus, you must have `emxrt.zip' for using it.  You
can get it from most ftp-sites, e.g. ftp.uni-stuttgart.de [129.69.1.12] and
it is on the Hobbes CD, too.  gzip(1) is available from simply everywhere.


The author of ln(1) for OS/2 is

Ralph Schleicher
rs@purple.in-ulm.de
