.\" -*- 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-P2Q 1"
.TH LEI-P2Q 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\-p2q \- استفاده از یک وصله (patch) برای تولید پرس‌وجوی lei\-q
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
lei p2q [OPTIONS] (FILE|COMMIT)
.PP
lei p2q [OPTIONS] (\-\-stdin|\-)
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
با دریافت یک وصله (patch)، پرس‌وجویی ایجاد می‌کند که می‌تواند از طریق stdin به \fBlei\-q\fR\|(1) فرستاده شود. این ابزار برای تطبیق وصله با پیام‌های مرتبط در یک صندوق پستی (inbox) مفید است.
.PP
وصله می‌تواند از طریق stdin یا به صورت یک فایل ارائه شود. در غیر این صورت، چنانچه آرگومانی ارائه شود که به یک فایل موجود اشاره نکند، به عنوان ارجاع به یک کامیت در مخزن گیت جاری در نظر گرفته شده و از \fBgit\-format\-patch\fR\|(1) برای تولید وصله استفاده می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\-w PREFIX[,PREFIX]" 4
.IX Item "-w PREFIX[,PREFIX]"
.PD 0
.IP \-\-want=PREFIX[,PREFIX] 4
.IX Item "--want=PREFIX[,PREFIX]"
.PD
پیشوندهای جستجو برای استفاده. پیشوندهای \f(CW\*(C`dfpost\*(C'\fR (شناسه blob گیت پس از تغییرات) و \f(CW\*(C`dfn\*(C'\fR (نام فایل‌ها از diff) مفیدترین موارد هستند. سایر مقادیر موجود عبارتند از \f(CW\*(C`dfa\*(C'\fR، \f(CW\*(C`dfb\*(C'\fR، \f(CW\*(C`dfctx\*(C'\fR، \f(CW\*(C`dfhh\*(C'\fR و \f(CW\*(C`dfpre\*(C'\fR.
.Sp
افزودن یک عدد صحیح به \f(CW\*(C`dfpost\*(C'\fR یا \f(CW\*(C`dfpre\*(C'\fR حداقل طول شناسه را مشخص می‌کند، و پرس‌وجوی تولیدشده برای آن مقدار تا طول اختصاری پیش‌فرض خواهد بود. به عنوان مثال، اگر تنظیم \f(CW\*(C`core.abbrev\*(C'\fR مخزن روی \f(CW\*(C`auto\*(C'\fR باشد و گیت طول اختصاری پیش‌فرض را ۷ محاسبه کند، مقدار \f(CW\*(C`dfpost6\*(C'\fR شناسه blob تغییرات e7b4b32 (هفت کاراکتر) را به \f(CW\*(C`dfpost:e7b4b32 OR dfpost:e7b4b3\*(C'\fR بسط می‌دهد.
.Sp
این گزینه ممکن است چندین بار تکرار شود.
.Sp
پیش‌فرض: \f(CW\*(C`dfpost7\*(C'\fR
.IP \-\-stdin 4
.IX Item "--stdin"
خواندن پیام از stdin. در صورتی که هیچ آرگومانی داده نشود و stdin یک لوله (pipe) یا فایل معمولی باشد، این گزینه به صورت ضمنی اعمال می‌شود.
.IP \-\-debug 4
.IX Item "--debug"
تخلیه خروجی برای نمایش اطلاعات جمع‌آوری‌شده به ازای هر پیشوند. این اطلاعات برای بررسی نحوه پردازش وصله مفید است، اما قالب آن پایدار در نظر گرفته نمی‌شود.
.IP \-\-uri 4
.IX Item "--uri"
اسکیپ کردن کاراکترهای خروجی به قالب URI برای تعامل با نمونه‌های HTTP(S) سامانه public\-inbox.
.IP \-q 4
.IX Item "-q"
.PD 0
.IP \-\-quiet 4
.IX Item "--quiet"
.PD
بی‌صدا کردن و عدم نمایش پیام‌های بازخورد.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
.Vb 2
\&  # برای جستجوی تمام رشته‌گفتگوهایی که به یک کامیت مشخص مربوط می‌شوند:
\&  lei p2q $COMMIT_OID | lei q \-t \-o /tmp/results
\&
\&  # برای مشاهده نتایج در یک نمونه راه دور HTTP(S) در public\-inbox:
\&  $BROWSER https://example.com/pub\-inbox/?q=$(lei p2q \-\-uri $COMMIT_OID)
\&
\&  # برای مشاهده وصله‌های اعمال‌نشده برای یک $FILE مشخص در طول سال گذشته:
\&  echo \e( rt:last.year.. AND dfn:$FILE \e) AND NOT \e( \e
\&        $(git log \-p \-\-pretty=mboxrd \-\-since=last.year $FILE |
\&                lei p2q \-F mboxrd )
\&        \e) | lei q \-o /tmp/unapplied
.Ve
.SH "تماس (CONTACT)"
.IX Header "CONTACT"
ارسال بازخورد از طریق ایمیل متنی ساده به <mailto:meta@public\-inbox.org> مورد استقبال است.
.PP
بایگانی ایمیل‌ها در <https://public\-inbox.org/meta> و
<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta> میزبانی می‌شود.
.SH "کپی‌رایت (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر متعلق به تمامی مشارکت‌کنندگان <mailto:meta@public\-inbox.org>
.PP
مجوز: AGPL\-3.0+ <https://www.gnu.org/licenses/agpl\-3.0.txt>
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBlei\-q\fR\|(1)