From 9f5aa4850133976eee22dcc0b506d7b632cd674c Mon Sep 17 00:00:00 2001 From: Eric Blake Date: Wed, 14 Mar 2012 13:42:59 -0600 Subject: realpath: let --relative-to default to --relative-base Most of the time, if someone wants to filter which paths are relative while leaving all others absolute, they also want to to the filtering based on the same --relative-to directory. Make this easier to specify. * src/realpath.c (main): Convert error to default. * doc/coreutils.texi (realpath invocation): Document this. * tests/misc/realpath: Adjust test to match. * NEWS: Document it. --- doc/coreutils.texi | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) (limited to 'doc') diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 39c9bbf67..835c245d4 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -12904,14 +12904,16 @@ pertaining to file existence. 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. Note: this option honors the @option{-m} and @option{-e} +absolute file name. If @option{--relative-to} was not specified, then +the descendants of @var{base} are printed relative to @var{base}. +Note: this option honors the @option{-m} and @option{-e} options pertaining to file existence. For example: @example realpath --relative-to=/usr /tmp /usr/bin @result{} ../tmp @result{} bin -realpath --relative-base=/usr --relative-to=/usr /tmp /usr/bin +realpath --relative-base=/usr /tmp /usr/bin @result{} /tmp @result{} bin @end example -- cgit v1.2.3-70-g09d2