diff options
author | David Nusinow <dnusinow@debian.org> | 2006-05-30 02:29:27 +0000 |
---|---|---|
committer | David Nusinow <dnusinow@debian.org> | 2006-05-30 02:29:27 +0000 |
commit | 0836575e61e03f4bd9623f19dab9de4b2d0861f7 (patch) | |
tree | 2d567bc929cf5078b083636dfbfd5d9c5f48e1e0 /imake/revpath.man | |
parent | 2b146c96244d7f63f3e619d060606917f0bf66a5 (diff) | |
download | xutils-dev-0836575e61e03f4bd9623f19dab9de4b2d0861f7.tar.gz |
Move all xutils-dev working dirs to use svn best practices
Diffstat (limited to 'imake/revpath.man')
-rw-r--r-- | imake/revpath.man | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/imake/revpath.man b/imake/revpath.man new file mode 100644 index 0000000..5b9cace --- /dev/null +++ b/imake/revpath.man @@ -0,0 +1,45 @@ +.\" $XFree86: xc/config/util/revpath.man,v 1.1 1999/01/03 03:58:14 dawes Exp $ +.TH REVPATH 1 __vendorversion__ +.SH NAME +revpath \- generate a relative path that can be used to undo a change-directory +.SH SYNOPSIS +.B revpath +.I path +.SH DESCRIPTION +The +.I revpath +program prints out a relative path that is the ``reverse'' or ``inverse'' of +.IR path . +Start with two directories +.I top +and +.IR bottom , +with the latter below the former, and +.I path +is the location of +.I bottom +relative to +.IR top . +The output of +.I revpath +is the location of +.I top +relative to +.IR bottom . +The resulting path contains a trailing `/' character when the result is +non-trivial. +If +.I path +is equivalent to `.', the resulting output is empty. +If +.I 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. +.SH DIAGNOSTICS +There are no diagnostics. Error conditions are silently ignored, and the +exit status is always 0. +.SH BUGS +It isn't possible to reverse arbitrary relative paths. +If any path element between the two end points of +.I path +is a symbolic link, the results will probably be incorrect. |