* openhab....@web.de <openhab....@web.de> [04-03-18 13:40]: > Hi Patrick, > > I can't quite follow your execution, probably because I'm not so deeply > involved in darktable. I don't know what the keyboardrc file is. > > I have had a computer for over 25 years and I learned what the primery key is > just a few weeks ago. Therefore, I do not think this term is so common.
perhaps not. my first "computer" was a VIC-20, and I also was not familiar with a prefix or primary key either but understand the concept. > Is it really important that the manual matches the keyboardrc? It is much more > important that beginners get along with the documentation and understand it. then explain both concepts and how used rather than changing one confusion for another. > The designation in the documentation should be the same as in the program. > In the settings of the German darktable version the key combinations are Ctrl > + C and the primary buttons are called Ctrl. Perhaps this is due to the > translation. How is it in the English version? they are <ctrl><c> or ctrl + c, there is no confusion. see below > Before I start and invest time, I would have clarified the topic and > defined the spelling. > > Thanks for feedback! > > Pierre Metzner > > Am Dienstag, 3. April 2018, 14:42:45 CEST schrieb Patrick Shanahan: > > * Tobias Ellinghaus <m...@houz.org> [04-03-18 08:18]: > > > Am Dienstag, 3. April 2018, 09:58:15 CEST schrieb openhab....@web.de: > > > > Hello, > > > > In the documentation there are different spellings for the key > > > > combinations. In the text you can usually find the notation e.g. > > > > Ctrl-c. In the chapter Shortcuts is the notation <Ctrl>c. > > > > > > Yes, it's quite inconsistent at the moment. > > > > > > > I would volunteer to correct this, but first I would like to define the > > > > spelling. > > > > > > Hooray! > > > > > > > I'd prefer an output like the attached picture, but I haven't found an > > > > XML > > > > compliant solution yet. Ideas are welcome! > > > > > > That would require a font which looks like that, which we would have to > > > ship. Sounds error prone. > > > > > > > Therefore I would adapt the documentation as follows: > > > > 1.) Change the lowercase letters to uppercase, this is the common > > > > spelling. > > > > 2.) I would change the hyphen to a plus sign. > > > > 3.) If there are several keys, one space between the character and plus > > > > > > > > This changes the previous notation from Ctrl-c to Ctrl + C. > > > > > > That sounds like a good plan. > > > > > > > The documentation often contains <primary>. With regard to Windows and > > > > Linux users, I would change this to Ctrl. In my opinion Ctrl is more > > > > common.> > > > Ack. > > > > > > > Feedback are wellcome! > > > > > > Go ahead! > > > > would it be better to display the key combinations as they appear in the > > keyboardrc file that they may be searched for readily if one happens to > > develope momentary old-timers, ie: <Primary><Shift>w > > and emphasize that the "Primary" key is the Control Key? > > > > or change <Primary> in the keyboardrc file to <Ctrl> and reference as: > > <Ctrl><Shift>w > > > > fwiw: tmux refers to the primary key as the "prefix" key but that key may > > be designated in tmuxrc. the primary/prefix keys are the same by different names. you can see the keyboardrc file at ~/.config/darktable/keyboardrc. it contains all the key definitions, but the <ctrl> key is designated as the <Primary> key. they are the same. I do not know the reasoning to designate the <ctrl> key as "Primary" but it was done by the dev's some time ago. the keys are defined as <Primary> in keyboardrc, not <Ctrl>, <ctrl> or Ctrl, common naming or not. so if you refer to the <Primary> key as Ctrl, it must be emphasized as such so no confusion results when looking at the file where all the key definitions are made. or change the key definition <Primary> to <Ctrl> and refer to <Ctrl> rather than just Ctrl. I believe changing one confusing definition for another is not beneficial. as I do not know your operating system, windows may have the keyboardrc file in a different location. I don't prefer windows. -- (paka)Patrick Shanahan Plainfield, Indiana, USA @ptilopteri http://en.opensuse.org openSUSE Community Member facebook/ptilopteri Registered Linux User #207535 @ http://linuxcounter.net Photos: http://wahoo.no-ip.org/piwigo paka @ IRCnet freenode ___________________________________________________________________________ darktable developer mailing list to unsubscribe send a mail to darktable-dev+unsubscr...@lists.darktable.org
