RE: Keybinding Patch gtags.el

[Stan Moore]

From: Shigio YAMAGUCHI [mailto:address@hidden
Sent: Wednesday, September 04, 2013 11:07 PM
> To: Stan Moore
> Cc: address@hidden
> Subject: Re: Keybinding Patch gtags.el
> 
> On Wed, 4 Sep 2013 20:58:52 -0400
> "Stan Moore" <address@hidden> wrote:
> 
> > Yes, it is wrong.  But this is what turns up when you google for a way
> > to get the keybindings to work. The original code only works when you
> > use the emacs customize interface. Many people don't use customize,
> > either by choice or ignorance, and attempt to set things up in .emacs.
> > The docs didn't make this situation clear so I spent some time trying
> > to get to keybindings setup with little success.  I actually spent
> > more time googling for a solution than I did reading the code and
> generating the patch.
> 
> OK. It seems that better (concrete) document is needed.
> I would like to show the example of recommendation of .emacs as a
> comment in gtags.el.
> How is it?

Sorry I can't create an actual patch right now but I would replace this;

;; (Policy of key mapping)
;; If 'gtags-suggested-key-mapping' is not set, any key mapping is not done.
;; If 'gtags-disable-pushy-mouse-mapping' is set, any mouse mapping is not
done.
;;

With something like this;

;; (Policy of key mapping)
;; Gtags examines 'gtags-suggested-key-mapping' when entering gtags-mode,
;; the default setting does not map any keys.  You can change the setting
through 
;; the customize interface or by setting the variable before entering
gtag-mode.
;;
;;To enable the suggested key mapping with gtags-mode minor mode in c-mode
;;you add this to your $HOME/.emacs.
;;
;; (add-hook 'c-mode-hook
;;    '(lambda ()
;;       (setq gtags-suggested-key-mapping t)
;;       (gtags-mode 1)
;; ))
;;
;;
;; If 'gtags-disable-pushy-mouse-mapping' is set, then no mouse mapping is
done.
;;

FWIW, I typically add stuff like this to c-mode-common-hook so it works for
c and c++ but that really is just a matter of personal preference.

I haven't played with 'gtags-disable-pushy-mouse-mapping'  but my patch
changed both settings. I think the previous example will be enough of a clue
to most users. I also suggest a change to make the wording flow a little
better.

Stan