'\" t
.TH "CARGO\-REPORT\-FUTURE\-INCOMPATIBILITIES" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-report\-future\-incompatibilities \- گزارش بسته‌هایی که در آینده کامپایل آن‌ها متوقف خواهد شد
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo report future\-incompatibilities\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
گزارشی از هشدارهای ناسازگاری‌های آینده (future-incompatible) را که در طول ساخت‌های پیشین صادر شده‌اند، نمایش می‌دهد.
این‌ها هشدارهایی برای تغییراتی هستند که ممکن است در آینده به خطاهای قطعی تبدیل شده و موجب عدم امکان ساخت وابستگی‌ها در نگارش‌های بعدی rustc شوند.
.sp
برای اطلاعات بیشتر، فصل \fIFuture incompat report\fR <https://doc.rust\-lang.org/cargo/reference/future\-incompat\-report.html>\& را ببینید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-\-id\fR \fIid\fR
.RS 4
گزارش را با شناسهٔ (id) مشخص‌شده که توسط Cargo تولید شده است نمایش می‌دهد.
اگر مشخص نشود، تازه‌ترین گزارش را نشان می‌دهد.
.RE
.SS "انتخاب بسته (Package Selection)"
به‌طور پیش‌فرض، بستهٔ موجود در دایرکتوری کاری فعلی انتخاب می‌شود. پرچم \fB\-p\fR می‌تواند برای انتخاب بسته‌ای متفاوت در یک فضای کاری (workspace) استفاده شود.
.sp
\fB\-p\fR \fIspec\fR, 
\fB\-\-package\fR \fIspec\fR
.RS 4
بسته‌ای که گزارش برای آن نمایش داده می‌شود. برای قالب SPEC به \fBcargo\-pkgid\fR(1) مراجعه کنید.
.RE
.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 به دلیل تفکیک وابستگی (dependency resolution) متفاوت تلاش کند فایل lock را تغییر دهد.
.RE
.sp
ممکن است در محیط‌هایی که ساخت‌های قطعی و بازتولیدپذیر مورد نیاز است، مانند خطوط لولهٔ CI، استفاده شود.
.RE
.sp
\fB\-\-offline\fR
.RS 4
از دسترسی Cargo به شبکه به هر دلیلی جلوگیری می‌کند. بدون این پرچم، اگر Cargo نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس نباشد، با خطا متوقف می‌شود. با این پرچم، Cargo در صورت امکان تلاش خواهد کرد بدون شبکه کار را ادامه دهد.
.sp
توجه داشته باشید که این ممکن است به تفکیک وابستگی متفاوتی نسبت به حالت برخط منجر شود. Cargo خود را به بسته‌هایی محدود خواهد کرد که به‌صورت محلی بارگیری شده‌اند، حتی اگر طبق نسخهٔ محلی نمایه (index)، نگارش جدیدتری موجود باشد. برای بارگیری وابستگی‌ها پیش از آفلاین شدن، دستور \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 آغاز شود، به‌عنوان نام زنجیره‌ابزار (toolchain) در 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 را رونویسی (override) می‌کند. آرگومان باید در نحو 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: ‏Cargo با موفقیت به پایان رسید.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB101\fR: ‏Cargo نتوانست به پایان برسد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
\h'-04' 1.\h'+01'نمایش تازه‌ترین گزارش future\-incompat:
.sp
.RS 4
.nf
cargo report future\-incompat
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'نمایش تازه‌ترین گزارش future\-incompat برای یک بستهٔ خاص:
.sp
.RS 4
.nf
cargo report future\-incompat \-\-package my\-dep@0.0.1
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-report\fR(1), \fBcargo\-build\fR(1)