<chapter id="advanced-editing-tools">
<title
>Herramientas de edición avanzadas</title>

<sect1 id="comment">

<title
>Comentar/descomentar</title>

<para
>Los comandos Comentar y Descomentar, disponibles en el menú <guimenu
>Herramientas</guimenu
> le permiten añadir o eliminar marcas de comentario de la selección, o de la línea actual si no hay ninguna selección. El formato de los comentarios depende del formato del texto que esté escribiendo.</para>

<para
>Las reglas que determinan cómo deben ser los comentarios se establecen en las definiciones de sintaxis, así que si no se utiliza el resaltado de sintaxis, no será posible la realización automática de comentarios.</para>

<para
>Algunos formatos definen marcas de comentarios de una sola línea, otros de varias líneas y otros utilizan ambas posibilidades. Si no están disponibles los comentarios de varias líneas, será imposible comentar una selección cuya última línea no esté incluida por completo.</para>

<para
>Si está disponible una marca de comentario de una sola línea, es preferible comentar las líneas individualmente, ya que así se evitan problema de comentarios anidados.</para>

<para
>Al eliminar las marcas de comentario, se debe seleccionar el texto no comentado. Al eliminar marcas de comentario multilínea de una selección, se ignorará cualquier espacio en blanco que quede fuera de las marcas de comentario.</para>

<para
>Para colocar marcas de comentario, utilice el elemento de menú <menuchoice
><guimenu
>Herramientas</guimenu
><guimenuitem
>Comentar</guimenuitem
></menuchoice
> o el acceso directo de teclado correspondiente, que por defecto es <keycombo action="simul"
>&Ctrl;<keycap
>#</keycap
></keycombo
>.</para>

<para
>Para eliminar marcas de comentario, utilice el elemento de menú <menuchoice
><guimenu
>Herramientas</guimenu
><guimenuitem
>Descomentar</guimenuitem
></menuchoice
> o el acceso directo de teclado correspondiente, que por defecto es <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>#</keycap
></keycombo
>.</para>

</sect1>

<sect1 id="edit-command">

<title
>Comando de edición</title>

<para
>Esta herramienta, disponible a través del elemento de menú <menuchoice
><guimenu
>Herramientas</guimenu
><guimenuitem
>Comando de edición</guimenuitem
></menuchoice
>, proporciona acceso a un pequeño conjunto de comandos similares a los de <application
>vi</application
>/<application
>vim</application
> para editar texto. Es una herramienta muy útil para los usuarios experimentados o avanzados, pero no deje que eso sea un motivo para no probar su potencia.</para>

<para
>En este momento están disponibles los siguientes comandos:</para>

<variablelist
> <varlistentry
> <term
><command
>time</command
></term
> <listitem
> <para
>Este comando escribirá la hora actual según el reloj del sistema, con el formato <quote
>HH:MM:SS</quote
></para
> <para
>Para utilizarlo, abra el diálogo de comando de edición y escriba en la casilla de entrada la palabra <userinput
>time</userinput
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><command
>char</command
></term
> <listitem
> <para
>Este comando le permite insertar caracteres literales por su identificador numérico, en formato decimal, octal o hexadecimal. Para utilizarlo lanze el diálogo del comando de edición y teclee <userinput
>char: [número]</userinput
> en la casilla de entrada, después pulse <guibutton
>Aceptar</guibutton
>.</para
> <example
> <title
>Ejemplos de <command
>char</command
></title
> <para
>Entrada: <userinput
>char:234</userinput
></para
> <para
>Salida: <computeroutput
>ê</computeroutput
></para
> <para
>Entrada: <userinput
>char:0x1234</userinput
></para
> <para
>Salida: <computeroutput
>ê</computeroutput
></para
> <para
>Entrada: <userinput
>char:1232</userinput
></para
> <para
>Salida: <computeroutput
>ê</computeroutput
></para
> </example
> </listitem
> </varlistentry
> <varlistentry
> <term
><command
>s///[ig]</command
> <command
>%s///[ig]</command
></term
> <listitem
> <para
>Este comando ejecuta una operación de búsqueda/sustitución similar a las de sed en la línea actual o en todo el archivo (<command
>%s///</command
>).</para
> <para
>Brevemente, se busca en el texto alguna cadena que coincida con el <emphasis
>patrón de búsqueda</emphasis
>, la expresión regular entre la primera y la segunda barra, y cuando se encuentra una coincidencia, la parte coincidente del texto es sustituida por la expresión contenida entre las barras central y última de la cadena. Los paréntesis en el patrón de búsquedas crean <emphasis
>retroreferencias</emphasis
>, es decir, que el comando recuerda qué parte de la coincidencia se encontraba entre los paréntesis; estas cadenas se pueden reutilizar en el patrón de sustitución, refiriendose a ellas como <userinput
>\1</userinput
> como el primer conjunto de paréntesis, <userinput
>\2</userinput
> como el segundo y así sucesivamente.</para
> <para
>Para hacer una búsqueda literal de <literal
>(</literal
> o <literal
>)</literal
>, debe <emphasis
>escapar</emphasis
> el carácter utilizando una barra invertida: <userinput
>\(\)</userinput
></para
> <para
>Si coloca una <userinput
>i</userinput
> al final de la expresión, la coincidencia no será sensible a las mayúsculas.</para
> <example
> <title
>Sustitución de texto en la línea actual</title
> <para
>Su buen amigo el ordenador se ha detenido, diciendo que la clase <classname
>myClass</classname
>, mencionada en la línea 3902 del archivo fuente no está definida.</para
> <para
><quote
>¡Vaya por Dios!</quote
> pensará usted, es que se trataba de <classname
>MyClass</classname
>. Se desplaza a la línea 3902 y en vez de intentar buscar la palabra en el texto, abre el diálogo del comando de edición, introduce <userinput
>s/myclass/MyClass/i</userinput
>, pulsa el botón <guibutton
>Aceptar</guibutton
>, guarda el archivo y vuelve a compilar esta vez sin ningún error.</para
> </example
> <example
> <title
>Sustitución de texto en todo el archivo</title
> <para
>Imagine que tiene un archivo, en el que menciona a <quote
>Miss Jensen</quote
> varias veces, cuando resulta que alguien viene y le dice que se acaba de casar con <quote
>Mr Jones</quote
>. Usted querrá, desde luego, sustituir cada aparición de <quote
>Miss Jensen</quote
> por <quote
>Ms Jones</quote
>.</para
> <para
>Lance el diálogo del comando de edición, y teclee en la casilla de entrada: <userinput
>%s/Miss Jensen/Ms Jones/</userinput
>, y una vez que haya pulsado Intro, el trabajo estará hecho.</para
> </example
> <example
> <title
>Un ejemplo más avanzado</title
> <para
>Este ejemplo hace uso de <emphasis
>retroreferencias</emphasis
> así como de una <emphasis
>clase de palabras</emphasis
> (si no sabe lo que es esto, por favor consulte la documentación citada más adelante).</para
> <para
>Suponga que tiene la siguiente línea: <programlisting
>void MyClass::DoStringOps( String      &amp;foo, String &amp;bar String *p, int  &amp;a, int &amp;b )</programlisting
> </para
> <para
>Pero usted se da cuenta de que ese código no está bien, y decide que quiere utilizar la palabra clave <constant
>const</constant
> en todos los argumentos<quote
>address of</quote
>, que se caracterizan por tener un operados &amp; delante del nombre del argumento. También desea simplificar el espacio en blanco, de forma que sólo haya uno entre cada palabra.</para
> <para
>Abra el diálogo del comando de edición, e introduzca: <userinput
>s/\s+(\w+)\s+(&amp;)/ const \1 \2/g</userinput
>, después pulse el botón <guibutton
>Aceptar</guibutton
>. La <userinput
>g</userinput
> al final de la expresión hace que la expresión regular recompile cada coincidencia para guardar las <emphasis
>retroreferencias</emphasis
>.</para
> <para
>Salida: <computeroutput
>void MyClass::DoStringOps( const String &amp;foo, const String &amp;bar String *p, const int &amp;a, const int &amp;b )</computeroutput
></para
> <para
>Misión completada. Ahora, ¿qué ha ocurrido? Buen, hemos buscado algún espacio en blanco (<literal
>\s+</literal
>) seguido de uno o más caracteres alfabéticos (<literal
>\w+</literal
>) seguidos de más espacio en blanco (<literal
>\s+</literal
>) seguido del símbolo <quote
>&amp;</quote
>, y en el proceso hemos guardado el bloque alfabético y el <quote
>&amp;</quote
> para reutilizarlos en la operación de sustitución. Entonces hemos sustituido la parte coincidente de nuestra línea por un espacio en blanco seguido de <quote
>const</quote
> seguido de un espacio en blanco seguido de nuestro bloque alfabético (<literal
>\1</literal
>) seguido de un espacio en blanco seguido de nuestro <quote
>&amp;</quote
> almacenado (<literal
>\2</literal
>)</para
> <para
>En algunos casos el bloque alfabético era <quote
>String</quote
>, en otros <quote
>int</quote
>, así que la clase de caracteres <literal
>\w</literal
> y el cuantificador <literal
>+</literal
> nos han servido de gran ayuda.</para
> </example
> </listitem
> </varlistentry
> </variablelist>

<warning>
<para
>Esto es extremadamente potente, y como las acciones se pueden deshacer varias veces (según se necesite) a través del comando <menuchoice
><guimenuitem
>Deshacer</guimenuitem
></menuchoice
>, le recomiendo que practique un poco antes de utilizar este comando en ediciones serias si no está familiarizado con las expresiones regulares de <application
>sed</application
> o perl.</para>
</warning>

</sect1>

</chapter>

