.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "LEI-Q 1" .TH LEI-Q 1 1993-10-02 public-inbox.git "public-inbox user manual" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" lei\-q \- جستجوی پیام‌های منطبق با عبارت‌ها .SH "خلاصه دستور (SYNOPSIS)" .IX Header "خلاصه دستور (SYNOPSIS)" lei q [OPTIONS] TERM [TERM...] .PP lei q [OPTIONS] (\-\-stdin|\-) .SH "توضیحات (DESCRIPTION)" .IX Header "توضیحات (DESCRIPTION)" جستجو برای پیام‌ها در سراسر lei/store و منابع خارجی (externals). .SH "گزینه‌ها (OPTIONS)" .IX Header "گزینه‌ها (OPTIONS)" .IP \-\-stdin 4 .IX Item "--stdin" خواندن عبارت‌های جستجو از stdin. .IP \-\-no\-save 4 .IX Item "--no-save" جستجو را برای \fBlei\-up\fR\|(1) ذخیره نکن. .IP \-\-output=MFOLDER 4 .IX Item "--output=MFOLDER" .PD 0 .IP "\-o MFOLDER" 4 .IX Item "-o MFOLDER" .IP \-\-mfolder=MFOLDER 4 .IX Item "--mfolder=MFOLDER" .PD هشدار: این گزینه مقصد خروجی را پاک و بازنویسی می‌کند، مگر اینکه "\-\-augment" مشخص شده باشد. .Sp مقصد برای نتایج (برای نمونه، \f(CW\*(C`/tmp/results\-Maildir\*(C'\fR، \&\f(CW\*(C`imaps://user@mail.example.com/INBOX.test\*(C'\fR، یا \&\f(CW\*(C`mboxcl2:/tmp/results\-mboxcl2\*(C'\fR). پیشوند ممکن است یک پروتکل پشتیبانی‌شده باشد: \&\f(CW\*(C`imap://\*(C'\fR یا \f(CW\*(C`imaps://\*(C'\fR. نشانی‌های اینترنتی که نیازمند احراز هویت هستند از \fBgit\-credential\fR\|(1) برای پر کردن نام کاربری و گذرواژه استفاده می‌کنند. .Sp یک پیشوند می‌تواند قالب خروجی را مشخص کند: \f(CW\*(C`maildir\*(C'\fR، \&\f(CW\*(C`mboxrd\*(C'\fR، \f(CW\*(C`mboxcl2\*(C'\fR، \f(CW\*(C`mboxcl\*(C'\fR، \f(CW\*(C`mboxo\*(C'\fR. برای شرح قالب‌های ایمیل، \fBlei\-mail\-formats\fR\|(5) را ببینید. .Sp \&\f(CW\*(C`v2:/path/to/inbox\*(C'\fR ممکن است برای ایجاد یک صندوق ورودی جدید از \&\fBpublic\-inbox\-v2\-format\fR\|(5) استفاده شود. صندوق ورودی جدید در فایل \fBpublic\-inbox\-config\fR\|(5) پیکربندی نخواهد شد. .Sp \&\f(CW\*(C`maildir\*(C'\fR پیش‌فرض برای یک دایرکتوری موجود یا مسیری ناموجود است. .Sp پیش‌فرض: \f(CW\*(C`\-\*(C'\fR (stdout) .IP \-\-format=FORMAT 4 .IX Item "--format=FORMAT" .PD 0 .IP "\-f FORMAT" 4 .IX Item "-f FORMAT" .PD قالب نتایج به stdout. این گزینه به عنوان روشی راحت برای مشخص کردن قالب مقصد پیش‌فرض stdout وجود دارد. \&\f(CW\*(C`reply\*(C'\fR، \f(CW\*(C`text\*(C'\fR، \f(CW\*(C`json\*(C'\fR، \f(CW\*(C`jsonl\*(C'\fR، یا \f(CW\*(C`concatjson\*(C'\fR همگی پشتیبانی می‌شوند، همان‌طور که انواع مختلف mbox که در "\-\-output" شرح داده شده پشتیبانی می‌شوند. .Sp هنگامی که قالبی مشخص نشده باشد، بر اساس پیشوند یا مقصد "\-\-output" انتخاب می‌شود. برای مقصد پیش‌فرض (stdout) از \f(CW\*(C`json\*(C'\fR استفاده می‌شود. .Sp استفاده از پیشوند \f(CW\*(C`format:\*(C'\fR همراه با مقصد \f(CW\*(C`\-\-output\*(C'\fR هنگامی که خروجی روی stdout نوشته نمی‌شود، ترجیح داده می‌شود. .IP \-\-no\-color 4 .IX Item "--no-color" غیرفعال کردن رنگ (برای \f(CW\*(C`\-f reply\*(C'\fR و \f(CW\*(C`\-f text\*(C'\fR). .IP \-\-pretty 4 .IX Item "--pretty" زیبانویسی (Pretty\-print) خروجی \f(CW\*(C`json\*(C'\fR یا \f(CW\*(C`concatjson\*(C'\fR. اگر stdout به یک tty متصل باشد و به عنوان مقصد \f(CW\*(C`\-\-output\*(C'\fR استفاده شود، \f(CW\*(C`\-\-pretty\*(C'\fR به صورت پیش‌فرض فعال است. .IP \-\-mua=COMMAND 4 .IX Item "--mua=COMMAND" دستوری برای اجرا روی Maildir یا mbox در \f(CW\*(C`\-\-output\*(C'\fR (برای نمونه، \f(CW\*(C`mutt \-f %f\*(C'\fR). برای زیرمجموعه‌ای از MUAها که به پذیرش صندوق پستی از طریق \f(CW\*(C`\-f\*(C'\fR شناخته می‌شوند، COMMAND می‌تواند به نام برنامه خلاصه شود: \f(CW\*(C`mutt\*(C'\fR، \f(CW\*(C`mailx\*(C'\fR، \f(CW\*(C`mail\*(C'\fR، یا \f(CW\*(C`neomutt\*(C'\fR. .IP \-\-alert=COMMAND[,COMMAND...] 4 .IX Item "--alert=COMMAND[,COMMAND...]" اجرای \f(CW\*(C`COMMAND\*(C'\fR پس از نوشتن در خروجی. \f(CW\*(C`:WINCH\*(C'\fR ارسال \&\f(CW\*(C`SIGWINCH\*(C'\fR به فرایند \f(CW\*(C`\-\-mua\*(C'\fR را مشخص می‌کند. \f(CW\*(C`:bell\*(C'\fR چاپ یک کد زنگ را نشان می‌دهد. هر مقدار دیگری به عنوان دستوری که باید همان‌طور که هست اجرا شود، تفسیر می‌گردد. .Sp این گزینه می‌تواند چندین بار مشخص شود. .Sp پیش‌فرض: \f(CW\*(C`:WINCH,:bell\*(C'\fR هنگامی که \f(CW\*(C`\-\-mua\*(C'\fR مشخص شده باشد و \f(CW\*(C`\-\-output\*(C'\fR به stdout اشاره نکند؛ در غیر این صورت هیچ‌چیز. .IP \-\-augment 4 .IX Item "--augment" .PD 0 .IP \-a 4 .IX Item "-a" .PD افزودن به مقصد خروجی به جای پاک و بازنویسی کردن آن. .IP \-\-no\-import\-before 4 .IX Item "--no-import-before" پیش از نوشتن در یک مقصد خروجی موجود، پیام‌ها را وارد نکنید. پیش از استفاده از این گزینه مطمئن شوید به داده‌های موجود در خروجی خود نیازی ندارید؛ این گزینه داده‌ها را برای همیشه پاک می‌کند مگر اینکه از \f(CW\*(C`\-\-augment\*(C'\fR استفاده شود. .IP \-\-threads 4 .IX Item "--threads" .PD 0 .IP \-t 4 .IX Item "-t" .PD بازگرداندن تمام پیام‌های موجود در رشته‌گفتگوی (thread) یکسان با پیام(های) منطبق واقعی. .Sp استفاده دو بار از این گزینه (\f(CW\*(C`\-tt\*(C'\fR)، نشان \f(CW\*(C`flagged\*(C'\fR (یا "important") را روی پیام‌هایی که تطابق واقعی داشته‌اند تنظیم می‌کند. این مورد برای تمایز پیام‌هایی که تطابق مستقیم داشته‌اند از پیام‌هایی که صرفاً بخشی از همان رشته‌گفتگو بوده‌اند مفید است. .Sp نکته در دست انجام (TODO): هشدار: این پرچم ممکن است ماندگار شده و در lei/store ذخیره شود، مگر اینکه یک MUA نشان آن را بردارد! (رفتار نهایی تعیین نشده است) .Sp توجه: \f(CW\*(C`\-tt\*(C'\fR در حال حاضر تنها روی پیام‌هایی کار می‌کند که به صورت محلی نمایه شده‌اند، و نه روی نقاط انتهایی راه دور (HTTP(S))..IP \-\-thread\-id=MSGID 4 .IX Item "--thread-id=MSGID" .PD 0 .IP "\-T MSGID" 4 .IX Item "-T MSGID" .PD تنها پیام‌های موجود در همان رشته گفت‌وگو (thread) مشابه با Message\-ID مشخص‌شده را جستجو می‌کند. .Sp برای منابع خارجی (externals) از نوع HTTP(S)، این ویژگی تنها روی نمونه‌هایی کار می‌کند که public\-inbox نسخه 2.0+ (UNRELEASED) را اجرا می‌کنند. .IP \-\-jobs=QUERY_WORKERS[,WRITE_WORKERS] 4 .IX Item "--jobs=QUERY_WORKERS[,WRITE_WORKERS]" .PD 0 .IP \-\-jobs=,WRITE_WORKERS 4 .IX Item "--jobs=,WRITE_WORKERS" .IP "\-j QUERY_WORKERS[,WRITE_WORKERS]" 4 .IX Item "-j QUERY_WORKERS[,WRITE_WORKERS]" .IP "\-j ,WRITE_WORKERS" 4 .IX Item "-j ,WRITE_WORKERS" .PD تنظیم تعداد فرآیندهای کارگر (worker) پرس‌وجو و نوشتن به منظور موازی‌سازی. .Sp مقدار پیش‌فرض \&\f(CW\*(C`QUERY_WORKERS\*(C'\fR برابر با تعداد پردازنده‌های (CPU) در دسترس است، اما برای هر میزبان دوردست (HTTP/HTTPS) برابر با ۴ می‌باشد. .Sp مقدار پیش‌فرض \&\f(CW\*(C`WRITE_WORKERS\*(C'\fR برابر با ۷۵٪ تعداد پردازنده‌های در دسترس برای مقصدهای Maildir و *mbox است، اما برای هر میزبان IMAP/IMAPS برابر با ۴ می‌باشد. .Sp حذف \f(CW\*(C`QUERY_WORKERS\*(C'\fR و باقی گذاشتن کاما (\f(CW\*(C`,\*(C'\fR) این امکان را می‌دهد که تنها \f(CW\*(C`WRITE_WORKERS\*(C'\fR تنظیم شود. .IP \-\-dedupe=STRATEGY 4 .IX Item "--dedupe=STRATEGY" .PD 0 .IP "\-d STRATEGY" 4 .IX Item "-d STRATEGY" .PD راهبرد برای یکتاسازی (حذف تکرار) پیام‌ها: \f(CW\*(C`content\*(C'\fR، \f(CW\*(C`oid\*(C'\fR، \f(CW\*(C`mid\*(C'\fR یا \&\f(CW\*(C`none\*(C'\fR. .Sp پیش‌فرض: \f(CW\*(C`content\*(C'\fR .IP \-\-[no\-]remote 4 .IX Item "--[no-]remote" تعیین اینکه آیا نتایج نیازمند دسترسی به شبکه گنجانده شوند یا خیر. هنگامی که منابع خارجی محلی پیکربندی شده باشند، \f(CW\*(C`\-\-remote\*(C'\fR باید به صراحت فرستاده شود تا گزارش نتایج از منابع خارجی دوردست فعال گردد. .IP \-\-no\-local 4 .IX Item "--no-local" محدود کردن عملیات تنها به مواردی که نیازمند دسترسی به شبکه هستند. .IP \-\-no\-external 4 .IX Item "--no-external" نتایج برگرفته از منابع خارجی (externals) گنجانده نشوند. .IP \-\-include=LOCATION 4 .IX Item "--include=LOCATION" .PD 0 .IP "\-I LOCATION" 4 .IX Item "-I LOCATION" .PD گنجاندن منبع خارجی مشخص‌شده در جستجو. این گزینه می‌تواند چندین بار مشخص شود. .IP \-\-exclude=LOCATION 4 .IX Item "--exclude=LOCATION" مستثنی کردن منبع خارجی مشخص‌شده از جستجو. این گزینه می‌تواند چندین بار مشخص شود. .IP \-\-only=LOCATION 4 .IX Item "--only=LOCATION" .PD 0 .IP "\-O LOCATION" 4 .IX Item "-O LOCATION" .PD تنها استفاده از منبع خارجی مشخص‌شده برای جستجو. این گزینه می‌تواند چندین بار مشخص شود، که در این حالت جستجو تنها از مجموعه مشخص‌شده استفاده می‌کند. .IP \-\-globoff 4 .IX Item "--globoff" .PD 0 .IP \-g 4 .IX Item "-g" .PD عدم تطبیق مکان‌ها با استفاده از نویسه‌های عمومی (wildcards) \f(CW\*(C`*?\*(C'\fR و بازه‌های \f(CW\*(C`[]\*(C'\fR. این گزینه روی \f(CW\*(C`\-\-include\*(C'\fR، \f(CW\*(C`\-\-exclude\*(C'\fR، و \f(CW\*(C`\-\-only\*(C'\fR اعمال می‌شود. .IP \-\-no\-import\-remote 4 .IX Item "--no-import-remote" غیرفعال کردن رفتار پیش‌فرضِ ذخیره‌سازی موقت (memoizing) پیام‌های دوردست در مخزن محلی (local store). .IP \-\-lock=METHOD 4 .IX Item "--lock=METHOD" روش(های) قفل‌گذاری \fBmbox\fR\|(5) برای استفاده: \f(CW\*(C`dotlock\*(C'\fR، \f(CW\*(C`fcntl\*(C'\fR، \f(CW\*(C`flock\*(C'\fR یا \&\f(CW\*(C`none\*(C'\fR. .Sp پیش‌فرض: fcntl,dotlock .IP \-\-limit=NUMBER 4 .IX Item "--limit=NUMBER" .PD 0 .IP \-NUMBER 4 .IX Item "-NUMBER" .IP "\-n NUMBER" 4 .IX Item "-n NUMBER" .PD محدودسازی تقریبی (Fuzzy\-limit) تعداد تطابق‌ها به ازای هر منبع خارجی محلی و lei/store. پیام‌های اضافه‌شده با سوییچ \-\-threads در این محدودیت به حساب نمی‌آیند، و هیچ محدودیتی بر منابع خارجی دوردست اعمال نمی‌شود. .Sp پیش‌فرض: 10000 .IP \-\-offset=NUMBER 4 .IX Item "--offset=NUMBER" جابه‌جایی نقطه شروع نتایج جستجو. .Sp پیش‌فرض: 0 .IP \-\-reverse 4 .IX Item "--reverse" .PD 0 .IP \-r 4 .IX Item "-r" .PD معکوس کردن نتایج. توجه داشته باشید که این گزینه پیش از \f(CW\*(C`\-\-limit\*(C'\fR اعمال می‌شود. .IP \-\-sort=KEY 4 .IX Item "--sort=KEY" .PD 0 .IP "\-s KEY" 4 .IX Item "-s KEY" .PD مرتب‌سازی نتایج بر اساس KEY. کلیدهای معتبر عبارتند از \f(CW\*(C`received\*(C'\fR، \f(CW\*(C`relevance\*(C'\fR، و \f(CW\*(C`docid\*(C'\fR. .Sp پیش‌فرض: \f(CW\*(C`received\*(C'\fR .IP \-\-verbose 4 .IX Item "--verbose" .PD 0 .IP \-v 4 .IX Item "-v" .PD ارائه بازخورد بیشتر در stderr. .IP \-\-quiet 4 .IX Item "--quiet" .PD 0 .IP \-q 4 .IX Item "-q" .PD جلوگیری از نمایش پیام‌های بازخورد. .IP \-\-torsocks=auto|no|yes 4 .IX Item "--torsocks=auto|no|yes" .PD 0 .IP \-\-no\-torsocks 4 .IX Item "--no-torsocks" .PD تعیین اینکه آیا دستورهای \fBgit\fR\|(1) و \fBcurl\fR\|(1) با \fBtorsocks\fR\|(1) کپسوله‌سازی (wrap) شوند یا خیر. .Sp پیش‌فرض: \f(CW\*(C`auto\*(C'\fR .IP \-\-proxy=PROTOCOL://HOST[:PORT] 4 .IX Item "--proxy=PROTOCOL://HOST[:PORT]".SH "عبارت‌های جستجو (SEARCH TERMS)" .IX Header "SEARCH TERMS" دستور \&\f(CW\*(C`lei q\*(C'\fR از همان پیشوندهای جستجویی پشتیبانی می‌کند که نمونه‌های HTTP(S) سامانهٔ public\-inbox استفاده می‌کنند: .PP .Vb 10 \& s: تطابق در Subject، مانند s:"a quick brown fox" \& d: تطابق با بازهٔ تاریخ\-زمان، قالب‌های "approxidate" در git پشتیبانی می‌شوند \& بازه‌های انتهای‌باز مانند \`d:last.week..\*(Aq و \& \`d:..2.days.ago\*(Aq پشتیبانی می‌شوند \& b: تطابق در بدنهٔ پیام، شامل پیوست‌های متنی \& nq: تطابق با متن نقل‌قول‌نشده در بدنهٔ پیام \& q: تطابق با متن نقل‌قول‌شده در بدنهٔ پیام \& n: تطابق با نام فایلِ پیوست(ها) \& t: تطابق در سرآیند To \& c: تطابق در سرآیند Cc \& f: تطابق در سرآیند From \& a: تطابق در سرآیندهای To، Cc و From \& tc: تطابق در سرآیندهای To و Cc \& l: تطابق با محتوای سرآیند List\-Id \& bs: تطابق در Subject و بدنهٔ پیام \& dfn: تطابق با نام فایل از diff \& dfa: تطابق با خطوط حذف‌شدهٔ diff (\-) \& dfb: تطابق با خطوط اضافه‌شدهٔ diff (+) \& dfhh: تطابق با بافت سرآیند قطعهٔ diff (معمولاً یک نام تابع) \& dfctx: تطابق با خطوط بافت (context) در diff \& dfpre: تطابق با شناسهٔ blob پیش‌تصویر (pre\-image) در git \& dfpost: تطابق با شناسهٔ blob پس‌تصویر (post\-image) در git \& dfblob: تطابق با هر یک از شناسه‌های blob پیش‌تصویر یا پس‌تصویر در git \& patchid: تطابق با خروجی \`git patch\-id \-\-stable\*(Aq \& rt: تطابق با زمان دریافت، مانند \`d:\*(Aq در صورت دقیق بودن ساعت فرستنده .Ve .PP پیشوندهای جستجوی اضافی که تنها بر lei/store محلی اثر می‌گذارند: .PP .Vb 2 \& L: تطابق با برچسب (label) مشخص‌شده \& kw: تطابق با کلیدواژه‌های (keywords) مشخص‌شده .Ve .PP برای اطلاعات بیشتر دربارهٔ برچسب‌ها و کلیدواژه‌ها، \fBlei\-tag\fR\|(1) را ببینید. .PP بیشتر پیشوندها احتمالاتی (probabilistic) هستند، به این معنی که از ریشه‌یابی کلمات (stemming) و نویسه‌های عام (\f(CW\*(C`*\*(C'\fR) پشتیبانی می‌کنند. بازه‌ها (مانند \f(CW\*(C`d:\*(C'\fR) و پیشوندهای بولی از ریشه‌یابی کلمات یا نویسه‌های عام پشتیبانی نمی‌کنند. مستندات بالادستی تجزیه‌کنندهٔ پرس‌وجوی Xapian نحو پرس‌وجو را به طور کامل توضیح می‌دهد: .SH "نکات (TIPS)" .IX Header "TIPS" گزینهٔ \&\f(CW\*(C`\-f reply\*(C'\fR برای کمک به تبدیل یک معرفی‌نامه (cover letter) به پاسخ در نظر گرفته شده است (چرا که استفاده از \f(CW\*(C`git format\-patch \-\-in\-reply\-to=...\*(C'\fR خسته‌کننده است). نتایج (از جمله خطوط "From ") باید پیش از ارسال، در \f(CW$EDITOR\fR دلخواه شما ویرایش و مرتب شوند. .SH "تماس (CONTACT)" .IX Header "CONTACT" ارسال بازخورد از طریق رایانامهٔ متن ساده به مورد استقبال است. .PP آرشیوهای رایانامه در و میزبانی می‌شوند. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT" کپی‌رایت متعلق به تمامی مشارکت‌کنندگان است .PP مجوز: AGPL\-3.0+ .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBlei\-add\-external\fR\|(1)، \fBlei\-lcat\fR\|(1)، \fBlei\-up\fR\|(1)، نحو Xapian::QueryParser