%changelog

Формировать его удобнее (и надёжнее!) при помощи add_changelog (существуют также макросы для vim и, кажется, *emacs).

Пример хороших записей (структурировать лучше именно так):

* Sat Jul 02 2005 Sergey Vlasov <vsu@altlinux> 2.6.12-alt1 - 2.6.12. - Updated kernel-fix-build, kernel-fix-core, kernel-fix-drivers-char, kernel-fix-drivers-ide, kernel-fix-drivers-media, kernel-fix-drivers-net, kernel-fix-drivers-pci, kernel-fix-drivers-scsi, kernel-fix-drivers-usb, kernel-fix-drivers-video, kernel-fix-fs, kernel-fix-net, kernel-fix-security: - removed obsolete patches - Updated kernel-fix-acpi: + updated acpi-attrs and suspend-setup-leave patches for 2.6.12 + call acpi_register_gsi() even for default PCI interrupt assignment (needed to set PCI interrupts to level/low properly) - Updated kernel-fix-core: + round size in remap_pfn_range() up to a page boundary + add "memory" clobbers to string.h functions to avoid memory access reordering by gcc - Updated kernel-fix-drivers-media: + updated Manli and BeholdTV remote control support patch for 2.6.12 - Updated kernel-fix-drivers-net: + e1000: fix spinlock bug - Updated kernel-fix-drivers-pci: + fix typo in drv->driver.shutdown setting for PCI drivers that might result in not setting drv->driver.owner - Updated kernel-fix-drivers-scsi: + fix qla2xxx initialization problems - Updated kernel-fix-drivers-usb: + updated old_scheme_first patch for 2.6.12 - Updated kernel-fix-net: + fix connection tracking on bridges + fix socket hashing bugs in netlink - Updated kernel-fix-security: + CAN-2005-1913 - Updated kernel-feat-drivers-input: + updated trackpoint support patch: - warning: module parameters for trackpoint device configuration are no longer available - use sysfs for configuration; - support for scroll emulation in the driver was removed - use the appropriate Xorg options - Updated kernel-feat-drivers-lirc, kernel-feat-drivers-sk98lin: + fix compilation with 2.6.12 - Updated kernel-feat-drivers-video-splash: + updated splash patch for kernel 2.6.12

Если пакет содержит исправления по части безопасности, следует добавить идентификацию проблемы принятым образом (например, по CVE:

* Tue Oct 11 2005 Dmitry V. Levin <ldv@altlinux.org> 0.9.7d-alt2 - Applied upstream fix for potential SSL 2.0 rollback during SSL handshake (CAN-2005-2969).

Соображения о плохих идеях насчёт ченжлога можно почитать здесь?.