Re: [NEW PATCH] mouse-1 click follows link

[Richard Stallman <rms@gnu.org>]

    > It is not just historical reasons.  Mouse-2 fits in better with the
    > usual Emacs mouse bindings than Mouse-1.  We've decided to give higher
    > priority to compatibility with other programs, at the cost of fitting
    > in not quite as well.

    Should I mention that in the manual?

There's no need for the manual to concern itself with previous
versions of Emacs except in the Antinews section.  However, explaining
briefly the motivation for what the current version does is useful
when it is interesting to the reader.  So if you see a reason/occasion
to do that, please try it.

    > I suggest you grep for Mouse-2 and for Mouse-1, and change the places
    > that need changing.

    What should I change them to?

That question has no general answer.  How to change the text depends, in
each case, on the details of the situation.

    Should I mention both Mouse-1 and Mouse-2?

Probably in most cases only Mouse-1.  But it partly depends
on what reads well and what would be interesting to the reader.

    Should I mention mouse-1-click-follows-link (every time)?

It would be boring and wasteful to repeat it in each of these places
where Mouse-1 gets a brief mention.  Rather, find one central place to
talk about this option.  Perhaps the section that explains the basic
general mouse commands could also talk about the convention for mouse
link following and the options that affect it.

    Should I mention that a long mouse-1 click still sets point
    (depending on the setting of mouse-1-click-follows-link)?

Try to put that in the one general explanation and see if it works.