Describiendo interacción con la aplicación

A veces es necesario describir la manera como interactua el usuario con una aplicación através de los menués que esta presenta o mediante combinaciones de teclas que el usuario digita, ese es el objetivo del siguiente ejemplo

<sect1>
  <title>Escribiendo y guardando un archivo</title>
      
    <para>Dentro del editor escriba la frase <userinput>Hola
    Mundo</userinput> y posteriormente guarde dicho archivo usando
    <menuchoice>
      <shortcut>
        <keycombo action="seq"><keycombo
        action="simul"><keycap>Control</keycap><keycap>x</keycap>
        </keycombo><keycombo><keycap>Control</keycap>
        <keycap>s</keycap></keycombo>
      </shortcut>
      <guimenu>Files</guimenu> <guimenuitem>Save Buffer
      as</guimenuitem> 
    </menuchoice>, a continuación <application>emacs</application> 
    responderá con el mensaje <computeroutput>File to save
    in:~/20013/doc-tut/e2</computeroutput>, restando que usted
    escriba solamente el nombre del archivo
   (<filename>hola.txt</filename>).</para>
</sect1>

y la manera como se ve dicho código es

Dentro del editor escriba la frase Hola Mundo y posteriormente guarde dicho archivo usando Files->Save Buffer as (Control+x Control-s), a continuación emacs responderá con el mensaje File to save in:~/20013/doc-tut/e2, restando que usted escriba solamente el nombre del archivo (hola.txt).

Dentro de este ejemplo hemos usado la marquilla menuchoice que indica la interacción con la aplicación através de menúes, posteriormente para seleccionar cada interacción con el menú lo hacemos através de guimenu y guimenuitem; como información adicional es útil saber que se tienen marquillas que permiten interacción con botones o iconos (guibutton y guiicon).

Otro punto importante de este ejemplo consiste en la utilización de shortcut que indica un atajo de interacción através del teclado, dentro de este usamos keycombo que nos permite describir una combinación de teclas, dicha marquilla tiene el atributo action el cual sirve para describir como se efectúa la combinación de teclas, en este caso la primera combinación es una secuencia (seq) y las siguientes dos combinaciones son simultáneas (simul), la marquilla keycap indica que se trata de una sola tecla.

La última observación consiste en que cuando se haga referencia a un nombre de un archivo es conveniente usar filename, en caso de que uno hable de un directorio debe usar el atributo de dicha marquilla class igual a directory