summaryrefslogtreecommitdiff
path: root/imake/revpath.man
diff options
context:
space:
mode:
authorDavid Nusinow <dnusinow@debian.org>2006-05-30 02:29:27 +0000
committerDavid Nusinow <dnusinow@debian.org>2006-05-30 02:29:27 +0000
commit0836575e61e03f4bd9623f19dab9de4b2d0861f7 (patch)
tree2d567bc929cf5078b083636dfbfd5d9c5f48e1e0 /imake/revpath.man
parent2b146c96244d7f63f3e619d060606917f0bf66a5 (diff)
downloadxutils-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.man45
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.