'\" t
.\"     Title: timew-annotate
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2025-04-26
.\"    Manual: User Manuals
.\"    Source: timew 1.9.1
.\"  Language: English
.\"
.TH "TIMEW\-ANNOTATE" "1" "2025-04-26" "timew 1.9.1" "User Manuals"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
timew-annotate \- افزودن یادداشت به بازه‌های زمانی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBtimew annotate\fP [\fI<id>\fP\fB...\fP] \fI<annotation>\fP
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \*(Aqannotate\*(Aq برای افزودن یادداشت به یک بازه زمانی به کار می‌رود.
.sp
برای چگونگی نمایش \fI<id>\fP و \fI<annotation>\fP یک بازه، دستور \*(Aqsummary\*(Aq را ببینید.
.SH "مثال‌ها (EXAMPLES)"
.sp
\fBیادداشت‌گذاری یک بازه منفرد\fP
.RS 4
.sp
دستور را با یک \fIid\fP و \fIannotation\fP فراخوانی کنید:
.sp
.if n .RS 4
.nf
.fam C
$ timew annotate @2 \*(AqLorem ipsum\*(Aq
Annotated @2 with "Lorem ipsum"
.fam
.fi
.if n .RE
.RE
.sp
\fBحذف یک یادداشت\fP
.RS 4
.sp
یادداشت‌گذاری یک بازه با یک رشته خالی، یادداشت آن را حذف می‌کند:
.sp
.if n .RS 4
.nf
.fam C
$ timew annotate @1 \*(Aq\*(Aq
Removed annotation from @1
.fam
.fi
.if n .RE
.RE
.sp
\fBیادداشت‌گذاری چند بازه به طور همزمان\fP
.RS 4
.sp
می‌توانید با مشخص کردن شناسه‌های بازه‌ها، چندین بازه را به طور هم‌زمان با یک \fIannotation\fP یکسان یادداشت‌گذاری کنید:
.sp
.if n .RS 4
.nf
.fam C
$ timew annotate @2 @10 @23 \*(AqLorem ipsum\*(Aq
Annotated @1 with "Lorem ipsum"
Annotated @10 with "Lorem ipsum"
Annotated @23 with "Lorem ipsum"
.fam
.fi
.if n .RE
.RE
.sp
\fBیادداشت‌گذاری بازه باز فعلی\fP
.RS 4
.sp
اگر رهگیری زمان فعالی وجود داشته باشد، هنگام افزودن یادداشت به بازه باز فعلی می‌توانید شناسه (ID) را حذف کنید:
.sp
.if n .RS 4
.nf
.fam C
$ timew start foo
\&...
$ timew annotate bar
Annotated @1 with "bar"
.fam
.fi
.if n .RE
.sp
این کار منجر می‌شود که بازه فعلی برچسب \*(Aqfoo\*(Aq و یادداشت \*(Aqbar\*(Aq را داشته باشد.
.RE
.SH "باگ‌ها و محدودیت‌ها (BUGS & LIMITATIONS)"
.sp
دستور summary یادداشت‌های طولانی‌تر از ۱۵ نویسه را کوتاه می‌کند.
برای نمایش یادداشت‌های طولانی‌تر، می‌توان از دستور \*(Aqexport\*(Aq یا یک گزارش سفارشی استفاده کرد.
.sp
در حال حاضر، دستور annotation آخرین توکن را از خط فرمان برداشته و از آن به عنوان یادداشت استفاده می‌کند.
یعنی عدم استفاده از نقل‌قول در دستوری مانند
.sp
.if n .RS 4
.nf
.fam C
$ timew annotate @1 lorem ipsum
.fam
.fi
.if n .RE
.sp
منجر به این خواهد شد که بازه @1 تنها \*(Aqipsum\*(Aq را به عنوان یادداشت خود داشته باشد.
برای جلوگیری از این مورد از نقل‌قول (کوتیشن) استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBtimew\-export\fP(1),
\fBtimew\-summary\fP(1),
\fBtimew\-tag\fP(1)