.\" Copyright (C) 2018  Free Software Foundation, Inc.
.\" You may distribute this file under the terms of the GNU Free
.\" Documentation License.
.Dd December 17, 2018
.Os GNU
.Dt DEJAGNU 1 URM
.Sh "نام (NAME)"
.Nm dejagnu
.Nd اجراکننده دستورات کمکی DejaGnu
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm dejagnu
.Ao Ar command Ac
.Op Fl -help \*(Ba Ar options...
.Nm
.Fl -help
.Nm
.Fl -version
.Sh "توضیحات (DESCRIPTION)"
دستور
.Nm
اسکریپتی را پیدا می‌کند که
.Ar command
درخواست‌شده را پیاده‌سازی کرده است، در صورت وجود چندین پیاده‌سازی بر اساس یک فهرست داخلی ثابت یکی را انتخاب می‌نماید و دستور را اجرا می‌کند.
.Sh "گزینه‌ها (OPTIONS)"
.Bl -tag -width ".Fl -version"
.It Fl -help
چاپ پیام راهنما به‌جای اجرای یک دستور.
اگر دستوری داده نشود، نحوه استفاده مختصر از خود
.Nm
را چاپ می‌کند.
.It Fl V , -version
چاپ بنر نگارش برای خود اجراکننده شامل نگارش DejaGnu.
هر دستور داده‌شده نادیده گرفته می‌شود.
.It Fl v , -verbose
ارائه خروجی اضافی که عملکرد خود اجراکننده
.Nm
را شرح می‌دهد.
این گزینه به دستور فراخوانی‌شده نیز منتقل می‌شود.
.El
.Pp
تمام آرگومان‌های بعد از نام دستور به دستور فراخوانی‌شده منتقل می‌شوند.
.Sh "محیط (ENVIRONMENT)"
.Bl -tag -width ".Ev DEJAGNULIBS"
.It Ev DEJAGNULIBS
در صورت تنظیم، مکان کتابخانه DejaGnu در فایل‌سیستم.
در صورتی که
.Ev DEJAGNULIBS
تنظیم شده باشد، جستجوی شرح داده شده در
.Sx FILES
انجام نمی‌شود.
.It Ev AWK
نام کامل فایل برای مفسر Awk که ممکن است در واقع GNU Awk باشد یا نباشد.
در صورت عدم تنظیم، متغیر
.Ev PATH
برای یافتن برنامه
.Nm awk
جستجو خواهد شد.
اگر مفسر Awk در واقع GNU Awk باشد، در صورت استفاده از پیاده‌سازی Awk گزینه
.Fl -posix
به آن داده خواهد شد.
.It Ev GAWK
نام کامل فایل برای GNU Awk. در صورت عدم تنظیم، متغیر
.Ev PATH
برای یافتن برنامه
.Nm gawk
جستجو خواهد شد.
.It Ev BASH
نام کامل فایل برای GNU Bash. در صورت عدم تنظیم، متغیر
.Ev PATH
برای یافتن برنامه
.Nm bash
جستجو خواهد شد.
توجه داشته باشید که خود Bash این متغیر را تنظیم می‌کند، حتی زمانی که به‌صورت
.Nm sh
اجرا شود یا زمانی که در حال اجرای یک اسکریپت باشد.
.It Ev EXPECT
نام کامل فایل برای Expect که یک مفسر Tcl با افزونه Expect از پیش بارگذاری‌شده است. در صورت عدم تنظیم، متغیر
.Ev PATH
برای یافتن برنامه
.Nm expect
جستجو خواهد شد. توجه داشته باشید که هسته DejaGnu با Expect نوشته شده است، بنابراین این مفسر همیشه باید در دسترس باشد.
.It Ev TCLSH
نام کامل فایل برای یک مفسر Tcl. در صورت عدم تنظیم، متغیر
.Ev PATH
برای یافتن برنامه
.Nm tclsh
جستجو خواهد شد.
.El
.Pp
توجه داشته باشید که GNU Awk یک ابرمجموعه از Awk و Expect یک ابرمجموعه از Tcl در نظر گرفته می‌شوند، که اجازه می‌دهد از اولی برای اجرای اسکریپت‌های نوشته‌شده برای دومی استفاده شود.
این بدان معنی است که در حالی که برنامه‌های Awk عموماً با غیرفعال بودن افزونه‌های GNU با استفاده از گزینه
.Fl -posix
در GNU Awk اجرا می‌شوند، برنامه‌های Tcl ممکن است با
.Nm tclsh
یا
.Nm expect
اجرا شوند و باید بر همین اساس نوشته شوند.
.Sh "فایل‌ها (FILES)"
.Bl -tag -width ".Pa $DEJAGNULIBS/commands"
.It Pa $DEJAGNULIBS/commands
اگر
.Ev DEJAGNULIBS
تنظیم شده باشد، انتظار می‌رود تمام اسکریپت‌های دستوری در این پوشه باشند.
.El
در غیر این صورت، اولین پوشه‌ای که واقعاً در فهرست زیر وجود داشته باشد استفاده می‌شود، جایی که
.Pa @bindir@
نمایانگر پوشه حاوی خود
.Nm
است.
.Bl -item -offset indent
.It
.Pa @bindir@/../share/dejagnu/commands
.It
.Pa @bindir@/../../share/dejagnu/commands
.It
.Pa /usr/share/dejagnu/commands
.It
.Pa /usr/local/share/dejagnu/commands
.El
.\" .Sh EXAMPLES
.Sh "همچنین ببینید (SEE ALSO)"
مستندات کامل DejaGnu در قالب راهنمای Texinfo نگهداری می‌شود.
اگر برنامه
.Nm info
به‌درستی بر روی سیستم شما نصب شده باشد، دستور
.Li info dejagnu
باید به شما امکان دسترسی به راهنمای کامل را بدهد.
.Sh "نویسندگان (AUTHORS)"
.An "Jacob Bachmeyer"
.Sh "اشکالات (BUGS)"
نام دستور باید به دلیل محدودیت‌های شل، قبل از تمام آرگومان‌های دیگر قرار گیرد.
.\"  LocalWords:  Dt URM Nm DejaGnu Ao DEJAGNULIBS DejaGnu's Sx awk posix tclsh
.\"  LocalWords:  tcl superset bindir usr Texinfo