.\" 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 "NOTMUCH-GIT" "1" "Apr 17, 2026" "0.40" "notmuch" .SH "نام (NAME)" notmuch-git \- مدیریت برچسب‌های 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 verbosity)، یکی از موارد: \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 از یک منبع دوردست (ریموت). .sp این دستور \(aqgit clone\(aq را پوشش می‌دهد و گزینه‌هایی را برای جلوگیری از ایجاد درخت کاری (working tree) در عین حفظ شاخه‌های ردیابی دوردست (remote\-tracking branches) و بالادست (upstreams) اضافه می‌کند. .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B repository .UNINDENT .sp مخزن (احتمالاً دوردست) برای کلون‌کردن از آن. برای اطلاعات بیشتر در مورد مشخص کردن مخازن، بخش URLS در \fBgit\-clone(1) \%\fP را ببینید. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B commit [\-f|\-\-force] [message] .UNINDENT .sp ثبت (commit) برچسب‌های منطبق با پیشوند از پایگاه‌داده 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 یک پوشش (wrapper) برای \(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 دریافت و ادغام (pull) تغییرات مخزن دوردست (remote) در 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) که مبدأ دریافت است. این پارامتر می‌تواند یک URL (بخش 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) که مقصد ارسال است. این پارامتر می‌تواند یک URL (بخش GIT URLS را در \fBgit\-push(1) \%\fP ببینید) یا نام یک remote (بخش REMOTES را در \fBgit\-push(1) \%\fP ببینید) باشد. .INDENT 0.0 .TP .B refspec .UNINDENT .sp مشخصهٔ مرجع یا Refspec (معمولاً نام یک شاخه) برای ارسال. برای سایر موارد ممکن، مدخل \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 محلی وجود دارد، اما در بالادست نیست. .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 این قالب موروثی و قدیمی است که پیش از نگارش 0.37 توسط ابزار \fInmbug\fP ایجاد می‌شد. برای پیامی با 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 \%<> نخستین مورد از موارد زیر را که مقداری غیرتهی داشته باشد برای تعیین پیشوند برچسب استفاده می‌کند: .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 and many others .\" End of generated man page.