HG(STATUS) HG(STATUS)

hg status - نمایش فایل‌های تغییریافته در دایرکتوری کاری

hg status [OPTION]... [FILE]...

وضعیت فایل‌ها را در مخزن نمایش می‌دهد. اگر نام‌هایی مشخص شده باشند، فقط فایل‌های منطبق با آن‌ها نمایش داده می‌شوند. فایل‌هایی که دست‌نخورده (clean) یا نادیده‌گرفته‌شده (ignored) هستند یا مبدأ یک عملیات رونوشت/انتقال بوده‌اند، در فهرست نمی‌آیند مگر اینکه گزینه‌های -c/--clean یا -i/--ignored یا -C/--copies یا -A/--all داده شده باشند. مگر در حالتی که گزینه‌های توصیف‌شده با «فقط نمایش بده...» مشخص شوند، گزینه‌های -mardu استفاده می‌شوند.

گزینه -q/--quiet فایل‌های ردیابی‌نشده (ناشناس و نادیده‌گرفته‌شده) را پنهان می‌کند، مگر اینکه صریحاً با -u/--unknown یا -i/--ignored درخواست شده باشند.

نکته
اگر مجوزها تغییر کرده باشند یا یک ادغام (merge) رخ داده باشد، ممکن است به نظر برسد hg status با diff مغایرت دارد. قالب استاندارد diff تغییرات مجوز را گزارش نمی‌کند و همچنین تغییرات را تنها نسبت به یکی از والدین ادغام نشان می‌دهد.

اگر یک بازبینی (revision) مشخص شود، به عنوان بازبینی مبنا در نظر گرفته می‌شود. اگر دو بازبینی مشخص شوند، تفاوت‌های میان آن‌ها نمایش داده می‌شود. گزینه --change نیز می‌تواند به عنوان یک میانبر برای فهرست کردن فایل‌های تغییریافتهٔ یک بازبینی نسبت به والد نخست آن به کار رود.

کدهای استفاده‌شده برای نمایش وضعیت فایل‌ها عبارتند از:

M = تغییریافته (modified)
A = اضافه‌شده (added)
R = حذف‌شده (removed)
C = بدون تغییر (clean)
! = ناموجود (توسط دستوری غیر از hg حذف شده، اما همچنان ردیابی می‌شود)
? = ردیابی‌نشده (not tracked)
I = نادیده‌گرفته‌شده (ignored)
  = مبدأ فایل قبلی (همراه با --copies)

گزینه -t/--terse با نمایش تنها نام دایرکتوری در حالتی که تمام فایل‌های درون آن وضعیت یکسانی داشته باشند، خروجی را خلاصه می‌کند. این گزینه آرگومانی می‌پذیرد که نشان‌دهندهٔ وضعیت‌ها برای خلاصه‌سازی است: 'm' برای تغییریافته ('modified')، 'a' برای اضافه‌شده ('added')، 'r' برای حذف‌شده ('removed')، 'd' برای پاک‌شده ('deleted')، 'u' برای ناشناس ('unknown')، 'i' برای نادیده‌گرفته‌شده ('ignored') و 'c' برای دست‌نخورده و بدون تغییر (clean).

این گزینه تنها وضعیت‌هایی را که ارسال شده‌اند خلاصه می‌کند. توجه داشته باشید که فایل‌های بدون تغییر و نادیده‌گرفته‌شده با '--terse ic' نمایش داده نمی‌شوند مگر اینکه گزینه‌های -c/--clean و -i/--ignored نیز به کار روند.

گزینه -v/--verbose هنگامی که مخزن در وضعیت‌هایی مانند ادغام ناتمام، shelve یا rebase باشد، اطلاعات تکمیلی را نمایش می‌دهد. با فعال کردن گزینه commands.status.verbose می‌توانید این رفتار را به صورت پیش‌فرض فعال کنید.

می‌توانید با تنظیم commands.status.skipstates روی یک یا چند مقدار از موارد زیر، از نمایش وضعیت‌های مربوطه صرف‌نظر کنید: 'bisect'، 'graft'، 'histedit'، 'merge'، 'rebase' یا 'unshelve'.

قالب (Template):

علاوه بر کلیدواژه‌ها و توابع عمومی قالب، کلیدواژه‌های زیر نیز پشتیبانی می‌شوند. همچنین hg help templates را ببینید.

رشته. مسیر فایل به صورت مطلق نسبت به مخزن.
رشته. مسیر مطلق فایلی که مبدأ بوده است نسبت به مخزن. در صورت مشخص شدن --copies در دسترس خواهد بود.
رشته. نویسه‌ای که وضعیت فایل را مشخص می‌کند.

مثال‌ها:

  • نمایش تغییرات دایرکتوری کاری نسبت به یک changeset: 
    hg status --rev 9353
  • نمایش تغییرات دایرکتوری کاری نسبت به دایرکتوری جاری (برای اطلاعات بیشتر hg help patterns را ببینید): 
    hg status re:
  • نمایش تمام تغییرات از جمله فایل‌های رونوشت‌شده در یک changeset موجود: 
    hg status --copies --change 9353
  • دریافت فهرستی از فایل‌های اضافه‌شده با جداکننده NUL، مناسب برای xargs: 
    hg status -an0
  • نمایش اطلاعات بیشتر درباره وضعیت مخزن با خلاصه‌سازی مسیرهای افزوده، حذف‌شده، تغییریافته، پاک‌شده و ردیابی‌نشده: 
    hg status -v -t mardu

    در صورت موفقیت 0 را برمی‌گرداند.

نمایش وضعیت تمام فایل‌ها
فقط نمایش فایل‌های تغییریافته
فقط نمایش فایل‌های اضافه‌شده
فقط نمایش فایل‌های حذف‌شده
فقط نمایش فایل‌های ناموجود
فقط نمایش فایل‌های بدون تغییر
فقط نمایش فایل‌های ناشناس (ردیابی‌نشده)
فقط نمایش فایل‌های نادیده‌گرفته‌شده
عدم نمایش پیشوند وضعیت
نمایش خروجی فشرده و خلاصه (آزمایشی) (پیش‌فرض: هیچ)
نمایش مبدأ فایل‌های رونوشت‌شده (پیش‌فرض: ui.statuscopies)
-0, --print0
خاتمه دادن نام فایل‌ها با نویسه NUL، مناسب برای استفاده با xargs
نمایش تفاوت نسبت به بازبینی
فهرست کردن فایل‌های تغییریافته در یک بازبینی
شامل کردن نام‌های منطبق با الگوهای ارائه‌شده
مستثنی کردن نام‌های منطبق با الگوهای ارائه‌شده
پیمایش بازگشتی در زیرمخزن‌ها
نمایش با استفاده از قالب مشخص‌شده

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

st