نام (NAME)

hg bundle - ایجاد یک فایل بسته (bundle)

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

hg bundle [-f] [-t BUNDLESPEC] [-a] [-r REV]... [--base REV]... FILE [DEST]...

توضیحات (DESCRIPTION)

تولید یک فایل بسته (bundle) حاوی داده‌هایی که قرار است به مخزن دیگری منتقل شوند.

برای ایجاد بسته‌ای حاوی تمام مجموعه‌تغییرات (changesets)، از -a/--all (یا --base null) استفاده کنید. در غیر این صورت، hg فرض می‌کند که مقصد تمام گره‌های مشخص‌شده با پارامترهای --base را دارد. در غیر این صورت، hg فرض خواهد کرد که مخزن شامل تمام گره‌های موجود در مقصد است، یا اگر مقصدی تعیین نشده باشد، default-push/default را در نظر می‌گیرد، که در آن مقصد همان مخازنی است که از طریق گزینه DEST ارائه می‌دهید.

می‌توانید قالب بسته را با گزینه -t/--type تغییر دهید. برای مستندات مربوط به این قالب، hg help bundlespec را ببینید. به‌طور پیش‌فرض، مناسب‌ترین قالب استفاده می‌شود و فشرده‌سازی به‌طور پیش‌فرض روی bzip2 تنظیم شده است.

سپس فایل بسته را می‌توان با استفاده از روش‌های معمول انتقال داد و با دستور unbundle یا pull روی مخزن دیگری اعمال کرد. این ویژگی زمانی مفید است که push و pull مستقیم در دسترس نباشد یا صادر کردن (export) کل مخزن مطلوب نباشد.

اعمال بسته‌ها تمام محتویات مجموعه‌تغییرات شامل مجوزها، اطلاعات کپی/تغییرنام و تاریخچه بازبینی‌ها را حفظ می‌کند.

در صورت موفقیت 0، و اگر تغییری پیدا نشود 1 را برمی‌گرداند.

گزینه‌ها (OPTIONS)

--exact: محاسبه پایه از روی بازبینی (revision) مشخص‌شده
-f, --force: اجرا حتی زمانی که مقصد نامرتبط است
-r,--rev <REV[+]>: مجموعه‌تغییری که در نظر است به مقصد افزوده شود
-b,--branch <BRANCH[+]>: شاخه خاصی که می‌خواهید بسته‌بندی کنید
--base <REV[+]>: مجموعه‌تغییر پایه‌ای که فرض می‌شود در مقصد موجود است
-a, --all: بسته‌بندی تمام مجموعه‌تغییرات موجود در مخزن
-t,--type <TYPE>: نوع فشرده‌سازی بسته جهت استفاده (پیش‌فرض: bzip2)
-e,--ssh <CMD>: تعیین دستور ssh جهت استفاده
--remotecmd <CMD>: تعیین دستور hg برای اجرا در سمت دوردست (remote)
--insecure: عدم اعتبارسنجی گواهی سرور (نادیده گرفتن پیکربندی web.cacerts)
گزینه‌های مشخص‌شده با [+] می‌توانند چندین بار تعیین شوند