get

مقدار مورد پیکربندی مشخص‌شده در خروجی استاندارد (stdout) چاپ می‌شود. اگر آن مورد چند مقداری باشد (یک فهرست باشد)، هر مقدار با یک نویسه خط جدید جدا می‌شود.

set

مورد پیکربندی مشخص‌شده روی مقدار داده‌شده تنظیم می‌شود. برای تعیین یک مورد چندمقداری (یک فهرست)، هر مقدار را به عنوان یک آرگومان خط فرمان جداگانه وارد کنید.

اگر هیچ مقداری ارائه نشود، مورد پیکربندی مشخص‌شده از فایل پیکربندی حذف خواهد شد.

با گزینه --database، فراداده‌های پیکربندی ذخیره‌شده در پایگاه‌داده، به جای فایل پیکربندی پیش‌فرض (متنی)، به‌روزرسانی می‌شوند.

list

تمام موارد پیکربندی در خروجی استاندارد چاپ می‌شوند، هر کدام در خطی جداگانه به شکل:

section.item=value

هیچ فاصله خالی اضافه‌ای در اطراف نویسه‌های نقطه یا علامت مساوی وجود ندارد. در موارد چندمقداری (یک فهرست)، مقادیر با نویسه نقطه-ویرگول از یکدیگر جدا می‌شوند.

built_with.<name>

ویژگی زمان کامپایل <name>. موارد ممکن کنونی شامل "retry_lock" (گزینه پیکربندی، گنجانده‌شده به طور پیش‌فرض) است. (از notmuch 0.30 به بعد، ویژگی‌های "compact" و "field_processor" همیشه گنجانده شده‌اند.)

database.autocommit

فواصل زمانی ثبت تراکنش‌ها (commit) روی دیسک. مقدار 0 به معنای صبر کردن تا زمان پایان اجرای دستور است؛ در غیر این صورت یک عدد صحیح n مشخص می‌کند که پس از هر n تراکنش تکمیل‌شده، تغییرات روی دیسک ثبت شوند.

تاریخچه: این مقدار پیکربندی در notmuch 0.33 معرفی شد.

database.backup_dir

دایرکتوری برای ذخیره خروجی برچسب‌ها هنگام ارتقای پایگاه‌داده.

تاریخچه: این مقدار پیکربندی در notmuch 0.32 معرفی شد.

پیش‌فرض: یک دایرکتوری هم‌سطح پایگاه‌داده Xapian به نام backups.

database.hook_dir

دایرکتوری حاوی قلاب‌هایی (hooks) که توسط دستورهای notmuch اجرا می‌شوند. نگاه کنید به notmuch-hooks <#notmuch-hooks-5>.

تاریخچه: این مقدار پیکربندی در notmuch 0.32 معرفی شد.

پیش‌فرض: به HOOKS در ادامه نگاه کنید.

database.mail_root

دایرکتوری سطح بالایی که ایمیل‌های فعلی شما در آن قرار دارند و ایمیل‌های آینده به آن تحویل داده می‌شوند. فایل‌ها باید پیام‌های ایمیل مجزا باشند.

تاریخچه: این مقدار پیکربندی در notmuch 0.32 معرفی شد.

پیش‌فرض: برای سازگاری با پیکربندی‌های قدیمی‌تر، در صورت تنظیم نبودن database.mail_root از مقدار database.path استفاده می‌شود.

database.path

دستور notmuch پایگاه‌داده خود را در اینجا ذخیره خواهد کرد (در صورت تنظیم نبودن database.mail_root، در زیردایرکتوری‌ای به نام .notmuch).

پیش‌فرض: به DATABASE LOCATION نگاه کنید

git.path

مکان پیش‌فرض مخزن git برای notmuch-git <>.

git.safe_fraction

برخی از عملیات notmuch-git <> بررسی می‌کنند که نسبت پیام‌های تغییریافته (در پایگاه‌داده یا در git، بسته به مورد) بیش از حد بزرگ نباشد. این مورد کنترل می‌کند چه نسبتی از کل پیام‌ها «نه چندان بزرگ» ("not too large") تلقی شود.

git.tag_prefix

پیشوند برچسب (فیلتر) پیش‌فرض برای notmuch-git <>.

index.as_text

فهرستی از عبارت‌های باقاعده (بدون جداکننده) برای انواع MIME که قرار است به صورت متن نمایه‌سازی شوند. در حال حاضر این ویژگی تنها روی پیوست‌ها اعمال می‌شود. به طور پیش‌فرض عبارت باقاعده با هر نقطه‌ای از نوع محتوا (content type) تطابق می‌یابد؛ اگر کاربر تطابق مهارشده (anchored) می‌خواهد، باید مهارها (anchors) را در عبارت باقاعده خود بگنجاند.

تاریخچه: این مقدار پیکربندی در notmuch 0.38 معرفی شد.

index.decrypt

سیاست رمزگشایی پیام‌های رمزگذاری‌شده در هنگام نمایه‌سازی. باید یکی از این مقادیر باشد: false، auto، nostash یا true.

هنگام نمایه‌سازی یک پیام ایمیل رمزگذاری‌شده، اگر این متغیر روی true تنظیم شده باشد، notmuch تلاش می‌کند پیام را رمزگشایی کرده و متن آشکار (cleartext) را نمایه کند، و نسخه‌ای از هر کلید جلسه (session key) کشف‌شده برای آن پیام را ذخیره (stash) نماید. اگر auto باشد، در صورتی که یک کلید جلسه ذخیره‌شده از قبل برای پیام شناخته شده باشد (مثلاً از نسخه‌ای قبلی)، تلاش می‌کند متن آشکار را نمایه کند، اما تلاشی برای دسترسی به کلیدهای مخفی شما نخواهد کرد. از false استفاده کنید تا از رمزگشایی اجتناب شود حتی اگر کلید جلسه ذخیره‌شده از قبل موجود باشد.

مقدار nostash همانند true است، به جز اینکه کلیدهای جلسه تازه کشف‌شده را در پایگاه‌داده ذخیره (stash) نمی‌کند.

از طریق خط فرمان (یعنی در طول اجرای notmuch-new <#notmuch-new-1>، notmuch-insert <#notmuch-insert-1> یا notmuch-reindex <#notmuch-reindex-1>)، کاربر می‌تواند با گزینه --decrypt=، سیاست رمزگشایی ذخیره‌شده در پایگاه‌داده را بازنویسی کند.

در اینجا جدولی آورده شده که عملکرد هر یک از این سیاست‌ها را خلاصه می‌کند:

	false	auto	nostash	true
نمایه‌سازی متن آشکار با استفاده از کلیدهای جلسه ذخیره‌شده		X	X	X
نمایه‌سازی متن آشکار با استفاده از کلیدهای مخفی			X	X
ذخیره کلیدهای جلسه (stash)				X
حذف کلیدهای جلسه ذخیره‌شده هنگام نمایه‌سازی مجدد (reindex)	X

کلیدهای جلسه ذخیره‌شده (stashed) به عنوان ویژگی‌های (properties) مرتبط با پیام در پایگاه‌داده نگهداری می‌شوند. برای جزئیات بیشتر درباره سودمندی آن‌ها، session-key را در notmuch-properties <#notmuch-properties-7> ببینید.

آگاه باشید که نمایه notmuch احتمالاً کافی است (و یک کلید جلسه ذخیره‌شده قطعاً کافی است) تا بتوان متن آشکار خود پیام را بازسازی کرد؛ بنابراین لطفاً اطمینان حاصل کنید که نمایه پیام‌های notmuch به میزان کافی محافظت می‌شود. از index.decrypt=true یا index.decrypt=nostash بدون در نظر گرفتن امنیت نمایه خود استفاده نکنید.

پیش‌فرض: auto.

maildir.synchronize_flags

اگر true باشد، پرچم‌های maildir زیر (در نام فایل پیام‌ها) با برچسب‌های متناظر notmuch همگام‌سازی خواهند شد:

پرچم	برچسب
D	draft
F	flagged
P	passed
R	replied
S	unread (هنگامی که پرچم 'S' موجود نباشد افزوده می‌شود)

دستور notmuch-new <#notmuch-new-1> متوجه تغییرات پرچم در نام فایل‌ها شده و برچسب‌ها را به‌روزرسانی می‌کند، در حالی که دستورهای notmuch-tag <#notmuch-tag-1> و notmuch-restore <#notmuch-restore-1> متوجه تغییرات برچسب‌ها شده و پرچم‌ها را در نام فایل‌ها به‌روزرسانی می‌کنند.

اگر هرگونه تغییری در maildir رخ داده باشد (افزوده شدن پیام‌های جدید، حذف یا تغییر نام پیام‌های قدیمی، تغییر پرچم‌های maildir و غیره)، توصیه می‌شود پیش از اجرای دستورهای notmuch-tag <#notmuch-tag-1> یا notmuch-restore <#notmuch-restore-1>، دستور notmuch-new <#notmuch-new-1> اجرا شود تا اطمینان حاصل گردد که تغییرات برچسب‌ها به‌درستی با پرچم‌های maildir همگام‌سازی می‌شوند، زیرا این دستورها انتظار دارند پایگاه‌داده و maildir با یکدیگر هماهنگ باشند.

پیش‌فرض: true.

new.ignore

فهرستی برای مشخص کردن فایل‌ها و دایرکتوری‌هایی که توسط notmuch-new <#notmuch-new-1> برای یافتن پیام‌ها جستجو نخواهند شد. هر ورودی در این فهرست یکی از موارد زیر است:

نام یک فایل یا دایرکتوری، بدون مسیر، که صرف‌نظر از مکان آن در سلسله‌مراتب دایرکتوری‌های مخزن نامه‌ها، نادیده گرفته خواهد شد.

یا:

یک عبارت باقاعده محصور در // که با مسیر فایل یا دایرکتوری به‌صورت نسبی نسبت به مسیر پایگاه‌داده مطابقت داده می‌شود. فایل‌ها و دایرکتوری‌های منطبق نادیده گرفته خواهند شد. ابتدا و انتهای رشته باید به‌صراحت مهاربندی (anchor) شوند. برای نمونه، /.*/foo$/ با "bar/foo" و "bar/baz/foo" مطابقت دارد، اما با "foo" یا "bar/foobar" مطابقت نخواهد داشت.

پیش‌فرض: فهرست خالی.

new.tags

فهرستی از برچسب‌ها که به تمام پیام‌های واردشده توسط notmuch new افزوده خواهند شد.

پیش‌فرض: unread;inbox.

query.<name>

بسط برای پرس‌وجوی نام‌گذاری‌شده با نام <name>. برای اطلاعات بیشتر درباره پرس‌وجوهای نام‌گذاری‌شده، notmuch-search-terms <#notmuch-search-terms-7> را ببینید.

search.exclude_tags

فهرستی از برچسب‌ها که به‌طور پیش‌فرض از نتایج جستجو مستثنی می‌شوند. استفاده از یک برچسب مستثنی‌شده در پرس‌وجو، این استثنا را نادیده خواهد گرفت.

پیش‌فرض: فهرست خالی. توجه داشته باشید که notmuch <#notmuch-setup-1> هنگام ایجاد فایل پیکربندی جدید، deleted;spam را در اینجا قرار می‌دهد.

search.authors_separator

رشته‌ای برای جداسازی نویسندگان هنگام نمایش یک رشته‌گفتگو (thread).

پیش‌فرض: ,

search.authors_matched_separator

رشته‌ای برای جداسازی نویسندگان منطبق از غیرمنطبق هنگام نمایش یک رشته‌گفتگو (thread).

پیش‌فرض: |

show.extra_headers

به‌طور پیش‌فرض notmuch-show <#notmuch-show-1> در صورت وجود سرآیندهای زیر در پیام، آن‌ها را در خروجی ساختاریافته می‌آورد: Subject، From، To، Cc، Bcc، Reply-To، Date. این گزینه امکان مشخص کردن فهرستی از سرآیندهای بیشتر را برای نمایش در خروجی فراهم می‌کند.

تاریخچه: این مقدار پیکربندی در notmuch 0.35 معرفی شد.

پیش‌فرض: فهرست خالی.

squery.<name>

بسط برای پرس‌وجوی نام‌گذاری‌شده با نام <name>، با استفاده از نحو s-expression. برای اطلاعات بیشتر درباره پرس‌وجوهای s-expression، notmuch-sexp-queries <#notmuch-sexp-queries-7> را ببینید.

user.name

نام کامل شما.

پیش‌فرض: در صورت تنظیم بودن، متغیر $NAME، در غیر این صورت از /etc/passwd خوانده می‌شود.

user.other_email

فهرستی از دیگر نشانی‌های رایانامه که در آن‌ها رایانامه دریافت می‌کنید (همچنین user.primary_email را ببینید).

پیش‌فرض: تنظیم‌نشده.

user.primary_email

نشانی رایانامه اصلی شما.

پیش‌فرض: در صورت تنظیم بودن، متغیر $EMAIL، در غیر این صورت از روی نام کاربری و نام میزبان ماشین فعلی ساخته می‌شود.