Re: trunk r112909: * doc/lispref/files.texi (File Attributes): Fix typo.

[Glenn Morris]

Xue Fuqiao wrote:

> +     * files.texi (File Attributes): Fix typo.
[...]
> --- a/doc/lispref/files.texi  2013-02-24 19:45:17 +0000
> +++ b/doc/lispref/files.texi  2013-06-10 11:19:12 +0000
> @@ -1166,11 +1166,11 @@
>  levels of parent directories.
>  
>  @defun file-nlinks filename
> -This functions returns the number of names (i.e., hard links) that
> -file @var{filename} has.  If the file does not exist, then this function
> -returns @code{nil}.  Note that symbolic links have no effect on this
> -function, because they are not considered to be names of the files they
> -link to.
> +This function returns the number of names (i.e., hard link(s) + 1)
> +that file @var{filename} has.  If the file does not exist, then this
> +function returns @code{nil}.  Note that symbolic links have no effect
> +on this function, because they are not considered to be names of the
> +files they link to.


I disagree with this change, and with classing it as a typo.

mkdir /tmp/foo
cd /tmp/foo
touch 1
ln 1 2

stat 1
   -> Links: 2

find . -links 1 -type f
   # no results
find . -links 2 -type f
./2
./1

(file-nlinks "/tmp/foo/1")   ; -> 2