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.