.TH git-annex-find 1
.SH "نام (NAME)"
git-annex-find \- فهرست کردن فایل‌های در دسترس
.PP
.SH "خلاصه دستور (SYNOPSIS)"
git annex find \fB[path ...]\fP
.PP
.SH "توضیحات (DESCRIPTION)"
فهرستی از فایل‌های ضمیمه‌شده (annexed) در مسیر مشخص‌شده را در خروجی نمایش می‌دهد. در صورت مشخص نکردن مسیر، فایل‌ها را در دایرکتوری جاری و زیردایرکتوری‌های آن پیدا می‌کند.
.PP
.SH "گزینه‌ها (OPTIONS)"
.IP "گزینه‌های تطبیق (matching options)"
.IP
می‌توان از
.BR git-annex\-matching\-options (1)
برای مشخص کردن فایل‌هایی که باید فهرست شوند استفاده کرد.
.IP
به‌طور پیش‌فرض، دستور find تنها فایل‌های ضمیمه‌شده‌ای را فهرست می‌کند که محتوای آن‌ها در حال حاضر موجود است. مشخص کردن هر یک از گزینه‌های تطبیق، این رفتار پیش‌فرض را لغو می‌کند.
.IP
برای فهرست کردن تمام فایل‌های ضمیمه‌شده، چه موجود باشند و چه نباشند، گزینه
.B \-\-anything
را مشخص کنید.
.IP
برای فهرست کردن فایل‌های ضمیمه‌شده‌ای که محتوای آن‌ها موجود نیست،
.B \-\-not \-\-in=here
را مشخص کنید.
.IP
.IP "\fB\-\-branch=ref\fP"
فهرست کردن فایل‌ها در شاخه (branch) یا treeish مشخص‌شده.
.IP
.IP "\fB\-\-print0\fP"
خروجی دادن نام فایل‌های خاتمه‌یافته با نویسه تهی (null)، جهت استفاده با
.BR xargs \ \-0
.IP
.IP "\fB\-\-format=value\fP"
استفاده از قالب‌بندی خروجی سفارشی.
.IP
مقدار مشخص‌شده یک رشته قالب است که در آن
.B ${var}
به مقدار متغیر بسط داده می‌شود. برای راست‌چین کردن متغیر با فاصله‌های خالی، از
.B ${var;width}
استفاده کنید؛ برای چپ‌چین کردن متغیر، از
.B ${var;\-width}
استفاده کنید؛ برای گریز دادن (اسکیپ کردن) نویسه‌های نامتعارف (شامل نویسه‌های کنترلی) در یک متغیر، از
.B ${escaped_var}
استفاده نمایید.
.IP
این متغیرها برای استفاده در قالب‌ها در دسترس هستند:
.BR file ،
.BR key ،
.BR backend ،
.BR bytesize ،
.BR humansize ،
.BR keyname ،
.BR hashdirlower ،
.BR hashdirmixed ،
.B mtime
(برای فیلد mtime از یک کلید WORM).
.IP
همچنین،
.B '\en'
خط جدید،
.B '\e000'
نویسه تهی (NULL) و غیره است.
.IP
قالب خروجی پیش‌فرض مشابه با
.B \-\-format='${file}\en'
است، به جز زمانی که خروجی به ترمینال ارسال می‌شود که در آن صورت نویسه‌های کنترلی اسکیپ خواهند شد.
.IP
.IP "\fB\-\-json\fP"
خروجی دادن فهرست فایل‌ها در قالب JSON.
.IP
این گزینه برای تجزیه خروجی توسط برنامه‌هایی که از git-annex استفاده می‌کنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است.
.IP
.IP "\fB\-\-json\-error\-messages\fP"
پیام‌هایی که در حالت عادی در خروجی خطای استاندارد نمایش داده می‌شدند، در عوض درون JSON قرار می‌گیرند.
.IP
.IP "\fB\-\-batch\fP"
حالت دسته‌ای (batch mode) را فعال می‌کند، که در آن یک فایل در یک خط از ورودی استاندارد (stdin) خوانده می‌شود، اطلاعات آن نمایش می‌یابد و این روند تکرار می‌شود.
.IP
توجه داشته باشید که اگر فایل مورد نظر یک فایل ضمیمه‌شده نباشد، یا موجود نباشد، یا به هر نحو دیگری با گزینه‌های تطبیق همخوانی نداشته باشد، به جای آن یک خط خالی در خروجی چاپ خواهد شد.
.IP
.IP "\fB\-z\fP"
باعث می‌شود ورودی
.B \-\-batch
به جای خطوط جدید معمول، با نویسه‌های تهی (null) از هم جدا شوند.
.IP
.IP
همچنین می‌توان از
.BR git-annex\-common\-options (1)
استفاده کرد.
.SH "همچنین ببینید (SEE ALSO)"
.BR git-annex (1)
.PP
.BR git-annex\-whereis (1)
.PP
.BR git-annex\-findkeys (1)
.PP
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>
.PP