.\" Process this file with
.\" groff -man -Tascii vorbiscomment.1
.\"
.TH VORBISCOMMENT 1 "December 30, 2008" "Xiph.Org Foundation" "Ogg Vorbis Tools"

.SH "نام (NAME)"
vorbiscomment \- فهرست کردن یا ویرایش توضیحات در فایل‌های Ogg Vorbis

.SH "خلاصه دستور (SYNOPSIS)"
.B vorbiscomment
.B [-l]
.RB [ -R ]
.RB [ -e ]
.I file.ogg
.br
.B vorbiscomment
.B -a
.B [ -c commentfile | -t \*(lqname=value\*(rq | -d \*(lqname=value\*(rq ]
.RB [ -q ]
.RB [ -R ]
.RB [ -e ]
.I in.ogg
.I [out.ogg]
.br
.B vorbiscomment
.B -w
.B [ -c commentfile | -t \*(lqname=value\*(rq ]
.RB [ -q ]
.RB [ -R ]
.RB [ -e ]
.I in.ogg
.I [out.ogg]

.SH "توضیحات (DESCRIPTION)"
دستور
.B vorbiscomment
برچسب‌های فرادادهٔ فایل صوتی Ogg Vorbis را می‌خواند، تغییر می‌دهد و اضافه می‌کند.

.SH "گزینه‌ها (OPTIONS)"
.IP "-a, --append"
توضیحات را به‌روزرسانی (الحاق) می‌کند.
.IP "-c file, --commentfile file"
توضیحات را از یک فایل می‌گیرد. این فایل همان قالبی را دارد که توسط گزینهٔ \-l تولید می‌شود یا به گزینهٔ \-t داده می‌شود: در هر سطر یک مورد در قالب 'tag=value'. اگر فایل ‎/dev/null‎ باشد و \-w داده شده باشد، توضیحات موجود حذف خواهند شد.
.IP "-h, --help"
نمایش راهنمای دستور.
.IP "-l, --list"
فهرست کردن توضیحات موجود در فایل Ogg Vorbis.
.IP "-q, --quiet"
حالت بی‌صدا. هیچ پیامی نمایش داده نمی‌شود.
.IP "-t 'name=value', --tag 'name=value'"
مشخص کردن یک برچسب جدید در خط فرمان. هر برچسب به صورت یک رشتهٔ واحد ارائه می‌شود. بخش قبل از '=' به عنوان نام برچسب و بخش بعد از آن به عنوان مقدار در نظر گرفته می‌شود.
.IP "-d 'name[=value]', --rm 'name[=value]'"
مشخص کردن یک برچسب در خط فرمان برای حذف. هر برچسب به عنوان یک رشتهٔ واحد ارائه می‌شود. بخش قبل از '=' به عنوان نام برچسب و بخش بعد از آن به عنوان مقدار در نظر گرفته می‌شود. اگر مقداری داده نشود، تمام برچسب‌های دارای نام مشخص‌شده حذف می‌شوند. در غیر این صورت تنها مواردی که دارای مقدار منطبق هستند حذف خواهند شد.
.IP "-w, --write"
جایگزین کردن توضیحات با مجموعهٔ جدیدی که در خط فرمان با \-t یا از طریق یک فایل با \-c مشخص شده است. اگر هیچ‌یک از گزینه‌های \-c یا \-t مشخص نشوند، مجموعهٔ جدید از ورودی استاندارد خوانده خواهد شد.
.IP "-R, --raw"
خواندن و نوشتن توضیحات با کدگذاری UTF-8، به جای تبدیل به مجموعه نویسه‌های کاربر.
.IP "-e, --escapes"
گریزدهی/لغو گریزدهی خطوط جدید و بک‌اسلش‌ها در توضیحات. این کار تضمین می‌کند که هر توضیح در خروجی (یا ورودی) دقیقاً یک سطر باشد، که امکان فیلتر کردن و انتقال رفت‌وبرگشتی آن‌ها را فراهم می‌کند. بدون این گزینه، تنها با استفاده از \-t می‌توانید توضیحات چندسطری بنویسید و نمی‌توانید آن‌ها را با اطمینان از چند توضیح تک‌سطری تشخیص دهید.

توالی‌های گریز پشتیبانی‌شده به سبک زبان C عبارتند از "\en"، "\er"، "\e\e" و "\e0". قرار گرفتن یک بک‌اسلش قبل از هر چیز دیگری یک خطا محسوب می‌شود.

نکته: در حال حاضر، هنگام نوشتن، هر چیزی پس از اولین "\e0" دور ریخته می‌شود. این یک باگ است \- قالب Vorbis می‌تواند نویسه‌های null را به طور ایمن ذخیره کند، اما بیشتر ابزارهای دیگر به هر حال قادر به کار با آن‌ها نیستند.
.IP "-V, --version"
نمایش نسخهٔ vorbiscomment.

.\" Examples go here
.SH "مثال‌ها (EXAMPLES)"

برای صرفاً مشاهدهٔ برچسب‌های توضیح درون یک فایل:

    vorbiscomment -l file.ogg

برای ویرایش آن توضیحات:

    vorbiscomment -l file.ogg > file.txt
    [ویرایش توضیحات درون file.txt به شکل دلخواه]
    vorbiscomment -w -c file.txt file.ogg newfile.ogg

برای اضافه کردن سادهٔ یک توضیح:

    vorbiscomment -a -t 'ARTIST=No One You Know' file.ogg newfile.ogg

برای افزودن مجموعه‌ای از توضیحات از ورودی استاندارد:

    vorbiscomment -a file.ogg
    ARTIST=No One You Know
    ALBUM=The Famous Album
    <ctrl-d>

.SH "قالب برچسب (TAG FORMAT)"

برای مستندات مربوط به قالب برچسب‌های Ogg Vorbis، از جمله فهرستی پیشنهادی از نام‌های استاندارد برچسب‌ها، <https://xiph.org/vorbis/doc/v-comment.html> را ببینید.

.SH "نویسندگان (AUTHORS)"

.TP
نویسندگان برنامه:
.br
Michael Smith <msmith@xiph.org>
.br
Ralph Giles <giles@xiph.org>
.br

.TP
نویسنده صفحه راهنما:
.br
Christopher L Cheney <ccheney@debian.org>

.SH "همچنین ببینید (SEE ALSO)"

.PP
\fBoggenc\fR(1), \fBoggdec\fR(1), \fBogg123\fR(1), \fBogginfo\fR(1)