.\" 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-TAG" "1" "Apr 17, 2026" "0.40" "notmuch"
.SH "نام (NAME)"
notmuch-tag \- افزودن/حذف برچسب‌ها برای تمام پیام‌های منطبق با عبارت‌های جستجو
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnotmuch\fP \fBtag\fP [options ...] +<\fItag\fP>|\-<\fItag\fP> [\-\-] <\fIsearch\-term\fP> ...
.sp
\fBnotmuch\fP \fBtag\fP \fB\-\-batch\fP [\-\-input=<\fIfilename\fP>]
.SH "توضیحات (DESCRIPTION)"
.sp
افزودن یا حذف برچسب‌ها برای تمامی پیام‌های منطبق با عبارت‌های جستجو.
.sp
برای جزئیات نحو پشتیبانی‌شده برای <\fIsearch\-term\fP>،
notmuch\-search\-terms \%<#\:notmuch-search-terms-7> را ببینید.
.sp
برچسب‌هایی با پیشوند \(aq+\(aq اضافه می‌شوند، در حالی که برچسب‌های دارای پیشوند \(aq\-\(aq حذف می‌گردند.
برای هر پیام، تغییرات برچسب به همان ترتیبی که در خط فرمان ظاهر شده‌اند اعمال می‌شوند.
.sp
شروع عبارت‌های جستجو با نخستین آرگومانی تشخیص داده می‌شود که نه با \(aq+\(aq آغاز شده باشد و نه با \(aq\-\(aq.
پشتیبانی از عبارت جستجوی اولیه‌ای که با \(aq+\(aq یا \(aq\-\(aq شروع شود، با دادن امکان تعیین آرگومان
\(dq\-\-\(dq به کاربر جهت تفکیک برچسب‌ها از عبارت‌های جستجو فراهم شده است.
.sp
در صورت فعال بودن گزینهٔ پیکربندی \fBmaildir.synchronize_flags\fP، دستور \fBnotmuch tag\fP پرچم‌های
maildir را بر اساس تغییرات برچسب به‌روزرسانی می‌کند.
برای جزئیات بیشتر notmuch\-config \%<#\:notmuch-config-1> را ببینید.
.sp
گزینه‌های پشتیبانی‌شده برای \fBtag\fP عبارتند از:
.INDENT 0.0
.TP
.B \-\-remove\-all
حذف تمام برچسب‌ها از هر پیامی که با عبارت‌های جستجو مطابقت دارد، پیش از اعمال تغییرات برچسب مشخص‌شده
در خط فرمان. این به معنای تنظیم برچسب‌های هر پیام به برچسب‌هایی است که قرار است اضافه شوند.
اگر هیچ برچسبی برای افزودن وجود نداشته باشد، پیام‌ها فاقد برچسب خواهند بود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-batch
خواندن عملیات برچسب‌گذاری دسته‌ای از یک فایل (به‌طور پیش‌فرض stdin).
این روش بسیار کارآمدتر از فراخوانی‌های مکرر دستور \fBnotmuch tag\fP است.
برای ساختار قالب ورودی، «قالب فایل برچسب» \%<#\:tag_file_format> در زیر را ببینید.
این گزینه با مشخص کردن برچسب‌گذاری در خط فرمان سازگار نیست.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-input=<filename>
خواندن ورودی از فایل مشخص‌شده به‌جای stdin. مستلزم گزینهٔ
\fB\-\-batch\fP است.
.UNINDENT
.SH "قالب فایل برچسب (TAG FILE FORMAT)"
.sp
ورودی باید شامل خطوطی با این قالب باشد:
.sp
+<\fItag\fP>|\-<\fItag\fP> [...] [\-\-] <\fIquery\fP>
.sp
هر خط به‌گونه‌ای مشابه با آرگومان‌های خط فرمان \fBnotmuch tag\fP تفسیر می‌شود. جداکننده یک یا چند
نویسهٔ فاصله \(aq \(aq است. هر نویسه‌ای در <\fItag\fP> \fBمی‌تواند\fP به‌صورت %NN به‌شکل شانزده‌شانزدهی
(hex) کدگذاری شود که در آن NN مقدار هگزادسیمال نویسه است. برای کدگذاری هگز نویسه‌ای با کدگذاری
چندبایتی UTF\-8، هر بایت را به‌صورت جداگانه هگز کنید. هرگونه فاصله در <tag> \fBباید\fP به‌صورت %20
کدگذاری هگز شود. هر نویسه‌ای که بخشی از <\fItag\fP> نیست \fBنباید\fP کدگذاری هگز شود.
.sp
در آینده ممکن است نقل‌قول به‌سبک tag:\(dqtag with spaces\(dq برای <\fItag\fP> نیز پشتیبانی شود؛
به همین دلیل کلیهٔ نویسه‌های نقل‌قول دوگانه (double quote) در <\fItag\fP> \fBباید\fP به‌صورت هگز کدگذاری شوند.
.sp
بخش <\fIquery\fP> باید با استفاده از قواعد نقل‌قول عبارت‌های بولی Xapian نقل‌قول شود:
اگر یک عبارت شامل نویسهٔ فاصله یا پرانتز بسته باشد یا با یک نقل‌قول دوگانه آغاز شود، باید در
نقل‌قول دوگانه محصور گردد (بدون احتساب هیچ پیشوندی) و نقل‌قول‌های دوگانهٔ درون عبارت باید دو برابر شوند
(برای مثال‌ها به بخش زیر مراجعه کنید).
.sp
فاصله‌های خالی \(aq \(aq در ابتدا و انتهای خط نادیده گرفته می‌شوند. خطوط خالی و خطوطی که با
\(aq#\(aq آغاز می‌شوند نادیده گرفته خواهند شد.
.SS "مثال (EXAMPLE)"
.sp
نمونهٔ زیر یک ورودی معتبر برای برچسب‌گذاری دسته‌ای را نشان می‌دهد. توجه داشته باشید که تنها نویسهٔ
منفرد \(aq*\(aq به‌عنوان نویسه عام (wildcard) عمل می‌کند. همچنین به دو شیوهٔ مختلف نقل‌قول برچسب
\fBspace in tags\fP دقت فرمایید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
+winner *
+foo::bar%25 \-\- (One and Two) or (One and tag:winner)
+found::it \-\- tag:foo::bar%
# ignore this line and the next

+space%20in%20tags \-\- Two
# add tag \(aq(tags)\(aq, among other stunts.
+crazy{ +(tags) +&are +#possible\e \-\- tag:\(dqspace in tags\(dq
+match*crazy \-\- tag:crazy{
+some_tag \-\- id:\(dqthis is \(dq\(dqnauty)\(dq\(dq\(dq
.EE
.UNINDENT
.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\-show \%<#\:notmuch-show-1>,
.SH "نویسندگان (AUTHORS)"
Carl Worth و افراد بسیار دیگر
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2009-2026, Carl Worth و افراد بسیار دیگر
.\" End of generated man page.