.\" 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-NEW" "1" "Apr 17, 2026" "0.40" "notmuch"
.SH "نام (NAME)"
notmuch-new \- گنجاندن و افزودن نامه‌های جدید به پایگاه‌داده notmuch
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnotmuch\fP \fBnew\fP [\fIگزینه‌ها\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
یافتن و وارد کردن (ایمپورت) هرگونه پیام جدید به پایگاه‌داده.
.sp
دستور \fBnew\fP تمام زیرپوشه‌های پایگاه‌داده را پیمایش کرده و نمایه‌سازی تمام‌متنی را روی پیام‌های جدیدِ یافت‌شده انجام می‌دهد. هر پیام جدید به‌طور خودکار با هر دو برچسب \fBinbox\fP و \fBunread\fP نشانه‌گذاری خواهد شد.
.sp
شما باید پس از اولین اجرای notmuch \%<#\:notmuch-setup-1> جهت ایجاد پایگاه‌داده اولیه، یک بار دستور \fBnotmuch new\fP را اجرا کنید. اگر حجم نامه‌های شما زیاد باشد (چندین صد هزار پیام یا بیشتر)، اجرای نخست ممکن است زمان زیادی ببرد. در ادامه، هر زمان که نامه جدیدی دریافت شد و تمایل داشتید آن را به پایگاه‌داده اضافه کنید، باید \fBnotmuch new\fP را اجرا نمایید. این اجراهای بعدی بسیار سریع‌تر از اجرای اولیه خواهند بود.
.sp
اجرای \fBnotmuch\fP بدون هیچ آرگومان دستوری، در صورتی که notmuch \%<#\:notmuch-setup-1> قبلاً تکمیل شده باشد ولی \fBnotmuch new\fP هنوز اجرا نشده باشد، به صورت خودکار \fBnew\fP را اجرا خواهد کرد.
.sp
دستور \fBnotmuch new\fP در صورت فعال بودن گزینه پیکربندی \fBmaildir.synchronize_flags\fP، برچسب‌ها را مطابق با تغییرات پرچم‌های maildir به‌روزرسانی می‌کند. برای جزئیات، notmuch\-config \%<#\:notmuch-config-1> را ببینید.
.sp
دستور \fBnew\fP از هوک‌ها (قلاب‌ها) پشتیبانی می‌کند. برای جزئیات بیشتر درباره هوک‌ها، notmuch\-hooks \%<#\:notmuch-hooks-5> را ببینید.
.sp
گزینه‌های پشتیبانی‌شده برای \fBnew\fP عبارتند از:
.INDENT 0.0
.TP
.B \-\-no\-hooks
از اجرای هوک‌ها جلوگیری می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-quiet
پیشرفت یا نتایج را چاپ نمی‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verbose
نام فایل‌های در حال پردازش را چاپ می‌کند. در صورت ترکیب با
\fB\-\-quiet\fP
نادیده گرفته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-decrypt=(true|nostash|auto|false)
در صورت تنظیم روی
\fBtrue\fP،
هنگام برخورد با یک پیام رمزگذاری‌شده، تلاش می‌کند آن را در حین نمایه‌سازی رمزگشایی کند و کلیدهای نشست (session keys) کشف‌شده را ذخیره نماید.
اگر روی
\fBauto\fP
تنظیم شود، تلاش می‌کند از هر کلید نشستی که از قبل برای این پیام شناخته شده است استفاده کند، اما تلاشی برای استفاده از کلیدهای مخفی کاربر نخواهد کرد.
در صورت موفقیت‌آمیز بودن رمزگشایی، متن واضح پیام نمایه‌سازی می‌شود.
.sp
توجه داشته باشید که این نمایه به احتمال زیاد برای بازسازی متن واضح خود پیام کافی است (و کلید نشست قطعاً کافی است)، بنابراین لطفاً اطمینان حاصل کنید که نمایه پیام notmuch به میزان کافی محافظت می‌شود. هرگز بدون در نظر گرفتن امنیت نمایه خود از
\fB\-\-decrypt=true\fP
یا
\fB\-\-decrypt=nostash\fP
استفاده نکنید.
.sp
همچنین
\fBindex.decrypt\fP
را در notmuch\-config \%<#\:notmuch-config-1> ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-full\-scan
به‌طور پیش‌فرض notmuch\-new از زمان آخرین تغییر دایرکتوری (mtime) برای بهینه‌سازی پیمایش دایرکتوری‌ها جهت یافتن نامه‌های جدید استفاده می‌کند. این گزینه آن بهینه‌سازی را غیرفعال می‌کند.
.UNINDENT
.SH "پیکربندی (CONFIGURATION)"
.sp
نمایه‌سازی تحت تأثیر گزینه‌های پیکربندی
index.decrypt \%<#\:nmconfig-index\:.decrypt>، index.header.<prefix> \%<#\:nmconfig-index\:.header\:.-prefix>
و
new.ignore \%<#\:nmconfig-new\:.ignore>\&
قرار دارد. برچسب‌گذاری توسط
new.tags \%<#\:nmconfig-new\:.tags>
و
maildir.synchronize_flags \%<#\:nmconfig-maildir\:.synchronize_flags>\&
کنترل می‌شود. برای جزئیات، notmuch\-config \%<#\:notmuch-config-1> را ببینید.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این دستور از کد وضعیت خروج ویژه زیر پشتیبانی می‌کند:
.INDENT 0.0
.TP
.B \fB75 (EX_TEMPFAIL)\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\-reply \%<#\:notmuch-reply-1>,
notmuch\-restore \%<#\:notmuch-restore-1>,
notmuch\-search \%<#\:notmuch-search-1>,
notmuch\-search\-terms \%<#\:notmuch-search-terms-7>,
notmuch\-show \%<#\:notmuch-show-1>,
notmuch\-tag \%<#\:notmuch-tag-1>
.SH "نویسنده (AUTHOR)"
کارل ورث (Carl Worth) و بسیاری دیگر
.SH "حق نشر (COPYRIGHT)"
2009-2026, Carl Worth and many others
.\" End of generated man page.