.TH git-annex-matchexpression 1
.SH "نام (NAME)"
git-annex-matchexpression \- بررسی مطابقت یک عبارت با داده‌ها
.PP
.SH "خلاصه دستور (SYNOPSIS)"
git annex matchexpression \fBexpression [data]\fP
.PP
.SH "توضیحات (DESCRIPTION)"
این دستور سطح پایین (plumbing)، یک عبارت محتوای ترجیحی (preferred content expression)
و مقداری داده دریافت می‌کند و بررسی می‌کند که آیا عبارت با آن داده‌ها مطابقت دارد یا خیر.
اگر مطابقت داشته باشد با کد ۰ و در غیر این صورت با ۱ خارج می‌شود. چنانچه داده‌های کافی ارائه
نشده باشد، خطایی نمایش داده و با کد خطای ویژهٔ ۴۲ خارج می‌شود.
.PP
برای نمونه، دستور زیر با کد ۰ خارج خواهد شد:
.PP
.EX
git annex matchexpression "include=*.png and largerthan=1mb" \-\-file=foo.png \-\-size=10mb
.EE
.PP
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-\-file=\fP"
.IP
نام فایلی را که باید تطابق با آن سنجیده شود مشخص می‌کند. توجه داشته باشید که نیازی
نیست این فایل واقعاً روی دیسک وجود داشته باشد.
.IP
.IP "\fB\-\-size=\fP"
اندازهٔ فایل را مشخص می‌کند. اندازه را می‌توان با هر یک از واحدهای متداول مانند
«0.5 gb» یا «100 KiloBytes» مشخص کرد.
.IP
.IP "\fB\-\-key=\fP"
کلیدی را که باید مورد بررسی قرار گیرد مشخص می‌کند. این گزینه برای عبارت‌های تطبیقی مانند
«copies=N»، «metadata=tag=foo» و «present» که همگی نیازمند بررسی اطلاعات ثبت‌شده برای یک کلید هستند، لازم است.
.IP
بسیاری از کلیدها اندازهٔ مشخصی دارند، بنابراین هنگام تعیین چنین کلیدی نیازی به
.B \-\-size
نیست.
.IP
.IP "\fB\-\-largefiles\fP"
عبارت را به جای یک عبارت محتوای ترجیحی، به عنوان یک عبارت annex.largefiles تحلیل و پردازش می‌کند.
.IP
.IP "\fB\-\-mimetype=\fP"
نوع MIME فایل را مشخص می‌کند. فقط هنگام استفاده از
.B \-\-largefiles
همراه با عبارت mimetype= مورد نیاز است.
.IP
.IP "\fB\-\-mimeencoding=\fP"
کدگذاری MIME فایل را مشخص می‌کند. فقط هنگام استفاده از
.B \-\-largefiles
همراه با عبارت mimeencoding= مورد نیاز است.
.IP
.IP "\fB\-\-explain\fP"
توضیحی دربارهٔ اینکه کدام بخش‌های عبارت محتوای ترجیحی همخوانی دارند و کدام بخش‌ها مطابقت ندارند نمایش می‌دهد.
.IP
همچنین می‌توان از گزینه‌های
.BR git-annex\-common\-options (1)
استفاده کرد.
.SH "همچنین ببینید (SEE ALSO)"
.BR git-annex (1)
.PP
.BR git-annex\-preferred\-content (1)
.PP
.BR git-annex\-matching\-expression (1)
.PP
.BR git-annex\-sim (1)
.PP
.SH "نویسندگان (AUTHORS)"
Joey Hess <id@joeyh.name>