Abr 24 2009

Ediff (Diffs en emacs)

Tag: basicoverdrive @ 3:09 am

En el artículo anterior explicabamos como trabajar con VC para el control de versiones, de aquí la importancia de este artículo, que enseña a utilizar ediff para ver las diferencias entre varios ficheros y esto puede emplearse de forma conjunta y muy útil con VC.

Se puede emplear M-x ediff-revision para iniciar ediff. En este modo podemos emplear distintas teclas asociadas a funciones relacionadas con ediff:

? : ‘ediff-help‘; ayuda sobre ediff
n ó SPC : ‘ediff-next-difference‘; muestra la siguiente diferencia.
p ó DEL : ‘ediff-previous-difference‘; muestra la diferencia anterior.
j : ‘ediff-jump-to-difference‘; se desplaza o salta a una diferencia específica.
C-v ó v ó >: ‘ediff-scroll-vertically‘; pasa a la siguiente página de diferencias.
M-v ó V ó <: ‘ediff-scroll-horizontally‘; pasa a la página anterior de diferencias.
| (pipe): ‘ediff-toggle-split‘; intercambia las vistas de los buffers.
m : ‘ediff-toggle-wide-display‘; hace toggle entre el tamaño normal y el ancho máximo.
a : ‘ediff-copy-A-to-B‘; copia la diferencia actual en el buffer del fichero A sobre el buffer del fichero B.
b : ‘ediff-copy-B-to-A‘; copia la diferencia actual en el buffer del fichero B sobre el buffer del fichero A.
r a ó r b : ‘ediff-restore-diff‘; restaura la diferencia actual del fichero del buffer A (ó B respectivamente) a la anterior.
A ó B : ‘ediff-toggle-read-only‘; Cambia el buffer a sólo lectura/escritura para A (ó B respectivamente).
g a ó g b : ‘ediff-jump-to-difference-at-point‘; re-centra la comparación de buffers en la diferencia más cercana a la localización actual.
C-l : ‘ediff-recenter‘; restaura la comparación mostrada para que sean resaltadas las regiones de todos los buffers y sean visibles.
! : ‘ediff-update-diffs‘; actualiza y vuelve a mostrar las regiones resaltadas.
w a ó w b : ‘ediff-save-buffer‘; guarda un buffer específico en el disco.
E : ‘ediff-documentation‘; abre el manual para ediff.
z : ‘ediff-suspend‘; cierra la ventana de control de ediff, pero deja la sesión activa por lo que puede ser recuperada luego.
q : ‘ediff-quit‘; cierra ediff.

Además usando C-h i se accede a info de cada acción de ediff. Por ejemplo C-h i m e d, haria info (C-h i) para el menú (m) de e (ediff) d (de la función asociada a e dentro de ediff).


Abr 24 2009

VC (Version Control) en emacs

Tag: basicoverdrive @ 12:56 am

Emacs provee de un front-end que agiliza el uso de control de versiones, dicha feature se llama VC (Version Control) y permite usar de forma generalizada distintos controles de versiones mediante una misma interfaz. Los controles de versiones soportados son SCCS, RCS, CVS, SVN, GIT y demás, aunque algunos de ellos no estan adaptados perfectamente o requieren de algún otro front-end más específico para ellos mismos, como es el caso de emergente GIT.

Modelo tradicional vs concurrente

Existen dos modelos basicos a hora de trabajar con controles de versiones, uno es el tradiciona y otro el concurrente que muestro a continuacion para notar las diferencias:

Modelo tradicional:

modelo tradicional

Modelo concurrente:

concurrente

(Imágenes extraidas del libro ‘Learning GNU Emacs’, 3rd Edition by Debra Cameron, James Elliot, Marc Loy. O’Reilly)

Por lo que puede existir algún problema durante los procesos de check in debemos intentar resolverlos mediante M-x vc-resolve-conflicts. A partir de aquí podemos comenzar a explicar las siguientes tareas típicas y los keybindings asociados a un proceso general de desarrollo.

C-c C-c; commit del buffer comentado.
C-x v u: ‘vc-revert-buffer‘; revisa los cambios realizados desde el último check in.
C-x v c: ‘vc-cancel-version‘; cancela una revisión.

Indicadores VC

En el modeline se pueden mostrar los siguientes indicadores:

Si no muestra nada indica que no se está bajo VC.
CVS-version cambiado respecto al repositorio.
CVS:version cambios guardados pero no committeados.

Además debemos comprobar la variable ‘vc-handeled-backends’ que revisa cuál es el control de versiones disponible en el sistema que puede ser:

comb: el control de versiones empleado en el sistema es SCCS.
rcs: el control de versiones empleado en el sistema es RCS.
cvs: el control de versiones empleado en el sistema es CVS.
snv: el control de versiones empleado en el sistema es SNV.

Trabajando con grupos y directorios

C-x v d: ‘vc-directory‘; configura dired para registrar ficheros bajo el directorio actual.

Reporte de revisiones

C-x v =; ‘vc-diff‘; configura dired para mostrar los diffs y presionando ‘g‘ refresca el estado de VC en el directorio.
C-u C-x v =; muestra el fichero y dos revisiones para reportar diffs entre dichas versiones del fichero.
C-x v ~: ‘vc-version-other-window‘; realiza la revisión de cualquier fichero guardado.

Si estamos en foo.c y pulsamos C-x v ~ 1.3 abrirá el fichero foo.c~1.3~ (es decir la version 1.3 de dicho fichero).

Historial de cambios

C-x v l: ‘vc-print-log‘; muestra cambios en el historial y changelog.
C-x v a: ‘vc-update-change-log‘; actualiza el fichero changelog al estilo GNU.

Registrando un fichero

C-x v i: ‘vc-register‘; registrar un fichero en el control de versiones.

Insertando cabeceras del control de versiones

C-x v h: ‘vc-insert-headers‘; inserta cabeceras de control.

Además existe la variable ‘comment-start‘ y ‘comment-end‘ que puede tomar uno de estos tres valores: nroff, troff. groff.

Creando y recuperando snapshots

C-x v r: ‘vc-retrieve-snapshot‘; hace check out del snapshot del proyecto de desarrollo o lo que es lo mismo, asocia un nombre un snapshot nuevo.
C-x v s: ‘vc-create-snapshot‘; crea un nuevo snapshot del proyecto de desarrollo.

Renombrando ficheros

vc-rename-file‘; dicha función renombra un fichero bajo el control de versiones. Aunque en algunos controles de versiones da problemas, por lo que si ocurre debemos realizar de nuevo la acción limpiando la cache mediante ‘vc-clear-context‘.

Configurando VC

Las siguientes variables pueden modificarse para alterar el funcionamiento y configuración de VC:

vc-display-backends‘; maneja el control de versiones usado por VC.
vc-display-status‘; muestra el número de revisión y su estado.
vc-backend-header‘; contiene un listado de cabeceras dado por la variable ‘vc-cvs-header‘, etc.
vc-keep-workfiles‘; evita tener que hacer check out cada vez.
vc-mistrust-permissions‘; si se pone a ‘t‘ le indica a VC que no confie en los permisos del fichero local, sino en los del control de versiones.
vc-suppress-confirm‘; si se pone a ‘t’ elimina la confirmación para ‘vc-revert-buffer‘.
vc-initial-comment‘; comentario inicial cuando se muestra un fichero (opcional) por los controles de versiones.
vc-switches‘; puede tomar 2 valores:

-c para cuando haga diff tenga un formato context-diff.
-u para cuando haga diff tenga un formato unified-diff.

Extendiendo VC

Existen extensiones por ejemplo para ClearCase de IBM, llamada vc-clearcase.


Abr 22 2009

Formato de texto enriquecido en emacs (rtf – Riched Text Format)

Tag: basicoverdrive @ 4:34 am

Es posible trabajar en GNU/Emacs con formato de texto enriquecido (Riched Text Format, que generalmente usa la extensión .rtf). Para quienes no lo sepan, dicho formato se emplea para mejorar o resaltar el texto plano sin necesidad de usar formatos pesados ni demasiadas opciones.

Cuando se trabaja con un buffer en emacs mientras se emplea el modo para texto enriquecido, emacs automáticamente convierte el formato de text a text/enritched a la hora de guardar el fichero en disco, por lo que emacs podrá reconocer este formato y reconvertir el texto cuando se cargue de nuevo el fichero en un buffer, reconociendo por lo tanto el formato automaticamente.

Para habilitar el formato de texto enriquecido tan sólo debemos pulsar M-x enritched-mode. Antes de comenzar a explicar las opciones que tenemos debemos distinguir entre tipos de líneas.

Hard y soft lines

Emacs distingue entre dos tipos diferentes de nuevas líneas, las duras (hard lines) y las blandas (soft lines). Estas funcionalidades se pueden habilitar o deshabilitar en emacs mediante M-x use-hard-newlines.

Las líneas duras (hard lines) son empleadas para separar párrafos u otros elementos en una lista, siempre buscando una línea como margen. El comando intro (newline) y C-o (open-line) inserta hard lines.

Las líneas blandas (soft lines) son usadas para ajustar texto entre márgenes. Todos los comandos relacionados con dichos ajustes, incluyendo Auto Fill, etc, sólo eliminan soft lines.

Las hard lines y soft lines pueden parecer lo mismo, pero es importante saber su diferencia. Es decir debemos evitar usar intro para ‘romper lineas’ por la mitad para crear párrafos, eso creará barreras y problemas a la hora de dar formato a los márgenes para los párrafos. En lugar de ello, debemos usar Auto Fill mode para romper líneas, de esa forma si el texto o los márgenes cambian, emacs podrá reorganizar las líneas de forma correcta.

En cambio, en tablas y listas, donde las líneas siempre deben permanecer en el formato que se escribieron originalmente, debemos usar intro para finalizar las líneas. Para dichas líneas debemos ajustar la alineación del texto a unfilled.

Información del formato y color

(sin keystroke asociada): ‘facemenu-remove-face-props; elimina de una región las propiedades asociadas al color y letra.
(sin keystroke asociada):describe-text-properties; muestra las propiedades del texto seleccionado.
(sin keystroke asociada):list-faces-display; muestra un listado de todos las fuentes existentes.
(sin keystroke asociada): list-colors-display; muestra una lista de todos los colores existentes.

Así pues se podrá especificar un color determinado a una fuente mediante el uso de M-x facemenu-set-foreground y M-x facemenu-set-background para el color de fuente y fondo respectivamente.

Propiedades de las fuentes

M-o d: ‘facemenu-set-default‘; elimina todas las propiedades de una región, incluyendo colores o bien fuerza el siguiente carácter a no tener definida una propiedad específica de fuente.
M-o b: ‘facemenu-set-bold‘; marca en negrita el texto de una región o bien el siguiente carácter.
M-o i: ‘facemenu-set-italic‘; marca en cursiva el texto de una región o bien el siguiente carácter.
M-o l: ‘facemenu-set-bold-italic‘; marca en negrita y cursiva el texto de una región o bien el siguiente carácter.
M-o u: ‘facemenu-set-underline‘; subraya el texto de una región o bien el siguiente carácter.
M-o o fuente: ‘facemenu-set-face‘; añade la fuente a una región o bien en siguiente carácter.

Además se definen dos adicionales fuentes, excerpt y fixed, empleadas para usar texto con tamaño fijo de ancho de fuente (por defecto el valor es variable-width). En caso de que el terminal no soporte mostrar diferentes fuentes, obviamente no será visible esta diferencia, pero se conservará dicho valor de forma interna y emacs podrá seguir trabajando con ellos especificando dichos valores y trabajando de forma correcta y conservando valores de forma interna en emacs para que cuando se emplee un terminal con dicho soporte sean visibles dichos cambios.

Indentación

C-x TAB o C-u C-x TAB o C-num C-x TAB: ‘increase-left-margin‘ o ‘decrease-left-margin‘ o ‘increase-right-margin‘ o ‘decrease-right-margin‘; indenta la región en 4 columnas. Si se prevee de un argumento, será un número específico de columnas dado el que incrementará el margen izquierdo. Si el argumento es negativo lo decrementará en dicho número específico de columnas.

Las variable standard-indent especifica cuantas columnas deben añadir o substraer de la identación dichos comandos (su valor por defecto es 4). El valor del margen derecho es controlado por la variable fill-column.

Estos comandos se pueden adaptar al margen izquierdo y derecho de forma absoluta mediante set-left-margin y set-right-margin asociados a C-c [ y C-c ] respectivamente.

Existen momentos cuando se edita, que los párrafos quedan desordenados, para ello se debe emplear M-q que ejecutará el comando fill-paragraph.

Márgenes

M-j l: set-justification-left‘; Izquierda.
M-j r: set-justification-right‘; Derecha.
M-j b: set-justification-full‘; Justificado.
M-j c o M-S: set-justification-center‘; Centrado.
M-j u: set-justification-none‘; Sin justificación.

Los estados de márgenes se aplican de forma completa a párrafos. El valor por defecto de los márgenes viene dado por la variable default-justification.

Propiedades especiales

Existen propiedades especiales que al no ser estandares puede no ser interpretadas por otros entornos, sin embargo en emacs tenemos la posibilidad de trabajar partes de texto de sólo lectura (read-only), invisible, e intangible, una no podrá ser modificada, otra no será mostrada y la última no podrá ser accedida con el cursor.

Forzando emacs para reconocer rtf proviniente de otros entornos

Existen propiedades especiales en emacs como por ejemplo M-x format-decode-buffer para traducir el texto y adaptarlo al formato de texto enriquecido. Si en cambio no queremos interpretar dichos formatos de texto enriquecido podremos usar M-x find-file-literally. Para especificar una conversión de carácteres a otro formato específico siempre podremos emplear M-x format-find-file.