.\"                                      -*- nroff -*-
.\" icmd.1 - Manual page for icmd, imv and icp.
.\"
.\" Copyright (C) 2001, 2002, 2004, 2005, 2007, 2008 Oskar Liljeblad
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 3 of the License, or
.\" (at your option) any later version.
.\"
.\" This program 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 Library General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
.\"
.TH ICMD "1" "December 1, 2007" "icmd (renameutils)"
.SH "نام (NAME)"
imv, icp \- تغییر نام یا رونوشت از یک فایل با ویرایش نام مقصد با استفاده از GNU readline
.SH "خلاصه دستور (SYNOPSIS)"
.B imv
.RI [ OPTION ] " FILE"...

.B icp
.RI [ OPTION ] " FILE"...
.SH "توضیحات (DESCRIPTION)"
این صفحهٔ راهنما دستورهای \fBicmd\fP، \fBimv\fP و \fBicp\fP را شرح می‌دهد.

\fBimv\fP برنامه‌ای برای تغییر نام تعاملی یک تک‌فایل است.
این کار با فراهم کردن امکان ویرایش درون‌خطی نام فایل با استفاده از GNU readline انجام می‌پذیرد. این روش بسیار شبیه به استفاده از \fBmv\fP(1) و ویرایش نام فایل در خط فرمان شل است، با یک استثنا: نیازی نیست نام فایل دو بار تایپ شود.

برنامهٔ \fBimv\fP به طور معمول \fBmv\fP(1) را برای انجام عمل تغییر نام واقعی اجرا می‌کند.
با این حال، می‌توان این رفتار را با گزینهٔ \-\-command تغییر داد.

دستور \fBicp\fP دقیقاً همانند \fBimv\fP است، با این تفاوت که به جای آن، فایل با استفاده از \fBcp\fP(1) رونوشت می‌شود. هر دوی این دستورها پیوندهای نمادین به دستور \fBicmd\fP هستند.

.SH "گزینه‌ها (OPTIONS)"
این برنامه‌ها از ساختار معمول خط فرمان گنو پیروی می‌کنند که در آن گزینه‌های طولانی با دو خط تیره (\(aq\-\(aq) آغاز می‌شوند.

تمام گزینه‌ها، به‌جز مواردی که در زیر فهرست شده‌اند، به \fBmv\fP، \fBcp\fP یا دستوری که توسط \-\-command مشخص شده ارسال می‌شوند.
.TP
\fB\-\-command\fR=\fIFILE\fR
دستوری را برای اجرا به جای پیش‌فرض \(aqmv\(aq یا \(aqcp\(aq تعیین کنید.
اگر FILE در مسیر فعلی (که با متغیر محیطی $PATH تنظیم می‌شود) یافت شود، نیازی به ذکر نام دایرکتوری FILE نیست.

فرض بر این است که دستور مشخص‌شده، همان گزینه‌های کوتاه و بلندی را می‌پذیرد که مشابه mv یا cp به یک آرگومان نیاز دارند. در غیر این صورت، باید آن گزینه‌ها را با \-\-arg\-options مشخص کنید (زیر را ببینید). همچنین توجه داشته باشید تا زمانی که گزینه و مقدار آن را در قالب یک کلمهٔ واحد تعیین کنید (مانند \(aq\-\-suffix=bak\(aq به جای \(aq\-\-suffix bak\(aq هنگام ارسال گزینه‌های اضافی به mv از طریق imv)، به \-\-arg\-options نیازی نخواهد بود.

.TP
\fB\-\-arg\-options\fR=\fIOPTION\fR[,\fIOPTION\fR...]
مشخص می‌کند کدام گزینه‌ها برای mv، cp یا دستور مشخص‌شده با \-\-command که با کاما از هم جدا شده‌اند، نیاز به آرگومان دارند. گزینه‌ها می‌توانند کوتاه (مانند \-S) یا بلند (مانند \-\-suffix) باشند.
فهرست پیش‌فرض برای mv عبارت است از \(aqt,S,reply,suffix,target-directory\(aq
و فهرست مربوط به cp عبارت است از:
\(aqt,S,Z,no-preserve,sparse,suffix,context,target-directory\(aq.
(این فهرست‌ها برای GNU Coreutils 5.97 کامل و صحیح هستند.)

این فهرست ضروری است زیرا icmd باید بداند کدام یک از آرگومان‌های ارائه‌شده در خط فرمان فایل‌هایی برای انتقال/رونوشت هستند و کدام مقادیر گزینه‌ها (که بعد از یک گزینه می‌آیند) می‌باشند.
.TP
\fB\-\-pass-through\fR
در صورتی که دو یا چند آرگومان مشخص شده باشد، mv/cp (یا دستور مشخص‌شده با \-\-command) را اجرا می‌کند. به این ترتیب imv/icp می‌تواند به عنوان یک نام مستعار (alias) برای mv/cp استفاده شود (زیر را ببینید).
.TP
\fB\-\-help\fR
نمایش خلاصه‌ای از گزینه‌ها.
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه و خروج.
.SH "مثال‌ها (EXAMPLES)"
استفاده از imv به عنوان نام مستعار Bash برای mv:
.br
	\fBalias mv=imv \-\-pass-through \-i\fR
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها به <\fIoskar@osk.mine.nu\fP>.
.SH "همچنین ببینید (SEE ALSO)"
\fBmv\fP(1), \fBcp\fP(1)
.SH "نویسندگان (AUTHORS)"
نویسندهٔ \fBrenameutils\fP و این صفحهٔ راهنما Oskar Liljeblad <\fIoskar@osk.mine.nu\fP> است.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر \(co 2001, 2002, 2004, 2005, 2007, 2008 Oskar Liljeblad

این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر به کد مبدأ مراجعه کنید. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.