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