[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [PATCH 5/6] doc: clarify current realpath --relative-base behavior

From: Eric Blake
Subject: Re: [PATCH 5/6] doc: clarify current realpath --relative-base behavior
Date: Tue, 20 Mar 2012 10:29:46 -0600
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:10.0.1) Gecko/20120216 Thunderbird/10.0.1

On 03/14/2012 02:38 PM, Eric Blake wrote:
> For compatibility with MacOS relpath(1), as seen here:
> 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.
> ---
> The git pre-commit hook gave me grief, as the URL is longer than 72
> columns.  I'm not sure if you want the longer URL intact when pushing
> this upstream, by forcefully bypassing the hook.
>  doc/coreutils.texi |    4 +++-
>  1 files changed, 3 insertions(+), 1 deletions(-)
> diff --git a/doc/coreutils.texi b/doc/coreutils.texi
> index 835c245..10be715 100644
> --- a/doc/coreutils.texi
> +++ b/doc/coreutils.texi
> @@ -12905,7 +12905,9 @@ realpath invocation
>  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:

I've gone ahead and pushed this.

Eric Blake   address@hidden    +1-919-301-3266
Libvirt virtualization library

Attachment: signature.asc
Description: OpenPGP digital signature

reply via email to

[Prev in Thread] Current Thread [Next in Thread]