<jwZ@lucid.com> writes:
   We have been trying to stay consistent with the following guidelines:
	   button1 moves point
	   button2 "selects" or "opens"
	   button3 pops up a menu of all your choices
   It would be good if others could try to be consistent with this as well,
   because otherwise nobody will ever know what their mouse is likely to do
   from one mode to another.

Well, as I mentioned before on this list, Hyperbole already provides
mouse handling for many modes.  I believe it pre-dates Lucid Emacs and
runs across all GNU Emacs version and window systems, so people should
try to stay compatible with it.  It is also pretty easy to configure
to your needs.  The basics are:

	   button1 moves point
	   button2 (primary smart key) acts on items (can also pop up a menu)
	   button3 (secondary smart key) provides help or does the inverse of button2

For example, a button2 click at the end of a line scrolls forward a page
and a button3 click scrolls backward.

I'll mail out the updates to make Hyperbole work with Lucid Emacs today.
In the mean time, here's the complete help summary (also provided by button3)
of what the smart keys do, so that people DO know what their keys do:

==============================================================================
Context                                     Smart Key
                                Primary                    Secondary
==============================================================================
Hyperbole
  On a menu item                Item is activated          Item help
  On an explicit button         Button is activated        Button help
  Reading argument
    1st press at an arg value   Value copied to minibuffer <- same
    2nd press at an arg value   Value used as argument     <- same
    In minibuffer               Minibuf arg is applied     Completion help
  On an implicit button         Button is activated        Button help
  Wrolo Match Buffer            Toggles narrow to one entry and edits entries

Screen Control
  Line end, not end of buffer   Scrolls up a windowful     Scrolls down
  End of Any Help buffer        Screen restored to previous state

Special Modes
  C Mode                        Jumps to id def            Jumps to next def
  Any Lisp mode                 Jumps to id def            Jumps to next def
  Occur match                   Jumps to match source line <- same
  Multi-buffer occur match      Jumps to match source line <- same
  Outline Major/Minor Modes     Collapses, expands, and moves outline entries
  Man Apropos                   Displays man page entry    <- same
  Man Pages                     Follows cross refs, file refs and C code refs
  Buffer Menu                   Saves, deletes and displays buffers

Emacs Info Reader
  Menu Entry or Cross Ref       Jumps to referent          <- same
  Up, Next or Prev Header       Jumps to referent          Jumps to prior node
  File entry of Header          Jumps to top node          Jumps to (DIR) node
  End of current node           Jumps to next node         Jumps to prev node
  Anywhere else                 Scrolls up a windowful     Scrolls down a wind

Subsystems
  Calendar                      Scrolls or shows appts  Scrolls or marks dates
  Dired Mode                    Views and deletes files from directory listing
  GNUS News Reader              Toggles group subscriptions, gets new news,
                                  and browses articles
  Mail reader and Summaries     Browses, deletes and expunges messages

Any other context (defaults)    Hyperbole top menu      Smart Key summary
==============================================================================

x-gateway: rodan.UU.NET from help-lucid-emacs to alt.lucid-emacs.help; Wed, 26 Aug 1992 14:16:25 EDT
Date: Wed, 26 Aug 1992 20:14:54 +0200
From: ssos006%hebe.ccvr.fr@lucid.com (ccvr__MERCIER_Claude)
Subject: sorry
Newsgroups: alt.lucid-emacs.help