[newbies] changelog in spec and commit message

[Paul Wolneykien]

В Thu, 25 Sep 2025 14:33:04 +0300
Alexander Lubyagin <lubyagin на yandex.ru> пишет:

> Добрый день.
> 
> В каких случаях запись 'commit message' (git commit -m) дублирует 
> многострочную запись в spec's changelog?
> 
> В каких случаях они различаются? Есть ли рекомендации?

  Основная рекомендация по моей версии такая. Работая в git вы
комментируете свои изменения для других мэйнтейнеров (и для себя).
Проделав эту работу (или попутно) в %changelog пакета вы перечисляете
важные для пользователя изменения, переводя их на понятный пользователю
язык. Таким образом, главное в том, что целевая аудитория у git и
%changelog разная. Всегда нужно думать о том, для кого вы пишете
сообщение.

  К примеру, в git следует написать о том, что была убрана
неиспользуемая функция или забытая переменная в коде, а также о том,
что были исправлены предупреждения (warnings) во время компиляции.
Однако, поскольку для пользователя ровно ничего от этого не изменилось,
в %changelog об этом писать не следует.

  А вот если вы добавили новую переменную в конфигурационный файл, то
написать об этом в %changelog нужно обязательно. Правда относится это
только к вашим собственным изменениям: дублировать release notes из
апстрима в %changelog не нужно (он раздуется тогда до гигантских
размеров). Поэтому при тривиальном обновлении пишем просто "New
version: такая-то" или подобную запись (не регламентировано). Однако,
если сборка новой версии исправляет известную ошибку -- об этом всё
же стоит написать отдельно (с указанием номера ошибки).

  Бывают ситуации, когда в %changelog и написать особо нечего, а хотя
бы строчку написать нужно -- без этого никак. Поэтому бывают записи
наподобие "Recompiled with new libXXYY", которые для пользователя,
в общем-то, не несут никакой полезной информации.