HG(FILES)                                                            HG(FILES)

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

خلاصه دستور (SYNOPSIS)
       hg files [OPTION]... [FILE]...

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

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

       قالب (Template):

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

       flags  رشته (String). نویسه‌ای که بیت‌های پیوند نمادین (symlink) و اجرایی
              بودن فایل را نشان می‌دهد.

       path   رشته (String). مسیر فایل نسبت به ریشه مخزن (Repository-absolute
              path).

       size   عدد صحیح (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 را برمی‌گرداند.

گزینه‌ها (OPTIONS)
       -r,--rev <REV>
              جستجوی مخزن به شکلی که در بازبینی <REV> قرار دارد

       -0, --print0
              خاتمه دادن نام فایل‌ها با نویسه NUL، جهت استفاده با xargs

       -I,--include <PATTERN[+]>
              شامل کردن نام‌های منطبق با الگوهای داده‌شده

       -X,--exclude <PATTERN[+]>
              مستثنی کردن نام‌های منطبق با الگوهای داده‌شده

       -T,--template <TEMPLATE>
              نمایش با استفاده از قالب

       -S, --subrepos
              پیمایش بازگشتی در زیرمخزن‌ها (subrepositories)

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

                                                                     HG(FILES)