[GNC-dev] Mouse usage in Gnucash

classic Classic list List threaded Threaded
12 messages Options
Reply | Threaded
Open this post in threaded view
|

[GNC-dev] Mouse usage in Gnucash

David Cousens
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.

Any feedback would be appreciated.

David



-----
David Cousens
--
Sent from: http://gnucash.1415818.n4.nabble.com/GnuCash-Dev-f1435356.html
_______________________________________________
gnucash-devel mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
David Cousens
Reply | Threaded
Open this post in threaded view
|

Re: [GNC-dev] Mouse usage in Gnucash

John Ralls-2


> On Oct 10, 2019, at 10:26 PM, David Cousens <[hidden email]> 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
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Reply | Threaded
Open this post in threaded view
|

Re: [GNC-dev] Mouse usage in Gnucash

David Cousens
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
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
David Cousens
Reply | Threaded
Open this post in threaded view
|

Re: [GNC-dev] Mouse usage in Gnucash

Adrien Monteleone-2
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 <[hidden email]> 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
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Reply | Threaded
Open this post in threaded view
|

Re: [GNC-dev] Mouse usage in Gnucash

GnuCash - Dev mailing list
In reply to this post by David Cousens


On October 12, 2019, at 3:45 AM, John Ralls <[hidden email]> wrote:

>
>> On Oct 10, 2019, at 10:26 PM, David Cousens <[hidden email]> 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
>[hidden email]
>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
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Reply | Threaded
Open this post in threaded view
|

Re: [GNC-dev] Mouse usage in Gnucash

David Carlson-4
Are there examples in other major applications  to compare to?


David Carlson

On Fri, Oct 11, 2019, 11:33 PM D via gnucash-devel <
[hidden email]> wrote:

>
>
> On October 12, 2019, at 3:45 AM, John Ralls <[hidden email]> wrote:
>
> >
> >> On Oct 10, 2019, at 10:26 PM, David Cousens <[hidden email]>
> 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
> >[hidden email]
> >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
> [hidden email]
> https://lists.gnucash.org/mailman/listinfo/gnucash-devel
>
_______________________________________________
gnucash-devel mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Reply | Threaded
Open this post in threaded view
|

Re: [GNC-dev] Mouse usage in Gnucash

Tommy Trussell
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 <[hidden email]>
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 <
> [hidden email]> wrote:
>
> >
> >
> > On October 12, 2019, at 3:45 AM, John Ralls <[hidden email]> wrote:
> >
> > >
> > >> On Oct 10, 2019, at 10:26 PM, David Cousens <[hidden email]
> >
> > 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
> > >[hidden email]
> > >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
> > [hidden email]
> > https://lists.gnucash.org/mailman/listinfo/gnucash-devel
> >
> _______________________________________________
> gnucash-devel mailing list
> [hidden email]
> https://lists.gnucash.org/mailman/listinfo/gnucash-devel
>
_______________________________________________
gnucash-devel mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Reply | Threaded
Open this post in threaded view
|

Re: [GNC-dev] Mouse usage in Gnucash

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 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
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
David Cousens
Reply | Threaded
Open this post in threaded view
|

Re: [GNC-dev] Mouse usage in Gnucash

Frank H. Ellenberger-3
Hi all,

my main concern was against the use of '<emphasis role="bold">Fat
text</emphasis>', 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
<[hidden email]>:

>
> 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
<!ENTITY url-gnm-dev "https://developer.gnome.org/"> <!-- Append the
desired topic -->
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
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Reply | Threaded
Open this post in threaded view
|

Re: [GNC-dev] Mouse usage in Gnucash

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'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
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
David Cousens
Reply | Threaded
Open this post in threaded view
|

Re: [GNC-dev] Mouse usage in Gnucash

Frank H. Ellenberger-3
Hi David,


Am Di., 15. Okt. 2019 um 23:14 Uhr schrieb David Cousens
<[hidden email]>:
>
> 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:      <para>An <glossterm
linkend="gnc-gl_account">account</glossterm> 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
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Reply | Threaded
Open this post in threaded view
|

Re: [GNC-dev] Mouse usage in Gnucash

David Cousens
In reply to this post by Frank H. Ellenberger-3
Frank,

I think I have worked out how to make the keycap keysym  and mousebutton
tags bold without having to use the <emphasis role="bold"></emphasis> 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
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
David Cousens