The Gnome Documentation Style Gude says to refer to Left, Middle, and Right mouse buttons or clicks https://developer.gnome.org/gdp-style-guide/
KMymoney seems to use the same or similar convention https://kmymoney.org/documentation.php I know one of the things that generated the discussion was concern about tablets, touchpads, touchscreens or other non-mouse interactions... so I looked for the Android documentation style guide. My interpretation is they encourage writers to emphasize the task more than the mechanics. https://developers.google.com/style I had some more thoughts but I want to ponder them more carefully... And before I put my foot in my mouth... is there already a GnuCash documentation Style Guide, or some suggestions for writers? I vaguely recall seeing something, but I may be mistaken. On Sat, Oct 12, 2019 at 6:30 AM David Carlson <david.carlson....@gmail.com> wrote: > Are there examples in other major applications to compare to? > > > David Carlson > > On Fri, Oct 11, 2019, 11:33 PM D via gnucash-devel < > gnucash-devel@gnucash.org> wrote: > > > > > > > On October 12, 2019, at 3:45 AM, John Ralls <jra...@ceridwen.us> wrote: > > > > > > > >> On Oct 10, 2019, at 10:26 PM, David Cousens <davidcous...@bigpond.com > > > > wrote: > > >> > > >> Do we by any chance have some sort of standard description of mouse > > usage in > > >> GNuCash on the various OS. > > >> > > >> I am updating documentation. Docbooks has tags for description of > mouse > > >> operations. With configurable mouses for LH or RH operation terms > like > > Left > > >> Click and Right Click start to become ambiguous. DocBooks has tags for > > >> <mousebutton>. In a review of some recent changes Frank suggested > using > > >> Button1, Button2 and Button 3 rather than Left, Middle and Right to > > avoid > > >> the LH/RH mouse conundrum. I haven't been able to find anything in > the > > >> documentation re input devices but I could have missed it > > >> > > >> Two of my mice have 6 buttons and two scroll wheels (basic config is > a 2 > > >> button + central scroll/button) and another only has 2 buttons and a > > single > > >> scroll wheel/button. Linux Mint can configure that for LH operation, > > >> emulation of a centre button by pressing both buttons together, > > scrolling > > >> reversal and double click timeout and I presume most OSs will have > > something > > >> similar. Then we go to Macs and we have single buttons and magic mice > to > > >> contend with. Then there are tablets and touchpads and gestures. > GTK3 > > >> seems to support a wide range > > >> https://developer.gnome.org/gtk3/stable/chap-input-handling.html and > > does > > >> interpret the scroll wheel appropriately on my mice but the wheel > button > > >> inserts "another" each time it is pressed while editing a transaction > > in a > > >> register - not too useful. > > >> > > >> It is clearly far too onerous to describe all possible mice/input > > >> variations. > > >> > > >> My own preference would to perhaps settle on a fairly common 2 button > RH > > >> basic mouse and keyboard configuration and describe operations in > terms > > of > > >> that. Perhaps then offer in a wiki section some translations from this > > >> configuration to other configurations like track pads that could be > > >> populated by users. I think Left (Centre) Right for a RH mouse is > > likely to > > >> be far less confusing to translate than a "Button1 Button2, Button3 > > where > > >> it is totally ambiguous whether the mouse is LH RH or upside down. > > >> > > >David, > > >The middle-button behavior on Linux is an X-Windows thing: The right > > button begins a selection, the left button completes the selection, and > the > > middle button pastes the selection. I don't know if Wayland has that > > behavior as well. Gtk has a GdkSelection class to try to provide it on > > other Ones but it was implemented only partly on Windows and not at all > on > > MacOS. It's been deprecated for some time. > > >If you don't like "left click" or "click button 1", how about "primary > > click" and "secondary click"? You could even say "primary click/tap" to > > include the touchpad users. > > >I don't think that it's particularly useful for our documentation to try > > to teach users the basics of using their computers, and explaining > > everything at that level quickly gets tiresome for the majority of users > > who know how to click a button, select some text, or open a context menu. > > >Regards, > > >John Ralls > > >_______________________________________________ > > >gnucash-devel mailing list > > >gnucash-devel@gnucash.org > > >https://lists.gnucash.org/mailman/listinfo/gnucash-devel > > > > +1 to John's comments. > > > > I think it best to focus on the task, rather than the specific mechanics. > > > > David T. > > _______________________________________________ > > gnucash-devel mailing list > > gnucash-devel@gnucash.org > > https://lists.gnucash.org/mailman/listinfo/gnucash-devel > > > _______________________________________________ > gnucash-devel mailing list > gnucash-devel@gnucash.org > https://lists.gnucash.org/mailman/listinfo/gnucash-devel > _______________________________________________ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
