Fix %changelog in cta.spec.in
Problem to solve
The file cta.spec.in
has a section %changelog
which contains the changelog for the packaged RPM. This changelog forms part of the RPM and can be viewed using rpm -q --changelog -p <rpm>
.
When I read up on this, I learned that this changelog is the changelog for the RPM itself, NOT the changelog of the CTA software. In other words, it should only contain changes to the spec file:
Just as many programs include a ChangeLog with the source code, RPM allows you to embed a ChangeLog for the RPM directly inside the
.spec
file. This helps identify what changes have been made to the RPM package for other users. It should list changes made to the.spec
file, upgrades to new versions, and so forth.
The list of changes can be as long as is necessary, but keep in mind that this should be a list of changes for the RPM itself and not for the package. It’s considered bad form to include the ChangeLog of the actual program in the RPM ChangeLog.
Additional information
Entries in the %changelog
section should follow this format:
* [dow mon dd yyyy] [Firstname Lastname [email address]] [RPM version]
- list of changes
Example:
Thu Mar 03 2022 Aurélien Gounon <aurelien.gounon@cern.ch> 4.5.2-1
- move cta-versionlock apply to posttrans
Stakeholders
End-users of CTA RPMs.
In other words, this issue needs to be fixed for the public release.