| HG(RENAME) | HG(RENAME) |
نام (NAME)
hg rename - تغییر نام فایل‌ها؛ معادل copy + remove
خلاصه دستور (SYNOPSIS)
hg rename [OPTION]... SOURCE... DEST
توضیحات (DESCRIPTION)
مقصد (dest) را به‌عنوان رونوشت‌هایی از مبداها (sources) علامت‌گذاری می‌کند؛ مبداها را برای حذف نشانه‌گذاری می‌کند. اگر dest یک دایرکتوری باشد، رونوشت‌ها درون آن دایرکتوری قرار می‌گیرند. اگر dest یک فایل باشد، تنها یک مبدا می‌تواند وجود داشته باشد.
به‌طور پیش‌فرض، این دستور محتویات فایل‌ها را همان‌گونه که در دایرکتوری کاری وجود دارند کپی می‌کند. اگر با -A/--after فراخوانی شود، عملیات ثبت می‌شود، اما هیچ کپی‌کردنی انجام نمی‌گیرد.
برای لغو علامت‌گذاری یک فایل مقصد به‌عنوان تغییرنام‌یافته، از --forget استفاده کنید. با این گزینه، علامت تغییر نام از روی تمام آرگومان‌های (وضعیتی) داده‌شده برداشته می‌شود. فایل(های) مقصد در جای خود باقی می‌مانند (همچنان ردگیری می‌شوند). فایل(های) مبدا بازیابی نخواهند شد. توجه داشته باشید که hg rename --forget دقیقاً مانند hg copy --forget رفتار می‌کند.
این دستور به‌طور پیش‌فرض با commit بعدی اعمال می‌شود.
در صورت موفقیت مقدار 0 و در صورت بروز خطا مقدار 1 را برمی‌گرداند.
گزینه‌ها (OPTIONS)
- --forget
- لغو علامت‌گذاری فایل مقصد به‌عنوان تغییرنام‌یافته
- -A, --after
- ثبت تغییر نامی که پیش‌تر رخ داده است
- --at-rev <REV>
- علامت‌گذاری یا لغو علامت‌گذاری تغییر نام‌ها در ویرایش (revision) مشخص‌شده (آزمایشی)
- -f, --force
- انتقال اجباری بر روی یک فایل مدیریت‌شده موجود
- -I,--include <PATTERN[+]>
- شامل کردن نام‌های منطبق با الگوهای داده‌شده
- -X,--exclude <PATTERN[+]>
- مستثنی کردن نام‌های منطبق با الگوهای داده‌شده
- -n, --dry-run
- عدم اجرای
عملیات،
صرفاً
نمایش
خروجی
گزینه‌های مشخص‌شده با [+] را می‌توان چندین بار تعیین کرد
نام‌های مستعار (ALIASES)
move, mv