.TH git-annex-smudge 1
.SH "نام (NAME)"
git-annex-smudge \- درایور فیلتر گیت برای git-annex
.PP
.SH "خلاصه دستور (SYNOPSIS)"
git annex smudge [\-\-clean] file
.PP
git annex smudge \-\-update
.PP
.SH "توضیحات (DESCRIPTION)"
این دستور امکان استفاده از git-annex را به عنوان یک درایور فیلتر گیت فراهم می‌کند که اجازه می‌دهد فایل‌های ضمیمه‌شده در مخزن گیت به جای پیوندهای نمادین، در حالت قفل‌گشایی‌شده باشند و همچنین دستور \fBgit add\fP فایل‌ها را در ضمیمه ذخیره نماید.
.PP
هنگام افزودن یک فایل با \fBgit add\fP، پیکربندی annex.largefiles بررسی می‌شود تا تصمیم‌گیری شود آیا فایل مورد نظر باید به همان شکلی که هست به گیت افزوده شود یا محتوای آن به اندازه کافی بزرگ است که نیاز به استفاده از git-annex داشته باشد. تنظیمات annex.gitaddtoannex بر این مورد اولویت دارد؛ تنظیم آن روی false مانع از اضافه شدن فایل‌ها به ضمیمه توسط \fBgit add\fP می‌شود.
.PP
با این حال، اگر git-annex تشخیص دهد فایلی قبلاً به ضمیمه افزوده شده بوده است، حتی اگر آن تنظیمات در حالت معمول مانع شوند، فایل همچنان به ضمیمه اضافه خواهد شد. دو نمونه از این موارد عبارتند از افزودن نسخه تغییریافته یک فایل ضمیمه‌شده، و انتقال یک فایل ضمیمه‌شده به نام فایلی جدید و سپس افزودن آن.
.PP
پیکربندی گیت برای استفاده از این دستور به عنوان یک درایور فیلتر به شرح زیر است. این پیکربندی معمولاً توسط git-annex init انجام می‌شود، بنابراین نیازی به پیکربندی دستی آن ندارید.
.PP
.nf
 [filter "annex"]
         smudge = git-annex smudge %f
         clean = git-annex smudge \-\-clean %f
.fi
.PP
برای اینکه گیت از این درایور فیلتر استفاده کند، لازم است در فایل \fB.gitattributes\fP یا در \fB.git/info/attributes\fP پیکربندی شود. دومی معمولاً هنگام مقداردهی اولیه یک مخزن با محتوای زیر تنظیم می‌شود:
.PP
.nf
 * filter=annex
.fi
.PP
فیلتر smudge محتوای فایل‌های ضمیمه‌شده را به گیت ارائه نمی‌دهد، زیرا این کار بسیار کُند بوده و باعث نشت حافظه در گیت می‌شود. در عوض، مشخص می‌کند که کدام فایل‌های درخت کاری (worktree) باید به‌روزرسانی شوند و سپس دستور \fBgit annex smudge \-\-update\fP درخت کاری را به‌روز می‌کند تا حاوی محتوا شود. این عمل توسط چندین قلاب گیت از جمله post\-checkout و post\-merge اجرا می‌شود. با این حال، چند دستور گیت به‌ویژه \fBgit stash\fP و \fBgit cherry\-pick\fP هیچ قلابی را اجرا نمی‌کنند؛ بنابراین پس از استفاده از این دستورات می‌توانید به‌صورت دستی \fBgit annex smudge \-\-update\fP را جهت به‌روزرسانی درخت کاری اجرا کنید.
.PP
.SH "گزینه‌ها (OPTIONS)"
.IP "همچنین می‌توان از گزینه‌های \fBgit-annex\-common\-options\fP(1) نیز استفاده کرد."
.IP
.SH "همچنین ببینید (SEE ALSO)"
git-annex(1)
.PP
git-annex\-filter\-process(1)
.PP
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>
.PP