HG(EXPORT)                                                          HG(EXPORT)

نام (NAME)
       hg export - استخراج سرآیند و تفاضل‌ها برای یک یا چند مجموعه‌تغییر

خلاصه دستور (SYNOPSIS)
       hg export [OPTION]... [-o OUTFILESPEC] [-r] [REV]...

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

       اطلاعات نمایش‌داده‌شده در سرآیند مجموعه‌تغییر عبارت است از: نویسنده،
       تاریخ، نام شاخه (در صورت غیرپیش‌فرض بودن)، هش مجموعه‌تغییر، والد(ها) و
       یادداشت کامیت.

       Note   hg export ممکن است برای مجموعه‌تغییرات ادغام، خروجی تفاضل
              غیرمنتظره‌ای تولید کند، زیرا مجموعه‌تغییر ادغام را تنها با اولین
              والد آن مقایسه خواهد کرد.

       خروجی می‌تواند به یک فایل هدایت شود، که در این حالت نام فایل با استفاده
       از یک رشتهٔ الگو داده می‌شود. hg help templates را ببینید. علاوه بر کلمات
       کلیدی مشترک الگو، قواعد قالب‌بندی زیر پشتیبانی می‌شوند:

       %%

              نویسهٔ لفظی «%»

       %H

              هش مجموعه‌تغییر (۴۰ رقم هگزادسیمال)

       %N

              تعداد وصله‌های تولیدشده

       %R

              شمارهٔ بازبینی مجموعه‌تغییر

       %b

              نام پایه (basename) مخزن صادرکننده

       %h

              فرم کوتاه‌شدهٔ هش مجموعه‌تغییر (۱۲ رقم هگزادسیمال)

       %m

              خط اول پیام کامیت (تنها نویسه‌های الفبایی‌عددی)

       %n

              شمارهٔ ترتیبی پدشده با صفر، با شروع از ۱

       %r

              شمارهٔ بازبینی مجموعه‌تغییر پدشده با صفر

       \

              نویسهٔ لفظی «\»

              بدون گزینهٔ -a/--text، دستور export از تولید تفاضل فایل‌هایی که به
              عنوان باینری تشخیص داده می‌شوند خودداری می‌کند. با -a، دستور
              export در هر صورت تفاضل تولید خواهد کرد، که احتمالاً نتایج
              نامطلوبی در پی خواهد داشت.

              با -B/--bookmark مجموعه‌تغییرات قابل دسترسی با نشانک داده‌شده
              انتخاب می‌شوند.

              از گزینهٔ -g/--git برای تولید تفاضل در قالب تفاضلی گسترش‌یافتهٔ git
              استفاده کنید. برای اطلاعات بیشتر hg help diffs را ببینید.

              با گزینهٔ --switch-parent، تفاضل در برابر والد دوم گرفته می‌شود.
              این کار می‌تواند برای بررسی یک ادغام مفید باشد.

              الگو:

              کلمات کلیدی زیر علاوه بر کلمات کلیدی و توابع مشترک الگو پشتیبانی
              می‌شوند. همچنین hg help templates را ببینید.

       diff   رشته. محتوای تفاضل (diff).

       parents
              فهرستی از رشته‌ها. گره‌های والد مجموعه‌تغییر.

              مثال‌ها:

       • استفاده از export و import برای انتقال یک اصلاح باگ به شاخهٔ فعلی:

         hg export -r 9353 | hg import -

       • صادر کردن تمامی مجموعه‌تغییرات بین دو بازبینی به یک فایل همراه با
         اطلاعات تغییر نام:

         hg export --git -r 123:150 > changes.txt

       • تقسیم تغییرات خروجی به مجموعه‌ای از وصله‌ها با نام‌های توصیفی:

         hg export -r "outgoing()" -o "%n-%m.patch"

         در صورت موفقیت مقدار 0 بازگردانده می‌شود.

گزینه‌ها (OPTIONS)
       -B,--bookmark <BOOKMARK>
              صادر کردن تغییراتی که تنها توسط نشانک مشخص‌شده قابل دسترسی هستند

       -o,--output <FORMAT>
              چاپ خروجی درون فایلی با نام قالب‌بندی‌شده

       --switch-parent
              تفاضل‌گیری در برابر والد دوم

       -r,--rev <REV[+]>
              بازبینی‌ها برای صادر کردن

       -a, --text
              در نظر گرفتن تمامی فایل‌ها به عنوان متنی

       -g, --git
              استفاده از قالب تفاضلی گسترش‌یافتهٔ git (پیش‌فرض: diff.git)

       --binary
              تولید تفاضل‌های باینری در حالت git (پیش‌فرض)

       --nodates
              حذف تاریخ‌ها از سرآیندهای تفاضل

       -T,--template <TEMPLATE>
              نمایش همراه با الگو

              گزینه‌های علامت‌گذاری‌شده با [+] را می‌توان چندین بار مشخص کرد

                                                                    HG(EXPORT)