.TH DUB-DESCRIBE 1 "2026-08-16" "The D Language Foundation" "The D Language Foundation"
.SH "نام (NAME)"
dub-describe \- چاپ توصیف JSON از پروژه و وابستگی‌های آن
.SH "خلاصه دستور (SYNOPSIS)"
\fBdub describe \fR[<\fIpackage\fR>[@<\fIversion-spec\fR>]] \fIOPTIONS\&.\&.\&.\fR
.SH "توضیحات (DESCRIPTION)"
یک توصیف ساخت JSON برای بستهٔ ریشه و تمام وابستگی‌های آن در قالبی مشابه فایل توصیف بستهٔ JSON چاپ می‌کند. این ویژگی بیشتر برای IDEها مفید است.



تمام گزینه‌های معمول که برای build/run/generate استفاده می‌شوند نیز در اینجا اعمال می‌شوند.



هنگامی که \-\-data=VALUE مشخص شود، به جای آن تنظیمات ساخت مشخصی برای یک پروژه چاپ خواهد شد (به طور پیش‌فرض، برای کامپایلر فعلی قالب‌بندی می‌شود).



گزینهٔ \-\-data=VALUE می‌تواند چندین بار برای بازیابی چند بخش از اطلاعات به طور هم‌زمان مشخص شود. یک فهرست جداشده با کاما نیز قابل قبول است (برای مثال: \-\-data=dflags,libs). داده‌ها با همان ترتیبی که در خط فرمان درخواست شده‌اند در خروجی قرار خواهند گرفت.



مقادیر پذیرفته‌شده برای \-\-data=VALUE عبارتند از:



main-source-file, dflags, lflags, libs, linker-files, source-files, versions, debug-versions, import-paths, string-import-paths, import-files, options



موارد زیر نیز در صورت استفاده از \-\-data\-list توسط \-\-data پذیرفته می‌شوند:



target-type, target-path, target-name, working-directory, copy-files, string-import-files, pre-generate-commands, post-generate-commands, pre-build-commands, post-build-commands, pre-run-commands, post-run-commands, requirements
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-dest\fR=\fIVALUE\fR
.RS 4
دایرکتوری پایه‌ای که مصنوعات خروجی در آن قرار خواهند گرفت
.RE
.PP
\fB\-b\fR, \fB\-\-build\fR=\fIVALUE\fR
.RS 4
نوع ساخت برای اجرا را مشخص می‌کند. توجه داشته باشید که تنظیم متغیر محیطی DFLAGS نوع ساخت را با پرچم‌های سفارشی رونویسی خواهد کرد.
نام‌های ممکن:
  debug, plain, release, release-debug, release-nobounds, unittest, profile, profile-gc, docs, ddox, cov, cov-ctfe, unittest-cov, unittest-cov-ctfe, syntax و انواع سفارشی
.RE
.PP
\fB\-c\fR, \fB\-\-config\fR=\fIVALUE\fR
.RS 4
پیکربندی مشخص‌شده را می‌سازد. پیکربندی‌ها می‌توانند در dub.json تعریف شوند
.RE
.PP
\fB\-\-override\-config\fR=\fIVALUE\fR
.RS 4
از پیکربندی مشخص‌شده برای یک وابستگی خاص استفاده می‌کند. می‌تواند چندین بار مشخص شود.
قالب: \-\-override\-config=<dependency>/<config>
.RE
.PP
\fB\-\-compiler\fR=\fIVALUE\fR
.RS 4
باینری کامپایلر مورد استفاده را مشخص می‌کند (می‌تواند یک مسیر باشد).
پیشوندها و پسوندهای دلخواه شناسه‌های زیر شناسایی شده (مانند ldc2 یا dmd-2.063) و با نوع کامپایلر مناسب تطبیق داده می‌شوند:
  dmd, gdc, ldc, gdmd, ldmd
.RE
.PP
\fB\-a\fR, \fB\-\-arch\fR=\fIVALUE\fR
.RS 4
اجبار به استفاده از یک معماری متفاوت (مانند x86 یا x86_64)
.RE
.PP
\fB\-d\fR, \fB\-\-debug\fR=\fIVALUE\fR
.RS 4
شناسهٔ نسخهٔ `debug` مشخص‌شده را هنگام ساخت تعریف می‌کند \- می‌تواند چندین بار استفاده شود
.RE
.PP
\fB\-\-d\-version\fR=\fIVALUE\fR
.RS 4
شناسهٔ `version` مشخص‌شده را هنگام ساخت تعریف می‌کند \- می‌تواند چندین بار استفاده شود.
با احتیاط استفاده کنید، قدرت زیاد مسئولیت زیادی به همراه دارد! برای نسخه‌های پرکاربرد یا ترکیبی و نسخه‌هایی که وابستگان باید بتوانند از آن‌ها استفاده کنند، در بستهٔ خود پیکربندی ایجاد کنید.
.RE
.PP
\fB\-\-nodeps\fR
.RS 4
وابستگی‌های ناموجود را قبل از ساخت حل‌وفصل نمی‌کند
.RE
.PP
\fB\-\-build\-mode\fR=\fIVALUE\fR
.RS 4
نحوهٔ فراخوانی کامپایلر و پیونددهنده را مشخص می‌کند. مقادیر معتبر:
  separate (پیش‌فرض), allAtOnce, singleFile
.RE
.PP
\fB\-\-single\fR
.RS 4
با نام بسته به عنوان یک نام فایل رفتار می‌کند. فایل باید شامل یک کامنت دستورالعمل بسته باشد.
.RE
.PP
\fB\-\-force\-remove\fR
.RS 4
گزینهٔ منسوخ‌شده‌ای که کاری انجام نمی‌دهد.
.RE
.PP
\fB\-\-filter\-versions\fR
.RS 4
[آزمایشی] شناسه‌های نسخه و شناسه‌های نسخهٔ اشکال‌زدایی را فیلتر می‌کند تا کارایی حافظهٔ موقت ساخت بهبود یابد.
.RE
.PP
\fB\-\-import\-paths\fR
.RS 4
میانبری برای \-\-data=import\-paths \-\-data\-list
.RE
.PP
\fB\-\-string\-import\-paths\fR
.RS 4
میانبری برای \-\-data=string\-import\-paths \-\-data\-list
.RE
.PP
\fB\-\-data\fR=\fIVALUE\fR
.RS 4
صرفاً مقادیر یک تنظیم ساخت خاص را، چه تنها برای این بسته یا به صورت بازگشتی با احتساب تمام وابستگی‌ها، فهرست می‌کند. یک فهرست جداشده با کاما را می‌پذیرد. برای جزئیات بیشتر و گزینه‌های پذیرفته‌شده برای VALUE، به بالا مراجعه کنید.
.RE
.PP
\fB\-\-data\-list\fR
.RS 4
اطلاعات \-\-data را به جای قالب‌بندی برای خط فرمان کامپایلر، در قالب فهرست (خط‌به‌خط) در خروجی نمایش می‌دهد.
.RE
.PP
\fB\-\-data\-0\fR
.RS 4
اطلاعات \-\-data را با استفاده از جداکننده‌های null، به جای فاصله‌ها یا خط‌های جدید خروجی می‌دهد. نتیجه برای مثال با xargs \-0 قابل استفاده است.
.RE
.SS "گزینه‌های مشترک (COMMON OPTIONS)"
به \fBdub\fR(1) مراجعه کنید
.SH "وضعیت خروج (EXIT STATUS)"
.TP
.BR 0
دستور DUB با موفقیت اجرا شد
.TP
.BR 1
خطاهای نحوهٔ استفاده، پرچم‌های ناشناخته در خط فرمان
.TP
.BR 2
بسته پیدا نشد، بارگیری بسته ناموفق بود، خطای متفرقه
.SH "فایل‌ها (FILES)"
\fIdub\&.sdl\fR, \fIdub\&.json\fR
.SH "نویسندگان (AUTHORS)"
Copyright (c) 1999-2026 by The D Language Foundation
.SH "مستندات برخط (ONLINE DOCUMENTATION)"
.UR http://code.dlang.org/docs/commandline
http://code.dlang.org/docs/commandline
.UE
.SH "همچنین ببینید (SEE ALSO)"
\fBdub\fR(1), \fBdub-generate\fR(1)