Re: realpath edge cases

[Assaf Gordon]

Hi,

On Sun, Jun 25, 2017 at 11:54:40PM -0700, Pádraig Brady wrote:
> On 24/06/17 17:02, Assaf Gordon wrote:

> > Second,
> > `realpath --help` shows:
> >   --relative-to=FILE       print the resolved path relative to FILE
> >   --relative-base=FILE     print absolute paths unless paths below FILE
> >
> > So perhaps just update the usage text? (patch attached).

> Yes this is clearer.
> Otherwise one might also think the FILE's directory is used.
> Please update the info doc also.

Attached are three patches for realpath's documentation:

 realpath: improve usage description for --relative-{to,base}
 doc: fix realpath index entry
 doc: add 'realpath usage examples' section

 doc/coreutils.texi | 103 +++++++++++++++++++++++++++++++++++++++++------------
 src/realpath.c     |   4 +--
 2 files changed, 83 insertions(+), 24 deletions(-)

The last one gives examples of the interaction between
--relative-to and --relative-base, and I hope it makes
them easier to understand.

Comments welcomed,
- assaf