'\" t .\" 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-SHOW" "1" "Apr 17, 2026" "0.40" "notmuch" .SH "نام (NAME)" notmuch-show \- نمایش پیام‌های منطبق با عبارت‌های جستجوی مشخص‌شده .SH "خلاصه دستور (SYNOPSIS)" .sp \fBnotmuch\fP \fBshow\fP [\fIoption\fP ...] <\fIsearch\-term\fP> ... .SH "توضیحات (DESCRIPTION)" .sp همه پیام‌های منطبق با عبارت‌های جستجو را نمایش می‌دهد. .sp برای جزئیات نحو پشتیبانی‌شده برای به notmuch\-search\-terms \%<#\:notmuch-search-terms-7> مراجعه کنید. .sp پیام‌ها بر اساس رشته‌های گفتگو (threading) گروه‌بندی و مرتب می‌شوند (همه پاسخ‌ها به یک پیام خاص، بلافاصله پس از آن پیام و به ترتیب تاریخ ظاهر می‌شوند). خروجی به‌طور پیش‌فرض دندانه‌دار نیست، اما برچسب‌های عمق چاپ می‌شوند تا دندانه‌گذاری مناسب توسط یک پس‌پردازشگر (مانند رابط emacs برای notmuch) انجام گیرد. .sp گزینه‌های پشتیبانی‌شده برای \fBshow\fP شامل موارد زیر است: .INDENT 0.0 .TP .B \-\-duplicate=N نمایش رونوشت (duplicate) شماره N در خروجی. شماره‌گذاری از ۱ آغاز می‌شود و با ترتیبی که توسط \fBsearch \-\-duplicate\fP \%<#\:cmdoption-search-duplicate> و \fBsearch \-\-output=files\fP \%<#\:cmdoption-search-output> استفاده می‌شود، مطابقت دارد. .UNINDENT .INDENT 0.0 .TP .B \-\-entire\-thread=(true|false) اگر true باشد، \fBnotmuch show\fP همه پیام‌های موجود در رشته گفتگوی هر پیامی که با عبارت‌های جستجو مطابقت دارد را در خروجی نمایش می‌دهد؛ اگر false باشد، تنها پیام‌های منطبق را در خروجی می‌آورد. برای \fB\-\-format=json\fP و \fB\-\-format=sexp\fP این گزینه به‌طور پیش‌فرض true است. برای سایر قالب‌ها، پیش‌فرض false است. .UNINDENT .INDENT 0.0 .TP .B \-\-format=(text|json|sexp|mbox|raw) .INDENT 7.0 .TP .B text (پیش‌فرض برای پیام‌ها) قالب متن ساده (plain\-text) پیش‌فرض تمام بخش‌های MIME حاوی محتوای متنی را رمزگشایی می‌کند. مؤلفه‌های گوناگون در خروجی، (\fBmessage\fP، \fBheader\fP، \fBbody\fP، \fBattachment\fP، و MIME \fBpart\fP)، با نشانگرهایی که به‌راحتی تجزیه می‌شوند از هم جدا خواهند شد. هر نشانگر شامل یک نویسه Control\-L (کد اسکی ده‌دهی ۱۲)، نام نشانگر، و سپس یک آکولاد باز یا بسته (\(aq{\(aq یا \(aq}\(aq) برای باز یا بستن مؤلفه است. برای یک پیام MIME چندبخشی، این بخش‌ها به‌صورت تو‌در‌تو خواهند بود. .TP .B json خروجی با نشانه‌گذاری شیء جاوااسکریپت (JSON) قالب‌بندی می‌شود. این قالب نسبت به قالب متنی برای پردازش خودکار پایدارتر است. ساختار تو‌در‌توی پیام‌های MIME چندبخشی در خروجیِ تو‌در‌توی JSON بازتاب می‌یابد. به‌طور پیش‌فرض خروجی JSON شامل تمام پیام‌های یک رشته گفتگوی منطبق است؛ یعنی به‌طور پیش‌فرض، \fB\-\-format=json\fP گزینه \fB\-\-entire\-thread\fP\& را فعال می‌کند. فراخواننده می‌تواند با تنظیم \fB\-\-entire\-thread=false\fP\& این رفتار را غیرفعال کند. خروجی JSON همواره به صورت UTF\-8 کدگذاری می‌شود و محتوای هر پیامی که در خروجی گنجانده شود، مجموعه‌نویسه (charset) آن به UTF\-8 تبدیل خواهد شد. .TP .B sexp خروجی به‌صورت معادل عبارت نمادین لیسپ (Lisp s\-expression یا sexp) از قالب JSON بالا قالب‌بندی می‌شود. شیءها به‌صورت فهرست‌های ویژگی (property lists) قالب‌بندی می‌شوند که کلیدهای آن‌ها کلمات کلیدی (نمادهای با پیشوند دونقطه) هستند. مقدار True به‌صورت \fBt\fP و مقادیر false و null هر دو به‌صورت \fBnil\fP\& قالب‌بندی می‌شوند. همانند JSON، خروجی s\-expression همیشه با کدگذاری UTF\-8 کدگذاری می‌شود. .TP .B mbox تمام پیام‌های منطبق در قالب سنتی mbox یونیکس خروجی داده می‌شوند، به‌طوری که هر پیام با خطی که با \(dqFrom \(dq آغاز می‌شود شروع شده و یک خط خالی هر پیام را جدا می‌کند. خطوطی در محتوای پیام که با \(dqFrom \(dq آغاز می‌شوند (با پیشوند صفر یا چند نویسه \(aq>\(aq)، یک نویسه \(aq>\(aq اضافی دریافت می‌کنند. این گریزدهی برگشت‌پذیر، قالب \(dqmboxrd\(dq نامیده شده و جزئیات آن در اینجا شرح داده شده است: .INDENT 7.0 .INDENT 3.5 \% .UNINDENT .UNINDENT .TP .B raw (پیش‌فرض در صورت مشخص شدن \fB\-\-part\fP) نوشتن بایت‌های خام بخش MIME داده‌شده از یک پیام در خروجی استاندارد. برای این قالب، تعیین پرس‌وجویی که با بیش از یک پیام مطابقت داشته باشد خطا است. .sp اگر بخش مشخص‌شده یک بخش برگ (leaf part) باشد، بدنه بخش پس از انجام رمزگشایی انتقال محتوا (اما بدون تبدیل مجموعه‌نویسه) در خروجی نوشته می‌شود. این حالت برای مثال جهت ذخیره پیوست‌ها مناسب است. .sp برای یک بخش multipart یا message، خروجی شامل سرایندهای بخش و همچنین بدنه (شامل تمام بخش‌های فرزند) است. هیچ رمزگشایی انجام نمی‌شود زیرا بخش‌های multipart و message نمی‌توانند کدگذاری انتقال محتوای غیربدیهی داشته باشند. مصرف‌کنندگان این خروجی ممکن است نیاز به پیاده‌سازی رمزگشایی MIME و توابع مشابه داشته باشند. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-format\-version=N استفاده از نسخه مشخص‌شده قالب خروجی ساختاریافته. این گزینه برای برنامه‌هایی در نظر گرفته شده است که notmuch \%<#\:notmuch-1> را به‌صورت داخلی فراخوانی می‌کنند. در صورت حذف، از آخرین نسخه پشتیبانی‌شده استفاده خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-part=N خروجی دادن تک‌بخش MIME رمزگشایی‌شده N از یک تک‌پیام. عبارت‌های جستجو باید تنها با یک پیام مطابقت داشته باشند. بخش‌های پیام در یک پیمایش اول‌عمق (depth\-first) از ساختار MIME پیام شماره‌گذاری می‌شوند و در قالب‌های خروجی \(aqjson\(aq، \(aqsexp\(aq یا \(aqtext\(aq مشخص می‌گردند. .sp توجه داشته باشید که حتی یک پیام بدون ساختار MIME یا با یک بخش بدنه منفرد نیز دارای دو بخش MIME است: بخش ۰ کل پیام است (سرایندها و بدنه) و بخش ۱ تنها بدنه پیام است. .UNINDENT .INDENT 0.0 .TP .B \-\-sort=(newest\-first|oldest\-first) این گزینه می‌تواند برای ارائه نتایج به ترتیب زمانی (\fBoldest\-first\fP) یا به ترتیب زمانی معکوس (\fBnewest\-first\fP) استفاده شود. .sp تنها رشته‌های گفتگو به عنوان یک کل بازچینی می‌شوند. ترتیب پیام‌ها درون هر رشته گفتگو تحت تأثیر این پرچم قرار نمی‌گیرد، چرا که آن ترتیب همواره توسط پاسخ‌های درون رشته تعیین می‌شود. .sp به‌طور پیش‌فرض، نتایج به ترتیب زمانی معکوس نمایش داده خواهند شد (یعنی جدیدترین نتایج ابتدا نمایش داده می‌شوند). .UNINDENT .INDENT 0.0 .TP .B \-\-offset=[\-]N صرف‌نظر کردن از نمایش N نتیجه اول. با پیشوند \(aq\-\(aq، از Nامین نتیجه از انتها آغاز می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-limit=N محدود کردن تعداد نتایج نمایش‌داده‌شده به N. .UNINDENT .INDENT 0.0 .TP .B \-\-verify محاسبه و گزارش اعتبار هرگونه امضای رمزنگاری MIME یافت‌شده در محتوای انتخاب‌شده (مانند بخش‌های \(dqmultipart/signed\(dq). وضعیت امضا گزارش خواهد شد (در حال حاضر تنها با \fB\-\-format=json\fP و \fB\-\-format=sexp\fP پشتیبانی می‌شود)، و بخش multipart/signed با داده‌های امضاشده جایگزین خواهد شد. .UNINDENT .INDENT 0.0.TP .B \-\-decrypt=(false|auto|true|stash) اگر \fBtrue\fP باشد، هر بخش رمزگذاری‌شدهٔ MIME موجود در محتوای انتخاب‌شده (مانند بخش‌های \(dqmultipart/encrypted\(dq) را رمزگشایی می‌کند. وضعیت رمزگشایی گزارش خواهد شد (در حال حاضر تنها با \fB\-\-format=json\fP و \fB\-\-format=sexp\fP پشتیبانی می‌شود) و در صورت رمزگشایی موفقیت‌آمیز، بخش multipart/encrypted با محتوای رمزگشایی‌شده جایگزین خواهد شد. .sp مقدار \fBstash\fP رفتاری مشابه \fBtrue\fP دارد، اما پس از رمزگشایی موفق، کلید نشست (session key) پیام را نیز در پایگاه‌داده ذخیره (stash) کرده و متن رمزنشدهٔ (cleartext) پیام را نمایه‌سازی می‌کند که امکان رمزگشایی خودکار را در آینده فراهم می‌سازد. .sp اگر \fBauto\fP باشد، و کلید نشست از قبل برای پیام مشخص باشد، پیام رمزگشایی خواهد شد، اما notmuch برای دسترسی به کلیدهای کاربر تلاشی نخواهد کرد. .sp از \fBfalse\fP برای جلوگیری حتی از رمزگشایی خودکار استفاده کنید. .sp رمزگشایی غیرخودکار (\fBstash\fP یا \fBtrue\fP، در غیاب کلید نشست ذخیره‌شده) مستلزم یک \fBgpg\-agent(1) \%\fP فعال است تا اعتبارنامه‌های لازم را فراهم کند. بدون آن، رمزگشایی با شکست مواجه خواهد شد. .sp نکته: تنظیم هر یک از مقادیر \fBtrue\fP یا \fBstash\fP در اینجا به معنی اعمال \fB\-\-verify\fP است\&. .sp در اینجا جدولی آمده است که هر یک از این سیاست‌ها را خلاصه می‌کند: .TS box center; l|l|l|l|l. T{ T} T{ false T} T{ auto T} T{ true T} T{ stash T} _ T{ نمایش متن رمزنشده در صورتی که کلید نشست از قبل مشخص باشد T} T{ T} T{ X T} T{ X T} T{ X T} _ T{ استفاده از کلیدهای مخفی برای نمایش متن رمزنشده T} T{ T} T{ T} T{ X T} T{ X T} _ T{ ذخیرهٔ کلیدهای نشست تازه‌بازیابی‌شده و نمایه‌سازی مجدد پیام در صورت یافتن T} T{ T} T{ T} T{ T} T{ X T} .TE .sp نکته: \fB\-\-decrypt=stash\fP نیازمند دسترسی نوشتن به پایگاه‌داده است. در غیر این صورت، \fBnotmuch show\fP کاملاً در حالت فقط‌خواندنی عمل می‌کند. .sp پیش‌فرض: \fBauto\fP .UNINDENT .INDENT 0.0 .TP .B \-\-exclude=(true|false) مشخص می‌کند که آیا رشته‌گفتگوهایی که تنها با search.exclude_tags مطابقت دارند از نتایج جستجو حذف شوند (پیش‌فرض) یا خیر. در هر دو حالت، پیام مستثنی‌شده با پرچم exclude علامت‌گذاری می‌شود (به جز زمانی که output=mbox باشد که جایی برای قرار دادن پرچم وجود ندارد). .sp اگر \fB\-\-entire\-thread\fP مشخص شده باشد، کل رشته‌گفتگوها در هر صورت بازگردانده می‌شوند (با تنظیم پرچم مستثنی در صورت لزوم)، اما در صورت تعیین \fB\-\-exclude=true.\fP رشته‌گفتگوهایی که تنها در یک پیام مستثنی‌شده مطابقت داشته باشند بازگردانده نخواهند شد. .sp پیش‌فرض \fB\-\-exclude=true.\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-body=(true|false) اگر true باشد (پیش‌فرض)، دستور \fBnotmuch show\fP بدنهٔ پیام‌ها را در خروجی قرار می‌دهد؛ اگر false باشد، بدنه‌ها حذف می‌شوند. گزینهٔ \fB\-\-body=false\fP تنها برای قالب‌های text، json و sexp پیاده‌سازی شده است و با \fB\-\-part > 0.\fP ناسازگار است. .sp این گزینه زمانی مفید است که فراخواننده تنها به سرآیندها نیاز داشته باشد، چرا که خروجی بدون بدنه بسیار سریع‌تر و به‌طور چشمگیری کوچک‌تر است. .UNINDENT .INDENT 0.0 .TP .B \-\-include\-html بخش‌های \(dqtext/html\(dq را به عنوان بخشی از خروجی می‌گنجاند (در حال حاضر تنها با \fB\-\-format=text\fP، \fB\-\-format=json\fP و \fB\-\-format=sexp\fP پشتیبانی می‌شود). به‌طور پیش‌فرض، مگر اینکه \fB\-\-part=N\fP برای انتخاب یک بخش خاص استفاده شود یا \fB\-\-include\-html\fP برای گنجاندن تمام بخش‌های \(dqtext/html\(dq به کار رود، هیچ بخشی با نوع محتوای \(dqtext/html\(dq در خروجی گنجانده نمی‌شود. .UNINDENT .sp یک کاربرد رایج \fBnotmuch show\fP نمایش یک رشته‌گفتگوی منفرد از پیام‌های ایمیل است. برای این منظور، از عبارت جستجوی \(dqthread:\(dq استفاده کنید، همان‌طور که در ستون اول خروجی دستور notmuch\-search \%<#\:notmuch-search-1> دیده می‌شود..SH "پیکربندی (CONFIGURATION)" .sp خروجی ساختاریافته (json / sexp) تحت تأثیر گزینهٔ پیکربندی show.extra_headers \%<#\:nmconfig-show\:.extra_headers>\& قرار می‌گیرد. برای جزئیات، notmuch\-config \%<#\:notmuch-config-1> را ببینید. .SH "وضعیت خروج (EXIT STATUS)" .sp این دستور از کدهای وضعیت خروج ویژهٔ زیر پشتیبانی می‌کند: .INDENT 0.0 .TP .B \fB20\fP نسخهٔ قالب درخواستی بیش از حد قدیمی است. .TP .B \fB21\fP نسخهٔ قالب درخواستی بیش از حد جدید است. .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp notmuch \%<#\:notmuch-1>, notmuch\-config \%<#\:notmuch-config-1>, notmuch\-count \%<#\:notmuch-count-1>, notmuch\-dump \%<#\:notmuch-dump-1>, notmuch\-hooks \%<#\:notmuch-hooks-5>, notmuch\-insert \%<#\:notmuch-insert-1>, notmuch\-new \%<#\:notmuch-new-1>, notmuch\-reply \%<#\:notmuch-reply-1>, notmuch\-restore \%<#\:notmuch-restore-1>, notmuch\-search \%<#\:notmuch-search-1>, notmuch\-search\-terms \%<#\:notmuch-search-terms-7>, notmuch\-tag \%<#\:notmuch-tag-1> .SH "نویسندگان (AUTHORS)" Carl Worth و بسیاری دیگر .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2009-2026، Carl Worth و بسیاری دیگر .\" End of generated man page.