Hi,

As a result of the discussion below, I made the changes and I create a 
corresponding pull request. Can anyone check and release it?
https://github.com/darktable-org/darktable/pull/1667

Thanks
Pierre

Am Mittwoch, 4. April 2018, 00:05:32 CEST schrieb Tobias Ellinghaus:
> Am Dienstag, 3. April 2018, 19:38:09 CEST schrieb openhab....@web.de:
> > 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.
> > 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.
> > 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?
> > 
> > Before I start and invest time, I would have clarified the topic and
> > defined the spelling.
> 
> Just ignore the "primary" and the fact that there is a keyboardrc file. It's
> just a technical detail inherited from GTK. The very few people that will
> ever edit that file manually will be able to find out what the things
> inside mean on their own. The usermanual is not meant to teach that.
> 
> > Thanks for feedback!
> > 
> > Pierre Metzner
> 
> Tobias
> 
> > 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.
> > 
> > __________________________________________________________________________
> > _
> > darktable developer mailing list to unsubscribe send a mail to
> > darktable-dev+unsubscr...@lists.darktable.org




___________________________________________________________________________
darktable developer mailing list
to unsubscribe send a mail to darktable-dev+unsubscr...@lists.darktable.org

Reply via email to