bug#15117: 24.3.50; doc of `(forward|backward)-*': state return value

[Eli Zaretskii]

> Date: Tue, 11 Feb 2014 19:42:52 +0100
> From: Andreas Röhler <andreas.roehler@easy-emacs.de>
> 
> IMO these functions should return point if successful, i.e. if point was 
> moved, but nil otherwise, for example at EOB.

Why point?  E.g., forward-to-indentation could returns the column
where it ended up, forward-same-syntax could return the syntax class,
forward-visible-line could return the number of screen lines
traversed, etc.

Once again, the potentially useful value might well be different for
each function, and needs to be considered separately for each.
There's no "one fits all" here.