.\" 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 سازگار است.
این ابزار نام، مسیر اصلی، تاریخ حذف و مجوزهای دسترسی هر فایل منتقل‌شده به سطل زباله را به خاطر می‌سپارد.
.PP
فایل‌های حذف‌شده از پارتیشن خانه (home) در یکی از دو مسیر
.B $XDG_DATA_HOME/Trash
یا
.B ~/.local/share/Trash
(در صورتی که
.B $XDG_DATA_HOME
تعریف نشده یا خالی باشد) قرار خواهند گرفت.
.PP
فایل‌های حذف‌شده از سایر پارتیشن‌ها در یکی از این دو مکان قرار خواهند گرفت:
.PP
.nf
 \- $top_dir/.Trash/$uid
 \- $top_dir/.Trash-$uid
.fi
.PP
که در آن:
.IP "\\- $top_dir"
نقطه اتصال (mount point) پارتیشنی است که فایل حذف‌شونده در آن قرار دارد.
.IP "\\- $uid"
شناسه عددی کاربری است که عمل حذف را انجام می‌دهد.
.PP
حالت اول یعنی
.B $top_dir/.Trash/$uid
تنها زمانی کار می‌کند که بیت چسبان (sticky bit) روی دایرکتوری
.B .Trash
تنظیم شده باشد. حالت دوم زمانی استفاده می‌شود که استفاده از حالت اول امکان‌پذیر نباشد.

.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)، نسخهٔ ۲ یا بالاتر منتشر شده‌اند.