master 9cc1344c9f: Improve function-alias-p documentation

[Lars Ingebrigtsen]

branch: master
commit 9cc1344c9fbec39cf193a745e2720f1e008ff2f6
Author: Robert Pluim <rpluim@gmail.com>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    Improve function-alias-p documentation
    
    * doc/lispref/functions.texi (Defining Functions): Improve the text.
---
 doc/lispref/functions.texi | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi
index f2dce71e96..2378e9efd7 100644
--- a/doc/lispref/functions.texi
+++ b/doc/lispref/functions.texi
@@ -670,11 +670,10 @@ records.  @xref{Function Cells}.
 @end defun
 
 @defun function-alias-p object &optional noerror
-Use the @code{function-alias-p} function to check whether an object is
-a function alias.  If it isn't, this predicate will return
-@code{nil}.  If it is, the value returned will be a list of symbol
-representing the function alias chain.  For instance, if @code{a} is
-an alias for @code{b}, and @code{b} is an alias for @code{c}:
+Checks whether @var{object} is a function alias.  If it is, it returns
+a list of symbols representing the function alias chain, else
+@code{nil}.  For instance, if @code{a} is an alias for @code{b}, and
+@code{b} is an alias for @code{c}:
 
 @example
 (function-alias-p 'a)