.TH "cueprint" "1"
.SH "نام (NAME)"
cueprint \- گزارش اطلاعات دیسک و قطعه‌ها از یک فایل CUE یا TOC
.SH "خلاصه دستور (SYNOPSIS)"
.B cueprint
[ {
.B \-i
.I format
|
.BR \-\-input\-format =\fIformat\fP
} {
.B \-n
.I number
|
.BR \-\-track\-number =\fInumber\fP
} {
.B \-d
.I template
|
.BR \-\-disc\-template =\fItemplate\fP
} {
.B \-t
.I template
|
.BR \-\-track\-template =\fItemplate\fP
} ]
[
.I file
\&... ]
.br
.B cueprint \-h | \-\-help
.br
.B cueprint \-V | \-\-version
.SH "توضیحات (DESCRIPTION)"
دستور
.B cueprint
اطلاعات دیسک و قطعه‌ها را از فایل‌های CUE و TOC که معمولاً توسط نرم‌افزارهای استخراج دیسک فشرده (سی‌دی) ایجاد می‌شوند، گزارش می‌دهد.
.PP
به‌طور پیش‌فرض،
.B cueprint
مجموعه‌ای پیش‌فرض از اطلاعات دیسک و مجموعه‌ای پیش‌فرض از اطلاعات را برای هر قطعه روی دیسک گزارش می‌کند.
با استفاده از گزینه‌ها، می‌توان گزارش را به یک قطعه خاص محدود کرد و نحوه ارائه اطلاعات دیسک و قطعه را می‌توان با استفاده از رشته‌های قالب‌بندی به سبک
.BR printf (3)
(که در اینجا برای جلوگیری از سردرگمی با مفهوم قالب فایل، «الگو» یا \(oqtemplates\(cq نامیده می‌شوند) به طور گسترده سفارشی‌سازی کرد.
تمام نویسه‌ها در یک الگو بدون تغییر در خروجی بازتولید می‌شوند، به جز تبدیل‌ها (که با
.RB \(oq % \(cq
آغاز می‌شوند) و گریزها (که با
.RB \(oq \e \(cq
آغاز می‌شوند).
.PP
اگر هیچ نام فایلی مشخص نشده باشد،
.B cueprint
از ورودی استاندارد می‌خواند و گزینه قالب ورودی
.I حتماً
باید مشخص شود.
اگر یک یا چند نام فایل ارائه شده باشد، اما گزینه قالب ورودی مشخص نشده باشد، قالب ورودی بر اساس پسوند هر فایل (مثلاً
.I .cue
یا
.IR .toc )
حدس زده خواهد شد. این روش تشخیص به بزرگی و کوچکی حروف حساس نیست.
.SS "تبدیل‌ها (Conversions)"
یک تبدیل دارای ساختاری به صورت
.RB \(oq % [ \fIflags\fP ][ \fIwidth\fP ][ .\fIprecision\fP ] \fItype\fP \(cq
است.
.PP
مقدارهای
.I flags
می‌تواند صفر یا چند مورد از موارد زیر باشد:
.TS
nokeep;
l	l.
نویسه	معنی
_
\-	چپ‌چین کردن بسط
+	قرار دادن علامت قبل از اعداد
\(oq \(cq (space)	قرار دادن یک فاصله خالی قبل از اعداد مثبت
0	پر کردن اعداد با صفر
.TE
.\"#	(unused)
.PP
مقدار
.I width
حداقل عرض فیلد است.
.I precision
حداکثر عرض برای رشته‌ها است.
.I type
یک تک‌نویسه است که نوع تبدیل را مشخص می‌کند \(em به جز
.BR % ،
این تنها بخش اجباری تبدیل است.
.PP
انواع تبدیل موجود در جدول زیر آورده شده‌اند؛ انواع تبدیل دیسک در نیمه سمت چپ جدول، و انواع تبدیل قطعه در نیمه سمت راست ارائه شده‌اند.
نویسه‌های بسط الگوی دیسک، هم برای الگوهای دیسک و هم برای الگوهای قطعه معتبر هستند.
.TS
nokeep;
l	l	l	l.
نویسه	تبدیل	نویسه	تبدیل
_
A	تنظیم‌کننده آلبوم	a	تنظیم‌کننده قطعه
C	آهنگساز آلبوم	c	آهنگساز قطعه
G	سبک آلبوم	g	سبک قطعه
		i	کد ISRC قطعه
M	پیام آلبوم	m	پیام قطعه
N	تعداد قطعه‌ها	n	شماره قطعه
P	اجراکننده آلبوم	p	اجراکننده قطعه
S	ترانه‌سرای آلبوم
T	عنوان آلبوم	t	عنوان قطعه
U	کد UPC/EAN آلبوم	u	کد ISRC قطعه (CD-TEXT)
.TE
.PP
هر نویسه دیگری که به عنوان نوع تبدیل استفاده شود، به خود بسط می‌یابد.
به این ترتیب است که می‌توان علامت درصد واقعی را در الگو قرار داد؛ یعنی
.RB \(oq %% \(cq
به
.RB \(oq % \(cq
بسط می‌یابد.
.SS "گریزها (Escapes)"
نویسه‌های گریز شناخته‌شده همگی تک‌نویسه هستند و در جدول زیر فهرست شده‌اند.
.TS
nokeep;
l	l.
توالی گریز	بسط
_
\ea	هشدار (bell)
\eb	پس‌بر (backspace)
\ef	تغذیه صفحه (formfeed)
\en	خط جدید (newline)
\er	بازگشت به ابتدای سطر (carriage return)
\et	تب افقی (horizontal tab)
\ev	تب عمودی (vertical tab)
\e0	تهی (null)
.TE
.PP
هر نویسه دیگری که پس از
.RB \(oq \e \(cq
در یک توالی گریز استفاده شود به خود بسط می‌یابد.
به این ترتیب است که می‌توان نویسه گریز (بک‌اسلش) واقعی را در الگو قرار داد؛ یعنی
.RB \(oq \e\e \(cq
به
.RB \(oq \e \(cq
بسط می‌یابد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-d " \fItemplate\fP, " \-\-disc\-template=\fItemplate\fP
الگوی دیسک را تعیین می‌کند (بخش
.B تبدیل‌ها (Conversions)
را ببینید).
.TP
.BR \-h ", " \-\-help
پیام راهنمای استفاده را نمایش می‌دهد و خارج می‌شود.
.TP
.BR \-i " \fIformat\fP, " \-\-input\-format=\fIformat\fP
قالب مورد انتظار فایل(های) ورودی را روی
.I format
تنظیم می‌کند، که باید یا
.B cue
یا
.B toc
باشد.
.TP
.BR \-n " \fInumber\fP, " \-\-track\-number=\fInumber\fP
تنها اطلاعات مربوط به یک قطعه را چاپ می‌کند.
حالت پیش‌فرض چاپ اطلاعات همه قطعه‌ها است.
.TP
.BR \-t " \fItemplate\fP, " \-\-track\-template=\fItemplate\fP
الگوی قطعه را تعیین می‌کند (بخش
.B تبدیل‌ها (Conversions)
را ببینید).
.TP
.B \-V ", " \-\-version
اطلاعات نسخه را نمایش می‌دهد و خارج می‌شود.
.SH "وضعیت خروج (EXIT STATUS)"
دستور
.B cueprint
اگر اطلاعات را با موفقیت از هر فایل ورودی گزارش کند با وضعیت خروج صفر، و در صورت بروز مشکل با وضعیتی غیرصفر خارج می‌شود.
.SH "مثال‌ها (EXAMPLES)"
برای نمایش اطلاعات دیسک و قطعه‌ها (با استفاده از الگوی پیش‌فرض برای هر دو):
.PP
.RB "% " "cueprint album.cue"
.PP
برای چاپ تعداد قطعه‌ها در یک فایل CUE:
.PP
.RB "% " "cueprint -d \(aq%N\en\(aq album.cue"
.SH "نویسندگان (AUTHORS)"
مجموعه Cuetools توسط Svend Sorensen نوشته شده است.
Branden Robinson در اصلاحات و بهبودهای ابزارها و مستندات مشارکت داشته است.
.SH "همچنین ببینید (SEE ALSO)"
.BR cuebreakpoints (1),
.BR cueconvert (1),
.BR printf (3)