xfree86 man page for revpath

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)