| HG(UPDATE) | HG(UPDATE) |
نام (NAME)
hg update - به‌روزرسانی دایرکتوری کاری (یا تغییر بازبینی‌ها)
خلاصه دستور (SYNOPSIS)
hg update [-C|-c|-m] [-d DATE] [[-r] REV]
توضیحات (DESCRIPTION)
دایرکتوری کاری مخزن را به مجموعه تغییرات (changeset) مشخص‌شده به‌روزرسانی می‌کند. اگر هیچ مجموعه تغییراتی مشخص نشده باشد، به نوک (tip) شاخه نام‌گذاری‌شده فعلی به‌روزرسانی شده و نشانک (bookmark) فعال منتقل می‌شود (ببینید hg help bookmarks).
دستور update بازبینی والد دایرکتوری کاری را روی مجموعه تغییرات مشخص‌شده تنظیم می‌کند (ببینید hg help parents).
اگر مجموعه تغییرات، نواده یا جد والد دایرکتوری کاری نباشد و تغییرات ثبت‌نشده‌ای وجود داشته باشد، عملیات به‌روزرسانی لغو می‌شود. با گزینه -c/--check، دایرکتوری کاری برای وجود تغییرات ثبت‌نشده بررسی می‌شود؛ اگر هیچ تغییری یافت نشود، دایرکتوری کاری به مجموعه تغییرات مشخص‌شده به‌روزرسانی می‌شود.
گزینه‌های -C/--clean، -c/--check و -m/--merge کنترل می‌کنند که در صورت وجود تغییرات ثبت‌نشده در دایرکتوری کاری، چه اتفاقی رخ دهد. حداکثر یکی از آن‌ها را می‌توان مشخص کرد.
- 1.
- اگر هیچ گزینه‌ای مشخص نشده باشد و مجموعه تغییرات درخواستی جد یا نواده والد دایرکتوری کاری باشد، تغییرات ثبت‌نشده با مجموعه تغییرات درخواستی ادغام می‌شوند و نتیجه ادغام به‌صورت ثبت‌نشده باقی می‌ماند. اگر مجموعه تغییرات درخواستی جد یا نواده نباشد (یعنی روی شاخه دیگری قرار داشته باشد)، به‌روزرسانی لغو شده و تغییرات ثبت‌نشده حفظ می‌شوند.
- 2.
- با گزینه -m/--merge، به‌روزرسانی مجاز خواهد بود حتی اگر مجموعه تغییرات درخواستی جد یا نواده والد دایرکتوری کاری نباشد.
- 3.
- با گزینه -c/--check، عملیات به‌روزرسانی لغو شده و تغییرات ثبت‌نشده حفظ می‌شوند.
- 4.
- با گزینه
-C/--clean،
تغییرات
ثبت‌نشده
دور ریخته
می‌شوند و
دایرکتوری
کاری به
مجموعه
تغییرات
درخواستی
به‌روزرسانی
می‌شود.
برای لغو یک ادغام ثبت‌نشده (و از دست رفتن تغییراتتان)، از hg merge --abort استفاده کنید.
از null به عنوان مجموعه تغییرات برای خالی کردن دایرکتوری کاری (مشابه hg clone -U) استفاده کنید.
اگر می‌خواهید فقط یک فایل را به یک بازبینی قدیمی‌تر بازگردانید، از hg revert [-r REV] NAME استفاده کنید.
برای مشاهده فهرستی از قالب‌های معتبر برای -d/--date به hg help dates مراجعه کنید.
در صورت موفقیت 0، و در صورت وجود فایل‌های حل‌نشده (unresolved) مقدار 1 را برمی‌گرداند.
گزینه‌ها (OPTIONS)
- -C, --clean
- دور ریختن تغییرات ثبت‌نشده (بدون پشتیبان‌گیری)
- -c, --check
- الزام تمیز بودن دایرکتوری کاری
- -m, --merge
- ادغام تغییرات ثبت‌نشده
- -d,--date <DATE>
- بالاترین بازبینی منطبق با تاریخ
- -r,--rev <REV>
- بازبینی
- -t,--tool <TOOL>
- مشخص کردن ابزار ادغام
نام‌های مستعار (ALIASES)
up, checkout, co