.TH git-annex-log 1
.SH "نام (NAME)"
git-annex-log \- نمایش گزارش تاریخچه تغییرات موقعیت و مکان فایل‌ها
.PP
.SH "خلاصه دستور (SYNOPSIS)"
git annex log \fB[path ...]\fP
.PP
.SH "توضیحات (DESCRIPTION)"
این دستور اطلاعاتی را از تاریخچه شاخه git-annex نمایش می‌دهد.
.PP
چندین مورد می‌تواند مانع از در دسترس بودن این اطلاعات برای نمایش شود.
هنگامی که از
.B git-annex\-forget
استفاده می‌شود، داده‌های تاریخی قدیمی از شاخه پاک می‌شوند. هنگامی که
.B annex.private
یا
.B remote.name.annex\-private
پیکربندی شده باشد،
.B git-annex
اصلاً هیچ اطلاعاتی در شاخه ثبت نمی‌کند. و هنگامی که
.B annex.alwayscommit
بر روی
.B false
تنظیم شده باشد، ممکن است اطلاعات هنوز در شاخه کامیت نشده باشند.
.PP
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB[path ...]\fP"
.IP
گزارش موقعیت مکانی فایل یا فایل‌های مشخص‌شده را نمایش می‌دهد و هر مخزنی را که این فایل‌ها به آن اضافه شده‌اند («+») و از آن حذف شده‌اند («\-») نشان می‌دهد. توجه داشته باشید که این گزینه اطلاعات مربوط به محتوای فایلی را که در حال حاضر در این مسیرها قرار دارد نمایش می‌دهد، نه هرگونه محتوای متفاوتی را که در کامیت‌های قبلی در آنجا وجود داشته است.
.IP
.IP "matching options"
می‌توان از
.BR git-annex\-matching\-options (1)
برای کنترل مواردی که هنگام نمایش گزارش موقعیت مکانی برای فایل‌های مشخص‌شده روی آن‌ها اقدام می‌شود، استفاده کرد.
.IP
.IP "\fB\-\-all\fP \fB\-A\fP"
تغییرات گزارش موقعیت مکانی را برای تمام محتواها نشان می‌دهد، به‌طوری که جدیدترین تغییرات در ابتدا نمایش داده می‌شوند. در این حالت، نام فایل‌ها در دسترس نیست و در عوض کلیدها نمایش داده می‌شوند.
.IP
.IP "\fB\-\-key=keyname\fP"
گزارش موقعیت مکانی را برای کلید مشخص‌شده نمایش می‌دهد.
.IP
.IP "\fB\-\-branch=ref\fP"
گزارش موقعیت مکانی فایل‌ها را در شاخه یا شیء درختی (treeish) مشخص‌شده نمایش می‌دهد.
.IP
.IP "\fB\-\-unused\fP"
گزارش موقعیت مکانی فایل‌های یافت‌شده در آخرین اجرای
.B git-annex unused
را نمایش می‌دهد.
.IP
.IP "\fB\-\-sizesof=repository\fP"
تاریخچه‌ای از اندازه کل فایل‌های پیوست‌شده (annexed) در یک مخزن را در طول زمان، از زمان ایجاد مخزن تا زمان حال نمایش می‌دهد.
.IP
مخزن می‌تواند
.B "here"
برای مخزن جاری، یا نام یک مخزن دوردست (remote)، یا توضیحات مخزن یا uuid باشد.
.IP
توجه داشته باشید کلیدهایی که اندازه مشخصی ندارند، در این مجموع محاسبه نمی‌شوند.
.IP
.IP "\fB\-\-sizes\fP"
این گزینه شبیه به
.B \-\-sizesof
است، اما به جای نمایش اندازه یک مخزن منفرد، اندازه تمام مخازن شناخته‌شده را نمایش می‌دهد.
.IP
خروجی این دستور، یک جدول با قالب‌بندی CSV است.
.IP
.IP "\fB\-\-totalsizes\fP"
این گزینه شبیه به
.B \-\-sizesof
است، اما مجموع اندازه تمام مخازن شناخته‌شده را نمایش می‌دهد.
.IP
.IP "\fB\-\-interval=time\fP"
هنگام استفاده از
.BR \-\-sizesof ،
.B \-\-sizes
و
.BR \-\-totalsizes ،
این گزینه حداقل فاصله زمانی بین نمایش‌های اندازه را کنترل می‌کند. حالت پیش‌فرض نمایش هر اندازه ثبت‌شده جدید است.
.IP
زمان به شکل
.B "30d"
یا
.B "1y"
است.
.IP
.IP "\fB\-\-received\fP"
ترکیب این گزینه با
.B \-\-sizesof
یا
.B \-\-sizes
میزان داده‌های دریافت شده در مخازن از زمان چاپ آخرین خط خروجی را نمایش می‌دهد.
.IP
.IP "\fB\-\-gnuplot\fP"
این گزینه را با
.BR \-\-sizesof ،
.B \-\-sizes
یا
.B \-\-totalsizes
ترکیب کنید تا با استفاده از
.BR gnuplot (1)
داده‌ها به صورت نمودار رسم شوند. فایل gnuplot برای استفاده مجدد شما بر روی دیسک باقی خواهد ماند.
.IP
برای مثال، جهت رسم نمودار اندازه تمام مخازن:
.IP
git-annex log \-\-sizes \-\-interval=1d \-\-gnuplot
.IP
برای رسم نمودار میزان داده‌های جدید دریافت‌شده در هر مخزن در هر ۳۰ روز:
.IP
git-annex log \-\-sizes \-\-interval=30d \-\-gnuplot \-\-recieved
.IP
.IP "\fB\-\-bytes\fP"
نمایش اندازه‌ها بر حسب بایت، و غیرفعال کردن واحدهای خواناتر پیش‌فرض.
.IP
.IP "\fB\-\-raw\-date\fP"
به جای نمایش معمول تاریخ در منطقه زمانی محلی، ثانیه‌های سپری‌شده از مبدأ یونیکس (unix epoch) را نمایش می‌دهد.
.IP
.IP "\fB\-\-since=date\fP, \fB\-\-after=date\fP, \fB\-\-until=date\fP, \fB\-\-before=date\fP, \fB\-\-max\-count=N\fP"
این گزینه‌ها به
.B git log
ارسال می‌شوند و می‌توانند برای محدود کردن میزان بازگشت به گذشته در جستجوی تغییرات گزارش موقعیت مکانی استفاده شوند.
.IP
برای مثال:
\fB\-\-since "1 month ago"\fP
.IP
این گزینه‌ها هنگام استفاده از
.BR \-\-sizesof ،
.B \-\-sizes
و
.B \-\-totalsizes
تأثیری ندارند.
.IP
.IP "\fB\-\-gource\fP"
خروجی مناسبی برای برنامه مصورسازی
.B gource
تولید می‌کند.
.IP
این گزینه هنگام استفاده از
.BR \-\-sizesof ،
.B \-\-sizes
و
.B \-\-totalsizes
تأثیری ندارد.
.IP
.IP "\fB\-\-json\fP"
فعال کردن خروجی JSON. این گزینه برای تجزیه و پردازش توسط برنامه‌هایی که از
.B git-annex
استفاده می‌کنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است.
.IP
این گزینه هنگام استفاده از
.BR \-\-sizesof ،
.B \-\-sizes
و
.B \-\-totalsizes
تأثیری ندارد.
.IP
.IP "\fB\-\-json\-error\-messages\fP"
پیام‌هایی که به‌طور معمول در خروجی خطای استاندارد قرار می‌گیرند، در عوض در داخل JSON گنجانده می‌شوند.
.IP
این گزینه هنگام استفاده از
.BR \-\-sizesof ،
.B \-\-sizes
و
.B \-\-totalsizes
تأثیری ندارد.
.IP
.IP "همچنین می‌توان از گزینه‌های \fBgit-annex\-common\-options\fP(1) نیز استفاده کرد."
.SH "همچنین ببینید (SEE ALSO)"
git-annex(1)
.PP
git-annex\-forget(1)
.PP
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>
.PP