Aardvark Shell Utils v1.0
Dec. 23, 2003

The Aardvark Shell Utils is a collection of 3 (currently) utilities designed
to aid the user when working with shell scripts, or from the shell command
line. All three accept their input on the command line, or from standard
input, and thus they can be piped (|) with other commands.

All commands come with their own man page.

All code herein is provided free under the GPL. See "Copying" for more
information.


REALPATH(1)

Realpath is an implementation of the realpath(3) function for 
returning the canonicalized absolute pathname of an input path.

Essentially this means it returns the path with all '.' and '..' charcters
removed and all symlinks resolved.

Please see the included manpage in the man/ dir for more info.

You will need a system with a realpath(3) function. (This is pretty standard
ANSI C stuff.)

It is possible that your realpath(3) call will not return an absolute path in
some circumstances (reports of Solaris behaving like this have surfaced). If
you find this and would like to help make realpath work the same on your
platform please email me <software@laffeycomputer.com>. Most likely you will
instead have a resolvepath(2) call that does the same thing (or similar).


FILEBASE(1)

Filebase returns the base portion of a filename, that is the filename with
its extension (e.g. .txt) removed. It works by returning everything preceeding
the last period in the input string. The period itself is not returned.


FILEEXT(1)

Fileext returns the extension portion of a filename (e.g. txt). It works by
returning everything following the last period in the input string. The 
period itself is not returned.



Note: All command names are lowercase. Capitals are used above only for
emphasis or English clarity.

Please report bugs to <software@laffeycomputer.com>


