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.