.TH CLEAR 1 "" "ncurses 6.4" "دستورات کاربر"
.de NS
.ie n  .sp
.el    .sp .5
.ie n  .in +4
.el    .in +2
.nf
.ft C
..
.de NE
.fi
.ft R
.ie n  .in -4
.el    .in -2
..
.ie \n(.g .ds `` \(lq
.el       .ds `` ``
.ie \n(.g .ds '' \(rq
.el       .ds '' ''
.de bP
.ie n  .IP \(bu 4
.el    .IP \(bu 2
..
.ds n 5
.SH "نام (NAME)"
\fBclear\fP \- پاک کردن صفحه ترمینال
.SH "خلاصه دستور (SYNOPSIS)"
\fBclear\fR [\fB\-T\fItype\fR] [\fB\-V\fR] [\fB\-x\fR]
.br
.SH "توضیحات (DESCRIPTION)"
دستور \fBclear\fP در صورت امکان صفحه ترمینال شما را پاک می‌کند،
از جمله بافر پیمایش به عقب (scrollback buffer) ترمینال
(اگر قابلیت گسترش‌یافته \*(``E3\*('' تعریف شده باشد).
دستور \fBclear\fP نوع ترمینال را در محیط از طریق متغیر محیطی
\fBTERM\fP بررسی کرده و سپس در پایگاه داده
\fBterminfo\fP جستجو می‌کند تا نحوه پاک کردن صفحه را تعیین نماید.
.PP
دستور \fBclear\fP در خروجی استاندارد می‌نویسد.
می‌توانید خروجی استاندارد را به یک فایل تغییر مسیر دهید (که از پاک شدن واقعی صفحه توسط
\fBclear\fP جلوگیری می‌کند)،
و سپس با اجرای دستور \fBcat\fP روی آن فایل، صفحه را در آن لحظه پاک کنید.
.SH "گزینه‌ها (OPTIONS)"
.PP
.TP 5
.B \-T \fItype\fP
نوع ترمینال (\fItype\fP) را مشخص می‌کند.
به‌طور معمول این گزینه غیرضروری است، زیرا مقدار پیش‌فرض از متغیر محیطی
\fBTERM\fP گرفته می‌شود.
اگر \fB\-T\fP مشخص شود، متغیرهای پوسته
\fBLINES\fP و \fBCOLUMNS\fP نیز نادیده گرفته خواهند شد.
.TP
.B \-V
نسخه ncurses استفاده‌شده در این برنامه را گزارش داده و خارج می‌شود.
.TP
.B \-x
تلاش برای پاک کردن بافر پیمایش به عقب ترمینال با استفاده از قابلیت گسترش‌یافته
\*(``E3\*('' را انجام ندهد.
.SH "تاریخچه (HISTORY)"
دستور \fBclear\fP نخستین بار در 2.79BSD مورخ ۲۴ فوریه ۱۹۷۹ ظاهر شد.
سپس در ویرایش هشتم یونیکس (1985) ارائه گردید.
.PP
شرکت AT&T برنامه دیگری از BSD به نام (\fBtset\fP) را برای ساخت دستور جدیدی
(\fBtput\fP) اقتباس کرد و از آن برای جایگزینی دستور \fBclear\fP با یک اسکریپت پوسته که
\fBtput clear\fP را فراخوانی می‌کرد استفاده نمود، مانند:
.NS
/usr/bin/tput ${1:+-T$1} clear 2> /dev/null
exit
.NE
.PP
در سال ۱۹۸۹، هنگامی که Keith Bostic دستور \fBtput\fP در BSD را بازبینی کرد تا آن را مشابه \fBtput\fP در AT&T سازد،
یک اسکریپت پوسته برای دستور \fBclear\fP افزود:
.NS
exec tput clear
.NE
.PP
باقی‌مانده اسکریپت در هر مورد یک اطلاعیه حق نشر است.
.PP
دستور \fBclear\fP در ncurses در سال ۱۹۹۵ با اقتباس از دستور اصلی
\fBclear\fP در BSD (البته به همراه terminfo) آغاز شد.
.PP
افزونه \fBE3\fP بعداً ارائه شد:
.bP
در ژوئن ۱۹۹۹، \fBxterm\fP یک افزونه برای توالی کنترلی استاندارد پاک کردن صفحه ارائه داد.
به جای پاک کردن تنها بخش قابل مشاهده صفحه با استفاده از:
.NS
printf '\\033[2J'
.NE
.IP
امکان پاک کردن \fIبافر پیمایش به عقب (scrollback)\fP فراهم شد با:
.NS
printf '\\033[\fB3\fPJ'
.NE
.IP
این مورد در \fIXTerm Control Sequences\fP به عنوان قابلیتی که از \fBxterm\fP سرچشمه گرفته مستند شده است.
.bP
چند توسعه‌دهنده ترمینال دیگر نیز این ویژگی را پذیرفتند، مانند PuTTY در سال ۲۰۰۶.
.bP
در آوریل ۲۰۱۱، یک توسعه‌دهنده Red Hat وصله‌ای برای هسته لینوکس ارسال کرد که درایور کنسول آن را برای انجام همین کار تغییر داد.
تغییر لینوکس، بخشی از انتشار 3.0، نامی از \fBxterm\fP نبرد، اگرچه در گزارش باگ Red Hat (شماره 683733) که منجر به این تغییر شد به آن اشاره شده بود.
.bP
مجدداً، چند توسعه‌دهنده ترمینال دیگر این ویژگی را پذیرفتند.
اما گام مرتبط بعدی تغییر در برنامه \fBclear\fP در سال ۲۰۱۳ برای ادغام این افزونه بود.
.bP
در سال ۲۰۱۳، افزونه \fBE3\fP در دستور \fBtput\fP با پارامتر \*(``clear\*('' نادیده گرفته شده بود.
این مسئله در سال ۲۰۱۶ با سازماندهی مجدد \fBtput\fP جهت به اشتراک‌گذاری منطق آن با \fBclear\fP و \fBtset\fP برطرف شد.
.SH "قابلیت حمل (PORTABILITY)"
نه استاندارد IEEE Std 1003.1/The Open Group Base Specifications Issue 7 (POSIX.1-2008) و نه X/Open Curses Issue 7 هیچ‌کدام دستورات tset یا reset را مستند نمی‌کنند.
.PP
مورد دوم دستور \fBtput\fP را مستند می‌کند که می‌تواند برای جایگزینی این ابزار از طریق اسکریپت پوسته یا با یک نام مستعار (مانند یک پیوند نمادین) جهت اجرای \fBtput\fP به عنوان \fBclear\fP استفاده شود.
.SH "نویسنده (AUTHOR)"
توماس ای. دیکی (Thomas E. Dickey) و بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.).
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش اشکالات به: <https://invisible-island.net/ncurses/ncurses.html>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2018-2021,2022 Thomas E. Dickey
.br
حق نشر \(co 1998-2016,2017 Free Software Foundation, Inc.
.br
مجوز MIT/X11: این نرم‌افزار به صورت رایگان به هر شخصی که نسخه‌ای از آن را دریافت می‌کند واگذار می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
\fBtput\fP(1), \fBterminfo\fP(\*n), \fBxterm\fP(1).
.PP
این سند \fBncurses\fP نسخه 6.4 (وصله 20221231) را توصیف می‌کند.