.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "deb-changelog 5"
.TH deb-changelog 5 2026-03-06 1.23.7-dirty "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
deb-changelog \- پرونده گزارش تغییرات بسته‌های منبع دبیان
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBdebian/changelog\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
تغییرات در نگارش بسته‌بندی‌شده یک پروژه در پرونده گزارش تغییرات
\fIdebian/changelog\fR
توضیح داده می‌شوند.
این مورد شامل اصلاحات انجام‌شده در بسته منبع در مقایسه با نگارش بالادستی (upstream) و همچنین سایر تغییرات و به‌روزرسانی‌های بسته است.
.PP
قالب
\fIdebian/changelog\fR
به ابزارهای ساخت بسته اجازه می‌دهد دریابند کدام نگارش از بسته در حال ساخت است و اطلاعات اختصاصی دیگر انتشار را به دست آورند.
.PP
این قالب مجموعه‌ای از مدخل‌ها به این شکل است:
.PP
.nf
 \fIpackage\fR (\fIversion\fR) \fIdistributions\fR; \fImetadata\fR
          [خط(های) خالی اختیاری، حذف می‌شوند]
  * \fIchange\-details\fR
    \fImore\-change\-details\fR
          [خط(های) خالی، در خروجی \fBdpkg\-parsechangelog\fR\|(1) گنجانده می‌شوند]
  * \fIeven\-more\-change\-details\fR
          [خط(های) خالی اختیاری، حذف می‌شوند]
  \-\- \fImaintainer\-name\fR <\fIemail\-address\fR>  \fIdate\fR
.fi
.PP
\&\fIpackage\fR
و
\fIversion\fR
نام بسته منبع و شماره نگارش آن هستند.
\&\fIversion\fR
بین پرانتزهای U+0028 \(oq\fB(\fR\(cq و U+0029 \(oq\fB)\fR\(cq محدود شده است.
.PP
\&\fIdistributions\fR
یک یا چند توزیع جداشده با فاصله را فهرست می‌کند که این نگارش هنگام بارگذاری (upload) باید در آن‌ها نصب شود؛ این مقدار به فیلد
\fBDistribution\fR
در پرونده
\fI.changes\fR
کپی می‌شود.
\&\fIdistributions\fR
باید با یک نقطه\-ویرگول (سیکولون، U+003B \(oq\fB;\fR\(cq) خاتمه یابد.
.PP
\&\fImetadata\fR
صفر یا چند مورد
\fIkeyword\fR=\fIvalue\fR
جداشده با کاما را فهرست می‌کند.
هر کلیدواژه فقط می‌تواند شامل علامت منها و نویسه‌های الفبایی\-عددی بدون حساسیت به حروف کوچک و بزرگ باشد، زیرا باید به نام‌های فیلد
\fBdeb822\fR\|(5)
نگاشت شوند.
تنها \fIkeyword\fRهایی که در حال حاضر توسط
\fBdpkg\fR
پشتیبانی می‌شوند عبارتند از:
.IP \fBurgency\fR 4
.IX Item "urgency"
مقدار آن برای فیلد
\fBUrgency\fR
در پرونده
\fI.changes\fR
هنگام بارگذاری استفاده می‌شود.
.IP \fBbinary\-only\fR 4
.IX Item "binary-only"
با مقدار
\fByes\fR،
برای نشان دادن این موضوع استفاده می‌شود که این مدخل گزارش تغییرات مربوط به یک بارگذاری غیرنگهدارنده صرفاً دودویی (binary-only non-maintainer upload) است (یک بازساخت خودکار دودویی که تنها تغییر آن خود مدخل گزارش تغییرات است).
.PP
جزئیات تغییرات در واقع می‌تواند هر مجموعه‌ای از خطوط باشد که با دست‌کم دو فاصله (U+0020 \fBSPACE\fR) شروع می‌شوند، اما به صورت قراردادی هر تغییر با یک علامت ستاره و یک فاصله جداکننده آغاز می‌شود و خط‌های ادامه‌دار به گونه‌ای تورفتگی پیدا می‌کنند که با شروع متن بالاتر تراز شوند.
در صورت تمایل می‌توان از خط‌های خالی برای جداسازی گروه‌های تغییرات استفاده کرد.
.PP
اگر این بارگذاری باگ‌های ثبت‌شده در سامانه پیگیری باگ توزیع را برطرف کند، ممکن است با گنجاندن رشته زیر در جزئیات تغییرات:
.Sp
.RS 4
\&\fBCloses: #\fR\fInnnnn\fR
.RE
.PP
با گنجانده شدن این بسته در بایگانی توزیع، باگ‌ها به طور خودکار بسته شوند، که در آن
\fB#\fR\fInnnnn\fR
شماره باگ است.
عبارت باقاعده (regex) دقیق پرل به شرح زیر است:
.Sp
.RS 4
\&\fB/closes:\es*(?:bug)?\e#?\es?\ed+(?:,\es*(?:bug)?\e#?\es?\ed+)*/i\fR
.RE
.PP
به بیان دیگر، این رشته باید شامل واژه
\fBcloses:\fR
به همراه فهرستی از شماره‌های باگ جداشده با کاما باشد.
شماره‌های باگ ممکن است با کلمه
\fBbug\fR
یا علامت
\fB#\fR
شروع شوند، مانند
\f(CW\*(C`Closes: 42, bug#43, #44, bug 45\*(C'\fR.
واژه‌های
\fBcloses:\fR
و
\fBbug\fR
به بزرگی و کوچکی حروف حساس نیستند.
فهرست شماره‌های باگ می‌تواند چند خط را در بر بگیرد.
.PP
این اطلاعات از طریق فیلد
\fBCloses\fR
در پرونده
\fI.changes\fR
منتقل می‌شود.
در آنجا، بسته به نرم‌افزار مدیریت بایگانی، تمام شماره باگ‌های فهرست‌شده ممکن است به طور خودکار بسته شوند.
.PP
نام و نشانی رایانامه نگه‌دارنده که در گزارش تغییرات استفاده می‌شود باید مشخصات فردی باشد که این انتشار از بسته را آماده کرده است.
این اطلاعات الزماً
\fBنه\fR
مشخصات بارگذار است و نه نگه‌دارنده همیشگی بسته.
اطلاعات موجود در اینجا در فیلد
\fBChanged\-By\fR
در پرونده
\fI.changes\fR
کپی خواهد شد، و ممکن است بعداً هنگام نصب بارگذاری در بایگانی توزیع، برای ارسال پیام تایید و وصول استفاده شود.
.PP
متغیر \fIdate\fR دارای قالب زیر است (سازگار و با همان بار معنایی RFC2822 و RFC5322، یا آنچه دستور \(Fodate \-R\(Fc تولید می‌کند):
.Sp
.RS 4
\&\fIday\-of\-week\fR\fB,\fR \fIdd\fR \fImonth\fR \fIyyyy\fR \fIhh\fR\fB:\fR\fImm\fR\fB:\fR\fIss\fR \fB+\fR\fIzzzz\fR
.RE
.PP
که در آن:
.IP \fIday\-of\-week\fR 4
.IX Item "day-of-week"
یکی از این موارد است:
\&\fBMon\fR، \fBTue\fR، \fBWed\fR، \fBThu\fR، \fBFri\fR، \fBSat\fR، \fBSun\fR.
.IP \fIdd\fR 4
.IX Item "dd"
روز یک یا دو رقمی ماه (\fB01\fR\-\fB31\fR) است که صفر آغازین اختیاری است، اما به صورت سنتی حذف نمی‌شود.
.IP \fImonth\fR 4
.IX Item "month"
یکی از این موارد است:
\&\fBJan\fR، \fBFeb\fR، \fBMar\fR، \fBApr\fR، \fBMay\fR، \fBJun\fR، \fBJul\fR، \fBAug\fR،
\&\fBSep\fR، \fBOct\fR، \fBNov\fR، \fBDec\fR.
.IP \fIyyyy\fR 4
.IX Item "yyyy"
سال چهار رقمی است (مانند 2010).
.IP \fIhh\fR 4
.IX Item "hh"
ساعت دو رقمی است (\fB00\fR\-\fB23\fR).
.IP \fImm\fR 4
.IX Item "mm"
دقیقه دو رقمی است (\fB00\fR\-\fB59\fR).
.IP \fIss\fR 4
.IX Item "ss"
ثانیه دو رقمی است (\fB00\fR\-\fB60\fR).
.IP [\fB+\-\fR]\fIzzzz\fR 4
.IX Item "[+-]zzzz"
اختلاف منطقه زمانی نسبت به زمان هماهنگ جهانی (UTC) است.
علامت \(oq\fB+\fR\(cq نشان می‌دهد زمان جلوتر از UTC (یعنی شرق آن) است و
\(oq\fB\-\fR\(cq نشان می‌دهد زمان عقب‌تر از UTC (یعنی غرب آن) است.
دو رقم اول اختلاف ساعت نسبت به UTC و دو رقم آخر دقایق اضافی اختلاف نسبت به UTC را نشان می‌دهند.
دو رقم آخر باید در بازه \fB00\fR\-\fB59\fR باشند.
.PP
نخستین خط «عنوان» (title) با نام بسته باید دقیقاً از حاشیه سمت چپ آغاز شود.
پیش از خط «پایانی» (trailer) حاوی مشخصات نگه‌دارنده و تاریخ، باید دقیقاً یک فاصله (U+0020 \fBSPACE\fR) قرار گیرد.
مشخصات نگه‌دارنده و تاریخ باید دقیقاً با دو فاصله (U+0020 \fBSPACE\fR) از یکدیگر جدا شوند.
هر بخش از \fIdate\fR می‌تواند با یک یا چند فاصله (U+0020 \fBSPACE\fR) جدا شود، به‌جز پس از کاما که می‌تواند با صفر یا چند فاصله (U+0020 \fBSPACE\fR) جدا شود.
.PP
هر خطی که به طور کامل (یعنی بدون هیچ فاصله آغازین) متشکل از نماد \fB#\fR یا یادداشت‌های به شیوه \fB/* */\fR یا کلیدواژه‌های RCS باشد باید نادیده گرفته شود.
.PP
خطوط modeline در Vim یا متغیرهای محلی Emacs، و مدخل‌های قدیمی گزارش تغییرات با قالب‌های دیگر در انتهای پرونده باید پذیرفته شده و در خروجی حفظ شوند، اما ممکن است محتوای آن‌ها در غیر این صورت نادیده گرفته شود و تجزیه پرونده در آن نقطه متوقف شود.
.PP
کل پرونده گزارش تغییرات باید با کدگذاری UTF\-8 باشد.
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
.IP \fIdebian/changelog\fR 4
.IX Item "debian/changelog"
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
.Vb 1
\& 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 <guillem@debian.org>  Sun, 12 Oct 2014 15:47:44 +0200
.Ve
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBdeb822\fR\|(5),
\&\fBdeb\-changes\fR\|(5),
\&\fBdeb\-version\fR\|(7),
\&\fBdpkg\-parsechangelog\fR\|(1).