.\" Hey, Emacs! This is -*-nroff-*- you know...
.\"
.\" icupkg.8: manual page for the icupkg utility
.\"
.\" Copyright (C) 2016 and later: Unicode, Inc. and others.
.\" License & terms of use: http://www.unicode.org/copyright.html
.\" Copyright (C) 2000-2006 IBM, Inc. and others.
.\"
.TH ICUPKG 8 "18 August 2006" "ICU MANPAGE" "ICU 78.3 Manual"
.SH "نام (NAME)"
icupkg \- مدیریت و استخراج بسته‌های داده‌ای باینری ICU
.SH "خلاصه دستور (SYNOPSIS)"
.B icupkg
[
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
]
[
.BR "\-tl\fP, \fB\-\-type" " l"
|
.BR "\-tb\fP, \fB\-\-type" " b"
|
.BR "\-te\fP, \fB\-\-type" " e"
]
[
.BR "\-c\fP, \fB\-\-copyright"
|
.BI "\-C\fP, \fB\-\-comment" " comment"
]
[
.BI "\-a\fP, \fB\-\-add" " list"
]
[
.BI "\-r\fP, \fB\-\-remove" " list"
]
[
.BI "\-x\fP, \fB\-\-extract" " list"
]
[
.BI "\-l\fP, \fB\-\-list"
]
[
.BI "\-s\fP, \fB\-\-sourcedir" " source"
]
[
.BI "\-d\fP, \fB\-\-destdir" " destination"
]
[
.BI "\-w\fP, \fB\-\-writepkg"
]
[
.BI "\-m\fP, \fB\-\-matchmode" " mode"
]
.IR infilename
[
.BI "outfilename"
]
.SH "توضیحات (DESCRIPTION)"
دستور
.B icupkg
پرونده بسته
.B .dat
ورودی ICU را می‌خواند، آن را مطابق با گزینه‌ها تغییر می‌دهد، مشخصات آن را به ویژگی‌های بستر مورد نظر (مجموعه‌نویسه و ترتیب بایت‌ها یا endianness) تبدیل (swap) می‌کند، و در صورت تمایل، بسته
.B .dat
حاصل از ICU را در پرونده خروجی می‌نویسد.
آیتم‌ها ابتدا حذف، سپس اضافه، و در نهایت استخراج و فهرست می‌شوند.
یک بسته
.B .dat
مربوط به ICU در صورتی نوشته می‌شود که مواردی حذف یا اضافه شوند، یا نام پرونده‌های ورودی و خروجی متفاوت باشند، یا گزینه
.BR "\-w\fP, \fB\-\-writepkg"
تنظیم شده باشد.
.PP
اگر نام پرونده ورودی "new" باشد، یک بسته خالی ایجاد می‌شود.
اگر نام پرونده خروجی مشخص نشده باشد، به‌طور خودکار بر اساس نام پرونده ورودی تولید می‌شود. اگر نام پرونده ورودی به یکی از حروف l، b یا e که منطبق با ویژگی‌های بستر آن است ختم شود، نام پرونده خروجی حاوی حرف برگرفته از گزینه
.BI "\-t\fP, \fB\-\-type"
خواهد بود.
.PP
همچنین می‌توان از این ابزار فقط برای تبدیل مشخصات یک پرونده داده منفرد ICU استفاده کرد که جایگزین ابزار سابق icuswap شده است. برای این حالت، نام پرونده ورودی infilename (و در صورت تمایل outfilename) را برای یک پرونده داده‌ای غیربسته‌ای ICU مشخص کنید.
گزینه‌های مجاز در این حالت شامل
.BI "\-t\fP, \fB\-w\fP, \fB\-s\fP"
و
.B \-d
هستند.
نام پرونده‌ها می‌توانند مطلق یا نسبی نسبت به مسیرهای دایرکتوری مبدا/مقصد باشند.
سایر گزینه‌ها در این حالت مجاز نیستند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
چاپ راهنمای نحوه استفاده و خروج.
.TP
.BI "\-tl\fP, \fB\-\-type" " l"
خروجی برای خانواده مجموعه‌نویسه little-endian/ASCII.
نوع خروجی به‌صورت پیش‌فرض همان نوع ورودی است.
.TP
.BI "\-tb\fP, \fB\-\-type" " b"
خروجی برای خانواده مجموعه‌نویسه big-endian/ASCII.
نوع خروجی به‌صورت پیش‌فرض همان نوع ورودی است.
.TP
.BI "\-te\fP, \fB\-\-type" " e"
خروجی برای خانواده مجموعه‌نویسه big-endian/EBCDIC.
نوع خروجی به‌صورت پیش‌فرض همان نوع ورودی است.
.TP
.BR "\-c\fP, \fB\-\-copyright"
گنجاندن اعلان حق نشر ICU در داده‌های خروجی حاصل.
.TP
.BI "\-C\fP, \fB\-\-comment" " comment"
گنجاندن
.I comment
مشخص‌شده در داده‌های حاصل به‌جای اعلان حق نشر ICU.
.TP
.BI "\-a\fP, \fB\-\-add" " list"
افزودن آیتم‌ها از
.I list
به بسته. این فهرست می‌تواند نام یک پرونده با پسوند
.B .txt
حاوی فهرستی از نام پرونده‌های آیتم‌ها، یا نام یک بسته
.B .dat
مربوط به ICU باشد.
.TP
.BI "\-r\fP, \fB\-\-remove" " list"
حذف آیتم‌های موجود در
.I list
از بسته. این فهرست می‌تواند نام یک پرونده با پسوند
.B .txt
حاوی فهرستی از نام پرونده‌های آیتم‌ها، یا نام یک بسته
.B .dat
مربوط به ICU باشد.
.TP
.BI "\-x\fP, \fB\-\-extract" " list"
استخراج آیتم‌های موجود در
.I list
از بسته. این فهرست می‌تواند نام یک پرونده با پسوند
.B .txt
حاوی فهرستی از نام پرونده‌های آیتم‌ها، یا نام یک بسته
.B .dat
مربوط به ICU باشد.
.TP
.BI "\-m\fP, \fB\-\-matchmode" " mode"
تنظیم حالت تطبیق برای نام آیتم‌های دارای نویسه‌های عام (wildcard).
.TP
.BI "\-s\fP, \fB\-\-sourcedir" " source"
تنظیم دایرکتوری مبدا روی
.IR source .
دایرکتوری مبدا پیش‌فرض، دایرکتوری جاری است.
.TP
.BI "\-d\fP, \fB\-\-destdir" " destination"
تنظیم دایرکتوری مقصد روی
.IR destination .
دایرکتوری مقصد پیش‌فرض، دایرکتوری جاری است.
.TP
.BI "\-l\fP, \fB\-\-list"
فهرست کردن آیتم‌های بسته در stdout (پس از اعمال تغییرات روی بسته).
.SH "ساختار پرونده فهرست (LIST FILE SYNTAX)"
آیتم‌ها در یک یا چند خط فهرست شده و با فاصله خالی (فاصله و کلید tab) جدا می‌شوند.
توضیحات با
.B #
شروع می‌شوند و نادیده گرفته می‌شوند. خطوط خالی نادیده گرفته می‌شوند. خطوطی که اولین نویسه غیرفاصله‌ای آن‌ها یکی از نویسه‌های "%&'()*+,-./:;<=>?_ باشد نیز جهت رزرو برای ساختارهای آینده نادیده گرفته می‌شوند.
.PP
آیتم‌های تعیین‌شده برای حذف یا استخراج می‌توانند حاوی یک نویسه عام منفرد
.B *
باشند. نویسه
.B *
با صفر یا چند نویسه تطبیق داده می‌شود. اگر گزینه
.BI "\-m\fP, \fB\-\-matchmode" " noslash"
تنظیم شده باشد، آنگاه نویسه
.B *
با نویسه
.B /
تطبیق داده نمی‌شود.
.PP
آیتم‌ها باید به‌صورت نسبی نسبت به بسته فهرست شوند و مسیرهای
.B \-\-sourcedir
یا
.B \-\-destdir
به ابتدای آن‌ها افزوده خواهد شد. این مسیرها تنها در هنگام افزودن یا استخراج آیتم‌ها به ابتدای نام پرونده‌های آیتم اضافه می‌شوند، نه به نام پرونده فهرست یا بسته .dat مربوط به ICU.
.PP
مسیرها می‌توانند به‌جای نویسه جداکننده پرونده سیستم‌عامل، حاوی
.B /
باشند و در صورت نیاز تبدیل خواهند شد.
.SH "نویسندگان (AUTHORS)"
Markus Scherer
.br
George Rhoten
.SH "نسخه (VERSION)"
1.0
.SH "حق نشر (COPYRIGHT)"
Copyright (C) 2006 IBM, Inc. and others.
.SH "همچنین ببینید (SEE ALSO)"
.BR pkgdata (1)
.BR genrb (1)