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 relative 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.