.\" Hey, Emacs! This is -*-nroff-*- you know...
.\"
.\" icu-config.1: manual page for the icu-config utility
.\"
.\" Copyright (C) 2016 and later: Unicode, Inc. and others.
.\" License & terms of use: http://www.unicode.org/copyright.html
.\" Copyright (C) 2002-2008 IBM, Inc. and others.
.\"
.\" Based on  Yves Arrouye's pkgdata page <yves@arrouye.net>
.\" Modified by Steven R. Loomis <srl@jtcsv.com>.
.\" With help from http://www.igpm.rwth-aachen.de/~albrecht/manpage.html
.TH "ICU-CONFIG" "1" "مه ۲۰۲۵" "icu" "دستورهای کاربری"
.SH "نام (NAME)"
icu-config \- نمایش گزینههای ساخت و پرچمهای کامپایل کتابخانه ICU
.SH "خلاصه دستور (SYNOPSIS)"
\fBicu-config\fP [ \fIگزینهها\fP... ]
.SH "توضیحات (DESCRIPTION)"
اسکریپت \fBicu-config\fR اطلاعات پیکربندی، مسیرهای هدر و پرچمهای کامپایلر و پیونددهنده را برای برنامههای متکی به ICU ارائه میدهد.
.PP
دستور
.B icu-config
کار ساخت و پیوند دادن برنامه‌ها با ICU را در مقایسه با پیکربندی دستی Makefileهای کاربر بسیار ساده‌تر می‌کند. از آنجا که
.B icu-config
یک اسکریپت اجرایی است، با امکان‌پذیر ساختن مکان‌یابی خود از طریق متغیر محیطی PATH سیستم، مشکل یافتن کتابخانه‌ها و فایل‌های سرایند (Header) مربوط به ICU را نیز حل می‌کند.
.SH "مثال‌ها (EXAMPLES)"
دستور
.B icu-config
می‌تواند بدون makefile استفاده شود. دستور زیر در خط فرمان برای ساخت یک برنامه تک‌فایلی ++C متکی به ICU کافی است (به‌عنوان نمونه، \fBicu/source/samples/props/props.cpp\fR):
.PP
.RS
.nf
`icu-config --cxx --cxxflags --cppflags --ldflags` -o props props.cpp
.fi
.RE
.PP
در حالت رایج‌تر،
.B icu-config
از درون یک makefile فراخوانی شده و برای مقداردهی متغیرها به کار می‌رود. مثال زیر نیز برنامه نمونه \fIprops\fR را می‌سازد:
.PP
.RS
.nf
CC=$(shell icu-config --cc)

CXX=$(shell icu-config --cxx)

CPPFLAGS=$(shell icu-config --cppflags)

CXXFLAGS=$(shell icu-config --cxxflags)

LDFLAGS =$(shell icu-config --ldflags)

all: props

props.o: props.cpp
.fi
.RE
.PP
ابزار
.BR make (1)
به‌طور خودکار متغیرهای بالا را به کار خواهد گرفت.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "\-\-bindir"
مسیر دایرکتوری فایل‌های باینری (اجرایی) را چاپ می‌کند. معمولاً معادل 'bin' است. برنامه‌های کاربردی و اسکریپت‌های اجرایی کاربر مربوط به ICU در اینجا قرار دارند.
.TP
.BI "\-\-cc"
کامپایلر C مورد استفاده را چاپ می‌کند. معادل متغیر $(CC) در Makefile است.
.TP
.BI "\-\-cflags"
پرچم‌های کامپایلر C را چاپ می‌کند. معادل متغیر $(CFLAGS) در Makefile است. شامل دستورات پیش‌پردازنده مانند مسیرهای include یا نمادهای تعریف‌شده نمی‌شود. مثال‌ها شامل پرچم‌های اشکال‌زدایی (\-g) و بهینه‌سازی هستند.
.TP
.BI "\-\-cppflags"
پرچم‌های پیش‌پردازنده C را چاپ می‌کند. معادل متغیر $(CPPFLAGS) در Makefile است. مثال‌ها شامل مسیرهای include با \-I و دستورات تعریف با \-D هستند.
.TP
.BI "\-\-cppflags\-searchpath"
پرچم‌های پیش‌پردازنده C را چاپ می‌کند، مشابه گزینه بالا اما تنها شامل مسیرهای جستجوی \-I می‌شود.
.TP
.BI "\-\-cxx"
کامپایلر ++C مورد استفاده را چاپ می‌کند. معادل متغیر $(CXX) در Makefile است.
.TP
.BI "\-\-cxxflags"
پرچم‌های کامپایلر ++C را چاپ می‌کند. معادل متغیر $(CXXFLAGS) در Makefile است.
.TP
.BI "\-\-detect\-prefix"
اگر ICU از محل نصب اولیه خود منتقل شده باشد، قرار دادن این پرچم پیش از سایر فراخوانی‌های
.B icu-config
تلاش می‌کند محل ICU را نسبت به محلی که اسکریپت
.B icu-config
در آن واقع است شناسایی کند. این گزینه می‌تواند در صورت آسیب دیدن محل نصب ICU به‌عنوان آخرین راهکار استفاده شود.
.TP
.BI "\-\-exec\-prefix"
پیشوند مورد استفاده برای دایرکتوری برنامه‌های اجرایی (مانند bin، sbin و غیره) را چاپ می‌کند. معمولاً همانند پیشوند اصلی (prefix) است.
.TP
.BI "\-\-exists"
اگر به نظر برسد ICU به درستی نصب و جای‌گذاری شده است، این اسکریپت با وضعیت موفقیت‌آمیز (۰) خارج می‌شود، در غیر این صورت پیام خطا و وضعیت غیرصفر برگردانده خواهد شد.
.TP
.BI "\-\-help\fP, \fB\-?\fP,\fB\-\-usage"
پیام راهنما و نحوه استفاده را چاپ می‌کند.
.TP
.BI "\-\-icudata"
نام کوتاه (\fIshortname\fP) فایل داده ICU را چاپ می‌کند. این نام هیچ پسوندی مانند ‎.dat‎، ‎.dll‎، ‎.so‎، ‎.lib‎، ‎.a‎ و غیره و همچنین پیشوندهایی مانند 'lib' را شامل نمی‌شود. ممکن است به فرم \fBicudt21b\fP باشد.
.TP
.BI "\-\-icudata\-install\-dir"
دایرکتوری محل نصب داده‌های بسته‌بندی‌شده ICU را چاپ می‌کند. می‌تواند به‌عنوان گزینه ‎--install در
.BR pkgdata (1)
استفاده شود.
.TP
.BI "\-\-icudata\-mode"
حالت پیش‌فرض pkgdata در ICU (مانند dll یا common) را چاپ می‌کند. می‌تواند به‌عنوان گزینه ‎--mode در
.BR pkgdata (1)
استفاده شود.
.TP
.BI "\-\-icudatadir"
مسیر داده‌های آرشیو بسته‌بندی‌شده را چاپ می‌کند (باید جایی باشد که متغیر محیطی ICU_DATA$ یا مسیر پیش‌فرض معادل به آن اشاره دارد). این گزینه به libdir اشاره نخواهد کرد.
.TP
.BI "\-\-invoke"
اگر ICU در محلی نصب نشده باشد که سیستم‌عامل بتواند کتابخانه‌های مشترک آن را پیدا کند، این گزینه دستوراتی را برای تنظیم متغیرهای محیطی مناسب جهت بارگذاری کتابخانه‌های مشترک ICU چاپ می‌کند. برای مثال، در بسیاری از سیستم‌ها متغیری به نام LD_LIBRARY_PATH یا معادل آن باید مقداردهی شود.
.TP
.BI "\-\-invoke=" "prog"
مشابه گزینه
.B \-\-invoke
است، با این تفاوت که گزینه‌های لازم برای فراخوانی برنامه‌ای به نام \fIprog\fP را نیز شامل می‌شود. اگر \fIprog\fP نام یکی از ابزارهای ICU مانند
.BR genrb (1)
باشد،
.B icu-config
مسیر کامل منتهی به آن ابزار را نیز در بر خواهد داشت.
.TP
.BI "\-\-ldflags"
تمام پرچم‌هایی را که باید به پیونددهنده (Linker) ارسال شوند چاپ می‌کند. این‌ها می‌توانند شامل \-L برای مسیرهای جستجوی کتابخانه و \-l برای افزودن کتابخانه‌های ICU باشند. به‌طور پیش‌فرض، این گزینه تلاش می‌کند کتابخانه‌های "common" (libicuuc) و "i18n" (libicui18n) و همچنین کتابخانه داده را پیوند دهد. اگر به کتابخانه‌های اضافی نیاز باشد، می‌توان هر یک از دو پرچم زیر را به همراه این گزینه به کار برد؛ برای مثال "\-\-ldflags \-\-ldflags\-icuio" در صورتی که کتابخانه icuio علاوه بر کتابخانه‌های استاندارد ICU مورد نیاز باشد. معادل متغیر $(LDFLAGS) در Makefile است.
.TP
.BI "\-\-ldflags\-layout"
گزینه پیوند را برای کتابخانه Layout مربوط به ICU چاپ می‌کند.
.TP
.BI "\-\-ldflags\-icuio"
گزینه پیوند را برای افزودن بسته ICU I/O چاپ می‌کند.
.TP
.BI "\-\-ldflags\-libsonly"
مشابه
.B \-\-ldflags
است، اما تنها شامل گزینه‌های \-l می‌شود.
.TP
.BI "\-\-ldflags\-searchpath"
مشابه
.B \-\-ldflags
است، اما تنها شامل گزینه‌های مسیر جستجوی \-L می‌شود.
.TP
.BI "\-\-ldflags\-system"
مشابه
.B \-\-ldflags
است، اما فقط کتابخانه‌های سیستمی (مانند pthreads) را در بر می‌گیرد.
.TP
.BI "\-\-mandir"
محل صفحات راهنمای (man) نصب‌شده ICU را چاپ می‌کند؛ معمولاً (man).
.TP
.BI "\-\-prefix"
پیشوند (دایرکتوری پایه) که ICU نصب‌شده در آن قرار دارد را چاپ می‌کند.
.TP
.BI "\-\-prefix=" "prefix"
پیشوند ICU را برای ادامه این خط فرمان روی \fIprefix\fP تنظیم می‌کند. معتبر بودن پیشوند جدید را نیز می‌آزماید.
.TP
.BI "\-\-sbindir"
محل باینری‌های سیستمی ICU را چاپ می‌کند؛ معمولاً (sbin).
.TP
.BI "\-\-shared\-datadir"
محل داده‌های اشتراکی ICU را چاپ می‌کند؛ معمولاً (share).
.TP
.BI "\-\-sysconfdir"
محل داده‌های پیکربندی سیستم ICU را چاپ می‌کند؛ معمولاً (etc).
.TP
.BI "\-\-unicode\-version"
نسخه استاندارد یونیکد (Unicode) مورد استفاده توسط ICU کنونی را چاپ می‌کند.
.TP
.BI "\-\-version"
نسخه فعلی ICU را چاپ می‌کند.
.TP
.BI "\-\-incfile"
مسیر فایل 'Makefile.inc' را چاپ می‌کند که برای استفاده با گزینه \-O در
.BR pkgdata (1)
مناسب است.
.SH "نویسندگان (AUTHORS)"
Steven Loomis
.SH "نسخه (VERSION)"
78.3
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2002-2004 متعلق به IBM, Inc. و دیگران است.
.SH "همچنین ببینید (SEE ALSO)"
.BR pkgdata (1),
.BR genrb (1)