.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "PRUNEHISTORY 8"
.TH PRUNEHISTORY 8 2022-07-10 "INN 2.7.4" "InterNetNews Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
prunehistory \- پاکسازی و هرس ورودی‌های فایل تاریخچه در INN
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBprunehistory\fR [\fB\-p\fR] [\fB\-f\fR \fIfilename\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBprunehistory\fR
یک فایل متنی با قالب
\&\fBhistory\fR(5)
را تغییر می‌دهد تا مجموعه‌ای از توکن‌ها را از آن «حذف» کند. این توکن‌ها با رونویسی فضاهای خالی (فاصله) روی آن‌ها حذف می‌شوند، به گونه‌ای که اندازه و موقعیت ورودی‌های بعدی تغییر نکند. این کار اثری شبیه به منقضی کردن مقالات دارد، به این ترتیب که همچنان در پایگاه داده تاریخچه از آن‌ها یاد می‌شود اما قابل بازیابی نخواهند بود.
.PP
دستور
\&\fBprunehistory\fR
ورودی استاندارد را می‌خواند. این ورودی به صورت مجموعه‌ای از خطوط دریافت می‌شود. خطوط خالی و خطوطی که با علامت هش (\f(CW\*(C`#\*(C'\fR) آغاز می‌شوند نادیده گرفته می‌شوند. تمامی خطوط دیگر باید شامل یک شناسه پیام (message-ID) و به دنبال آن صفر یا چند فیلد دیگر (که نادیده گرفته می‌شوند) باشند. از شناسه پیام به عنوان کلید
\&\fIdbz\fR
برای به دست آوردن موقعیت (offset) در فایل متنی استفاده می‌شود. از آنجا که
\&\fBinnd\fR
تنها اطلاعات را به انتهای فایل متنی اضافه می‌کند،
\&\fBprunehistory\fR
نیازی به هیچ‌گونه تعامل با آن ندارد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-p\fR 4
.IX Item "-p"
دستور
\&\fBprunehistory\fR
در حالت عادی در صورت وجود خطوطی که از قالب درست پیروی نمی‌کنند، پیام خطا می‌دهد. اگر گزینه
\&\fB\-p\fR
استفاده شود، برنامه خطوط نامعتبر را بدون ایجاد خطا در خروجی استاندارد خود چاپ می‌کند. (خطوط خالی و خطوط توضیحات نیز بدون تغییر عبور داده می‌شوند.)
.IP "\fB\-f\fR \fIfilename\fR" 4
.IX Item "-f filename"
نام پیش‌فرض فایل
\&\fIhistory\fR
برابر با
\&\fIpathdb\fR/history
است؛ برای مشخص کردن نامی متفاوت، از گزینه
\&\fB\-f\fR
استفاده کنید.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
نوشته‌شده توسط Rich $alz <rsalz@uunet.uu.net> برای InterNetNews. تبدیل به POD توسط Julien Elie.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBhistory\fR(5),
\&\fBinnd\fR(8),
\&\fBlibinn_dbz\fR(3).