From 99deaff7e804298cecc326142bbe7263e2576224 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?P=C3=A1draig=20Brady?= Date: Wed, 8 Feb 2017 20:45:32 -0800 Subject: doc: note the relationship between realpath and readlink * doc/coreutils.texi (realpath invocation): Mention that realpath is the preferred command for canonicalization. (readlink invocation): Likewise. * man/readlink.x: Likewise. --- doc/coreutils.texi | 8 +++++++- man/readlink.x | 2 ++ 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 629136b01..3eac96b7d 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -10260,7 +10260,8 @@ of a symbolic link, it produces no output and exits with a nonzero exit code. @command{readlink} outputs the absolute name of the given files which contain no @file{.}, @file{..} components nor any repeated separators -(@file{/}) or symbolic links. +(@file{/}) or symbolic links. Note the @command{realpath} command is the +preferred command to use for canonicalization. @xref{realpath invocation} @end table @@ -13685,6 +13686,11 @@ all but the last component of the specified files must exist. Synopsis: realpath [@var{option}]@dots{} @var{file}@dots{} @end example +The file name canonicalization functionality overlaps with that of the +@command{readlink} command. This is the preferred command for +canonicalization as it's a more suitable and standard name. In addition +this command supports relative file name processing functionality. + The program accepts the following options. Also see @ref{Common options}. @table @samp diff --git a/man/readlink.x b/man/readlink.x index 6b28bca47..3141cd253 100644 --- a/man/readlink.x +++ b/man/readlink.x @@ -2,5 +2,7 @@ readlink \- print resolved symbolic links or canonical file names [DESCRIPTION] .\" Add any additional description here +Note realpath(1) is the preferred command to use +for canonicalization functionality. [SEE ALSO] readlink(2), realpath(1), realpath(3) -- cgit v1.2.3