From a6342a320eebe522c42399733c8bb6be88749368 Mon Sep 17 00:00:00 2001 From: Eric Blake Date: Wed, 14 Mar 2012 14:02:59 -0600 Subject: doc: clarify current realpath --relative-base behavior For compatibility with MacOS relpath(1), as seen here: http://opensource.apple.com/source/bootstrap_cmds/\ bootstrap_cmds-79/relpath.tproj/relpath.c we implemented 'realpath --relative-base=dir1 --relative-to=dir2 file' in the same way as 'relpath -d dir1 dir2 file'. This can result in --relative-base rendering --relative-to as a no-op if dir1 is a child of dir2. Document this. * doc/coreutils.texi (realpath invocation): Mention restriction. --- doc/coreutils.texi | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 835c245d4..10be7156b 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -12905,7 +12905,9 @@ This option is valid when used with @option{--relative-to}, and will restrict the output of @option{--relative-to} so that relative names are output, only when @var{file}s are descendants of @var{base}. Otherwise output the absolute file name. If @option{--relative-to} was not specified, then -the descendants of @var{base} are printed relative to @var{base}. +the descendants of @var{base} are printed relative to @var{base}. If +@option{--relative-to} is specified, then that directory must be a +descendant of @var{base} for this option to have an effect. Note: this option honors the @option{-m} and @option{-e} options pertaining to file existence. For example: -- cgit v1.2.1