<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_reading">
  <info>
    <link type="next" xref="commands_structural_navigation" />
    <link type="guide" xref="commands#reading_documents" />
    <link type="seealso" xref="howto_documents"  />
    <link type="seealso" xref="howto_text_attributes"  />
    <link type="seealso" xref="howto_whereami"  />
    <title type="sort">1. Reading</title>
    <title type="link">Reading</title>
    <desc>
      Commands for accessing document text
    </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>Reading Commands</title>
  <p>
    In addition to the caret navigation commands which are part of GNOME,
    <app>Orca</app> provides a number of commands which you can use to read a
    document.
  </p>
  <note style="tip">
    <p>
      In the lists that follow, you will see several references to "KP". All
      "KP" keys are located on the numeric keypad. You will also notice that
      there are different keystrokes depending upon whether you are using a
      desktop or a laptop -- or more accurately, whether you are using
      <app>Orca</app>'s Desktop keyboard layout or its Laptop keyboard layout.
      For additional information, please see the
      <link xref="howto_keyboard_layout">Keyboard Layout</link> topic.
    </p>
  </note>
  <section id="flat_review">
    <title>Reading Your Current Location</title>
    <p>
      The following <app>Orca</app> <link xref="commands_flat_review">Flat
      Review Commands</link> can be used to read your current location:
    </p>
    <list>
      <item>
        <p>Read the current line:</p>
        <list>
          <item>
            <p>
              Desktop: <keyseq><key>KP 8</key></keyseq>
            </p>
          </item>
          <item>
            <p>
              Laptop: <keyseq><key>Orca Modifier</key><key>I</key></keyseq>
            </p>
          </item>
        </list>
      </item>
      <item>
        <p>Read the current word:</p>
        <list>
          <item>
            <p>
              Desktop: <keyseq><key>KP 5</key></keyseq>
            </p>
          </item>
          <item>
            <p>
              Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq>
            </p>
          </item>
        </list>
      </item>
      <item>
        <p>Spell the current word:</p>
        <list>
          <item>
            <p>
              Desktop: <keyseq><key>KP 5</key></keyseq> (double-clicked)
            </p>
          </item>
          <item>
            <p>
              Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq>
              (double-clicked)
            </p>
          </item>
        </list>
      </item>
      <item>
        <p>Phonetically spell the current word:</p>
        <list>
          <item>
            <p>
              Desktop: <keyseq><key>KP 5</key></keyseq> (triple-clicked)
            </p>
          </item>
          <item>
            <p>
              Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq>
              (triple-clicked)
            </p>
          </item>
        </list>
      </item>
      <item>
        <p>Read the current character:</p>
        <list>
          <item>
            <p>
              Desktop: <keyseq><key>KP 2</key></keyseq>
            </p>
          </item>
          <item>
            <p>
              Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq>
            </p>
          </item>
        </list>
      </item>
      <item>
        <p>Phonetically speak the current character:</p>
        <list>
          <item>
            <p>
              Desktop: <keyseq><key>KP 2</key></keyseq> (double-clicked)
            </p>
          </item>
          <item>
            <p>
              Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq>
              (double-clicked)
            </p>
          </item>
        </list>
      </item>
      <item>
        <p>Speak the unicode value of current character:</p>
        <list>
          <item>
            <p>
              Desktop: <keyseq><key>KP 2</key></keyseq> (triple-clicked)
            </p>
          </item>
          <item>
            <p>
              Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq>
              (triple-clicked)
            </p>
          </item>
        </list>
      </item>
    </list>
  </section>
  <section id="say_all">
    <title>Say All</title>
    <p>
      Orca's Say All command will cause <app>Orca</app> to speak the
      entire document beginning from your current location.
    </p>
    <list>
      <item>
        <p>Desktop: <key>KP Plus</key></p>
      </item>
      <item>
        <p>
          Laptop: <keyseq><key>Orca Modifier</key><key>Semicolon</key></keyseq>
        </p>
      </item>
    </list>
  </section>
  <section id="attributes_and_selection">
    <title>Text Attributes and Selected Text</title>
    <p>
      Orca has a dedicated command for obtaining the attributes of the
      text at the caret location. In addition, if you use <app>Orca</app>'s
      Where Am I commands from within a text object in which text has been
      selected, <app>Orca</app> will announce the selected text.
    </p>
    <list>
      <item>
        <p>
          Present the text attributes:
          <keyseq><key>Orca Modifier</key><key>F</key></keyseq>
        </p>
      </item>
      <item>
        <p>Perform basic where am I:</p>
        <list>
          <item>
            <p>
              Desktop: <key>KP Enter</key>
            </p>
          </item>
          <item>
            <p>
              Laptop: <keyseq><key>Orca Modifier</key><key>Return</key></keyseq>
            </p>
          </item>
        </list>
    </item>
    <item>
      <p>Perform detailed where am I:</p>
      <list>
        <item>
          <p>
            Desktop: <key>KP Enter</key> (double-clicked)
          </p>
        </item>
        <item>
          <p>
            Laptop: <keyseq><key>Orca Modifier</key><key>Return</key></keyseq>
            (double-clicked)
          </p>
        </item>
      </list>
    </item>
  </list>
</section>
</page>
