.\" Man page for man-recode
.\"
.\" Copyright (C) 2019 Colin Watson <cjwatson@debian.org>
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file docs/COPYING.GPLv2 that comes with the
.\" man-db distribution.
.pc
.TH MAN-RECODE 1 "2025-05-02" "2.13.1" "Manual pager utils"
.SH "نام (NAME)"
man\-recode \- تبدیل کدگذاری صفحات راهنما به یک کدگذاری دیگر
.SH "خلاصه دستور (SYNOPSIS)"
.B man-recode
.B \-t
.I to-code
{\|\fB\-\-suffix=\fIsuffix\/\fR\||\|\c
.BR \-\-in\-place \|}
.RB [\| \-dqhV \|]
.RI [\| filename \|]
.SH "توضیحات (DESCRIPTION)"
دستور
.B man-recode
چندین صفحهٔ راهنما را از یک کدگذاری به کدگذاری دیگر تبدیل می‌کند و کدگذاری ورودی مناسب برای هر یک را حدس می‌زند.
این ابزار هنگام بازکدگذاری دائمی صفحاتی که با مجموعه‌نویسه‌های قدیمی نوشته شده‌اند، یا در سامانه‌های ساختی که باید مجموعه‌ای از صفحات را برای نصب به یک کدگذاری مشترک واحد (معمولاً
.BR UTF\-8 )
تبدیل کنند، مفید است.
هنگام تبدیل تعداد زیادی صفحهٔ راهنما، این برنامه بسیار سریع‌تر از اجرای
.B man \-\-recode
یا
.B manconv
روی تک‌تک صفحات است.
.PP
اگر اعلان کدگذاری در سطر نخست یک صفحهٔ راهنما یافت شود، از آن اعلان به عنوان کدگذاری ورودی آن صفحه استفاده می‌شود.
در غیر این صورت، کدگذاری ورودی بر پایهٔ نام فایل حدس زده می‌شود.
.PP
اعلان‌های کدگذاری ساختار زیر را دارند:
.PP
.RS
.nf
\&\(aq\e" \-*\- coding: UTF\-8 \-*\-
.fi
.RE
.PP
یا (در صورتی که پیش‌پردازنده‌های صفحهٔ راهنما نیز باید اعلان شوند):
.PP
.RS
.nf
\&\(aq\e" t \-*\- coding: ISO\-8859\-1 \-*\-
.fi
.RE
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-t\fR \fIencoding\/\fR, \fB\-\-to\-code=\fIencoding\fR
تبدیل صفحات راهنما به
.IR encoding .
.TP
\fB\-\-suffix=\fIsuffix\fR
تشکیل نام هر فایل خروجی با افزودن
.I suffix
به نام فایل ورودی، پس از حذف هرگونه پسوند فشرده‌سازی.
.TP
.B \-\-in\-place
بازنویسی هر فایل ورودی با خروجی، پس از حذف هرگونه پسوند فشرده‌سازی.
.TP
.BR \-q ", " \-\-quiet
عدم صدور پیام‌های خطا هنگامی که صفحه قابل تبدیل نباشد.
.TP
.BR \-d ", " \-\-debug
چاپ اطلاعات اشکال‌زدایی.
.TP
.BR \-h ", " \-\-help
چاپ پیام راهنما و خروج.
.TP
.BR \-V ", " \-\-version
نمایش اطلاعات نسخه.
.SH "همچنین ببینید (SEE ALSO)"
.IR iconv (1),
.IR man (1),
.IR manconv (1)
.SH "گزارش اشکال (REPORTING BUGS)"
https://gitlab.com/man-db/man-db/\-/issues
.br
https://savannah.nongnu.org/bugs/?group=man\-db
.SH "نویسندگان (AUTHORS)"
.nf
Colin Watson (cjwatson@debian.org).
.fi