.\" Hey, Emacs! This is -*-nroff-*- you know...
.\"
.\" makeconv.1: manual page for the makeconv utility
.\"
.\" Copyright (C) 2016 and later: Unicode, Inc. and others.
.\" License & terms of use: http://www.unicode.org/copyright.html
.\" Copyright (C) 2000-2002 IBM, Inc. and others.
.\"
.\" Manual page by Yves Arrouye <yves@realnames.com>.
.\"
.TH MAKECONV 1 "16 April 2002" "ICU MANPAGE" "ICU 78.3 Manual"
.SH "نام (NAME)"
makeconv \- کامپایل یک جدول تبدیل (converter table)
.SH "خلاصه دستور (SYNOPSIS)"
.B makeconv
[
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
]
[
.BR "\-c\fP, \fB\-\-copyright"
]
[
.BR "\-v\fP, \fB\-\-verbose"
]
[
.BI "\-d\fP, \fB\-\-destdir" " destination"
]
.IR convertertable " .\|.\|."
.SH "توضیحات (DESCRIPTION)"
دستور
.B makeconv
جدول تبدیل ICU یعنی
.I convertertable
را به یک فایل باینری تبدیل می‌کند. فایل باینری همان نام پایه
.I convertertable
را دارد، اما دارای پسوند
.B .cnv
است (به جای پسوند متداول
.B .ucm
فایل
.IR convertertable ).
سپس این فایل باینری می‌تواند مستقیماً توسط ICU خوانده شود، یا توسط
.BR pkgdata (1)
برای ادغام در یک آرشیو یا کتابخانه بزرگ‌تر مورد استفاده قرار گیرد.
.PP
فایل
.I convertertable
باید در قالب ucm مربوط به ICU (نگاشت صفحه کد یونیکد یا Unicode Codepage Mapping) باشد تا برای
.B makeconv
قابل درک باشد.
قالب ucm در ICU شبیه به فایل‌های upmap/tpmap/rpmap در IBM NLTC است.
توضیحات در
.I convertertable
به این صورت مدیریت می‌شوند: اگر توضیحی (که با علامت «#» شروع می‌شود) پس از مقداری متن بیاید و حاوی نشانگر بازگشتی «|» باشد، تنها متنی نادیده گرفته می‌شود که با علامت «#» شروع شده و پیش از علامت «|» پایان می‌یابد.
در غیر این صورت، یا چنانچه توضیح در ابتدای سطر باشد، توضیح تا انتهای سطر ادامه خواهد داشت. این شیوه ویژه مدیریت توضیحات، جهت سازگاری با شیوه قرار دادن اطلاعات بازگشتی در توضیحات در قالب سخت‌گیرانه IBM NLTC ucmap است.
.PP
توجه داشته باشید که مبدل‌های جدید پس از نصب در دایرکتوری داده‌های ICU، به‌طور خودکار توسط ICU شناسایی می‌شوند. نیازی نیست آن‌ها در فایل نام‌های مستعار مبدل‌ها یعنی
.BR convrtrs.txt (5)
فهرست شوند تا در دسترس برنامه‌های کاربردی استفاده‌کننده از ICU قرار گیرند؛ با این حال در صورتی که بخواهید برای آن‌ها نام مستعار یا برچسب تعیین کنید، باید در آن فایل فهرست شوند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
راهنمای استفاده را نمایش داده و خارج می‌شود.
.TP
.BR "\-c\fP, \fB\-\-copyright"
یک اعلان حق نشر را در داده‌های باینری می‌گنجاند.
.TP
.BR "\-v\fP, \fB\-\-verbose"
پیام‌های اطلاعاتی اضافی را در حین اجرا نمایش می‌دهد.
.TP
.BI "\-d\fP, \fB\-\-destdir" " destination"
دایرکتوری مقصد را روی
.I destination
تنظیم می‌کند. دایرکتوری مقصد پیش‌فرض توسط متغیر محیطی
.B ICU_DATA
مشخص می‌شود.
.SH "هشدارها (CAVEATS)"
اگر یک جدول تبدیل موجود تغییر یابد و با استفاده از
.B makeconv
دوباره کامپایل شود، فایل باینری حاصل باید به همان روشی که در ابتدا بسته‌بندی شده بود، بسته‌بندی شود. برای نمونه، اگر مبدل‌ها با استفاده از
.BR pkgdata (1)
در یک آرشیو یا یک کتابخانه گروه‌بندی شده بودند، آن‌گاه آن آرشیو یا کتابخانه باید با فایل باینری جدید دوباره ساخته شود. یک فایل مبدل باینری مستقل بر یک فایل بسته‌بندی‌شده اولویت نخواهد داشت.
.SH "محیط (ENVIRONMENT)"
.TP 10
.B ICU_DATA
دایرکتوری حاوی داده‌های ICU را مشخص می‌کند. مقدار پیش‌فرض آن
.BR ${prefix}/share/icu/78.3/
است. برخی از ابزارها در ICU به وجود اسلش پایانی وابسته هستند. بنابراین در صورت مقداردهی
.B ICU_DATA
مهم است که از وجود آن اطمینان حاصل شود.
.SH "نسخه (VERSION)"
78.3
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2000 متعلق به IBM, Inc. و دیگران است.
.SH "همچنین ببینید (SEE ALSO)"
.BR convrtrs.txt (5)
.br
.BR pkgdata (1)