.\" -*- 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 "GUARDS 1"
.TH GUARDS 1 2025-09-18 "perl v5.42.0" "User Contributed Perl Documentation"
.\" 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)"
guards \- انتخاب از میان فهرستی از فایل‌های محافظت‌شده با شرط‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fIguards\fR [\-\-prefix=\fIdir\fR] [\-\-path=\fIdir1:dir2:...\fR] [\-\-default=<0|1>]
[\-\-check|\-\-list] [\-\-invert\-match] [\-\-with\-guards] [\-\-config=<file>]
\&\fIsymbol\fR ...
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این اسکریپت یک فایل پیکربندی را می‌خواند که ممکن است حاوی اصطلاحاً محافظ‌ها (guards)، نام‌های فایل و توضیحات باشد، و آن نام‌های فایلی را که همهٔ محافظ‌ها را برآورده می‌کنند در خروجی استاندارد می‌نویسد. این اسکریپت فهرستی از نمادها را به عنوان آرگومان‌های خود می‌گیرد. هر خط در فایل پیکربندی به صورت جداگانه پردازش می‌شود. خطوط می‌توانند با تعدادی محافظ آغاز شوند. محافظ‌های زیر تعریف شده‌اند:
.Sp
.RS 4
+\fIxxx\fR در صورتی که نماد \fIxxx\fR تعریف شده باشد، فایل(های) این خط را لحاظ می‌کند.
.Sp
\&\-\fIxxx\fR در صورتی که نماد \fIxxx\fR تعریف شده باشد، فایل(های) این خط را مستثنی می‌کند.
.Sp
+!\fIxxx\fR در صورتی که نماد \fIxxx\fR تعریف نشده باشد، فایل(های) این خط را لحاظ می‌کند.
.Sp
\&\-!\fIxxx\fR در صورتی که نماد \fIxxx\fR تعریف نشده باشد، فایل(های) این خط را مستثنی می‌کند.
.Sp
\&\- این فایل را مستثنی می‌کند. برای جلوگیری از پیام‌های کاذب \fI\-\-check\fR استفاده می‌شود.
.RE
.PP
محافظ‌ها از چپ به راست پردازش می‌شوند. آخرین محافظی که مطابقت داشته باشد تعیین می‌کند که آیا فایل لحاظ شود یا خیر. اگر هیچ محافظی مشخص نشده باشد، تنظیم \fI\-\-default\fR لحاظ شدن یا نشدن فایل را تعیین می‌کند.
.PP
اگر هیچ فایل پیکربندی‌ای مشخص نشده باشد، اسکریپت از ورودی استاندارد می‌خواند.
.PP
گزینهٔ \fI\-\-check\fR برای مقایسهٔ فایل مشخصات با سیستم فایل استفاده می‌شود. اگر در فایل مشخصات به فایل‌هایی ارجاع داده شده باشد که وجود ندارند، یا اگر فایل‌هایی در فایل مشخصات درج نشده باشند، هشدارها چاپ می‌شوند. از گزینهٔ \fI\-\-path\fR می‌توان برای مشخص کردن دایرکتوری یا دایرکتوری‌هایی که باید پویش شوند استفاده کرد. دایرکتوری‌های متعدد با نویسهٔ دونقطه (\f(CW\*(C`:\*(C'\fR) از هم جدا می‌شوند. گزینهٔ \fI\-\-prefix\fR مکان فایل‌ها را مشخص می‌کند. همچنین، نحو \fI\-\-path=@<file>\fR می‌تواند برای تعیین فایلی به کار رود که نام‌های فایل از آن خوانده خواهند شد.
.PP
از \fI\-\-list\fR برای فهرست کردن تمام فایل‌ها بدون وابستگی به هیچ قاعده‌ای استفاده کنید. از \fI\-\-invert\-match\fR فقط برای فهرست کردن وصله‌های مستثنی‌شده استفاده کنید. از \fI\-\-with\-guards\fR برای لحاظ کردن تمامی قواعد شمول و استثنا استفاده کنید.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Andreas Gruenbacher <agruen@suse.de>, SUSE Labs