Re: [GNC-dev] Mouse usage in Gnucash
Frank, I think I have worked out how to make the keycap keysym and mousebutton tags bold without having to use the tags by creating mousebutton.xsl and keycap.xsl and having them included in general-customisation .xsl in the same way the guimenu.xsl bolded the menu items. I will go through and remove the emphasis tags from those elements where I have used them excessively and then check if it works OK. Agree about adding a common section to both docs with some interface guidlines to also translate mouse buttons to touchpad and simple touch screen conventions David - David Cousens -- Sent from: http://gnucash.1415818.n4.nabble.com/GnuCash-Dev-f1435356.html ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: [GNC-dev] Mouse usage in Gnucash
Hi David, Am Di., 15. Okt. 2019 um 23:14 Uhr schrieb David Cousens : > > Hi Frank, > > > Sorry I am referrring to the glossary currently in the guide. > > Ok found the 1.79.2/html/glossary.xsl but it is beyond my current > understanding of xsl processing to modify it. I am slowly getting the idea > but don't want to invest the time at tis point to get up to speed. I still do not understand, which problem you have with the glossary. The only current usage I was able to find, is ch_basics.xml:305: An account keeps track of what you own, If you open https://code.gnucash.org/docs/C/gnucash-guide/basics-entry1.html and go to 2.2.2. Accounts the first appearance of "account" in the first para is a link to the glossentry. > I'll add the appropriate references to the gnome hig in the > gnc-docbookx.dtd as you suggested. Right, but only the base URL, so can later use it for references to other sections, too. > David Frank ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: [GNC-dev] Mouse usage in Gnucash
Hi Frank, Sorry I am referrring to the glossary currently in the guide. Ok found the 1.79.2/html/glossary.xsl but it is beyond my current understanding of xsl processing to modify it. I am slowly getting the idea but don't want to invest the time at tis point to get up to speed. I'll add the appropriate references to the gnome hig in the gnc-docbookx.dtd as you suggested. David - David Cousens -- Sent from: http://gnucash.1415818.n4.nabble.com/GnuCash-Dev-f1435356.html ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: [GNC-dev] Mouse usage in Gnucash
Hi all, my main concern was against the use of 'Fat text', where more specific docbook elements exist. In between I have no strong opinion about "Left click" vs. "click Button1". It seems "Button n" makes the things gratuitous complex. Perhaps we should include a short common snippet "Conventions in this document" at the beginning of both docs, explaining we assume a right-hand configured mouse. Am So., 13. Okt. 2019 um 05:44 Uhr schrieb David Cousens : > > Thanks Tommy, > > The gnome developers guide is a useful read in any case apart from the mouse > specific issues. They seem to settle on the primary and secondary > descriptions in one place and then use the left-click right-click etc, > particularly in the glossary > (https://developer.gnome.org/gdp-style-guide/2.32/gdp-style-guide.html#gnome-glossary-user-actions) > description of user actions. It may be useful to link to this from the wiki > on udpdating the documentation( see below). Perhaps a glossary may be a > useful place to eventually include references/crossreferences to alternate > actions. > > The current docbook glossary Which? > is not terribly useful for html documents as it > simply displays a popup with the glossary term in it rather than the > definition part of the glossary entry which would be really useful. That > behavior could be altered by using some custon xslt processing in the build > but I don't have any expertise in that as yet. 1. For docbook/xml there is no build. 2. In theory it could be done in the xslt directory, which is mostly a two decades old copy of yelps xslt with a few modifications or updates - who knows. The versioned subdir is the official docbook xslt. > At present the glossary > exists only in the guide and not the help manual. There is a way of making a > common glossary available in both but it will require some alteration of the > build structure. I am avoiding that at the moment because I think it is more > important to update the documentation in a few areas where there were new > features in V3 and I don't have the expertise in the cmake and xslt > processing to do it easily at the moment. Right, that is a separate task. > This section is a pretty good guide to usage in developments and the > organization of GTK3 > https://developer.gnome.org/hig-book/unstable/input-mouse.html.en > particularly the table of mouse and keyboard equivalents. You saw also https://developer.gnome.org/hig-book/unstable/note-on-gnome3.html.en ? It is a GTK2 doc. They did until now not release a HIG3. > The GDK reference manual refers to Button 1,2,3 with 1 Left 2 Middle and 3 > Right but that is more related to usage in coding than in user > documentation. > > There is no style guide in the Gnome documentation guide sense but there is > the wiki on updating documentation > (https://wiki.gnucash.org/wiki/Documentation_Update_Instructions) but it > doesn't refer to mouse interaction descrptions. > > My inclination is to stay with left click, right click descriptions as for > a two button mouse for the moment. It is probably more important to be > consistent rather than totally compliant with being as general as possible. > I think some general reference to the GTK3 input-mouse.html document would > be useful as all the intefaces are based on it as well as > https://developer.gnome.org/hig/stable/pointer-and-touch-input.html.en bu > that is problematical as these are external references. It is no problem to define https://developer.gnome.org/;> in gnc-docbookx.dtd. I am collecting others used in the texts: gnu wikipedia as orgs, alphavantage, yahoo as coms... > If it is desired to change this a global search and replace can always be > used and much of the current documentation uses a left click, right click > convention yes > David Frank ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: [GNC-dev] Mouse usage in Gnucash
Thanks Tommy, The gnome developers guide is a useful read in any case apart from the mouse specific issues. They seem to settle on the primary and secondary descriptions in one place and then use the left-click right-click etc, particularly in the glossary (https://developer.gnome.org/gdp-style-guide/2.32/gdp-style-guide.html#gnome-glossary-user-actions) description of user actions. It may be useful to link to this from the wiki on udpdating the documentation( see below). Perhaps a glossary may be a useful place to eventually include references/crossreferences to alternate actions. The current docbook glossary is not terribly useful for html documents as it simply displays a popup with the glossary term in it rather than the definition part of the glossary entry which would be really useful. That behavior could be altered by using some custon xslt processing in the build but I don't have any expertise in that as yet. At present the glossary exists only in the guide and not the help manual. There is a way of making a common glossary available in both but it will require some alteration of the build structure. I am avoiding that at the moment because I think it is more important to update the documentation in a few areas where there were new features in V3 and I don't have the expertise in the cmake and xslt processing to do it easily at the moment. This section is a pretty good guide to usage in developments and the organization of GTK3 https://developer.gnome.org/hig-book/unstable/input-mouse.html.en particularly the table of mouse and keyboard equivalents. The GDK reference manual refers to Button 1,2,3 with 1 Left 2 Middle and 3 Right but that is more related to usage in coding than in user documentation. There is no style guide in the Gnome documentation guide sense but there is the wiki on updating documentation (https://wiki.gnucash.org/wiki/Documentation_Update_Instructions) but it doesn't refer to mouse interaction descrptions. My inclination is to stay with left click, right click descriptions as for a two button mouse for the moment. It is probably more important to be consistent rather than totally compliant with being as general as possible. I think some general reference to the GTK3 input-mouse.html document would be useful as all the intefaces are based on it as well as https://developer.gnome.org/hig/stable/pointer-and-touch-input.html.en bu that is problematical as these are external references. If it is desired to change this a global search and replace can always be used and much of the current documentation uses a left click, right click convention David - David Cousens -- Sent from: http://gnucash.1415818.n4.nabble.com/GnuCash-Dev-f1435356.html ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: [GNC-dev] Mouse usage in Gnucash
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 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 wrote: > > > > > > > >> On Oct 10, 2019, at 10:26 PM, David Cousens > > > 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 > > >> . 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
Re: [GNC-dev] Mouse usage in Gnucash
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 wrote: > > > > >> On Oct 10, 2019, at 10:26 PM, David Cousens > 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 > >> . 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
Re: [GNC-dev] Mouse usage in Gnucash
On October 12, 2019, at 3:45 AM, John Ralls wrote: > >> On Oct 10, 2019, at 10:26 PM, David Cousens 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 >> . 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
Re: [GNC-dev] Mouse usage in Gnucash
I would expect that the language of ‘primary’ and ’secondary’ click is the most versatile across platforms and preferences. It allows for OS discrepancies, accounts for touch vs. click mice, and allows for handidness considerations. Of course, people using accessibility interfaces might not literally ‘click or tap’ but the concept of selection is the same. If there is an ‘all-inclusive’ term, so be it, but I’m not personally aware of one. (and getting too general might even detract from the specific communication intended) So far, my experience with touch devices has been that ’tap/click’=primary/left-click and ’two-finger-tap/click’=secondary/right-click but that could be a MacOS thing. However, I don’t experience anything different using the same hardware in VMs with Linux or Windows so maybe it gets translated properly by the VM software. I’ve yet to use the same touch hardware with either of those OS options natively. Now, how do you intend to describe interacting with GnuCash via a VR/AR interface where you point out in the space around you? (just kidding of course...) Regards, Adrien > On Oct 11, 2019 w41d284, at 6:35 PM, David Cousens > wrote: > > Thanks John, > > I agree totally. I am trying to settle on something which might be > intelligible or at least easily translatable to users on other OSs and > devices. Frank raised the issue with me while reviewing changes to the help > manual importing section. I tried what he suggested out but my view on the > end result is that it ends up being unintelligible to everybody and I may > yet revert it. > > I am not too concerned about fairly experienced users (they will figure it > out) but the novice who comes in without too much experience of other OSs > and computers is the real target - the one who gets hung up if the > description is not exactly the way the box in front of him operates. They > are becoming rarer beasts these days once they have grandkids to educate > them properly. > > I personally am happy with the left click/tap and right click/tap notation > and then let users translate that as required for their specific > equipment/OS as necessary. My son is a leftie and he has never really had a > problem translating automatically from the RH world unless the devices were > physically right handed. > > The touchpads on my laptop and tablet with a touchscreen all respond to > tap/s on either side of the touchpad or on the screen as expected so the > click/tap may be the way to go. I don't use tablets too much so I'm not too > au fait with the finer points of gestures in any case. I just blunder my way > through. > > David ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: [GNC-dev] Mouse usage in Gnucash
Thanks John, I agree totally. I am trying to settle on something which might be intelligible or at least easily translatable to users on other OSs and devices. Frank raised the issue with me while reviewing changes to the help manual importing section. I tried what he suggested out but my view on the end result is that it ends up being unintelligible to everybody and I may yet revert it. I am not too concerned about fairly experienced users (they will figure it out) but the novice who comes in without too much experience of other OSs and computers is the real target - the one who gets hung up if the description is not exactly the way the box in front of him operates. They are becoming rarer beasts these days once they have grandkids to educate them properly. I personally am happy with the left click/tap and right click/tap notation and then let users translate that as required for their specific equipment/OS as necessary. My son is a leftie and he has never really had a problem translating automatically from the RH world unless the devices were physically right handed. The touchpads on my laptop and tablet with a touchscreen all respond to tap/s on either side of the touchpad or on the screen as expected so the click/tap may be the way to go. I don't use tablets too much so I'm not too au fait with the finer points of gestures in any case. I just blunder my way through. David - David Cousens -- Sent from: http://gnucash.1415818.n4.nabble.com/GnuCash-Dev-f1435356.html ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: [GNC-dev] Mouse usage in Gnucash
> On Oct 10, 2019, at 10:26 PM, David Cousens 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 > . 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
[GNC-dev] Mouse usage in Gnucash
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 . 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. Any feedback would be appreciated. David - David Cousens -- Sent from: http://gnucash.1415818.n4.nabble.com/GnuCash-Dev-f1435356.html ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel