X.1 Registros de cambios

El comando de Emacs C-x 4 a agrega una nueva entrada al archivo de registro de cambios del archivo que ud. está editando (add-change-log-entry-other-window). Si dicho archivo es en realidad un archivo de seguridad, crea una entrada adecuada para el padre del archivo: eso sirve para crear entradas de registro de funciones que han sido borradas en la versión actual.

Un archivo de registro de cambios contiene un registro cronológico de cuándo y por qué ud. cambió un programa, que consta de una secuencia de entradas que describen cambios individuales. Normalmente se guarda en un archivo llamado `ChangeLog' en el mismo directorio que el archivo que ud. está editando, o uno de sus directorios padres. Un solo archivo `ChangeLog' puede registrar los cambios de todos los archivo en su directorio y todos sus subdirectorios.

Ud. debería poner un aviso de copyright y un aviso de autorización al final de el archivo de registro de cambios. He aquí un ejemplo:

Copyright 1997, 1998 Free Software Foundation, Inc.
Se permite copiar y distribuir este archivo, con o sin modificaciones,
siempre que se preserven el aviso de copyright y este aviso.

Por supuesto, ud. debería reemplazar los años y titular de copyright según corresponda.

Una entrada de registro de cambios comienza con una línea de encabezado que contiene la fecha actual, su nombre, y su dirección de correo electrónico (tomado de la variable user-mail-address). Aparte de dichas líneas de encabezado, cada línea del registro de cambios comienza con un espacio o un tabulador. La mayor parte de la entrada consiste en items, cada uno de los cuales comienza con una línea que a su vez comienza con espacio en blanco y un asterisco. He aquí dos entradas, ambas fechadas en mayo de 1993, cada una con dos items:

1993-05-25  Richard Stallman  <rms@gnu.org>

        * man.el: Renombra símbolos `man-*' a `Man-*'.
        (manual-entry): Escribe cadena de petición más clara.

        * simple.el (blink-matching-paren-distance):
        Cambia valor predeterminado a 12,000.

1993-05-24  Richard Stallman  <rms@gnu.org>

        * vc.el (minor-mode-map-alist): No usarlo si es nulo.
        (vc-cancel-version): Arreglo en documentación.

Una entrada puede describir varios cambios; cada cambio debería tener su propio ítem. Normalmente debería haber una línea en blanco entre los items. Cuando los items están relacionados (partes del mismo cambio, en distintos lugares), agrupe los items poniéndolos sin espacio en el medio. La segunda entrada de arriba contiene dos items agrupados de esta forma.

C-x 4 a visits the change log file and creates a new entry unless the most recent entry is for today's date and your name. It also creates a new item for the current file. For many languages, it can even guess the name of the function or other object that was changed.

When the option add-log-keep-changes-together is non-nil, C-x 4 a adds to any existing entry for the file rather than starting a new entry.

If the value of the variable change-log-version-info-enabled is non-nil, C-x 4 a adds the file's version number to the change log entry. It finds the version number by searching the first ten percent of the file, using regular expressions from the variable change-log-version-number-regexp-list.

The change log file is visited in Change Log mode. In this major mode, each bunch of grouped items counts as one paragraph, and each entry is considered a page. This facilitates editing the entries. C-j and auto-fill indent each new line like the previous line; this is convenient for entering the contents of an entry.

You can use the command M-x change-log-merge to merge other log files into a buffer in Change Log Mode, preserving the date ordering of entries.

Versions of Emacs before 20.1 used a different format for the time of the change log entry:

Fri May 25 11:23:23 1993 Richard Stallman  <rms@gnu.org>

The M-x change-log-redate command converts all the old-style date entries in the change log file visited in the current buffer to the new format, to make the file uniform in style. This is handy when entries are contributed by many different people, some of whom use old versions of Emacs.

Version control systems are another way to keep track of changes in your program and keep a change log. See section Features of the Log Entry Buffer.

This document was generated by Roberto on enero, 3 2007 using texi2html 1.76.