Manuelles Änderungsprotokoll (Changelog)
Dies beschreibt die traditionelle Methode zur Verwaltung von Änderungsprotokollen, die ein separates Textprotokoll der für Benutzer sichtbaren Änderungen unabhängig von den Git-Commit-Nachrichten bereitstellt. Dies ist eine Alternative zur empfohlenen Methode mit %autochangelog, die in Changelogs beschrieben ist.
Jedes Mal, wenn Sie Änderungen vornehmen, d.h. immer wenn Sie die E-V-R (Epoche-Version-Veröffentlichung) eines Pakets erhöhen, fügen Sie einen Änderungseintrag im Abschnitt +%changelog hinzu.
Änderungsprotokolleinträge sollten eine kurze Zusammenfassung der zwischen den Veröffentlichungen am Paket vorgenommenen Änderungen enthalten. Sie dürfen niemals einfach eine vollständige Kopie der CHANGELOG-Einträge des Quellcodes enthalten. Es gelten die gleichen allgemeinen Regeln wie unter Changelogs beschrieben.
Sie müssen eines der folgenden Formate verwenden:
%changelog
* Fri Jun 23 2006 Jesse Keating <jkeating@redhat.com> - 0.6-4
- And fix the link syntax.%changelog
* Fri Jun 23 2006 Jesse Keating <jkeating@redhat.com> 0.6-4
- And fix the link syntax.%changelog
* Fri Jun 23 2006 Jesse Keating <jkeating@redhat.com>
- 0.6-4
- And fix the link syntax.Wenn Sie Ihre E-Mail-Adresse im Änderungsprotokoll „verschlüsseln“ oder „verheimlichen“ möchten, können Sie dies tun, sofern sie für Menschen noch verständlich ist.
Mehrere Änderungsprotokolleinträge für eine Veröffentlichung
In manchen Situationen kann es für Paketierer hilfreich sein, mehrere Änderungsprotokolleinträge in der Spec-Datei zu haben, ohne das Release-Feld für jeden Eintrag zu erhöhen. Dafür gibt es zwei Methoden:
Aktualisieren und Ersetzen der vorhandenen Datumszeile
In dieser Situation haben Sie diesen Änderungsprotokolleintrag hinzugefügt, das Paket aber noch nicht gebaut:
%changelog
* Nov 12 2010 Toshio Kuratomi <toshio_fedoraproject.org> - 1.0-1
- Fix spelling errors in package descriptionAm nächsten Tag nehmen Sie weitere Änderungen an der Spec-Datei vor und müssen eine neue Änderungsprotokollzeile hinzufügen. Anschließend aktualisieren Sie die bestehende Datumszeile für 1.0-1 und fügen alle neuen Teile hinzu, so dass das Änderungsprotokoll wie folgt aussieht:
%changelog
* Nov 13 2010 Toshio Kuratomi <toshio_fedoraproject.org> - 1.0-1
- Fix spelling errors in package description
- Add a patch to fix compilation problems on F15Bitte beachten Sie, dass dies nur akzeptabel ist, wenn Version 1.0-1 noch nicht gebaut wurde.
Sie können dies beliebig oft wiederholen, bis Sie tatsächlich Version 1.0-1 im Bausystem erstellen. Sobald Sie dies getan haben, müssen Sie die E-V-R-Einstellungen ändern und alle neuen Einträge wie in Changelogs beschrieben hinzufügen.
Wiederholen der Veröffentlichung der alten Version mit einem neuen Eintrag
In dieser Situation haben Sie diesen Änderungsprotokolleintrag hinzugefügt, das Paket aber noch nicht gebaut:
%changelog
* Nov 12 2010 Toshio Kuratomi <toshio_fedoraproject.org> - 1.0-1
- Fix spelling errors in package descriptionAm nächsten Tag nehmen Sie weitere Änderungen an der Spezifikation vor und müssen eine neue Änderungsprotokollzeile hinzufügen. Sie können nun einen zusätzlichen Änderungsprotokolleintrag mit dem neuen Datum, aber derselben Versionsnummer hinzufügen, so dass Ihr neues Änderungsprotokoll wie folgt aussieht:
%changelog
* Nov 13 2010 Toshio Kuratomi <toshio_fedoraproject.org> - 1.0-1
- Add a patch to fix compilation problems on F15
* Nov 12 2010 Toshio Kuratomi <toshio_fedoraproject.org> - 1.0-1
- Fix spelling errors in package descriptionBitte beachten Sie, dass dies nur akzeptabel ist, wenn Version 1.0-1 noch nicht gebaut wurde.
Sie können dies beliebig oft wiederholen, bis Sie tatsächlich Version 1.0-1 im Bausystem erstellen. Sobald Sie dies getan haben, müssen Sie die E-V-R-Einstellungen ändern und alle neuen Einträge wie in Changelogs beschrieben hinzufügen.
Want to help? Learn how to contribute to Fedora Docs ›