نام (NAME)

lei-p2q - استفاده از یک وصله (patch) برای تولید پرس‌وجوی lei-q

خلاصه دستور (SYNOPSIS)

lei p2q [OPTIONS] (FILE|COMMIT)

lei p2q [OPTIONS] (--stdin|-)

توضیحات (DESCRIPTION)

با دریافت یک وصله (patch)، پرس‌وجویی ایجاد می‌کند که می‌تواند از طریق stdin به lei-q(1) فرستاده شود. این ابزار برای تطبیق وصله با پیام‌های مرتبط در یک صندوق پستی (inbox) مفید است.

وصله می‌تواند از طریق stdin یا به صورت یک فایل ارائه شود. در غیر این صورت، چنانچه آرگومانی ارائه شود که به یک فایل موجود اشاره نکند، به عنوان ارجاع به یک کامیت در مخزن گیت جاری در نظر گرفته شده و از git-format-patch(1) برای تولید وصله استفاده می‌شود.

گزینه‌ها (OPTIONS)

-w PREFIX[,PREFIX]

--want=PREFIX[,PREFIX]

پیشوندهای جستجو برای استفاده. پیشوندهای "dfpost" (شناسه blob گیت پس از تغییرات) و "dfn" (نام فایل‌ها از diff) مفیدترین موارد هستند. سایر مقادیر موجود عبارتند از "dfa"، "dfb"، "dfctx"، "dfhh" و "dfpre".

افزودن یک عدد صحیح به "dfpost" یا "dfpre" حداقل طول شناسه را مشخص می‌کند، و پرس‌وجوی تولیدشده برای آن مقدار تا طول اختصاری پیش‌فرض خواهد بود. به عنوان مثال، اگر تنظیم "core.abbrev" مخزن روی "auto" باشد و گیت طول اختصاری پیش‌فرض را ۷ محاسبه کند، مقدار "dfpost6" شناسه blob تغییرات e7b4b32 (هفت کاراکتر) را به "dfpost:e7b4b32 OR dfpost:e7b4b3" بسط می‌دهد.

این گزینه ممکن است چندین بار تکرار شود.

پیش‌فرض: "dfpost7"

--stdin

خواندن پیام از stdin. در صورتی که هیچ آرگومانی داده نشود و stdin یک لوله (pipe) یا فایل معمولی باشد، این گزینه به صورت ضمنی اعمال می‌شود.

--debug

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

--uri

اسکیپ کردن کاراکترهای خروجی به قالب URI برای تعامل با نمونه‌های HTTP(S) سامانه public-inbox.

-q

--quiet

بی‌صدا کردن و عدم نمایش پیام‌های بازخورد.

مثال‌ها (EXAMPLES)

# برای جستجوی تمام رشته‌گفتگوهایی که به یک کامیت مشخص مربوط می‌شوند:
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 \( rt:last.year.. AND dfn:$FILE \) AND NOT \( \
      $(git log -p --pretty=mboxrd --since=last.year $FILE |
              lei p2q -F mboxrd )
      \) | lei q -o /tmp/unapplied

تماس (CONTACT)

ارسال بازخورد از طریق ایمیل متنی ساده به <mailto:meta@public-inbox.org> مورد استقبال است.

بایگانی ایمیل‌ها در https://public-inbox.org/meta و http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta میزبانی می‌شود.

کپی‌رایت (COPYRIGHT)

حق نشر متعلق به تمامی مشارکت‌کنندگان <mailto:meta@public-inbox.org>

مجوز: AGPL-3.0+ https://www.gnu.org/licenses/agpl-3.0.txt

همچنین ببینید (SEE ALSO)

lei-q(1)