git-annex-log(1)            General Commands Manual           git-annex-log(1)

نام (NAME)
       git-annex-log - نمایش گزارش تاریخچه تغییرات موقعیت و مکان فایل‌ها

خلاصه دستور (SYNOPSIS)
       git annex log [path ...]

توضیحات (DESCRIPTION)
       این دستور اطلاعاتی را از تاریخچه شاخه git-annex نمایش می‌دهد.

       چندین مورد می‌تواند مانع از در دسترس بودن این اطلاعات برای نمایش شود.
       هنگامی که از git-annex-forget استفاده می‌شود، داده‌های تاریخی قدیمی از
       شاخه پاک می‌شوند. هنگامی که annex.private یا remote.name.annex-private
       پیکربندی شده باشد، git-annex اصلاً هیچ اطلاعاتی در شاخه ثبت نمی‌کند. و
       هنگامی که annex.alwayscommit بر روی false تنظیم شده باشد، ممکن است
       اطلاعات هنوز در شاخه کامیت نشده باشند.

گزینه‌ها (OPTIONS)
       [path ...]

              گزارش موقعیت مکانی فایل یا فایل‌های مشخص‌شده را نمایش می‌دهد و هر
              مخزنی را که این فایل‌ها به آن اضافه شده‌اند («+») و از آن حذف
              شده‌اند («-») نشان می‌دهد. توجه داشته باشید که این گزینه اطلاعات
              مربوط به محتوای فایلی را که در حال حاضر در این مسیرها قرار دارد
              نمایش می‌دهد، نه هرگونه محتوای متفاوتی را که در کامیت‌های قبلی در
              آنجا وجود داشته است.

       matching options
              می‌توان از git-annex-matching-options(1) برای کنترل مواردی که
              هنگام نمایش گزارش موقعیت مکانی برای فایل‌های مشخص‌شده روی آن‌ها
              اقدام می‌شود، استفاده کرد.

       --all -A
              تغییرات گزارش موقعیت مکانی را برای تمام محتواها نشان می‌دهد،
              به‌طوری که جدیدترین تغییرات در ابتدا نمایش داده می‌شوند. در این
              حالت، نام فایل‌ها در دسترس نیست و در عوض کلیدها نمایش داده
              می‌شوند.

       --key=keyname
              گزارش موقعیت مکانی را برای کلید مشخص‌شده نمایش می‌دهد.

       --branch=ref
              گزارش موقعیت مکانی فایل‌ها را در شاخه یا شیء درختی (treeish)
              مشخص‌شده نمایش می‌دهد.

       --unused
              گزارش موقعیت مکانی فایل‌های یافت‌شده در آخرین اجرای git-annex
              unused را نمایش می‌دهد.

       --sizesof=repository
              تاریخچه‌ای از اندازه کل فایل‌های پیوست‌شده (annexed) در یک مخزن را
              در طول زمان، از زمان ایجاد مخزن تا زمان حال نمایش می‌دهد.

              مخزن می‌تواند here برای مخزن جاری، یا نام یک مخزن دوردست
              (remote)، یا توضیحات مخزن یا uuid باشد.

              توجه داشته باشید کلیدهایی که اندازه مشخصی ندارند، در این مجموع
              محاسبه نمی‌شوند.

       --sizes
              این گزینه شبیه به --sizesof است، اما به جای نمایش اندازه یک مخزن
              منفرد، اندازه تمام مخازن شناخته‌شده را نمایش می‌دهد.

              خروجی این دستور، یک جدول با قالب‌بندی CSV است.

       --totalsizes
              این گزینه شبیه به --sizesof است، اما مجموع اندازه تمام مخازن
              شناخته‌شده را نمایش می‌دهد.

       --interval=time
              هنگام استفاده از --sizesof، --sizes و --totalsizes، این گزینه
              حداقل فاصله زمانی بین نمایش‌های اندازه را کنترل می‌کند. حالت
              پیش‌فرض نمایش هر اندازه ثبت‌شده جدید است.

              زمان به شکل 30d یا 1y است.

       --received
              ترکیب این گزینه با --sizesof یا --sizes میزان داده‌های دریافت شده
              در مخازن از زمان چاپ آخرین خط خروجی را نمایش می‌دهد.

       --gnuplot
              این گزینه را با --sizesof، --sizes یا --totalsizes ترکیب کنید تا
              با استفاده از gnuplot(1) داده‌ها به صورت نمودار رسم شوند. فایل
              gnuplot برای استفاده مجدد شما بر روی دیسک باقی خواهد ماند.

              برای مثال، جهت رسم نمودار اندازه تمام مخازن:

              git-annex log --sizes --interval=1d --gnuplot

              برای رسم نمودار میزان داده‌های جدید دریافت‌شده در هر مخزن در هر ۳۰
              روز:

              git-annex log --sizes --interval=30d --gnuplot --recieved

       --bytes
              نمایش اندازه‌ها بر حسب بایت، و غیرفعال کردن واحدهای خواناتر
              پیش‌فرض.

       --raw-date
              به جای نمایش معمول تاریخ در منطقه زمانی محلی، ثانیه‌های سپری‌شده
              از مبدأ یونیکس (unix epoch) را نمایش می‌دهد.

       --since=date, --after=date, --until=date, --before=date, --max-count=N
              این گزینه‌ها به git log ارسال می‌شوند و می‌توانند برای محدود کردن
              میزان بازگشت به گذشته در جستجوی تغییرات گزارش موقعیت مکانی
              استفاده شوند.

              برای مثال: --since "1 month ago"

              این گزینه‌ها هنگام استفاده از --sizesof، --sizes و --totalsizes
              تأثیری ندارند.

       --gource
              خروجی مناسبی برای برنامه مصورسازی gource تولید می‌کند.

              این گزینه هنگام استفاده از --sizesof، --sizes و --totalsizes
              تأثیری ندارد.

       --json فعال کردن خروجی JSON. این گزینه برای تجزیه و پردازش توسط
              برنامه‌هایی که از git-annex استفاده می‌کنند در نظر گرفته شده است.
              هر خط از خروجی یک شیء JSON است.

              این گزینه هنگام استفاده از --sizesof، --sizes و --totalsizes
              تأثیری ندارد.

       --json-error-messages
              پیام‌هایی که به‌طور معمول در خروجی خطای استاندارد قرار می‌گیرند، در
              عوض در داخل JSON گنجانده می‌شوند.

              این گزینه هنگام استفاده از --sizesof، --sizes و --totalsizes
              تأثیری ندارد.

       همچنین می‌توان از گزینه‌های git-annex-common-options(1) نیز استفاده کرد.

همچنین ببینید (SEE ALSO)
       git-annex(1)

       git-annex-forget(1)

نویسنده (AUTHOR)
       Joey Hess <id@joeyh.name>

                                                              git-annex-log(1)