revpath(1) [xfree86 man page]

REVPATH(1)						      General Commands Manual							REVPATH(1)

NAME

       revpath - generate a relative path that can be used to undo a change-directory

SYNOPSIS

       revpath path

DESCRIPTION

       The  revpath program prints out a relative path that is the ``reverse'' or ``inverse'' of path.	Start with two directories top and bottom,
       with the latter below the former, and path is the location of bottom relative to top.  The output of revpath is the location of	top  rela-
       tive  to  bottom.   The resulting path contains a trailing `/' character when the result is non-trivial.  If path is equivalent to `.', the
       resulting output is empty.  If path is invalid in some way (e.g., doesn't represent the path to a subdirectory) the output  is  also  empty
       and no error messages are ever generated.

DIAGNOSTICS

       There are no diagnostics.  Error conditions are silently ignored, and the exit status is always 0.

BUGS

       It  isn't  possible  to	reverse  arbitrary relative paths.  If any path element between the two end points of path is a symbolic link, the
       results will probably be incorrect.

XFree86 							   Version 4.7.0							REVPATH(1)

SHTOOL-PATH.TMP(1)					      GNU Portable Shell Tool						SHTOOL-PATH.TMP(1)

NAME

       shtool-path - GNU shtool command dealing with shell path variables

SYNOPSIS

       shtool path [-s|--suppress] [-r|--reverse] [-d|--dirname] [-b|--basename] [-m|--magic] [-p|--path path] str [str ...]

DESCRIPTION

       This command deals with shell $PATH variables. It can find a program through one or more filenames given by one or more str arguments.  It
       prints the absolute filesystem path to the program displayed on "stdout" plus an exit code of 0 if it was really found.

OPTIONS

       The following command line options are available.

       -s, --suppress
	   Supress output. Useful to only test whether a program exists with the help of the return code.

       -r, --reverse
	   Transform a forward path to a subdirectory into a reverse path.

       -d, --dirname
	   Output the directory name of str.

       -b, --basename
	   Output the base name of str.

       -m, --magic
	   Enable advanced magic search for ""perl"" and ""cpp"".

       -p, --path path
	   Search in path. Default is to search in $PATH.

EXAMPLE

	#   shell script
	awk=`shtool path -p "${PATH}:." gawk nawk awk`
	perl=`shtool path -m perl`
	cpp=`shtool path -m cpp`
	revpath=`shtool path -r path/to/subdir`

HISTORY

       The GNU shtool path command was originally written by Ralf S.  Engelschall <rse@engelschall.com> in 1998 for Apache. It was later taken
       over into GNU shtool.

SEE ALSO

       shtool(1), which(1).

18-Jul-2008							   shtool 2.0.8 						SHTOOL-PATH.TMP(1)