.\" Man page generated from reStructuredText .\" by the Docutils 0.22.4 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "NMBUG" "1" "Apr 17, 2026" "0.40" "notmuch" .SH "نام (NAME)" nmbug \- مدیریت باگ‌های notmuch با git .SH "خلاصه دستور (SYNOPSIS)" .sp \fBnotmuch\fP \fBgit\fP [\-h] [\-N] [\-C \fIrepo\fP] [\-p \fIprefix\fP] [\-v] [\-l \fIlog level\fP] \fIsubcommand\fP .sp \fBnmbug\fP [\-h] [\-C \fIrepo\fP] [\-p \fIprefix\fP] [\-v] [\-l \fIlog level\fP] \fIsubcommand\fP .SH "توضیحات (DESCRIPTION)" .sp مدیریت برچسب‌های notmuch با Git. .SS "گزینه‌ها (OPTIONS)" .sp گزینه‌های پشتیبانی‌شده برای \fInotmuch git\fP عبارتند از .INDENT 0.0 .TP .B \-h, \-\-help نمایش پیام راهنما و خروج .UNINDENT .INDENT 0.0 .TP .B \-N, \-\-nmbug تنظیم مقادیر پیش‌فرض برای \fB\-\-tag\-prefix\fP و \fB\-\-git\-dir\fP مناسب برای سامانه ردیابی باگ notmuch \%<> .UNINDENT .INDENT 0.0 .TP .B \-C , \-\-git\-dir عملیات بر روی مخزن گیت \fIrepo\fP\&. برای مقادیر پیش‌فرض به REPOSITORY LOCATION مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-p , \-\-tag\-prefix عملیات فقط روی برچسب‌های دارای پیشوند \fIprefix\fP\&. برای مقادیر پیش‌فرض به PREFIX VALUE مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-v, \-\-version نمایش شماره نسخه notmuch\-git و خروج .UNINDENT .INDENT 0.0 .TP .B \-l , \-\-log\-level میزان پرگویی ثبت گزارش (log)، یکی از موارد: \fIcritical\fP، \fIerror\fP، \fIwarning\fP، \fIinfo\fP، \fIdebug\fP\&. پیش‌فرض \fIwarning\fP است. .UNINDENT .SS "زیرفرمان‌ها (SUBCOMMANDS)" .sp برای راهنمایی درباره یک زیرفرمان خاص، اجرا کنید: \(aqnotmuch\-git ... \-\-help\(aq. .INDENT 0.0 .TP .B archive [tree\-ish] [arg ...] .UNINDENT .sp ایجاد خروجی بایگانی tar از یک مجموعه برچسب کامیت‌شده با استفاده از \(aqgit archive\(aq. برای جزئیات مربوط به محتوای بایگانی به REPOSITORY CONTENTS مراجعه کنید. .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B tree\-ish .UNINDENT .sp درخت یا کامیتی که بایگانی برای آن تولید می‌شود. پیش‌فرض \(aqHEAD\(aq است. .INDENT 0.0 .TP .B arg .UNINDENT .sp در صورت وجود، هرگونه آرگومان اختیاری به \fBgit\-archive(1) \%\fP ارسال می‌شود. آرگومان‌های \fIgit\-archive\fP به گونه‌ای بازآرایی می‌شوند که \fItree\-ish\fP در آخر قرار گیرد. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B checkout [\-f|\-\-force] .UNINDENT .sp به‌روزرسانی پایگاه‌داده notmuch از git. .sp این دستور عمدتاً برای نادیده گرفتن تغییرات شما در notmuch نسبت به git مفید است. .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B [\-f|\-\-force] .UNINDENT .sp نادیده‌گرفتن بررسی‌هایی که مانع از تغییر برچسب‌ها برای بخش بزرگی از پیام‌ها در پایگاه‌داده می‌شوند. همچنین ببینید: git.safe_fraction \%<#\:nmconfig-git\:.safe_fraction>\&. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B clone .UNINDENT .sp ایجاد یک مخزن محلی \fInotmuch git\fP از یک منبع دوردست (remote). .sp این دستور \(aqgit clone\(aq را پوشش داده و گزینه‌هایی را برای جلوگیری از ایجاد درخت کاری (working tree) در عین حفظ شاخه‌های ردیابی دوردست (remote\-tracking) و بالادستی‌ها (upstreams) اضافه می‌کند. .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B repository .UNINDENT .sp مخزنی (احتمالاً دوردست) که باید از آن شبیه‌سازی (clone) انجام شود. برای اطلاعات بیشتر در مورد مشخص کردن مخازن، به بخش URLS در \fBgit\-clone(1) \%\fP مراجعه کنید. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B commit [\-f|\-\-force] [message] .UNINDENT .sp کامیت کردن برچسب‌های منطبق بر پیشوند از پایگاه‌داده notmuch به git. .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B message .UNINDENT .sp متن اختیاری برای پیام کامیت. .INDENT 0.0 .TP .B \-f|\-\-force .UNINDENT .sp نادیده‌گرفتن بررسی‌هایی که مانع از تغییر برچسب‌ها برای بخش بزرگی از پیام‌ها در پایگاه‌داده می‌شوند. همچنین ببینید: git.safe_fraction \%<#\:nmconfig-git\:.safe_fraction>\&. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B fetch [remote] .UNINDENT .sp واکشی تغییرات از مخزن دوردست (remote). .INDENT 0.0 .INDENT 3.5 .INDENT 0.0.TP .B remote .UNINDENT .sp بازنویسی مقدار پیش‌فرض تنظیم‌شده در \fIbranch..remote\fP برای واکشی از یک مخزن دوردست خاص (مانند \fIorigin\fP). .UNINDENT .UNINDENT .INDENT 0.0 .TP .B help .UNINDENT .sp نمایش راهنمای مختصر برای یکی از دستورهای \fInotmuch git\fP. .INDENT 0.0 .TP .B init [\-\-format\-version=N] .UNINDENT .sp ایجاد یک مخزن خالی \fInotmuch git\fP. .sp این دستور پوششی بر \(aqgit init\(aq به همراه چند مرحلهٔ اضافی برای پشتیبانی از دستورهای بعدی status و commit است. .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B \-\-format\-version=N .UNINDENT .sp ایجاد مخزن با نگارش قالب N. به‌طور پیش‌فرض notmuch\-git \%<> از بالاترین نگارش پشتیبانی‌شده استفاده می‌کند که برای بیشتر موارد کاربرد، بهترین گزینه است. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B log [arg ...] .UNINDENT .sp پوششی برای \(aqgit log\(aq. .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B arg .UNINDENT .sp آرگومان‌های اضافی مستقیماً به \(aqgit log\(aq منتقل می‌شوند. .UNINDENT .UNINDENT .sp پس از اجرای \fInotmuch git fetch\fP، می‌توانید تغییرات را با دستور زیر بررسی کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ notmuch git log HEAD..@{upstream} .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B merge [reference] .UNINDENT .sp ادغام تغییرات از \(aqreference\(aq در HEAD و بارگذاری نتیجه در notmuch. .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B reference .UNINDENT .sp مرجع، معمولاً نوک شاخه‌های دیگر، برای ادغام در شاخهٔ جاری ما. پیش‌فرض \fI@{upstream}\fP\& است. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B pull [repository] [refspec ...] .UNINDENT .sp دریافت (ادغام) تغییرات مخزن دوردست در notmuch. .sp دستور \fBpull\fP معادل \fBfetch\fP و سپس \fBmerge\fP\& است. از مخزن پیکربندی‌شده در git برای شاخهٔ فعلی شما (\fIbranch..repository\fP، احتمالاً \fIorigin\fP، و \fIbranch..merge\fP، احتمالاً \fImaster\fP یا \fImain\fP) استفاده می‌شود. .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B repository .UNINDENT .sp مخزن «دوردست» (remote) که منبع pull است. این پارامتر می‌تواند یک نشانی وب (بخش GIT URLS را در \fBgit\-pull(1) \%\fP ببینید) یا نام یک remote (بخش REMOTES را در \fBgit\-pull(1) \%\fP ببینید) باشد. .INDENT 0.0 .TP .B refspec .UNINDENT .sp مشخصهٔ مرجع یا Refspec (معمولاً نام یک شاخه) برای واکشی و ادغام. برای دیدن سایر احتمالات، مدخل \fIrefspec\fP را در بخش OPTIONS در \fBgit\-pull(1 \%\fP) ببینید. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B push [repository] [refspec] .UNINDENT .sp ارسال (push) وضعیت محلی \fInotmuch git\fP به یک مخزن دوردست. .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B repository .UNINDENT .sp مخزن «دوردست» (remote) که مقصد push است. این پارامتر می‌تواند یک نشانی وب (بخش GIT URLS را در \fBgit\-push(1) \%\fP ببینید) یا نام یک remote (بخش REMOTES را در \fBgit\-push(1) \%\fP ببینید) باشد. .INDENT 0.0 .TP .B refspec .UNINDENT .sp مشخصهٔ مرجع یا Refspec (معمولاً نام یک شاخه) برای push کردن. برای دیدن سایر احتمالات، مدخل \fIrefspec\fP را در بخش OPTIONS در \fBgit\-push(1) \%\fP بررسی کنید. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B status .UNINDENT .sp نمایش به‌روزرسانی‌های معلق در notmuch یا مخزن git. .sp سطرهایی با این قالب چاپ می‌کند: .nf ng Message\-Id tag .fi .sp .sp که در آن n نویسه‌ای منفرد است که وضعیت پایگاه‌دادهٔ notmuch را نشان می‌دهد: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B A .UNINDENT .sp برچسب در پایگاه‌دادهٔ notmuch موجود است، اما در git ثبت نشده است (یا به عبارت دیگر، برچسب در مخزن git حذف شده، مثلاً با یک دستور pull، اما هنوز در پایگاه‌دادهٔ notmuch بازیابی نشده است). .INDENT 0.0 .TP .B D .UNINDENT .sp برچسب در مخزن git وجود دارد، اما هنوز در پایگاه‌دادهٔ notmuch بازیابی نشده است (یا به بیان دیگر، برچسب در notmuch حذف شده است). .INDENT 0.0 .TP .B U .UNINDENT .sp پیام ناشناخته است (در پایگاه‌دادهٔ محلی notmuch موجود نیست). .UNINDENT .UNINDENT .sp نویسهٔ دوم \fIg\fP (در صورت وجود) بیانگر تفاوت میان شاخه‌های محلی و بالادست (upstream) است. معمولاً برای به‌روزرسانی این وضعیت باید دستور \fInotmuch git fetch\fP اجرا شود. .INDENT 0.0 .INDENT 3.5 .INDENT 0.0.TP .B a .UNINDENT .sp برچسب در upstream وجود دارد، اما در شاخهٔ محلی git موجود نیست. .INDENT 0.0 .TP .B d .UNINDENT .sp برچسب در شاخهٔ محلی git وجود دارد، اما در upstream موجود نیست. .UNINDENT .UNINDENT .SH "محتویات مخزن (REPOSITORY CONTENTS)" .sp برچسب‌ها در مخزن git به‌صورت مجموعه‌ای از فایل‌های خالی ذخیره (و صادر) می‌شوند. این فایل‌های خالی درون دایرکتوری‌ای قرار دارند که بر اساس message\-id نام‌گذاری شده است. .sp در ادامه، \fIencode()\fP نشان‌دهندهٔ یک کدگذاری امن برای سیستم‌فایل‌های POSIX است. این کدگذاری نویسه‌های الفبایی\-عددی و نویسه‌های \fI+\-_@=.,:\fP\& را حفظ می‌کند. تمام بایت‌های دیگر با \fI%\fP و به‌دنبال آن یک عدد هگزادسیمال دو رقمی جایگزین می‌شوند. .sp در حال حاضر notmuch\-git \%<> می‌تواند هر نسخه‌ای از قالب را بخواند، اما فقط می‌تواند (از طریق \fBinit\fP) مخازن نسخهٔ ۱ را ایجاد کند. .SS "نسخه ۰ (Version 0)" .sp این قالب قدیمی ایجادشده توسط ابزار \fInmbug\fP قبل از انتشار 0.37 است. برای پیامی با Message\-Id \fIid\fP، به ازای هر برچسب \fItag\fP، یک فایل خالی با مسیر زیر وجود دارد: .INDENT 0.0 .INDENT 3.5 tags/ \fIencode\fP (\fIid\fP) / \fIencode\fP (\fItag\fP) .UNINDENT .UNINDENT .SS "نسخه ۱ (Version 1)" .sp در نسخهٔ قالب ۱ و بالاتر، نسخهٔ قالب در فایلی در بالاترین سطح به نام FORMAT نگهداری می‌شود. .sp برای پیامی با Message\-Id \fIid\fP، به ازای هر برچسب \fItag\fP، یک فایل خالی با مسیر زیر وجود دارد: .INDENT 0.0 .INDENT 3.5 tags/ \fIhash1\fP (\fIid\fP) / \fIhash2\fP (\fIid\fP) \fIencode\fP (\fIid\fP) / \fIencode\fP (\fItag\fP) .UNINDENT .UNINDENT .sp توابع هش هر کدام یک بایت از خلاصهٔ هگزادسیمال \fIblake2b\fP را نمایش می‌دهند. .sp در مقایسه با نسخهٔ ۰، این کار تعداد زیردایرکتوری‌های درون هر دایرکتوری را کاهش می‌دهد. .SH "مکان مخزن (REPOSITORY LOCATION)" .sp دستور notmuch\-git \%<> از نخستین مورد از موارد زیر که مقدار غیرخالی داشته باشد برای تعیین مکان مخزن git استفاده می‌کند: .INDENT 0.0 .IP \(bu 2 گزینهٔ \fB\-\-git\-dir\fP\&. .IP \(bu 2 متغیر محیطی \fBNOTMUCH_GIT_DIR\fP\&. .IP \(bu 2 مورد پیکربندی git.path \%<#\:nmconfig-git\:.path> .IP \(bu 2 در صورت فراخوانی به‌صورت \fInmbug\fP یا با گزینهٔ \fB\-\-nmbug\fP، \fB$HOME/.nmbug\fP؛ در غیر این صورت \fB$XDG_DATA_HOME/notmuch/$NOTMUCH_PROFILE/git\fP\&. .UNINDENT .SH "مقدار پیشوند (PREFIX VALUE)" .sp دستور notmuch\-git \%<> از نخستین مورد از موارد زیر که مقداری غیرتهی (non\-null) داشته باشد برای تعیین پیشوند برچسب استفاده می‌کند: .INDENT 0.0 .IP \(bu 2 گزینهٔ \fB\-\-tag\-prefix\fP\&. .IP \(bu 2 متغیر محیطی \fBNOTMUCH_GIT_PREFIX\fP\&. .IP \(bu 2 مورد پیکربندی git.tag_prefix \%<#\:nmconfig-git\:.tag_prefix>\&. .IP \(bu 2 در صورت فراخوانی به‌صورت \fInmbug\fP یا با گزینهٔ \fB\-\-nmbug\fP، \fBnotmuch::\fP؛ در غیر این صورت رشتهٔ خالی. .UNINDENT.SH "محیط (ENVIRONMENT)" .sp متغیر \fBNOTMUCH_PROFILE\fP \%<#\:envvar-NOTMUCH_PROFILE> بر مکان مخزن (REPOSITORY LOCATION) تأثیر می‌گذارد\&. اگر تنظیم نشده باشد، \(aqdefault\(aq فرض می‌شود. .INDENT 0.0 .TP .B NOTMUCH_GIT_DIR مکان پیش‌فرض مخزن git\&. با \fB\-\-git\-dir\fP بازنویسی می‌شود\&. .UNINDENT .INDENT 0.0 .TP .B NOTMUCH_GIT_PREFIX پیشوند پیش‌فرض برچسب (فیلتر)\&. با \fB\-\-tag\-prefix\fP بازنویسی می‌شود\&. .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp notmuch \%<#\:notmuch-1>, notmuch\-dump \%<#\:notmuch-dump-1>, notmuch\-restore \%<#\:notmuch-restore-1>, notmuch\-tag \%<#\:notmuch-tag-1> .SH "نویسندگان (AUTHORS)" Carl Worth و بسیاری دیگر .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2009-2026, Carl Worth و بسیاری دیگر .\" End of generated man page.