.\" -*- 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 "dpkg-genchanges 1"
.TH dpkg-genchanges 1 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)"
dpkg\-genchanges \- ایجاد فایل‌های .changes دبیان
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBdpkg\-genchanges\fR
[\fIگزینه\fR...]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBdpkg\-genchanges\fR
اطلاعات را از یک درخت سورس بازشده و ساخته‌شدهٔ دبیان و از فایل‌هایی که تولید کرده است می‌خواند و یک فایل کنترل بارگذاری دبیان
(فایل
\&\fB.changes\fR)
ایجاد می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-build=\fR\fIنوع\fR 4
.IX Item "--build=type"
\&\fIنوع\fR
ساخت را از یک فهرست از مؤلفه‌ها که با کاما جدا شده‌اند، مشخص می‌کند
(از نسخه dpkg 1.18.5).
.Sp
مقادیر مجاز عبارتند از:
.RS 4
.IP \fBsource\fR 4
.IX Item "source"
بارگذاری بسته سورس (منبع).
.IP \fBany\fR 4
.IX Item "any"
بارگذاری بسته‌های باینری وابسته به معماری.
.IP \fBall\fR 4
.IX Item "all"
بارگذاری بسته‌های باینری مستقل از معماری.
.IP \fBbinary\fR 4
.IX Item "binary"
بارگذاری بسته‌های باینری وابسته و مستقل از معماری.
این یک نام مستعار برای
\&\fBany,all\fR
است.
.IP \fBfull\fR 4
.IX Item "full"
بارگذاری همه‌چیز.
این یک نام مستعار برای
\&\fBsource,any,all\fR
است، و مشابه حالت پیش‌فرض در زمانی است که هیچ گزینه ساختی مشخص نشده باشد.
.RE
.RS 4
.RE
.IP \fB\-g\fR 4
.IX Item "-g"
معادل
\&\fB\-\-build=source,all\fR
(از نسخه dpkg 1.17.11).
.IP \fB\-G\fR 4
.IX Item "-G"
معادل
\&\fB\-\-build=source,any\fR
(از نسخه dpkg 1.17.11).
.IP \fB\-b\fR 4
.IX Item "-b"
معادل
\&\fB\-\-build=binary\fR
یا
\&\fB\-\-build=any,all\fR.
.IP \fB\-B\fR 4
.IX Item "-B"
معادل
\&\fB\-\-build=any\fR.
.IP \fB\-A\fR 4
.IX Item "-A"
معادل
\&\fB\-\-build=all\fR.
.IP \fB\-S\fR 4
.IX Item "-S"
معادل
\&\fB\-\-build=source\fR.
.PP
گزینه‌های
\&\fB\-s\fR\fIx\fR
کنترل می‌کنند که در صورت تولید سورس (یعنی زمانی که
\&\fB\-b\fR
یا
\&\fB\-B\fR
استفاده نشده باشد)، آیا آرشیو سورس اصلی در بارگذاری گنجانده شود یا خیر.
.IP \fB\-si\fR 4
.IX Item "-si"
به‌طور پیش‌فرض، یا در صورت مشخص شدن، سورس اصلی تنها در صورتی گنجانده خواهد شد که شماره نسخه بالادستی (نسخه بدون epoch و بدون بازبینی دبیان) با شماره نسخه بالادستی مدخل قبلی در گزارش تغییرات (changelog) متفاوت باشد.
.IP \fB\-sa\fR 4
.IX Item "-sa"
گنجاندن سورس اصلی را اجباری می‌کند.
.IP \fB\-sd\fR 4
.IX Item "-sd"
عدم گنجاندن سورس اصلی را اجباری کرده و فقط diff را شامل می‌شود.
.IP \fB\-v\fR\fIنسخه\fR 4
.IX Item "-vversion"
باعث می‌شود اطلاعات گزارش تغییرات (changelog) از تمامی نسخه‌هایی که دقیقاً جدیدتر از
\&\fIنسخه\fR
هستند استفاده شود.
.IP \fB\-C\fR\fIشرح\-تغییرات\fR 4
.IX Item "-Cchanges-description"
شرح تغییرات را از فایل
\&\fIشرح\-تغییرات\fR
می‌خواند، به جای اینکه از اطلاعات فایل changelog در درخت سورس استفاده کند.
.IP \fB\-m\fR\fIنشانی\-نگهدارنده\fR 4
.IX Item "-mmaintainer-address"
از
\&\fIنشانی\-نگهدارنده\fR
به عنوان نام و نشانی ایمیل نگهدارنده برای این بسته استفاده می‌کند، به جای استفاده از اطلاعات موجود در فایل کنترل درخت سورس.
.IP \fB\-e\fR\fIنشانی\-نگهدارنده\fR 4
.IX Item "-emaintainer-address"
از
\&\fIنشانی\-نگهدارنده\fR
به عنوان نام و نشانی ایمیل نگهدارنده برای این بارگذاری استفاده می‌کند، به جای استفاده از اطلاعات موجود در changelog درخت سورس.
.IP \fB\-V\fR\fIنام\fR\fB=\fR\fIمقدار\fR 4
.IX Item "-Vname=value"
یک متغیر جایگزینی خروجی را تنظیم می‌کند.
برای بررسی جایگزینی خروجی به
\&\fBdeb\-substvars\fR\|(5)
مراجعه کنید.
.IP \fB\-T\fR\fIفایل\-substvars\fR 4
.IX Item "-Tsubstvars-file"
متغیرهای جایگزینی را در
\&\fIفایل\-substvars\fR
می‌خواند؛ مقدار پیش‌فرض
\&\fBdebian/substvars\fR
است. هیچ جایگزینی متغیری روی هیچ‌یک از فیلدهای خروجی انجام نمی‌شود، به جز محتویات استخراج‌شده از فیلد
\&\fBDescription\fR
هر بسته باینری (از نسخه dpkg 1.19.0)؛ با این حال متغیر ویژه
\&\fIFormat\fR
فیلدی با همین نام را بازنویسی خواهد کرد.
این گزینه می‌تواند چندین بار برای خواندن متغیرهای جایگزینی از چندین فایل استفاده شود (از نسخه dpkg 1.15.6).
.IP \fB\-D\fR\fIفیلد\fR\fB=\fR\fIمقدار\fR 4
.IX Item "-Dfield=value"
یک فیلد فایل کنترل خروجی را بازنویسی کرده یا اضافه می‌کند.
.IP \fB\-U\fR\fIفیلد\fR 4
.IX Item "-Ufield"
یک فیلد فایل کنترل خروجی را حذف می‌کند.
.IP \fB\-c\fR\fIفایل\-کنترل\fR 4
.IX Item "-ccontrolfile"
فایل کنترل سورس اصلی را برای خواندن اطلاعات مشخص می‌کند.
مقدار پیش‌فرض
\&\fBdebian/control\fR
است.
.IP \fB\-l\fR\fIفایل\-changelog\fR 4
.IX Item "-lchangelog-file"
فایل گزارش تغییرات (changelog) را برای خواندن اطلاعات مشخص می‌کند.
مقدار پیش‌فرض
\&\fBdebian/changelog\fR
است.
.IP \fB\-f\fR\fIفایل\-فهرست\-فایل‌ها\fR 4
.IX Item "-ffiles-list-file"
فهرست فایل‌های آماده برای بارگذاری را به جای استفاده از
\&\fBdebian/files\fR
از این فایل می‌خواند.
.IP \fB\-F\fR\fIقالب\-changelog\fR 4
.IX Item "-Fchangelog-format"
قالب فایل changelog را مشخص می‌کند.
برای اطلاعات درباره قالب‌های جایگزین به
\&\fBdpkg\-parsechangelog\fR\|(1)
مراجعه کنید.
.IP \fB\-u\fR\fIدایرکتوری\-فایل‌های\-بارگذاری\fR 4
.IX Item "-uupload-files-dir"
فایل‌های آماده برای بارگذاری را به جای
\&\fB..\fR
در
\&\fIدایرکتوری\-فایل‌های\-بارگذاری\fR
جستجو می‌کند
(دستور
\&\fBdpkg\-genchanges\fR
نیاز به یافتن این فایل‌ها دارد تا بتواند اندازه‌ها و چکسام‌های آن‌ها را در فایل
\&\fB.changes\fR
درج کند).
.IP \fB\-q\fR 4
.IX Item "-q"
معمولاً
\&\fBdpkg\-genchanges\fR
پیام‌های آگاهی‌بخش را در خروجی خطای استاندارد تولید می‌کند، برای نمونه درباره تعداد فایل‌های سورس بسته که در حال بارگذاری هستند.
گزینه
\&\fB\-q\fR
این پیام‌ها را بی‌صدا می‌کند.
.IP \fB\-O\fR[\fIنام\-فایل\fR] 4
.IX Item "-O[filename]"
فایل changes را در خروجی استاندارد (پیش‌فرض) یا در صورت مشخص شدن در
\&\fIنام\-فایل\fR
چاپ می‌کند (از نسخه dpkg 1.18.5).
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
نمایش پیام راهنما و خروج.
.IP \fB\-\-version\fR 4
.IX Item "--version"
نمایش نسخه و خروج.
.SH "محیط (ENVIRONMENT)"
.IX Header "ENVIRONMENT"
.IP \fBDEB_HOST_ARCH\fR 4
.IX Item "DEB_HOST_ARCH"
معماری میزبان را تنظیم می‌کند.
.IP \fBDEB_BUILD_PROFILES\fR 4
.IX Item "DEB_BUILD_PROFILES"
در صورت تنظیم، به عنوان پروفایل(های) ساخت فعال هنگام تولید فایل .changes استفاده خواهد شد.
این متغیر فهرستی از نام‌های پروفایل است که با فاصله از هم جدا شده‌اند.
.IP \fBDPKG_COLORS\fR 4
.IX Item "DPKG_COLORS"
حالت رنگ‌بندی را تنظیم می‌کند (از نسخه dpkg 1.18.5).
مقادیر پذیرفته‌شده فعلی عبارتند از:
\&\fBauto\fR
(پیش‌فرض)،
\&\fBalways\fR
و
\&\fBnever\fR.
.IP \fBDPKG_NLS\fR 4
.IX Item "DPKG_NLS"
در صورت تنظیم، برای تصمیم‌گیری در مورد فعال‌سازی پشتیبانی از زبان بومی (Native Language Support)، که به عنوان بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود، استفاده خواهد شد (از نسخه dpkg 1.19.0).
مقادیر پذیرفته‌شده عبارتند از:
\&\fB0\fR
و
\&\fB1\fR
(پیش‌فرض).
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
.IP \fBdebian/files\fR 4
.IX Item "debian/files"
فهرست فایل‌های تولیدشده‌ای که بخشی از بارگذاری در حال آماده‌سازی هستند.
دستور
\&\fBdpkg\-genchanges\fR
هنگام تولید یک فایل
\&\fB.changes\fR
داده‌ها را از اینجا می‌خواند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBdeb\-substvars\fR\|(5),
\&\fBdeb\-src\-control\fR\|(5),
\&\fBdeb\-src\-files\fR\|(5),
\&\fBdeb\-changelog\fR\|(5),
\&\fBdeb\-changes\fR\|(5).