bug#2515: 23.0.91; Documentation of clear-abbrev-table seems wrong

Please write in English if possible, because the Emacs maintainers
usually do not have translators to read other languages for them.

Your bug report will be posted to the [email protected] mailing list.

Please describe exactly what actions triggered the bug
and the precise symptoms of the bug:

I came across:

,----[ (info "(elisp)Abbrev Tables") ]
|  -- º¯Êý: clear-abbrev-table table
|      This function undefines all the abbrevs in abbrev table TABLE,
|      leaving it empty.  It always returns `nil'.
`----

However after experimenting with it, I have the impression that it
returns the number of abbrevs being cleared.

Please take a look at this.

Leo