easy-menu Info documentation lacking

[MON KEY]

easy-menu.el really ought to have *some* sort of documentation in the
Elisp/Emacs .infos At the very least the lack of Info documentation
belies the library's name :P

The earliest reference of easy-menu I was able to find in the change logs is at:
1994-04-11  Richard Stallman  (address@hidden)

Including easy-menu documentation with Info may not be a task which
can be well mediated by relative newcomers to Emacs.  It seems that
there may have been some historical complications/kludges that might
have encouraged integration of easy-menu integration in the Infos. A
cursory glance through the archives indicates that there are some low
level decisions re: easy-menu behavior that would be best documented
(or not) by those with first hand knowledge of the library and which
parts deserve elucidation.

With Emacs' move to GTK+ as the default toolkit, increased image/font
support etc. there appears to be a collective indication in the
libraries of a move to a slightly more `GUI' oriented Emacs.  For
example, doc-view's .pdf integration and set-slice-using-mouse is
indicative of this general trend.  Now is prob. a good time to
consider inclusion of some more formal lip service to easy-menu
usage/examples.  As Emacs continues toward GUI integration it will be
increasingly important that there be some sort of guidance vis a vis
Emacs menu integration and `best practices'. This area should be
fleshed out formally.  While I can certainly appreciate a hesitancy to
promote heavy menu integration in Emacs esp. in lieu of existing
alternatives more in line with Emacs kbd based approach, there *does*
appear to be a real need for their use beyond simple `GUI convenience
features'.  Consider that Emacs 23.xx easy-menu functions are
invoked/referenced by the following libraries (some not
insignificant):

/lisp
ldefs-boot.el
loaddefs.el
mouse.el
doc-view.el
vc-hg.el
info.el
diff-mode.el
tmm.el
hexl.el
allout.el
woman.el
wid-browse.el
vc-annotate.el
speedbar.el
smerge-mode.el
ses.el
recentf.el
proced.el
printing.el
pcvs-defs.el
log-view.el
log-edit.el
help-mode.el
follow.el
cvs-status.el
cus-edit.el
calculator.el

/emacs-lisp
edebug.el
find-func.el
checkdoc.el

/net
eudc.el
eudc-hotlist.el
eudc-bob.el

/mh-e
mh-show.el
mh-search.el
mh-letter.el
mh-identity.el
mh-folder.el
mh-comp.el

/nxml
rng-nxml.el

/org
org-agenda.el
org.el
org-table.el
org-colview.el

/play
5x5.el

/progmodes
ebrowse.el
python.el
cc-mode.el
cc-langs.el
hideif.el
cperl-mode.el
vhdl-mode.el
verilog-mode.el
vera-mode.el
tcl.el
prolog.el
octave-mod.el
idlwave.el
fortran.el
f90.el
antlr-mode.el
ada-mode.el
sql.el
ps-mode.el
meta-mode.el
idlw-shell.el
idlw-help.el
hideshow.el
ada-xref.el

/textmodes
bibtex.el
table.el
texinfo.el
reftex.el
reftex-toc.el
reftex-index.el
dns-mode.el

/term
ns-win.el

/calc
calc-menu.el

/erc
erc-menu.el

/gnus
gnus-agent.el
gnus-art.el
gnus-diary.el
gnus-draft.el
gnus-eform.el
gnus-group.el
gnus-ml.el
gnus-salt.el
gnus-srvr.el
gnus-sum.el
gnus-topic.el
message.el
mml.el
score-mode.el
sieve-mode.el
sieve.el

/calendar
todo-mode.el
cal-menu.el
calendar.el