From: Leonid Krivoshein <klark.devel@gmail.com>
To: devel-newbies@lists.altlinux.org
Subject: Re: [newbies] changelog in spec and commit message
Date: Fri, 26 Sep 2025 00:24:28 +0300
Message-ID: <9f475d35-825d-4278-a701-3f4e3ac50efc@gmail.com> (raw)
In-Reply-To: <331cd651-d1dc-44d8-8e80-e6d41b398405@yandex.ru>
Добрый день!
On 9/25/25 14:33, Alexander Lubyagin wrote:
> В каких случаях запись 'commit message' (git commit -m) дублирует
> многострочную запись в spec's changelog?
>
> В каких случаях они различаются? Есть ли рекомендации?
>
Это разные сущности, их вообще не стоит связывать и сравнивать.
Commit message делается по каждому изменению в git'е для других
разработчиков. Заголовок сообщения отвечает на вопрос, что делает
коммит, а тело сообщения -- на вопрос, зачем он это делает. Для многих
коммитов, если это и так очевидно, тело сообщения можно опустить. Ширина
теста в обоих случаях должна быть ограничена, см. в книге
https://git-scm.com/book/ru/v2 (раздел "Правила создания коммитов").
Changelog в SPEC'ах делается для пользователей, а не для разработчиков.
В нём не нужно отражать все изменения в исходниках. В нём отражаются
наиболее важные изменения новой сборки пакета. По его написанию есть
своё руководство:
https://www.altlinux.org/Руководство_по_написанию_changelog
Если я, как разработчик, одним коммитом в git/исходники вношу важное
изменение в будущую сборку, только тогда сообщения в changelog и commit
message совпадут, такое встречается, но не так часто.
--
WBR, Leonid Krivoshein.
prev parent reply other threads:[~2025-09-25 21:24 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-09-25 11:33 Alexander Lubyagin
2025-09-25 11:43 ` Anton Farygin
2025-09-25 11:44 ` Anton Farygin
2025-09-25 12:12 ` Paul Wolneykien
2025-09-25 21:24 ` Leonid Krivoshein [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=9f475d35-825d-4278-a701-3f4e3ac50efc@gmail.com \
--to=klark.devel@gmail.com \
--cc=devel-newbies@lists.altlinux.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
devel@ where you _can_ ask
This inbox may be cloned and mirrored by anyone:
git clone --mirror http://lore.altlinux.org/devel-newbies/0 devel-newbies/git/0.git
# If you have public-inbox 1.1+ installed, you may
# initialize and index your mirror using the following commands:
public-inbox-init -V2 devel-newbies devel-newbies/ http://lore.altlinux.org/devel-newbies \
devel-newbies@lists.altlinux.org devel-newbies@lists.altlinux.ru devel-newbies@lists.altlinux.com
public-inbox-index devel-newbies
Example config snippet for mirrors.
Newsgroup available over NNTP:
nntp://lore.altlinux.org/org.altlinux.lists.devel-newbies
AGPL code for this site: git clone https://public-inbox.org/public-inbox.git