Subject: Re: bug#31135: 26.1; documentation of left-word and right-word are unclear

From: Eli Zaretskii <[email-masked]>
Date: Thu, 12 Apr 2018 19:51:10 +0300

> From: Robert Pluim <[email-masked]>
> Date: Thu, 12 Apr 2018 18:21:37 +0200
> 
> The documentation strings for left-word and right-word both say:
> 
>   Value is normally t.
>   If an edge of the buffer or a field boundary is reached, point is left there
>   there and the function returns nil.  Field boundaries are not noticed
> 
> 
> 1. Which value is normally t?

This is standard Emacs parlance: left-word is a function, and
functions generally return values in Lisp.  So when we say "value is"
in the doc string of a function, we mean the value returned by that
function.

> 2. 'there' is repeated in the second sentence.

This kind of stuff needs to be fixed, no need to report it.

Thanks.