'\" t
.TH mkmanifest 1 "14Jun25" mtools-4.0.49
.SH "نام (NAME)"
mkmanifest \- ایجاد فهرستی از نام‌های فایل و معادل 8+3 آن‌ها در DOS
'\" t
.de TQ
.br
.ns
.TP \\$1
..

.tr \(is'
.tr \(if`
.tr \(pd"

.SH "یادداشت هشدار (WARNING NOTE)"
این صفحه راهنما به‌طور خودکار از مستندات texinfo برنامه mtools تولید شده است و ممکن است کاملاً دقیق یا کامل نباشد. برای جزئیات بیشتر به انتهای این صفحه راهنما مراجعه کنید.
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fR\&\f(CWmkmanifest\fR برای ایجاد یک اسکریپت شل (فهرست بسته‌بندی یا packing list) جهت بازیابی نام‌های اصلی فایل‌های Unix استفاده می‌شود. نحو آن به این صورت است:
.PP
\&\fR\&\f(CWmkmanifest\fR [ \fIfiles\fR ]
.PP
دستور \&\fR\&\f(CWMkmanifest\fR یک اسکریپت شل ایجاد می‌کند که به بازیابی نام فایل‌های Unix که به دلیل محدودیت‌های نام‌گذاری MS-DOS مخدوش یا کوتاه شده‌اند کمک می‌نماید. نام فایل‌ها در MS-DOS به نام‌های ۸ نویسه‌ای، پسوندهای ۳ نویسه‌ای، فقط حروف بزرگ، بدون نام دستگاه‌ها (device names) و بدون نویسه‌های غیرمجاز محدود می‌شوند.
.PP
برنامه mkmanifest با روش‌های مورد استفاده در \&\fR\&\f(CWpcomm\fR، \&\fR\&\f(CWarc\fR و \&\fR\&\f(CWmtools\fR برای تغییر نام‌های صحیح فایل‌های Unix به گونه‌ای که با محدودیت‌های MS-DOS سازگار شوند، سازگاری دارد. این دستور تنها زمانی کاربرد دارد که سیستم مقصدی که دیسکت را می‌خواند، نتواند نام‌های طولانی VFAT را پردازش کند.
.PP
.SH "مثال‌ها (EXAMPLES)"
فرض کنید می‌خواهید فایل‌های Unix زیر را به یک دیسکت MS-DOS کپی کنید (با استفاده از دستور \&\fR\&\f(CWmcopy\fR).
.PP
 
.nf
.ft 3
.in +0.3i
  very_long_name
  2.many.dots
  illegal:
  good.c
  prn.dev
  Capital
.fi
.in -0.3i
.ft R
.PP
 
\&\fR
.PP
دستور \&\fR\&\f(CWASCII\fR
نام‌ها را به این صورت تبدیل می‌کند:
.PP
 
.nf
.ft 3
.in +0.3i
  very_lon
  2xmany.dot
  illegalx
  good.c
  xprn.dev
  capital
.fi
.in -0.3i
.ft R
.PP
 
\&\fR
.PP
دستور:
 
.nf
.ft 3
.in +0.3i
mkmanifest very_long_name 2.many.dots illegal: good.c prn.dev Capital >manifest
.fi
.in -0.3i
.ft R
.PP
 
\&\fRخروجی زیر را تولید خواهد کرد:
 
.nf
.ft 3
.in +0.3i
  mv very_lon very_long_name
  mv 2xmany.dot 2.many.dots
  mv illegalx illegal:
  mv xprn.dev prn.dev
  mv capital Capital
.fi
.in -0.3i
.ft R
.PP
 
\&\fR
.PP
توجه داشته باشید که «good.c» نیازی به هیچ‌گونه تبدیلی نداشت، بنابراین در خروجی ظاهر نشد.
.PP
فرض کنید این فایل‌ها را از دیسکت به یک سیستم Unix دیگر کپی کرده‌اید و اکنون می‌خواهید فایل‌ها به نام‌های اصلی‌شان بازگردند. اگر فایل «manifest» (خروجی ضبط‌شده در بالا) به همراه آن فایل‌ها ارسال شده باشد، می‌توان از آن برای بازگرداندن نام فایل‌ها استفاده کرد.
.PP
.SH "گزارش باگ‌ها (BUGS)"
.PP
نام‌های کوتاهی که توسط \fR\&\f(CWmkmanifest\fR تولید می‌شوند از قرارداد قدیمی (از mtools-2.0.7) پیروی می‌کنند و نه از روش Windows 95 و mtools-3.0.
.PP
.SH "همچنین ببینید (SEE ALSO)"
مستندات texinfo برنامه Mtools
.SH "مشاهده مستندات texi (VIEWING THE TEXI DOC)"
این صفحه راهنما به‌طور خودکار از مستندات texinfo برنامه mtools تولید شده است. با این حال، این فرایند فقط تقریبی است و برخی موارد، مانند ارجاعات متقابل، پاورقی‌ها و نمایه‌ها در طول این فرایند تبدیل از بین رفته‌اند. در واقع، این موارد نمایش مناسبی در قالب صفحه راهنما ندارند. علاوه بر این، تمام اطلاعات به نسخه صفحه راهنما منتقل نشده است. بنابراین اکیداً توصیه می‌شود از مستندات اصلی texinfo استفاده کنید. برای دستورالعمل‌های نحوه مشاهده مستندات texinfo، انتهای این صفحه راهنما را ببینید.
.TP
* \ \ 
برای تولید یک نسخه قابل چاپ از مستندات texinfo، دستورهای زیر را اجرا کنید:
 
.nf
.ft 3
.in +0.3i
    ./configure; make dvi; dvips mtools.dvi
.fi
.in -0.3i
.ft R
.PP
 
\&\fR
.TP
* \ \ 
برای تولید یک نسخه html، اجرا کنید:
 
.nf
.ft 3
.in +0.3i
    ./configure; make html
.fi
.in -0.3i
.ft R
.PP
 
\&\fRیک نسخه آماده html را می‌توان در آدرس زیر یافت:
\&\fR\&\f(CW\(ifhttp://www.gnu.org/software/mtools/manual/mtools.html\(is\fR
.TP
* \ \ 
برای تولید یک نسخه info (قابل مرور با استفاده از حالت info در emacs)، اجرا کنید:
 
.nf
.ft 3
.in +0.3i
    ./configure; make info
.fi
.in -0.3i
.ft R
.PP
 
\&\fR
.PP
مستندات texinfo هنگام چاپ یا به صورت html زیباترین نمایش را دارند. در واقع، در نسخه info خواندن برخی از مثال‌ها به دلیل قواعد نقل‌قول به‌کار‌رفته در info دشوار است.
.PP