.TH UNCRUSTIFY "1" "Oct 2014" "uncrustify " "User Commands"
.SH "نام (NAME)"
uncrustify \- زیباساز و مرتب‌ساز کدهای منبع C، C++، C#، D، Java و Pawn

.SH "خلاصه دستور (SYNOPSIS)"
.B uncrustify \fR[\fIOPTIONS\fR] [\fIFILES\fR]

.SH "توضیحات (DESCRIPTION)"

اگر هیچ فایل ورودی مشخص نشود، ورودی از stdin خوانده می‌شود.
.br
در صورت خواندن از stdin، باید زبان را با استفاده از \-l مشخص کنید.

اگر \-F استفاده شود یا فایل‌ها در خط فرمان مشخص شده باشند، نام فایل خروجی
\fIPFX\fR + "/" + filename + \fISFX\fR خواهد بود.
.br
مگر آنکه البته از گزینه‌های \fB\-\-replace\fR یا \fB\-\-no\-backup\fR استفاده شده باشد.

هنگام خواندن از stdin یا پردازش یک فایل منفرد با گزینهٔ '\-f'،
خروجی به stdout فرستاده می‌شود، مگر اینکه با \-o FILE تغییر مسیر داده شود.

خطاها همیشه به stderr فرستاده می‌شوند.

.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های پایه (Basic Options):"
.TP
\fB\-c\fI CFG\fR
استفاده از فایل پیکربندی \fICFG\fR، یا مقادیر پیش‌فرض اگر \fICFG\fR برابر '-' تنظیم شده باشد.
.br
در صورت عدم تعیین، uncrustify از \fB$UNCRUSTIFY_CONFIG\fR یا \fB$HOME/.uncrustify.cfg\fR استفاده خواهد کرد.
.TP
\fB\-f\fI FILE\fR
پردازش فایل منفرد \fIFILE\fR و ارسال خروجی به stdout یا فایل مشخص‌شده با \fB\-o\fR.
.TP
\fB\-o\fI FILE\fR
تغییر مسیر خروجی به \fIFILE\fR.
.br
استفاده به همراه \fB\-f\fR، \fB\-\-update\-config\fR، \fB\-\-update\-config\-with\-doc\fR، \fB\-\-universalindent\fR.
.TP
\fB\-\-check\fR
متن جدید را در خروجی چاپ نمی‌کند، بلکه بررسی می‌کند که آیا هنگام پردازش فایل(ها) تغییری ایجاد می‌شود یا خیر. وضعیت هر فایل در stderr چاپ می‌شود. اگر تغییری رخ ندهد کد وضعیت خروج EXIT_SUCCESS و در غیر این صورت EXIT_FAILURE خواهد بود.
.TP
\fB\-F\fI FILE\fR
خواندن نام فایل‌های مورد پردازش از \fIFILE\fR، یک نام فایل در هر خط. اگر \fIFILE\fR برابر \'\-\' باشد، نام فایل‌ها به جای فایل از ورودی استاندارد خوانده می‌شوند.
.br
می‌توانید این فایل را با دستوری مانند \'\fBfind . \-name "*.c" > list.txt\fR\' بسازید.
.br
این گزینه با \fB\-f\fR قابل جمع نیست.
.TP
\fB\-\-prefix\fI PFX\fR
افزودن پیشوند \fIPFX\fR به مسیر نام فایل خروجی.
.br
این گزینه با \fB\-f\fR، \fB\-\-replace\fR یا \fB\-\-no\-backup\fR قابل جمع نیست.
.TP
\fB\-\-suffix\fI SFX\fR
افزودن پسوند \fISFX\fR به نام فایل خروجی.
.br
اگر هیچ‌کدام از \fISFX\fR یا \fIPFX\fR مشخص نشده باشند، مقدار پیش‌فرض '.uncrustify' است.
.br
این گزینه با \fB\-f\fR، \fB\-\-replace\fR یا \fB\-\-no\-backup\fR قابل جمع نیست.
.TP
\fB\-\-frag\fR
فرض را بر این می‌گذارد که ورودی یک قطعه‌کد است و خط اول تورفتگی مناسب دارد.
.TP
\fB\-\-replace\fR
جایگزینی فایل‌های منبع (یک نسخهٔ پشتیبان ایجاد می‌کند).
.br
این گزینه با \fB\-f\fR، \fB\-\-prefix\fR یا \fB\-\-suffix\fR قابل جمع نیست.
.TP
\fB\-\-no\-backup\fR
جایگزینی فایل‌ها بدون ایجاد نسخهٔ پشتیبان. زمانی که فایل‌ها تحت سامانه کنترل نسخه هستند بسیار کاربردی است.
.br
این گزینه با \fB\-f\fR، \fB\-\-prefix\fR یا \fB\-\-suffix\fR قابل جمع نیست.
.TP
\fB\-\-if\-changed\fR
نوشتن در stdout (یا ساخت FILE خروجی) فقط در صورتی که تغییری شناسایی شود.
.br
.TP
\fB\-\-mtime\fR
حفظ زمان تغییر (mtime) در فایل‌های جایگزین‌شده.
.TP
\fB\-l\fR
تعیین صریح زبان: C، CPP، D، CS، JAVA، PAWN، VALA، OC، OC+
.TP
\fB\-t\fR
بارگذاری یک فایل حاوی انواع داده‌ای (معمولاً مورد نیاز نیست)
.TP
\fB\-q\fR
حالت بی‌صدا \- عدم ارسال خروجی به stderr (گزینهٔ \fB\-L\fR اولویت دارد)
.SS "گزینه‌های پیکربندی/راهنما (Config/Help Options):"
.TP
\fB\-h\fR \-? \fB\-\-help\fR \fB\-\-usage\fR
چاپ این پیام و خروج
.TP
\fB\-\-version\fR
چاپ نسخه و خروج
.TP
\fB\-\-count\-options\fR
چاپ تعداد گزینه‌های در دسترس و خروج
.TP
\fB\-\-show\-config\fR
چاپ مستندات گزینه‌ها و خروج
.TP
\fB\-\-update\-config\fR
تولید یک فایل پیکربندی جدید.
.TP
\fB\-\-update\-config\-with\-doc\fR
تولید یک فایل پیکربندی جدید همراه با توضیحات تعبیه‌شدهٔ مربوط به نحوهٔ استفاده.
.TP
\fB\-\-universalindent\fR
تولید یک فایل پیکربندی برای Universal Indent GUI.
.TP
\fB\-\-detect\fR
تشخیص پیکربندی از روی یک فایل منبع. به همراه '\-f \fIFILE\fR' استفاده شود.
تشخیص در حال حاضر نسبتاً محدود است.
.TP
\fB\-\-tracking space:FILE\fR
آماده‌سازی اطلاعات ردگیری فاصله‌ها برای اشکال‌زدایی.
.TP
\fB\-\-tracking nl:FILE\fR
آماده‌سازی اطلاعات ردگیری خطوط جدید برای اشکال‌زدایی.
.TP
\fB\-\-tracking start:FILE\fR
آماده‌سازی اطلاعات ردگیری آغاز دستورها برای اشکال‌زدایی. با گزینهٔ -o قابل استفاده نیست.

.SS "گزینه‌های اشکال‌زدایی (Debug Options):"
.TP
\fB\-p \fIFILE\fR
تخلیه اطلاعات اشکال‌زدایی در \fIFILE\fR، یا به stdout اگر \fIFILE\fR برابر '-' باشد.
.br
باید در ترکیب با '-f \fIFILE\fR' استفاده شود.
.TP
\fB\-ds \fIFILE\fR \fB\-\-dump\-steps \fIFILE\fR
تخلیه اطلاعات تجزیه در مراحل گوناگون فرایند قالب‌بندی.
.br
این گزینه مجموعه‌ای از فایل‌ها به نام '\fIFILE\fR_nnn.log' ایجاد می‌کند که هر کدام
.br
متناظر با یک مرحله از قالب‌بندی در uncrustify هستند.
.br
فایل '\fIFILE\fR_000.log' گزینه‌های قالب‌بندی مورد استفاده را فهرست می‌کند.
.br
باید در ترکیب با '-f \fIFILE\fR' استفاده شود.
.TP
\fB\-L\fI SEV\fR
تنظیم شدت لاگ (به log_levels.h مراجعه کنید)
.TP
\fB\-s\fR
نمایش شدت لاگ در پیام‌های لاگ
.TP
\fB\-\-decode\fI FLAG\fR
چاپ \fIFLAG\fR به‌صورت متنی و خروج

.SH "مثال‌ها (EXAMPLES)"
.TP
خواندن یک فایل D از stdin، خروجی به stdout.
cat foo.d | uncrustify \-q \-c my.cfg \-l d
.TP
پردازش یک فایل، خروجی به stdout.
uncrustify \-c my.cfg \-d foo.d
.TP
پردازش یک درخت منبع، خروجی در درختی دیگر.
find src \-name "*.[ch]" > files.txt
.br
uncrustify \-c my.cfg \-F files.txt \-\-prefix out
.TP
پردازش در‌جای (in\(hyplace) یک درخت منبع.
uncrustify \-c my.cfg \-\-no\-backup $(find src \-name "*.[ch]")

.SH "نکات (NOTES)"
از یادداشت‌های حاوی ' *INDENT\-OFF*' و ' *INDENT\-ON*' برای غیرفعال کردن
پردازش بخش‌هایی از فایل منبع استفاده کنید.

.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Ben Gardner

.SH "گزارش باگ‌ها (BUGS)"
از سامانه پیگیری اشکالات در <http://sourceforge.net/projects/uncrustify> استفاده کنید

.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر \(C) 2006\(hy2014 متعلق به Ben Gardner است.
.br
حق نشر \(C) 2015, 2016 متعلق به Guy Maurel است.

.SH "مجوز (LICENSE)"
مجوز گنو GPL نسخهٔ ۲ یا بالاتر <http://gnu.org/licenses/gpl.html>

این یک نرم‌افزار آزاد است؛ برای شرایط رونوشت‌برداری به کد منبع مراجعه کنید.
هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.