Document shortcuts

content/module-reference/processing-modules/color-calibration.md

@@ -432,3 +432,4 @@ It is possible to alleviate this issue, if you have a computer screen calibrated
 2. Take a blurry (out of focus) image of that surface with your camera, ensuring that you don't have any "parasite" light in the frame, you have no clipping, and are using an aperture between f/5.6 and f/8,
 3. Open the image in darktable and extract the white balance by using the [picker](../../darkroom/processing-modules/module-controls.md#pickers) tool in the _white balance_ module on the center area of the image (non-central regions might be subject to chromatic aberrations). This will generate a set of 3 RGB coefficients.
 4. [Save a preset](../../darkroom/processing-modules/presets.md#creating-and-editing-presets) for the _white balance_ module with these coefficients and auto-apply it to any color RAW image created by the same camera.
+

content/module-reference/processing-modules/crop.md

@@ -69,3 +69,8 @@ bottom
 ## guides
 
 Tick the box to show guide overlays whenever the module is activated. Click the icon on the right to control the properties of the guides. See [guides & overlays](../utility-modules/darkroom/guides-overlays.md) for details.
+
+# shortcut keys
+
+c
+: Toggle the on-image crop box even if the _crop_ module is currently not expanded.  This is useful for cropping from the [quick access panel](../darkroom/organization/quick-access-panel.md), which would otherwise require navigating to teh full crop module.

content/module-reference/processing-modules/exposure.md

@@ -83,3 +83,9 @@ This operation can be repeated as many times as you have images in your series w
 **Note 3:** Perfectly matching your control sample against the target lightness may still not yield a similar perceptual result, even if the numbers are exactly the same. For example, if your subject sits in front of a background made of some bright parts and some dark parts, the ratio of bright areas / dark areas will affect the perception of contrast and brightness. If this ratio changes across your series, the subject brightness will not appear constant even though the lightness value is exactly constant. For more details, see the [checker shadow illusion](https://en.wikipedia.org/wiki/Checker_shadow_illusion) and the [Chubb illusion](https://en.wikipedia.org/wiki/Chubb_illusion).
 
 ---
+
+# shortcut keys
+
+e
+: Pop up the bauhaus control for the `exposure` slider, allowing adjustment of its value (including by typing a number) even if the module is currently collapsed or hidden.  This is equivalent to right-clicking on the `exposure` slider.
+

content/module-reference/processing-modules/orientation.md

@@ -36,3 +36,11 @@ transform
 
 show guides
 : Tick the box to show guide overlays whenever the module is activated. Click the icon on the right to control the properties of the guides. See [guides & overlays](../utility-modules/darkroom/guides-overlays.md) for details.
+
+# shortcut keys
+
+[
+: Rotate the image 90 degrees counterclockwise.
+
+]
+: Rotate the image 90 degrees clockwise.

content/module-reference/processing-modules/rotate-perspective.md

@@ -126,5 +126,13 @@ Here is the image after having corrected for vertical and horizontal perspective
 
 ![perspective-correction-example-after](./rotate-perspective/perspective-correction-example-after.png#w66)
 
+# shortcut keys
 
+alt+[
+: Rotate the image clockwise by 0.1 degrees.
 
+alt+]
+: Rotate the image counterclockwise by 0.1 degrees.
+
+alt+r
+: Pop up the bauhaus control for the `rotation` slider, allowing adjustment of its value (including by typing a number) even if the module is currently collapsed or hidden.  This is equivalent to right-clicking on the slider.

content/preferences-settings/shortcuts.md

@@ -13,7 +13,7 @@ A _shortcut_ is a combination of key or button presses and/or mouse or device mo
 
 The recommended way to assign shortcuts to visual elements is the [visual shortcut mapping](#visual-shortcut-mapping) mode.
 
-A single action may have multiple shortcuts but a single shortcut can only be linked to one action in a given darktable view -- you can't chain actions together except by applying a preset or style. You can, however, set up a single shortcut that does one thing in the lighttable view, say, and another in the darkroom view.
+A single action may have multiple shortcuts but a single shortcut can only be linked to one action in a given darktable view -- you can't chain actions together except by applying a preset or style. You can, however, set up a single shortcut that does one thing in the lighttable view, say, and another in the [darkroom](../darkroom/darkrom-view-layout.md)  view.
 
 ## initiating a shortcut
 
@@ -128,6 +128,10 @@ The following additional options are provided in the shortcut mapping screen:
 export...
 : Export the current shortcut mappings for one or all of your devices (keyboard/mouse, midi, game controller) to an external file. The dialog will show you how many shortcuts exist for each device.
 
+import extras
+: Import extended default shortcuts from a system file.  This adds a substantial number of shortcuts for controlling processing modules.  As when importing shortcuts from an external file, existing shortcuts matching any in the system file will be replaced.  You can undo the import using the `restore...` button until you exit darktable if you notice that one of your existing shortcuts has been replaced.  Most of the extended shortcuts use key+mouse combinations, and many use a mnemonic key for the module the shortcut controls.  These mnemonic shortcuts can be localized to your preferred language, if a localized version of the system file is available (currently, only German in addition to the default English).
+: You can review the added shortcuts by pressing and holding the 'h' key in the [darkroom](../darkroom/darkroom-view-layout.md).
+
 import...
 : Import shortcut mappings from an external file for one or all of your devices. When loading a device, you can chose to assign it a different number. This can for example be used to exchange midi layouts. Before loading, you can chose to wipe the specific device first. When loading all from an empty file, this will effectively delete all your shortcuts.