.\" -*- 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-buildtree 1"
.TH dpkg-buildtree 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\-buildtree \- ابزارهای کمکی درخت ساخت بسته‌های منبع دبیان
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBdpkg\-buildtree\fR [\fIگزینه\fR...] [\fIدستور\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
\&\fBdpkg\-buildtree\fR ابزاری برای انجام عملیات متداول روی درخت ساخت برای یک بستهٔ منبع است.
.PP
این برنامه در dpkg نسخهٔ 1.22.3 معرفی شد.
.SH "دستورات (COMMANDS)"
.IX Header "COMMANDS"
.IP \fBclean\fR 4
.IX Item "clean"
تمام مصنوعات تولیدشده در طول فرآیند ساخت توسط ابزارهای مختلف dpkg، و مسیرهای استفاده‌شده یا کنترل‌شده توسط ابزارهای dpkg که پاک‌سازی آن‌ها امن است را حذف می‌کند.
این فایل‌ها برای ردیابی وضعیت بین دفعات اجرای ساخت بسته استفاده می‌شوند، و در بسیاری از موارد جزئیات پیاده‌سازی داخلی هستند که ایجادکنندهٔ بسته نباید نگران آن‌ها باشد، یا دایرکتوری‌های مرحله‌بندی حاوی مصنوعات ساخت هستند.
.IP \fBis\-rootless\fR 4
.IX Item "is-rootless"
بررسی می‌کند که آیا درخت ساخت می‌تواند بدون دسترسی‌های ریشه (root) ساخته شود یا خیر
(از نسخهٔ dpkg 1.22.12).
.Sp
این دستور را می‌توان حتی در نسخه‌هایی که این دستور هنوز در آن‌ها در دسترس نبود نیز با اطمینان استفاده کرد، زیرا در آن حالت مقدار پیش‌فرض همان حالت قدیمی خواهد بود که در آن دسترسی ریشه لازم بود.
.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"
حالت رنگ را تنظیم می‌کند.
مقادیر پذیرفته‌شده در حال حاضر عبارتند از: \fBauto\fR (پیش‌فرض)، \fBalways\fR و
\&\fBnever\fR.
.IP \fBDPKG_NLS\fR 4
.IX Item "DPKG_NLS"
در صورت تعیین، برای تصمیم‌گیری دربارهٔ فعال‌سازی پشتیبانی از زبان بومی (Native Language Support)، که به عنوان پشتیبانی بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود، استفاده خواهد شد.
مقادیر پذیرفته‌شده عبارتند از: \fB0\fR و \fB1\fR (پیش‌فرض).
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
.SS "فایل‌های پاک‌سازی‌شده (Cleaned files)"
.IX Subsection "Cleaned files"
.IP \fIdebian/files\fR 4
.IX Item "debian/files"
.PD 0
.IP \fIdebian/files.new\fR 4
.IX Item "debian/files.new"
.PD
فایل‌های تولیدشده توسط \fBdpkg\-distaddfile\fR\|(1).
.IP \fIdebian/substvars\fR 4
.IX Item "debian/substvars"
.PD 0
.IP \fIdebian/substvars.new\fR 4
.IX Item "debian/substvars.new"
.PD
فایل‌های تولیدشده توسط \fBdpkg\-shlibdeps\fR\|(1).
.IP \fIdebian/tmp\fR 4
.IX Item "debian/tmp"
دایرکتوری مرحله‌بندی حاوی محتویاتی که هنگام ایجاد یک بسته استفاده می‌شوند.
هر دو دستور \fBdpkg\-gencontrol\fR\|(1) و \fBdpkg\-gensymbols\fR\|(1) فایل‌هایی را درون آن ایجاد می‌کنند.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
.SS "کاربرد در debian/rules (Usage in debian/rules)"
.IX Subsection "Usage in debian/rules"
می‌توانید پس از انجام سایر پاک‌سازی‌های لازم، \fBdpkg\-buildtree clean\fR را از هدف \fBclean\fR در \fIdebian/rules\fR فراخوانی کنید.
.PP
برای نمونه در یک سامانهٔ ساخت شبیه به autoconf:
.Sp
.Vb 3
\&  clean:
\&        [ ! \-f Makefile ] || $(MAKE) distclean
\&        dpkg\-buildtree clean
.Ve