'\" t
.TH "CARGO\-HELP" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-help \- دریافت راهنما برای یکی از دستورات Cargo
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo help\fR [\fIsubcommand\fR]
.SH "توضیحات (DESCRIPTION)"
پیام راهنما را برای دستور مشخص‌شده چاپ می‌کند.
.sp
برای دستورهایی که دارای زیردستور هستند، سطوح مختلف دستور را با فاصله از یکدیگر جدا کنید. برای
نمونه، \fBcargo help report future\-incompatibilities\fR راهنمای دستور
\fBcargo report future\-incompatibilities\fR را نمایش می‌دهد.
.sp
فاصله‌ها تنها سطوح سلسله‌مراتبی میان یک دستور والد و زیردستورهای آن را جدا می‌کنند. خط تیره‌هایی که بخشی از نام
یک دستور هستند، مانند \fBgenerate\-lockfile\fR، همیشه باید حفظ شوند.
.sp
سطوح چندگانه یک دستور را می‌توان به صورت یک واژه متصل با خط تیره نیز نوشت.
برای نمونه، \fBcargo help report\-future\-incompatibilities\fR معادل با
\fBcargo help report future\-incompatibilities\fR\& است.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های نمایش (Display Options)"
.sp
\fB\-v\fR, 
\fB\-\-verbose\fR
.RS 4
استفاده از خروجی پرگو. می‌تواند دو بار مشخص شود تا خروجی «بسیار پرگو» تولید شود که
شامل اطلاعات اضافی مانند هشدارهای وابستگی و خروجی اسکریپت ساخت است.
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBterm.verbose\fR
<https://doc.rust\-lang.org/cargo/reference/config.html> مشخص شود.
.RE
.sp
\fB\-q\fR, 
\fB\-\-quiet\fR
.RS 4
پیام‌های لاگ cargo را چاپ نمی‌کند.
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBterm.quiet\fR
<https://doc.rust\-lang.org/cargo/reference/config.html> مشخص شود.
.RE
.sp
\fB\-\-color\fR \fIwhen\fR
.RS 4
کنترل زمان استفاده از خروجی رنگی. مقادیر معتبر:
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBauto\fR (پیش‌فرض): تشخیص خودکار در دسترس بودن پشتیبانی از رنگ در ترمینال.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBalways\fR: همیشه رنگ‌ها را نمایش می‌دهد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBnever\fR: هرگز رنگ‌ها را نمایش نمی‌دهد.
.RE
.sp
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBterm.color\fR
<https://doc.rust\-lang.org/cargo/reference/config.html> مشخص شود.
.RE
.SS "گزینه‌های مانیفست (Manifest Options)"
.sp
\fB\-\-locked\fR
.RS 4
تضمین می‌کند که دقیقاً همان وابستگی‌ها و نسخه‌هایی استفاده شوند که هنگام ایجاد اولیه فایل
موجود \fBCargo.lock\fR استفاده شده بودند. در صورت بروز هر یک از شرایط زیر، Cargo با یک
خطا خارج خواهد شد:
.sp
.RS 4
\h'-04'\(bu\h'+03'فایل lock موجود نباشد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'برنامه Cargo به دلیل حل وابستگی متفاوت، برای تغییر فایل lock تلاش کند.
.RE
.sp
این گزینه می‌تواند در محیط‌هایی که ساخت‌های قطعی و تکرارپذیر مد نظر است،
مانند خطوط لوله CI استفاده شود.
.RE
.sp
\fB\-\-offline\fR
.RS 4
از دسترسی Cargo به شبکه به هر دلیلی جلوگیری می‌کند. بدون این
پرچم، اگر Cargo نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس
نباشد، با خطا متوقف خواهد شد. با این پرچم، Cargo در صورت امکان تلاش
می‌کند کار را بدون شبکه پیش ببرد.
.sp
توجه داشته باشید که این کار ممکن است منجر به حل وابستگی متفاوتی نسبت به حالت برخط
شود. Cargo خود را به crateهایی که به صورت محلی دانلود شده‌اند محدود می‌کند، حتی
اگر طبق نسخه محلی شاخص، نسخه جدیدتری موجود باشد.
برای دانلود وابستگی‌ها پیش از رفتن به حالت آفلاین، دستور \fBcargo\-fetch\fR(1) را
ببینید.
.sp
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBnet.offline\fR <https://doc.rust\-lang.org/cargo/reference/config.html> مشخص شود.
.RE
.sp
\fB\-\-frozen\fR
.RS 4
معادل با مشخص کردن هم‌زمان هر دو گزینه \fB\-\-locked\fR و \fB\-\-offline\fR\& است.
.RE
.SS "گزینه‌های عمومی (Common Options)"
.sp
\fB+\fR\fItoolchain\fR
.RS 4
اگر Cargo با rustup نصب شده باشد و نخستین آرگومان \fBcargo\fR
با \fB+\fR آغاز شود، به عنوان نام زنجیره ابزار rustup تفسیر خواهد شد (مانند
\fB+stable\fR یا \fB+nightly\fR).
برای اطلاعات بیشتر در مورد نحوه عملکرد بازنویسی‌های زنجیره ابزار،
\fIمستندات rustup\fR <https://rust\-lang.github.io/rustup/overrides.html> را ببینید.
.RE
.sp
\fB\-\-config\fR \fIKEY=VALUE\fR یا \fIPATH\fR
.RS 4
یک مقدار پیکربندی Cargo را بازنویسی می‌کند. آرگومان باید در نحو TOML به صورت \fBKEY=VALUE\fR باشد،
یا به عنوان مسیری به یک فایل پیکربندی اضافی ارائه شود. این پرچم می‌تواند چندین بار مشخص شود.
برای اطلاعات بیشتر، \fIبخش بازنویسی‌های خط فرمان\fR <https://doc.rust\-lang.org/cargo/reference/config.html#command\-line\-overrides> را ببینید.
.RE
.sp
\fB\-C\fR \fIPATH\fR
.RS 4
دایرکتوری کاری فعلی را پیش از اجرای هرگونه عملیات مشخص‌شده تغییر می‌دهد. این گزینه بر
مواردی مانند جایی که cargo به طور پیش‌فرض برای مانیفست پروژه (\fBCargo.toml\fR) جستجو می‌کند، و
همچنین دایرکتوری‌های مورد جستجو برای یافتن \fB\&.cargo/config.toml\fR تأثیر می‌گذارد. این گزینه باید
پیش از نام دستور قرار گیرد، برای نمونه \fBcargo \-C path/to/my\-project build\fR\&.
.sp
این گزینه تنها در \fIکانال nightly\fR <https://doc.rust\-lang.org/book/appendix\-07\-nightly\-rust.html> در دسترس
است و برای فعال‌سازی به پرچم \fB\-Z unstable\-options\fR نیاز دارد (موضوع
\fI#10098\fR <https://github.com/rust\-lang/cargo/issues/10098> را ببینید).
.RE
.sp
\fB\-h\fR, 
\fB\-\-help\fR
.RS 4
اطلاعات راهنما را چاپ می‌کند.
.RE
.sp
\fB\-Z\fR \fIflag\fR
.RS 4
پرچم‌های ناپایدار (تنها در نسخه nightly) برای Cargo. برای جزئیات \fBcargo \-Z help\fR را اجرا کنید.
.RE
.SH "محیط (ENVIRONMENT)"
برای جزئیات درباره متغیرهای محیطی که Cargo می‌خواند، به \fIمرجع\fR <https://doc.rust\-lang.org/cargo/reference/environment\-variables.html> مراجعه کنید.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB0\fR: کار با موفقیت انجام شد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB101\fR: برنامه Cargo نتوانست عملیات را به پایان برساند.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
\h'-04' 1.\h'+01'دریافت راهنما برای یک دستور:
.sp
.RS 4
.nf
cargo help build
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'دریافت راهنما برای یک دستور تو در تو:
.sp
.RS 4
.nf
cargo help report future\-incompatibilities
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 3.\h'+01'حالت متصل با خط تیره نیز کار می‌کند:
.sp
.RS 4
.nf
cargo help report\-future\-incompatibilities
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 4.\h'+01'راهنما با استفاده از پرچم \fB\-\-help\fR نیز در دسترس است:
.sp
.RS 4
.nf
cargo build \-\-help
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1)