.TH CHANGESTOOL 1 "2010-03-19" "reprepro" REPREPRO
.SH "نام (NAME)"
changestool \- دستکاری و ویرایش فایل‌های تغییرات debian .changes
.SH "خلاصه دستور (SYNOPSIS)"
.B changestool \-\-help

.B changestool
[
\fIگزینه‌ها\fP
]
\fI.changes-filename\fP
\fIدستور\fP
[
\fIآرگومان‌های دستور\fP
]
.SH "توضیحات (DESCRIPTION)"
دستور changestool برنامه‌ای کوچک برای کار با فایل‌های .changes دبیان است،
همان‌طور که توسط \fBdpkg\-genchanges\fP(1) تولید می‌شوند و برای تغذیه
بسته‌های ساخته‌شده دبیان به ابزارهای مدیریت مخزن دبیان مانند
.BR  reprepro (1)
یا
.BR dak
استفاده می‌شوند.

.SH "مثال‌ها (EXAMPLES)"
.P
.B changestool \fIbloat.changes\fP setdistribution \fIlocal\fP
.br
هدر \fBDistribution:\fP درون فایل \fIbloat.changes\fP را اصلاح می‌کند
تا به جای مقدار قبلی، \fIlocal\fP قرار گیرد.
.P
.B changestool \fIreprepro_1.2.0\-1.local_sparc.changes\fP includeallsources
.br
فایل داده‌شده را اصلاح می‌کند تا فایل \fB.orig.tar.gz\fP را نیز فهرست کند،
فایلی که در فهرست نیست چون ساخت آن با
.BR "dpkg\-buildpackage \-sa"
فراموش شده بود.
.P
.B changestool \fIblafasel_1.0_abacus.changes\fP updatechecksums
.br
مقدارهای md5sum را با مقدارهای فایل‌های ارجاع‌شده توسط این فایل به‌روزرسانی می‌کند.
(به این ترتیب می‌توان پیش از بارگذاری در مخزن بسته شخصی، اصلاحات سریع روی آن‌ها انجام داد)
.P
.B changestool \-\-create \fItest.changes\fP add \fIbla_1\-1.dsc bla_1\-1_abacus.deb\fP
.br
فایل‌های مشخص‌شده را اضافه می‌کند (فرمت از روی نام فایل تشخیص داده می‌شود؛
اگر فرمت را می‌دانید از \fBadddeb\fP یا \fBadddsc\fP استفاده کنید).
اگر فایل \fItest.changes\fP هنوز وجود نداشته باشد، یک فایل کمینه تولید خواهد شد؛
گرچه ممکن است برای بیشتر کاربردهای مستقیم بیش از حد کمینه باشد.

.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
گزینه‌ها می‌توانند پیش از دستور مشخص شوند. هر گزینه روی زیرمجموعه متفاوتی
از دستورات اثر می‌گذارد و توسط سایر دستورات نادیده گرفته می‌شود.
.TP
.B \-h \-\-help
نمایش فهرست کوتاهی از گزینه‌ها و دستورات به همراه توضیحات.
.TP
.B \-o \-\-outputdir \fIdir\fP
هنوز پیاده‌سازی نشده است.
.TP
.B \-s \-\-searchpath \fIpath\fP
فهرستی از دایرکتوری‌ها که با دونقطه (colon) جدا شده‌اند برای جستجوی فایل‌ها
در صورتی که در دایرکتوری فایل .changes یافت نشوند.
.TP
.B \-\-create
فلگی برای دستوراتی که با \fBadd\fP شروع می‌شوند جهت ایجاد فایل \fB.changes\fP
در صورتی که هنوز وجود نداشته باشد.
.TP
.B \-\-create\-with\-all\-fields
فلگی برای دستوراتی که با \fBadd\fP شروع می‌شوند جهت ایجاد فایل \fB.changes\fP
در صورتی که هنوز وجود نداشته باشد.
برخلاف \fB\-\-create\fP، این گزینه فیلدهای بیشتری ایجاد می‌کند تا ابزارهایی مانند dupload
راضی‌تر باشند.
در حال حاضر این گزینه فیلدهای ساختگی \fBUrgency\fP و \fBChanges\fP ایجاد می‌کند.
.SH "دستورات (COMMANDS)"
.TP
.BR verify
بررسی ناهمخوانی‌ها در فایل \fB.changes\fP مشخص‌شده و فایل‌های ارجاع‌شده توسط آن.
.TP
.BR updatechecksums " [ " \fIfilename\fP " ]"
به‌روزرسانی اطلاعات چکسام (md5sum و اندازه) درون فایل \fB.changes\fP مشخص‌شده
و تمام فایل‌های \fB.dsc\fP ارجاع‌شده توسط آن.
بدون آرگومان، تمام فایل‌ها به‌روزرسانی خواهند شد.
برای به‌روزرسانی فقط فایل‌های خاص، نام فایل آن‌ها (بدون مسیر) را به عنوان آرگومان بدهید.
.TP
.BR setdistribution " [ " \fIdistributions\fP " ]"
تغییر هدر \fBDistribution:\fP برای فهرست کردن آرگومان‌های باقی‌مانده.
.TP
.BR includeallsources " [ " \fIfilename\fP " ]"
فهرست کردن تمام فایل‌های ارجاع‌شده توسط فایل‌های \fB.dsc\fP ذکرشده در فایل \fB.changes\fP
درون همان فایل.
بدون آرگومان، تمام فایل‌های مفقود گنجانده خواهند شد.
برای گنجاندن فقط فایل‌های خاص، نام فایل آن‌ها (بدون مسیر) را به عنوان آرگومان بدهید.
.PP
برای اینکه بدانید چگونه از نیاز به انجام این کار جلوگیری کنید، به توضیحات
\fB\-si\fP، \fB\-sa\fP و \fB\-sd\fP در صفحه راهنمای
\fBdpkg\-genchanges\fP/\fBdpkg\-buildpackage\fP مراجعه کنید.
.PP
توجه داشته باشید که در حالی که \fBreprepro\fP فایل‌های فهرست‌شده در یک فایل \fB.changes\fP
را در صورتی که قبلاً فایلی با همان اندازه و md5sum داشته باشد نادیده می‌گیرد،
اما \fBdak\fP ممکن است در آن صورت با مشکل مواجه شود.
.TP
.B adddeb \fIfilenames\fP
افزودن فایل‌های \fB.deb\fP و \fB.udeb\fP مشخص‌شده با نام فایل‌هایشان به
فایل \fB.changes\fP.
نام فایل‌های بدون اسلش در دایرکتوری جاری،
دایرکتوری محل قرارگیری فایل changes
و دایرکتوری‌های مشخص‌شده توسط \fB\-\-searchpath\fP جستجو خواهند شد.
.TP
.B adddsc \fIfilenames\fP
افزودن فایل‌های \fB.dsc\fP مشخص‌شده با نام فایل‌هایشان به
فایل \fB.changes\fP.
نام فایل‌های بدون اسلش در دایرکتوری جاری،
دایرکتوری محل قرارگیری فایل changes
و دایرکتوری‌های مشخص‌شده توسط \fB\-\-searchpath\fP جستجو خواهند شد.
.TP
.B addrawfile \fIfilenames\fP
افزودن فایل‌های مشخص‌شده با نام فایل‌هایشان به
فایل \fB.changes\fP.
نام فایل‌های بدون اسلش در دایرکتوری جاری،
دایرکتوری محل قرارگیری فایل changes
و دایرکتوری‌های مشخص‌شده توسط \fB\-\-searchpath\fP جستجو خواهند شد.
.TP
.B add \fIfilenames\fP
برای نام فایل‌هایی که به \fB.dsc\fP ختم می‌شوند مانند \fBadddsc\fP،
برای نام فایل‌هایی که به \fB.deb\fP یا \fB.udeb\fP ختم می‌شوند مانند \fBadddeb\fP،
و برای تمام نام فایل‌های دیگر مانند \fBaddrawfile\fP رفتار می‌کند.
.TP
.B dumbremove \fIfilenames\fP
حذف فایل‌های مشخص‌شده از فایل .changes.
هیچ فیلد دیگری (مانند Architectures، Binaries و...) به‌روزرسانی نمی‌شود و
هیچ فایل مرتبطی حذف نمی‌گردد.
فقط فایل‌های داده‌شده (که باید بدون هیچ \fB/\fP مشخص شوند)
دیگر در فایل .changes فهرست نمی‌شوند (و فقط در فایل changes دیگر فهرست نخواهند شد).

.SH "همچنین ببینید (SEE ALSO)"
.BR reprepro (1),
.BR dpkg\-genchanges (1),
.BR dpkg\-buildpackage (1),
.BR md5sum (1).
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها یا درخواست ویژگی‌ها را به سیستم ردیابی باگ دبیان (Debian BTS)
(مثلاً با استفاده از \fBreportbug reprepro\fP)
یا مستقیماً به <brlink@debian.org> ارسال کنید.
.br
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2006-2009 Bernhard R. Link
.br
این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر به سورس‌کد مراجعه کنید. هیچ‌گونه
ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب برای یک هدف خاص.