.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "dpkg-scansources 1"
.TH dpkg-scansources 1 2026-03-06 1.23.7-dirty "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
dpkg\-scansources \- ایجاد فایل‌های نمایه منابع (Sources)
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBdpkg\-scansources\fR
[\fIگزینه\fR...] \fIbinary\-dir\fR
[\fIoverride\-file\fR
[\fIpath\-prefix\fR]]
\&\fB>\fR
\&\fISources\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBdpkg\-scansources\fR
دایرکتوری
\&\fIbinary\-dir\fR
مشخص‌شده را برای یافتن فایل‌های
\&\fI.dsc\fR
پویش می‌کند. از این فایل‌ها برای ایجاد نمایه منابع دبیان استفاده می‌شود که در خروجی استاندارد چاپ می‌گردد.
.PP
فایل
\&\fIoverride\-file\fR
در صورت ارائه، برای تنظیم اولویت‌ها در بندهای نمایه حاصل و جایگزینی فیلد نگه‌دارنده مشخص‌شده در فایل‌های
\&\fI.dsc\fR
به کار می‌رود. این فایل می‌تواند فشرده باشد (از نسخه 1.15.5 dpkg به بعد). برای اطلاعات بیشتر در مورد قالب این فایل،
\&\fBdeb\-override\fR\|(5)
را ببینید.
.PP
\&\fBنکته\fR:
از آنجا که نمایه فایل override بر اساس بسته‌های باینری است و نه بسته‌های منبع (source)، یک مشکل جزئی در اینجا وجود دارد. پیاده‌سازی فعلی بالاترین اولویت را در میان تمام بسته‌های باینری تولیدشده توسط یک فایل
\&\fI.dsc\fR
برای اولویت بسته منبع استفاده می‌کند، و از مدخل override مربوط به اولین بسته باینری فهرست‌شده در فایل
\&\fI.dsc\fR
برای تغییر اطلاعات نگه‌دارنده بهره می‌برد. این رفتار ممکن است تغییر کند.
.PP
مقدار
\&\fIpath\-prefix\fR
در صورت ارائه، به ابتدای فیلد دایرکتوری در نمایه منبع تولیدشده افزوده می‌شود. شما عموماً از این گزینه استفاده می‌کنید تا فیلدهای دایرکتوری، مسیر را از بالاترین سطح سلسله‌مراتب آرشیو دبیان در بر داشته باشند.
.PP
\&\fBنکته\fR:
اگر می‌خواهید با
\&\fBapt\fR\|(8)
به فایل
\&\fISources\fR
تولیدشده دسترسی داشته باشید، احتمالاً لازم است فایل را با
\&\fBgzip\fR\|(1)
(تولید فایل Sources.gz) فشرده‌سازی کنید.
\&\fBapt\fR\|(8)
فایل‌های فشرده‌نشدهٔ
\&\fISources\fR
را نادیده می‌گیرد، مگر در مواردی که دسترسی محلی باشد (مانند منابع
\&\fBfile://\fR).
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-n\fR, \fB\-\-no\-sort\fR" 4
.IX Item "-n, --no-sort"
بندهای نمایه را مرتب نمی‌کند. به طور معمول آن‌ها بر اساس نام بسته منبع مرتب می‌شوند.
.IP "\fB\-e\fR, \fB\-\-extra\-override\fR \fIfile\fR" 4
.IX Item "-e, --extra-override file"
فایل
\&\fIfile\fR
را برای یافتن جایگزینی‌های تکمیلی پویش می‌کند (از نسخه 1.15.4 dpkg به بعد؛ این فایل از نسخه 1.15.5 dpkg به بعد می‌تواند فشرده باشد). برای اطلاعات بیشتر درباره قالب آن،
\&\fBdeb\-extra\-override\fR\|(5)
را ببینید.
.IP "\fB\-s\fR, \fB\-\-source\-override\fR \fIfile\fR" 4
.IX Item "-s, --source-override file"
از
\&\fIfile\fR
به عنوان فایل override منبع استفاده می‌کند (این فایل از نسخه 1.15.5 dpkg به بعد می‌تواند فشرده باشد). پیش‌فرض، نام فایل override مشخص‌شده است در حالی که
\&\fI.src\fR
به انتهای آن افزوده شده است.
.Sp
قالب فایل override منبع با فایل override باینری متفاوت است. این فایل تنها شامل دو فیلد جداشده با فاصله خالی است؛ اولی نام بسته منبع و دومی بخش (section) مربوطه است. خطوط خالی و خطوط توضیحات طبق معمول نادیده گرفته می‌شوند. اگر بسته‌ای در هر دو فایل وجود داشته باشد، فایل override منبع برای تعیین بخش اولویت خواهد داشت.
.IP \fB\-\-debug\fR 4
.IX Item "--debug"
فعال‌سازی حالت اشکال‌زدایی.
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش پیام راهنمای استفاده و خروج.
.IP \fB\-\-version\fR 4
.IX Item "--version"
نمایش نسخه و خروج.
.SH "محیط (ENVIRONMENT)"
.IX Header "ENVIRONMENT"
.IP \fBDPKG_COLORS\fR 4
.IX Item "DPKG_COLORS"
حالت رنگی را تنظیم می‌کند (از نسخه 1.18.5 dpkg به بعد). مقادیر پذیرفته‌شده در حال حاضر عبارتند از:
\&\fBauto\fR
(پیش‌فرض)،
\&\fBalways\fR
و
\&\fBnever\fR.
.IP \fBDPKG_NLS\fR 4
.IX Item "DPKG_NLS"
در صورت تنظیم، برای تصمیم‌گیری در مورد فعال‌سازی پشتیبانی از زبان بومی (Native Language Support)، که با عنوان پشتیبانی از بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود، به کار می‌رود (از نسخه 1.19.0 dpkg به بعد). مقادیر پذیرفته‌شده عبارتند از:
\&\fB0\fR
و
\&\fB1\fR
(پیش‌فرض).
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBdeb\-override\fR\|(5),
\&\fBdeb\-extra\-override\fR\|(5),
\&\fBdpkg\-scanpackages\fR\|(1).