Improve function-alias-p documentation

* doc/lispref/functions.texi (Defining Functions): Improve the text.

diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi
index f2dce71e96cbeec01a6485fc5ce04d3ae89da158..2378e9efd7ea182c6c7994874bcf39a7beff8dc8 100644 (file)
--- 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)