نام (NAME)

timew-annotate - افزودن یادداشت به بازه‌های زمانی

خلاصه دستور (SYNOPSIS)

timew annotate [<id>...] <annotation>

توضیحات (DESCRIPTION)

دستور 'annotate' برای افزودن یادداشت به یک بازه زمانی به کار می‌رود.

برای چگونگی نمایش <id> و <annotation> یک بازه، دستور 'summary' را ببینید.

مثال‌ها (EXAMPLES)

یادداشت‌گذاری یک بازه منفرد

دستور را با یک id و annotation فراخوانی کنید:

$ timew annotate @2 'Lorem ipsum'
Annotated @2 with "Lorem ipsum"

حذف یک یادداشت

یادداشت‌گذاری یک بازه با یک رشته خالی، یادداشت آن را حذف می‌کند:

$ timew annotate @1 ''
Removed annotation from @1

یادداشت‌گذاری چند بازه به طور همزمان

می‌توانید با مشخص کردن شناسه‌های بازه‌ها، چندین بازه را به طور هم‌زمان با یک annotation یکسان یادداشت‌گذاری کنید:

$ timew annotate @2 @10 @23 'Lorem ipsum'
Annotated @1 with "Lorem ipsum"
Annotated @10 with "Lorem ipsum"
Annotated @23 with "Lorem ipsum"

یادداشت‌گذاری بازه باز فعلی

اگر رهگیری زمان فعالی وجود داشته باشد، هنگام افزودن یادداشت به بازه باز فعلی می‌توانید شناسه (ID) را حذف کنید:

$ timew start foo
...
$ timew annotate bar
Annotated @1 with "bar"

این کار منجر می‌شود که بازه فعلی برچسب 'foo' و یادداشت 'bar' را داشته باشد.

باگ‌ها و محدودیت‌ها (BUGS & LIMITATIONS)

دستور summary یادداشت‌های طولانی‌تر از ۱۵ نویسه را کوتاه می‌کند. برای نمایش یادداشت‌های طولانی‌تر، می‌توان از دستور 'export' یا یک گزارش سفارشی استفاده کرد.

در حال حاضر، دستور annotation آخرین توکن را از خط فرمان برداشته و از آن به عنوان یادداشت استفاده می‌کند. یعنی عدم استفاده از نقل‌قول در دستوری مانند

$ timew annotate @1 lorem ipsum

منجر به این خواهد شد که بازه @1 تنها 'ipsum' را به عنوان یادداشت خود داشته باشد. برای جلوگیری از این مورد از نقل‌قول (کوتیشن) استفاده کنید.

همچنین ببینید (SEE ALSO)

timew-export(1), timew-summary(1), timew-tag(1)