cthulhu/help/C/howto_key_bindings.page

<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_key_bindings">
  <info>
    <link type="guide" xref="index#getting_started"/>
    <link type="next" xref="howto_profiles" />
  <title type="sort">8. Keybindings</title>
  <desc>Binding, rebinding, and unbinding commands</desc>
    <credit type="author">
      <name>Joanmarie Diggs</name>
      <email>joanied@gnome.org</email>
    </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
  </info>
  <title>Keybindings</title>
  <p>
    Cthulhu has many commands, some of which are bound to a keystroke, others
    of which are unbound. You can bind, rebind, and unbind <app>Cthulhu</app>'s
    commands by following the steps below.</p>
  <steps>
    <title>Binding an Unbound Command</title>
    <item>
      <p>
        Get into the <link xref="preferences">Cthulhu Preferences</link> dialog
        by pressing <keyseq><key>Cthulhu Modifier</key><key>Space</key></keyseq>.
      </p>
    </item>
    <item>
      <p>Move to the <gui>Key Bindings</gui> page.</p>
    </item>
    <item>
      <p>
        Arrow to the cell which contains the command you want to assign a
        keystroke to.
      </p>
    </item>
    <item>
      <p>
        Arrow once to the right. This will place focus in the <gui>Key
        Binding</gui> column. Press <key>Return</key>.
      </p>
    </item>
    <item>
      <p>Press the desired key combination.</p></item>
    <item>
      <p>
        Press <key>Return</key> to confirm the new combination. The new
        keystroke will be saved and the check box in the last column (the
        <gui>Modified</gui> column) will indicate that the key binding
        has been modified.
      </p>
    </item>
    <item>
      <p>Press the <gui>Apply</gui> button.</p>
    </item>
  </steps>
  <steps>
    <title>Changing Existing Bindings</title>
    <item>
      <p>
        Get into the <link xref="preferences">Cthulhu Preferences</link> dialog by
        pressing <keyseq><key>Cthulhu Modifier</key><key>Space</key></keyseq>.
      </p>
    </item>
    <item>
      <p>Move to the <gui>Key Bindings</gui> page.</p>
    </item>
    <item>
      <p>
        Arrow to the cell which contains the binding you which to change and
        press <key>Return</key>.
      </p>
    </item>
    <item>
        <p>Press the desired key combination.</p>
    </item>
    <item>
      <p>
        Press <key>Return</key> to confirm the new combination. The new
        keystroke will be saved and the check box in the last column (the
        <gui>Modified</gui> column) will indicate that the key binding has
        been modified.
      </p>
    </item>
    <item>
      <p>Press the <gui>Apply</gui> button.</p>
    </item>
  </steps>
  <steps>
    <title>Restoring Original Bindings</title>
    <item>
      <p>
        Get into the <link xref="preferences">Cthulhu Preferences</link> dialog by
        pressing <keyseq><key>Cthulhu Modifier</key><key>Space</key></keyseq>.
      </p>
    </item>
    <item>
      <p>Move to the <gui>Key Bindings</gui> page.</p>
    </item>
    <item>
      <p>Arrow to the modified column associated with the key binding.</p>
    </item>
    <item>
      <p>Uncheck the checkbox by pressing <key>Space</key>.</p>
    </item>
    <item>
      <p>Press the <gui>Apply</gui> button.</p>
    </item>
  </steps>
  <steps>
    <title>Unbinding Bound Commands</title>
    <item>
      <p>
        Get into the <link xref="preferences">Cthulhu Preferences</link> dialog by
        pressing <keyseq><key>Cthulhu Modifier</key><key>Space</key></keyseq>.
      </p>
    </item>
    <item>
      <p>Move to the <gui>Key Bindings</gui> page.</p>
    </item>
    <item>
      <p>
        Arrow to the cell which contains the binding you which to delete
        and press <key>Return</key>.
      </p>
    </item>
    <item>
      <p>
        When prompted for the new keybinding, press <key>Delete</key> or
        <key>BackSpace</key>. You will be told that the key binding has
        been removed.
      </p>
    </item>
    <item>
      <p>Press <key>Return</key> to confirm.</p>
    </item>
    <item>
      <p>Press the <gui>Apply</gui> button.</p>
    </item>
  </steps>
</page>