.\" Copyright (C) 2008 Steve Stalcup <vorian@ubuntu.com>
.\"
.\" This manual page is free software.  It is distributed under the
.\" terms of the GNU General Public License as published by the Free
.\" Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This manual page is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this manual page; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301
.\" USA
.\"
.TH "TRASH-PUT" "1"

.SH "نام (NAME)"
trash-put \- ابزار سطل زباله در خط فرمان

.SH "خلاصه دستور (SYNOPSIS)"
.B trash
.RI [ OPTION ] 
\&...
.RI [ ARGUMENTS ]
\&...
.br
.B trash-put
.RI [ OPTION ]
\&...
.RI [ ARGUMENTS ]
\&...

.SH "توضیحات (DESCRIPTION)"
.PP
بستهٔ trash-cli یک ابزار سطل زباله برای رابط خط فرمان، منطبق با مشخصات سطل زبالهٔ FreeDesktop.org فراهم می‌کند.
این ابزار نام، مسیر اصلی، تاریخ حذف و مجوزهای دسترسی هر فایل فرستاده‌شده به سطل زباله را به خاطر می‌سپارد.
.br

فایل‌های حذف‌شده از پارتیشن خانه (home) در $XDG_DATA_HOME/Trash
یا در ~/.local/share/Trash/ (اگر $XDG_DATA_HOME تعریف نشده یا خالی باشد) قرار خواهند گرفت.

فایل‌های حذف‌شده از سایر پارتیشن‌ها در یکی از دو مکان زیر خواهند بود:

 - $top_dir/.Trash/$uid
 - $top_dir/.Trash-$uid

که در آن:
 - $top_dir نقطهٔ اتصال (mount point) درایو یا پارتیشن حاوی فایل حذفی است
 - $uid شناسهٔ عددی کاربری است که عمل حذف را انجام می‌دهد

گزینهٔ نخست، یعنی $top_dir/.Trash/$uid، تنها هنگامی کار می‌کند که دایرکتوری .Trash بیت چسبنده (sticky bit) فعال داشته باشد. گزینهٔ دوم زمانی استفاده می‌شود که گزینهٔ اول امکان‌پذیر نباشد.

.SH "آرگومان‌ها (ARGUMENTS)"
.TP
نام فایل‌ها یا دایرکتوری‌ها جهت انتقال به سطل زباله.

.SH "گزینه‌ها (OPTIONS)"
.IP "-f"
.br
نادیده گرفتن بی‌سروصدای فایل‌ها یا دایرکتوری‌هایی که وجود ندارند.
به دلیل وجود چنین آرگومان‌های ناموجودی، هیچ پیام خطایی چاپ نمی‌شود و وضعیت خروج غیرصفر به فراخواننده بازگردانده نخواهد شد.

.IP "-h, --help"
نمایش پیام راهنما و خروج.

.IP "--trash-dir=TRASHDIR"
استفاده از TRASHDIR به‌عنوان پوشهٔ سطل زباله.

.IP "-v, --verbose"
توضیح آنچه در حال انجام است.

.IP "--version"
نمایش شمارهٔ نسخهٔ برنامه و خروج.

.SH "مثال‌ها (EXAMPLES)"
.nf
$ trash-put foo   # foo را به سطل زباله می‌فرستد
.fi

.SH "گزارش باگ‌ها (BUGS)"
لطفاً باگ‌ها را به https://github.com/andreafrancia/trash-cli/issues گزارش دهید

.SH "اگر می‌خواهید قدردانی کنید (IF YOU WANT SAY THANKS)"
توییت بزنید (به @andreafrancia یا #trash-cli) یا ۱، ۲ یا ۵ یورو با استفاده از paypal اهدا کنید:
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=93L6PYT4WBN5A

.SH "دست‌اندرکاران (CREDITS)"
برنامهٔ trash توسط Andrea Francia <andrea@andreafrancia.it> نوشته شده است.
نسخهٔ اصلی trash-empty توسط Einar Orn Olason <eoo@hi.is> مشارکت شد.
نخستین نسخه از صفحات راهنما توسط Steve Stalcup <vorian@ubuntu.com> نوشته شد
و توسط Massimo Cavalleri <submax@tiscalinet.it> اصلاح گردید.

.SH "همچنین ببینید (SEE ALSO)"
trash-list(1),
trash-restore(1),
trash-empty(1),
trash-rm(1),
و مشخصات سطل زبالهٔ FreeDesktop.org در
https://specifications.freedesktop.org/trash-spec/trashspec-1.0.html
.br

هر دو تحت «پروانهٔ عمومی همگانی گنو» (\s-1GNU\s0 General Public License)، نسخهٔ ۲ یا بالاتر منتشر شده‌اند.