| HG(REMOVE) | HG(REMOVE) |
نام (NAME)
hg remove - حذف فایل‌های مشخص‌شده در کامیت بعدی
خلاصه دستور (SYNOPSIS)
hg remove [OPTION]... FILE...
توضیحات (DESCRIPTION)
زمان‌بندی حذف فایل‌های مشخص‌شده از شاخهٔ جاری.
این دستور فایل‌ها را برای حذف شدن در کامیت بعدی زمان‌بندی می‌کند. برای لغو حذف پیش از آن، hg revert را ببینید. برای لغو فایل‌های اضافه‌شده، hg forget را ببینید.
می‌توان از -A/--after تنها برای حذف فایل‌هایی که پیش‌تر پاک شده‌اند استفاده کرد، از -f/--force برای اجبار به حذف، و از -Af می‌توان برای حذف فایل‌ها از بازبینی (revision) بعدی بدون پاک‌کردن آن‌ها از دایرکتوری کاری بهره برد.
جدول زیر رفتار remove را برای وضعیت‌های گوناگون فایل (ستون‌ها) و ترکیب گزینه‌ها (سطرها) شرح می‌دهد. وضعیت‌های فایل عبارتند از اضافه‌شده [A]، دست‌نخورده [C]، تغییریافته [M] و مفقود [!] (همان‌طور که توسط hg status گزارش می‌شود). کنش‌ها عبارتند از هشدار (Warn)، حذف (Remove) (از شاخه) و پاک‌کردن (Delete) (از دیسک):
| گزینه/وضعیت | A | C | M | ! |
| هیچ‌کدام | W | RD | W | R |
| -f | R | RD | RD | R |
| -A | W | W | W | R |
| -Af | R | R | R | R |
- نکته
- دستور hg remove هرگز فایل‌ها در وضعیت اضافه‌شده [A] را از دایرکتوری کاری پاک نمی‌کند، حتی اگر --force مشخص شده باشد.
در صورت موفقیت ۰، و در صورت مواجهه با هرگونه هشدار ۱ را برمی‌گرداند.
گزینه‌ها (OPTIONS)
- -A, --after
- ثبت حذف برای فایل‌های مفقود
- -f, --force
- فراموش‌کردن فایل‌های اضافه‌شده، پاک‌کردن فایل‌های تغییریافته
- -S, --subrepos
- پیمایش بازگشتی در زیرمخزن‌ها
- -I,--include <PATTERN[+]>
- شامل‌کردن نام‌های منطبق با الگوهای داده‌شده
- -X,--exclude <PATTERN[+]>
- مستثنی‌کردن نام‌های منطبق با الگوهای داده‌شده
- -n, --dry-run
- عدم انجام
عملیات،
صرفاً چاپ
خروجی
گزینه‌های دارای علامت [+] را می‌توان چندین بار مشخص کرد
نام‌های مستعار (ALIASES)
rm