'\" t
.\"     Title: flatpak build-commit-from
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/27/2026
.\"    Manual: flatpak build-commit-from
.\"    Source: flatpak
.\"  Language: Persian
.\"
.TH "FLATPAK BUILD\-COMMI" "1" "" "flatpak" "flatpak build-commit-from"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
flatpak-build-commit-from \- ایجاد کامیت‌های جدید بر اساس یک کامیت موجود (احتمالاً از مخزنی دیگر)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBflatpak\ build\-commit\-from\fR\ 'u
\fBflatpak build\-commit\-from\fR [OPTION...] DST\-REPO DST\-REF...
.SH "توضیحات (DESCRIPTION)"
.PP
کامیت‌های جدیدی را روی شاخهٔ
DST\-REF
در مخزن مقصد
DST\-REPO
ایجاد می‌کند، به‌طوری‌که محتویات (و بیشتر فراداده‌ها) از شاخهٔ دیگری گرفته می‌شوند؛ این شاخه می‌تواند از مخزنی دیگر باشد یا از شاخه‌ای دیگر درون همان مخزن\&.
.PP
شناسهٔ مجموعه (collection ID) تنظیم‌شده روی
DST\-REPO
(در صورت تنظیم بودن) برای کامیت‌های جدید استفاده خواهد شد\&.
.PP
این دستور زمانی بسیار کاربردی است که می‌خواهید شاخه‌ای با تاریخچهٔ تمیز و عاری از کامیت‌های امضانشده یا ناقص را نگهداری کنید\&. برای نمونه، می‌توانید پس از اطمینان از عملکرد صحیح خروجی یک سیستم ساخت خودکار (autobuilder)، کامیت سرشاخه (head) را از مخزن آن وارد کنید\&. کامیت جدید فاقد والدین یا امضاهای سازندهٔ خودکار خواهد بود و می‌تواند به‌درستی با کلید رسمی امضا شود\&.
.PP
هرگونه دلتایی که بر کامیت اصلی تأثیر می‌گذارد و با کامیت‌های والد در مخزن مقصد همخوانی دارد، کپی شده و برای شناسهٔ کامیت جدید بازنویسی می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش گزینه‌های راهنما و خروج\&.
.RE
.PP
\fB\-\-src\-repo=SRC\-REPO\fR
.RS 4
مخزن (محلی) مبدا که شاخهٔ مبدا از آن دریافت می‌شود\&. مقدار پیش‌فرض، مخزن مقصد است\&.
.RE
.PP
\fB\-\-src\-ref=SRC\-REF\fR
.RS 4
شاخه‌ای که به‌عنوان مبدا برای کامیت جدید استفاده می‌شود\&. به‌طور پیش‌فرض همان مرجع مقصد (destination ref) است، که تنها در صورت تعیین مخزن مبدا متفاوت کاربرد دارد\&.
.RE
.PP
\fB\-\-extra\-collection\-id=COLLECTION\-ID\fR
.RS 4
افزودن یک پیوند اضافی collection\-ref برای این مجموعه، علاوه بر مواردی که معمولاً به‌واسطهٔ شناسهٔ مجموعهٔ مخزن مقصد اضافه می‌شوند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-subset=SUBSET\fR
.RS 4
علامت‌گذاری کامیت جهت قرارگیری در زیرمجموعهٔ نام‌گذاری‌شده\&. این کار باعث می‌شود کامیت علاوه بر خلاصه‌وضعیت اصلی، در خلاصه‌وضعیت زیرمجموعهٔ مشخص‌شده نیز قرار گیرد و به کاربران اجازه می‌دهد به‌جای کل مخزن، تنها این زیرمجموعه را مشاهده کنند\&.
.RE
.PP
\fB\-\-untrusted\fR
.RS 4
مخزن مبدا غیرقابل‌اعتماد در نظر گرفته می‌شود؛ تمام اشیاء کپی می‌شوند (نه پیوند سخت) و تمام چکسام‌ها اعتبارسنجی می‌شوند\&.
.RE
.PP
\fB\-s\fR, \fB\-\-subject=SUBJECT\fR
.RS 4
موضوع یک‌خطی برای پیام کامیت\&. اگر مشخص نشود، از کامیت مبدا گرفته خواهد شد\&.
.RE
.PP
\fB\-b\fR, \fB\-\-body=BODY\fR
.RS 4
توضیحات کامل برای پیام کامیت\&. اگر مشخص نشود، از کامیت مبدا گرفته خواهد شد\&.
.RE
.PP
\fB\-\-update\-appstream\fR
.RS 4
به‌روزرسانی شاخهٔ appstream پس از ساخت\&.
.RE
.PP
\fB\-\-no\-update\-summary\fR
.RS 4
عدم به‌روزرسانی فایل خلاصه‌وضعیت (summary) پس از افزودن کامیت جدید\&. این بدان معناست که مخزن تا زمان اجرای build\-update\-repo برای ارائه از طریق http مناسب نخواهد بود\&. این گزینه زمانی مفید است که می‌خواهید چندین عملیات روی مخزن انجام دهید و سپس خلاصه‌وضعیت را به‌روزرسانی نمایید\&.
.RE
.PP
\fB\-\-force\fR
.RS 4
ایجاد کامیت جدید حتی در صورتی که محتوا نسبت به سرشاخهٔ فعلی تغییری نکرده باشد\&.
.RE
.PP
\fB\-\-disable\-fsync\fR
.RS 4
عدم استفاده از fsync هنگام نوشتن در مخزن\&. این گزینه ممکن است در شرایط استثنایی منجر به از دست رفتن داده‌ها شود، اما کارایی را هنگام کار با مخازن موقت یا آزمایشی بهبود می‌بخشد\&.
.RE
.PP
\fB\-\-gpg\-sign=KEYID\fR
.RS 4
امضای کامیت با این کلید GPG\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-gpg\-homedir=PATH\fR
.RS 4
مسیر دایرکتوری خانگی GPG جهت جستجوی دسته‌کلیدها (keyrings)\&.
.RE
.PP
\fB\-\-end\-of\-life=REASON\fR
.RS 4
علامت‌گذاری ساخت به‌عنوان پایان‌یافته (end\-of\-life)\&.
.RE
.PP
\fB\-\-end\-of\-life\-rebase=OLDID=NEWID\fR
.RS 4
علامت‌گذاری مراجع جدید به‌عنوان پایان‌یافته\&. بر خلاف
\fB\-\-end\-of\-life\fR،
این گزینه شناسه‌ای را می‌پذیرد که جایگزین شناسهٔ فعلی می‌شود\&. بنا به درخواست کاربر، داده‌های برنامه ممکن است برای برنامهٔ جدید حفظ شوند\&. توجه داشته باشید که این تطبیق در واقع به‌صورت پیشوندی (prefix match) است؛ بنابراین اگر بنویسید org\&.the\&.app=org\&.new\&.app، آنگاه موردی مانند org\&.the\&.app\&.Locale به org\&.new\&.app\&.Locale بازپایه‌ریزی (rebase) خواهد شد\&.
.RE
.PP
\fB\-\-timestamp=TIMESTAMP\fR
.RS 4
بازنویسی برچسب زمانی کامیت\&. از یک تاریخ با قالب ISO 8601 یا NOW برای زمان جاری استفاده کنید\&.
.RE
.PP
\fB\-\-disable\-fsync\fR
.RS 4
عدم استفاده از fsync هنگام نوشتن در مخزن\&. این گزینه ممکن است در شرایط استثنایی منجر به از دست رفتن داده‌ها شود، اما کارایی را هنگام کار با مخازن موقت یا آزمایشی بهبود می‌بخشد\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی در طول پردازش دستور\&.
.RE
.PP
\fB\-\-ostree\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی OSTree در طول پردازش دستور\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
برای بازگردانی یک کامیت به کامیت پیشین:
.PP
\fB$ flatpak build\-commit\-from \-\-timestamp=NOW \-\-src\-ref=app/org\&.gnome\&.gedit/x86_64/master^ repo app/org\&.gnome\&.gedit/x86_64/master\fR
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBostree\fR(1),
\fBflatpak\fR(1),
\fBflatpak-build-init\fR(1),
\fBflatpak-build\fR(1),
\fBflatpak-build-finish\fR(1),
\fBflatpak-build-sign\fR(1),
\fBflatpak-build-update-repo\fR(1)