HG(EXPORT) HG(EXPORT)

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

hg export [OPTION]... [-o OUTFILESPEC] [-r] [REV]...

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

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

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).
فهرستی از رشته‌ها. گره‌های والد مجموعه‌تغییر.

مثال‌ها:

  • استفاده از 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 بازگردانده می‌شود.

صادر کردن تغییراتی که تنها توسط نشانک مشخص‌شده قابل دسترسی هستند
چاپ خروجی درون فایلی با نام قالب‌بندی‌شده
تفاضل‌گیری در برابر والد دوم
بازبینی‌ها برای صادر کردن
در نظر گرفتن تمامی فایل‌ها به عنوان متنی
استفاده از قالب تفاضلی گسترش‌یافتهٔ git (پیش‌فرض: diff.git)
تولید تفاضل‌های باینری در حالت git (پیش‌فرض)
حذف تاریخ‌ها از سرآیندهای تفاضل
نمایش همراه با الگو

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