incomplete doc for facemenu-set-underline and so on

[Drew Adams]

emacs -Q
Edit a text file with font-lock turned off.
C-h k and choose menu item Edit > Text Properties > Face > underline

Buffer *Help* shows:

 facemenu-set-underline is an interactive Lisp function.
 It is bound to M-o u, <C-down-mouse-2> <fc> u, <menu-bar>
 <edit> <props> <fc> u.
 (facemenu-set-underline)

 Select face `underline' for subsequent insertion.

1. This does not help you find the definition of the command.
There should be some kind of link to the source code:

 facemenu-set-underline is an interactive Lisp function in
 `facemenu.el'.

The implementation problem is that the command name is created by
program, in function facemenu-add-new-face. Nevertheless, there should
be some kind of link, preferably to the definition of
facemenu-add-new-face, where facemenu-set-underline is defined, but at
least to the proper source file, facemenu.el.

2. The doc string is incomplete. It should also say that if a
region is active, this command underlines its text.

The same goes for the other, similar, commands (bold etc.).


In GNU Emacs 22.0.50.1 (i386-msvc-nt5.1.2600)
 of 2006-07-19 on BOS-CTHEWLAP2
X server distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-msvc (12.00)'

Important settings:
  value of $LC_ALL: nil
  value of $LC_COLLATE: nil
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: nil
  value of $LANG: ENU
  locale-coding-system: cp1252
  default-enable-multibyte-characters: t