212 lines
8.2 KiB
HTML
212 lines
8.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of deb-changelog</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>deb-changelog</H1>
|
|
Section: dpkg-suite (5)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAAM</H2>
|
|
|
|
deb-changelog - indeling van het dpkg changelog-bestand van
|
|
broncodepakketten
|
|
<A NAME="lbAC"> </A>
|
|
<H2>OVERZICHT</H2>
|
|
|
|
changelog
|
|
<A NAME="lbAD"> </A>
|
|
<H2>BESCHRIJVING</H2>
|
|
|
|
Wijzigingen aan de ingepakte versie van een project worden in het
|
|
changelog-bestand <I>debian/changelog</I> toegelicht. Daar vallen in de broncode
|
|
aangebrachte veranderingen ten opzichte van die van de toeleveraar onder,
|
|
evenals andere wijzigingen en updates aan het pakket.
|
|
<P>
|
|
|
|
De indeling van het bestand <I>debian/changelog</I> laat het gereedschap voor
|
|
het bouwen van pakketten toe om uit te zoeken welke versie van het pakket
|
|
gebouwd wordt en om andere release-specifieke informatie te weten te komen.
|
|
<P>
|
|
|
|
Deze indeling bestaat uit een reeks vermeldingen zoals deze:
|
|
<P>
|
|
<PRE>
|
|
<I>pakket</I> (<I>versie</I>) <I>distributies</I>; <I>metadata</I>
|
|
[optioneel (een) blanco regel(s), die gestript worden]
|
|
* <I>informatie-over-de-veranderingen</I>
|
|
<I>nog-informatie-i.v.m.-de-aanpassingen</I>
|
|
[blanco regel(s), zichtbaar in de uitvoer van <B><A HREF="/cgi-bin/man/man2html?1+dpkg-parsechangelog">dpkg-parsechangelog</A></B>(1)]
|
|
* <I>en-eventueel-nog-meer-wijzigingsinformatie</I>
|
|
[optioneel (een) blanco regel(s), die gestript worden]
|
|
-- <I>naam-van-de-onderhouder</I> <<I>e-mailadres</I>> <I>datum</I>
|
|
</PRE>
|
|
|
|
<P>
|
|
<P>
|
|
|
|
<I>pakket</I> en <I>versie</I> zijn de naam van het broncodepakket en zijn
|
|
versienummer.
|
|
<P>
|
|
|
|
<I>distributies</I> somt één of meer door een spatie van elkaar gescheiden
|
|
distributies op waarin deze versie ondergebracht moet worden als ze geüpload
|
|
wordt; dit wordt gekopieerd naar het veld <B>Distribution</B> in het bestand
|
|
<I>.changes</I>.
|
|
<P>
|
|
|
|
<I>metadata</I> is een lijst items van het type <I>trefwoord</I>=<I>waarde</I> die
|
|
onderling door een komma gescheiden worden. De enige <I>trefwoord</I>en die
|
|
momenteel ondersteund worden door <B>dpkg</B> zijn <B>urgency</B> en
|
|
<B>binary-only</B>. De waarde van <B>urgency</B> wordt gebruikt voor het
|
|
<B>Urgency</B>-veld in het <I>.changes</I>-bestand voor de upload. <B>binary-only</B>
|
|
met als waarde <B>yes</B> wordt gebruikt om aan te geven dat dit changelog-item
|
|
betrekking heeft op een niet door de onderhouder gedane upload van
|
|
uitsluitend het(de) binaire pakket(ten) (een automatisch opnieuw bouwen van
|
|
het(de) binaire pakket(ten) met het changelog-item als enige aangebrachte
|
|
wijziging).
|
|
<P>
|
|
|
|
De informatie over de wijzigingen kan in feite om het even welk aantal
|
|
regels beslaan die beginnen met minstens twee spaties. Gewoonlijk begint men
|
|
bij het beschrijven van een wijziging steeds met een asterisk, gevolgd door
|
|
een spatie. Eventuele vervolgregels springen zo in dat ze uitgelijnd zijn
|
|
met de tekst van de regel erboven. Als men dat wenst kunnen blanco regels
|
|
gebruikt worden om groepen van veranderingen onderling te scheiden.
|
|
<P>
|
|
|
|
Indien deze upload bugs oplost die vermeld staan in het opvolgingssysteem
|
|
voor bugs van de distributie, kunnen die automatisch gesloten worden op het
|
|
ogenblik dat het pakket opgenomen wordt in het archief van de distributie,
|
|
indien de tekenreeks
|
|
<PRE>
|
|
<B>Closes: Bug#</B><I>nnnnn</I>
|
|
</PRE>
|
|
|
|
opgenomen wordt in de beschrijving van de wijzigingen (de exacte Perl
|
|
reguliere expressie is
|
|
<B>/closes:\s*(?:bug)?\#?\s?\d+(?:,\s*(?:bug)?\#?\s?\d+)*/i</B>). Deze
|
|
informatie wordt overgedragen via het veld <B>Closes</B> in het bestand
|
|
<I>.changes</I>.
|
|
<P>
|
|
|
|
De naam van de onderhouder en het e-mailadres die in het changelog-bestand
|
|
vermeld worden moeten betrekking hebben op de persoon die deze release van
|
|
het pakket voorbereidde. Deze gegevens betreffen <B>niet</B> noodzakelijk de
|
|
persoon die het pakket uploadt of de persoon die het pakket gewoonlijk
|
|
onderhoudt. Deze informatie wordt gekopieerd naar het veld <B>Changed-By</B> in
|
|
het bestand <I>.changes</I> en zal later, wanneer de upload in het
|
|
distributiearchief ondergebracht wordt, gebruikt worden voor het zenden van
|
|
een kennisgeving.
|
|
<P>
|
|
|
|
De <I>datum</I> heeft de volgende indeling (compatibel met en met dezelfde
|
|
betekenis als in RFC2822 en RFC5322, of hetgeen het commando «date -R»
|
|
genereert):
|
|
<DL COMPACT>
|
|
<DT id="1"><DD>
|
|
<I>dag-van-de-week</I><B>,</B> <I>dd</I> <I>maand</I> <I>jjjj</I> <I>uu</I><B>:</B><I>mm</I><B>:</B><I>ss</I>
|
|
<B>+</B><I>zzzz</I>
|
|
</DL>
|
|
<P>
|
|
|
|
waarbij
|
|
<DL COMPACT>
|
|
<DT id="2"><I>dag-van-de-week</I><DD>
|
|
een van volgende mogelijkheden is: <B>Mon</B>, <B>Tue</B>, <B>Wed</B>, <B>Thu</B>, <B>Fri</B>,
|
|
<B>Sat</B>, <B>Sun</B>.
|
|
<DT id="3"><I>dd</I><DD>
|
|
met één of twee cijfers de dag van de maand aanduidt (<B>01</B>-<B>31</B>).
|
|
<DT id="4"><I>maand</I><DD>
|
|
een van volgende mogelijkheden is: <B>Jan</B>, <B>Feb</B>, <B>Mar</B>, <B>Apr</B>, <B>May</B>,
|
|
<B>Jun</B>, <B>Jul</B>, <B>Aug</B>, <B>Sep</B>, <B>Oct</B>, <B>Nov</B>, <B>Dec</B>.
|
|
<DT id="5"><I>jjjj</I><DD>
|
|
met vier cijfers het jaar aanduidt (bijv. 2010).
|
|
<DT id="6"><I>uu</I><DD>
|
|
met twee cijfers het uur aanduidt (<B>00</B>-<B>23</B>).
|
|
<DT id="7"><I>mm</I><DD>
|
|
met twee cijfers de minuut aanduidt (<B>00</B>-<B>59</B>).
|
|
<DT id="8"><I>ss</I><DD>
|
|
met twee cijfers de seconde aanduidt (<B>00</B>-<B>60</B>).
|
|
<DT id="9">[<B>+-</B>]<I>zzzz</I><DD>
|
|
aanduidt wat het tijdsverschil is tegenover de gecoördineerde wereldtijd
|
|
(UTC). '<B>+</B>' geeft aan dat de tijd voorloopt op UTC (d.w.z. dat de tijdzone
|
|
zich ten oosten van de nulmeridiaan bevindt) en '<B>-</B>' geeft aan dat de tijd
|
|
achterloopt op UTC (d.w.z. dat de tijdzone zich ten oosten van de
|
|
nulmeridiaan bevindt). De eerste twee cijfers geven aan hoeveel uur het
|
|
verschil bedraagt ten opzichte van UTC en de laatste twee hoeveel extra
|
|
minuten het verschil is ten opzichte van UTC. De laatste twee cijfers moeten
|
|
vallen binnen het bereik <B>00</B>-<B>59</B>.
|
|
</DL>
|
|
<P>
|
|
|
|
De eerste "titel"-regel met de naam van het pakket moet beginnen aan de
|
|
linkermarge. De "volgende" regel met de gegevens over de onderhouder en de
|
|
datum moet door exact één spatie voorafgegaan worden. Tussen de informatie
|
|
over de onderhouder en de datum moeten exact twee spaties staan.
|
|
<P>
|
|
|
|
Elke regel die volledig (d.w.z. zonder voorafgaande witruimte) bestaat uit
|
|
commentaar in de vorm van <B>#</B>- of <B>/* */</B> of RCS-trefwoorden.
|
|
<P>
|
|
|
|
Modusregels van Vim of lokale variabelen van Emacs en oudere
|
|
changelog-elementen met een andere indeling aan het einde van het bestand,
|
|
moeten aanvaard worden en in de uitvoer behouden blijven, maar de inhoud
|
|
ervan kan verder genegeerd worden en het ontleden kan op dat punt gestopt
|
|
worden.
|
|
<P>
|
|
|
|
Het volledige changelog-bestand moet in UTF-8 opgemaakt zijn.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>BESTANDEN</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="10"><I>debian/changelog</I><DD>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>VOORBEELDEN</H2>
|
|
|
|
<PRE>
|
|
dpkg (1.17.18) unstable; urgency=low
|
|
|
|
[ Guillem Jover ]
|
|
* Handle empty minimum versions when initializing dependency versions,
|
|
as the code is mapping the minimum version 0 to '' to avoid outputting
|
|
useless versions. Regression introduced in dpkg 1.17.17. Closes: #764929
|
|
|
|
[ Updated programs translations ]
|
|
* Catalan (Guillem Jover).
|
|
|
|
[ Updated dselect translations ]
|
|
* Catalan (Guillem Jover).
|
|
* German (Sven Joachim).
|
|
|
|
-- Guillem Jover <<A HREF="mailto:guillem@debian.org">guillem@debian.org</A>> Sun, 12 Oct 2014 15:47:44 +0200
|
|
</PRE>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ZIE OOK</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?7+deb-version">deb-version</A></B>(7), <B><A HREF="/cgi-bin/man/man2html?5+deb-changes">deb-changes</A></B>(5), <B><A HREF="/cgi-bin/man/man2html?1+dpkg-parsechangelog">dpkg-parsechangelog</A></B>(1).
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="11"><A HREF="#lbAB">NAAM</A><DD>
|
|
<DT id="12"><A HREF="#lbAC">OVERZICHT</A><DD>
|
|
<DT id="13"><A HREF="#lbAD">BESCHRIJVING</A><DD>
|
|
<DT id="14"><A HREF="#lbAE">BESTANDEN</A><DD>
|
|
<DT id="15"><A HREF="#lbAF">VOORBEELDEN</A><DD>
|
|
<DT id="16"><A HREF="#lbAG">ZIE OOK</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:19 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|