HG(FILES) HG(FILES)

hg files - فهرست کردن فایل‌های تحت ردیابی

hg files [OPTION]... [FILE]...

چاپ کردن فایل‌های تحت کنترل Mercurial در دایرکتوری کاری یا نسخه (بازبینی) مشخص‌شده برای فایل‌های داده‌شده (به‌استثنای فایل‌های حذف‌شده). فایل‌ها را می‌توان به‌صورت نام فایل یا مجموعه‌فایل (fileset) مشخص کرد.

اگر فایلی برای تطبیق داده نشود، این دستور نام تمامی فایل‌های تحت کنترل Mercurial را چاپ می‌کند.

قالب (Template):

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

رشته (String). نویسه‌ای که بیت‌های پیوند نمادین (symlink) و اجرایی بودن فایل را نشان می‌دهد.
رشته (String). مسیر فایل نسبت به ریشه مخزن (Repository-absolute path).
عدد صحیح (Integer). اندازه فایل به بایت.

مثال‌ها:

  • فهرست کردن تمام فایل‌های درون دایرکتوری جاری: 
    hg files .
  • نمایش اندازه‌ها و پرچم‌ها برای نسخه (بازبینی) جاری: 
    hg files -vr .
  • فهرست کردن تمام فایل‌هایی با نام README: 
    hg files -I "**/README"
  • فهرست کردن تمام فایل‌های باینری: 
    hg files "set:binary()"
  • یافتن فایل‌های حاوی یک عبارت منظم (regular expression): 
    hg files "set:grep('bob')"
  • جستجو در محتوای فایل‌های ردیابی‌شده با xargs و grep: 
    hg files -0 | xargs -0 grep foo

    برای اطلاعات بیشتر در مورد تعیین الگوهای فایل، به hg help patterns و hg help filesets مراجعه کنید.

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

جستجوی مخزن به شکلی که در بازبینی <REV> قرار دارد
-0, --print0
خاتمه دادن نام فایل‌ها با نویسه NUL، جهت استفاده با xargs
شامل کردن نام‌های منطبق با الگوهای داده‌شده
مستثنی کردن نام‌های منطبق با الگوهای داده‌شده
نمایش با استفاده از قالب
پیمایش بازگشتی در زیرمخزن‌ها (subrepositories)

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