88.3.4. Deník změn (ChangeLog)

section id="emacs.changelog"

Zdroje a odkazy:

Deník změn je soubor pojmenovaný ChangeLog jenž obsahuje záznamy o změnách v souborech projektu. Tyto záznamy chronologicky řazené popisují kdo a kdy provedl změnu a v jakých souborech.

Na konec souboru ChangeLog můžete přidat copyright notice a permission notice. Například

Copyright 1997, 1998 Free Software Foundation, Inc.
Copying and distribution of this file, with or without modification,
are permitted provided the copyright notice and this notice are
preserved.

Záznam v deníku začíná řádkem hlavičky který obsahuje aktuální datum, jméno autora změny a jeho emailovou adresu. Každý řádek (další) mimo počáteční řádky záznamů začíná mezerou nebo tabelátorem.

1993-05-25  Richard Stallman  

        * man.el: Rename symbols `man-*' to `Man-*'.
        (manual-entry): Make prompt string clearer.

        * simple.el (blink-matching-paren-distance):
        Change default to 12,000.

1993-05-24  Richard Stallman  

        * vc.el (minor-mode-map-alist): Don't use it if it's void.
        (vc-cancel-version): Doc fix.

Jeden záznam popisuje několik změn, každá ná dalším řádku.

C-j

FIXME:

M-x change-log-merge

FIXME:

Ctrl+x [ backward-page

FIXME:

Ctrl+x ] forward--page

FIXME:

Meta+[ backward-paragraph

FIXME:

Meta+] forward-paragraph

FIXME:

Esc h mark-paragraph

FIXME:

Ctrl+x a, add-change-log-entry

Pomáhá udržovat záznamy o provedených změnách v programu/souboru. Předpokládá(funkce) že máme k dispozici soubor do kterého provádíme chronologicky záznamy popisující individuální změny. Implicitní jméno tohoto souboru je ChangeLog a je uložen/očekáván ve stejném adresáři jako editované soubory.

Nalezne soubor změn ChangeLog a přidá do něj záznam pro dnešní den, soubor a FIXME:defun.

Ctrl+x 4 a , add-change-log-entry-other-window

Příkaz vloží novou položku/záznam pro aktuálně editovaný soubor do deníku změn, souboru ChangeLog.

Je-li parametr/proměnná add-log-keep-changes-together ne nil, příkaz vloží záznam do aktuálního raději než aby otevíral nový záznam.

Je-li parametr/proměnná change-log-version-info-enabled ne nil, příkaz přídá do hlavičky číslo verze. Tot číslo získá prozkoumáním první desetiny souboru (10%) s použitím regulárního výrazu v proměnné change-log-version-number-regexp-list.

add-change-log-entry-rcs-format

Default: ",v %s"