.TH INTLTOOL-UPDATE 8 "2003-08-02" "intltool"

.SH "نام (NAME)"
intltool\-update \- به‌روزرسانی پرونده قالب PO و ادغام ترجمه‌ها با آن

.SH "خلاصه دستور (SYNOPSIS)"
.BI intltool\-update " [گزینه‌ها]..."
.br
.BI intltool\-update " LANGCODE"

.SH "توضیحات (DESCRIPTION)"
دستور
.B intltool\-update
قالب‌های جدید پرونده po را از کد منبع تولید کرده و ترجمه‌های موجود را با این قالب‌های جدید po ادغام می‌کند.
.PP
پیش از اجرای
.BR intltool\-update ،
باید دایرکتوری کاری را به زیردایرکتوری حاوی ترجمه‌ها (معمولاً
"\fIpo/\fR")
تغییر دهید.

.SH "گزینه‌ها (OPTIONS)"
هنگام اجرای
.BR intltool\-update ،
در هر نوبت تنها استفاده از یک حالت عملکرد مجاز است.
.\" -------------------------------------------------------
.SS "حالت عملکرد (Mode of operation)"
.\" -------------------------------------------------------
.IP "\fB\-p\fR" 4
.PD 0
.IP "\fB\-\-pot\fR" 4
.PD
تنها تولید قالب po (با پسوند ‎.pot).
.IP "\fB\-s\fR" 4
.PD 0
.IP "\fB\-\-headers\fR" 4
.PD
اجرای
\fBintltool\-extract\fR(8)
جهت استخراج رشته‌های درون پرونده‌های با سبک XML/INI فهرست‌شده در
\fBPOTFILES.in\fR،
و نوشتن رشته‌های استخراج‌شده در پرونده‌های سرآیند (header)، به‌گونه‌ای که این رشته‌ها توسط
\fBxgettext\fR(1)
قابل شناسایی باشند.
.IP "\fB\-m\fR" 4
.PD 0
.IP "\fB\-\-maintain\fR" 4
.PD
جستجو برای پرونده‌های جاافتاده‌ای که باید در
.B POTFILES.in
یا
.B POTFILES.skip
فهرست می‌شدند. فهرستی از تمام این پرونده‌ها در پرونده دیگری به نام
"\fBmissing\fR"
نوشته می‌شود.
.IP "\fB\-r\fR" 4
.PD 0
.IP "\fB\-\-report\fR" 4
.PD
نمایش گزارش وضعیت برای تمام ترجمه‌های موجود در نرم‌افزار.
.IP "\fB\-d \fILANGCODE\fR" 4
.PD 0
.IP "\fB\-\-dist \fILANGCODE\fR" 4
.PD
ادغام
.BR LANGCODE .po
با قالب PO موجود.
.\" -------------------------------------------------------
.SS "سایر گزینه‌ها (Other options)"
.\" -------------------------------------------------------
.
.IP "\fB\-g \fINAME\fR" 4
.PD 0
.IP "\fB\-\-gettext\-package\fR=\fINAME\fR" 4
.PD
مشخص کردن دستی نام پرونده قالب PO، به‌جای تعیین خودکار نام از روی کد منبع. این گزینه همراه با گزینه
.BR \-p / \-\-pot
کاربرد دارد. همچنین یک اثر جانبی دیگر نیز دارد: نام دایرکتوری کاری فعلی دیگر به "po" یا "po-*" محدود نخواهد بود.
.IP "\fB\-o \fIFILENAME\fR" 4
.PD 0
.IP "\fB\-\-output\-file\fR=\fIFILENAME\fR" 4
.PD
مشخص کردن دستی نام پرونده خروجی
(\fIFILENAME\fR)
پس از ادغام ترجمه قدیمی با قالب PO. چه همراه با گزینه
.BR \-d / \-\-dist
و چه بدون هیچ گزینه‌ای مفید است.
.IP "\fB\-x\fR" 4
.PD 0
.IP "\fB\-\-verbose\fR" 4
.PD
نمایش بازخوردها و جزئیات فراوان در خروجی.
.IP "\fB\-\-version\fR" 4
نمایش اطلاعات نسخه.
.IP "\fB\-\-help\fR" 4
نمایش نحوه استفاده و اطلاعات راهنمای پایه.

.SH "مثال‌ها (EXAMPLES)"
تولید یک قالب PO جدید از روی کد منبع و نام‌گذاری آن به foo.pot:
.PP
.RS 2
.nf
.ft CW
.ne 1
intltool-update \-\-pot \-\-gettext-package=foo
.ft R
.fi
.RE
.PP
به‌روزرسانی پرونده ترجمه xy.po با استفاده از قالب po موجود به نام "bar.pot" و نوشتن خروجی در "xy1.po":
.PP
.RS 2
.nf
.ft CW
.ne 1
intltool-update \-\-dist \-\-gettext-package=bar \-\-output-file=xy1.po xy
.ft R
.fi
.RE
.PP
تولید قالب PO جدید و به‌روزرسانی پرونده ترجمه xy.po (پرونده xy.po با محتوای جدید بازنویسی می‌شود):
.PP
.RS 2
.nf
.ft CW
.ne 1
intltool-update xy
.ft R
.fi
(معادل با \fBintltool\-update \-\-pot && intltool\-update \-\-dist xy\fR)
.RE

.SH "فایل‌ها (FILES)"
.IP "\fBpo/POTFILES.in\fR"
شامل فهرستی از پرونده‌های منبع که حاوی رشته‌های قابل ترجمه هستند، یک پرونده در هر خط.
.IP "\fBpo/POTFILES.skip\fR"
.PD 0
.IP "\fBpo/POTFILES.ignore\fR (منسوخ)"
.PD
شامل فهرستی از پرونده‌های منبع که هنگام جستجو برای رشته‌های قابل ترجمه باید نادیده گرفته شوند.

.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به http://bugs.launchpad.net/intltool

.SH "نویسندگان (AUTHORS)"
Darin Adler <darin@bentspoon.com>
.br
Kenneth Christiansen <kenneth@gnu.org>
.br
Maciej Stachowiak <mjs@eazel.com>

.SH "همچنین ببینید (SEE ALSO)"
.BR intltoolize (8),
.BR intltool\-prepare (8),
.BR intltool\-extract (8),
.BR intltool\-merge (8),
.BR xgettext (1)