.\" -*- 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 "OVERCHAN 8"
.TH OVERCHAN 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)"
overchan \- به‌روزرسانی دسته‌ای پایگاه‌داده چکیده (overview) در INN
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBoverchan\fR [\fIفایل\fR ...]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \&\fBoverchan\fR داده‌های چکیده (overview) را از فایل‌های مشخص‌شده، یا در صورت مشخص نشدن هیچ فایلی از ورودی استاندارد می‌خواند و آن داده‌ها را در پایگاه‌داده چکیده INN می‌نویسد. (نام فایل \f(CW\*(C`\-\*(C'\fR نیز به معنای خواندن داده‌ها از ورودی استاندارد است.)
.PP
به‌طور معمول، داده‌های چکیده هنگام پذیرفته شدن مقاله‌ها توسط \fBinnd\fR ذخیره می‌شوند. با این حال، به منظور بهبود کارایی، گاهی اوقات سودمند است که فرآیندی جداگانه داده‌های چکیده را بنویسد. برای انجام این کار، متغیر \&\fIuseoverchan\fR را در فایل \fIinn.conf\fR روی true تنظیم کنید تا به \fBinnd\fR اعلام شود داده‌های چکیده را مستقیماً ننویسد، و سپس یک کانال \fBoverchan\fR را به \&\fInewsfeeds\fR اضافه نمایید:
.PP
.Vb 1
\&    overview!:*:Tc,WnteO:<pathbin>/overchan
.Ve
.PP
که در آن <pathbin> همان متغیر \fIpathbin\fR در \fIinn.conf\fR است. علاوه بر این، می‌توان از \fBoverchan\fR برای بارگذاری انبوه داده‌های چکیده از فایل‌های دسته‌ای با قالب‌بندی مناسب (مانند فایل‌های سرریز یک کانال \fBoverchan\fR) استفاده کرد.
.PP
هر خط از ورودی باید دارای ساختار زیر باشد:
.PP
.Vb 1
\&    <token> <arrived> <expires> <data>
.Ve
.PP
که در آن <token> نشانه (token) رابط برنامه‌نویسی ذخیره‌سازی مقاله در قالب متنی (محصور میان نویسه‌های \f(CW\*(C`@\*(C'\fR) است، <arrived> برچسب زمانی رسیدن مقاله به ثانیه از مبدأ زمان یونیکس (epoch) است، <expires> زمان انقضای مقاله به ثانیه از مبدأ زمان یونیکس (epoch) یا 0 در صورت عدم وجود است، و <data> داده‌های چکیده جداشده با نویسه تب (tab) است. هر یک از این فیلدها باید با یک فاصله تکی (space) از هم جدا شوند.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
نوشته‌شده توسط راب رابرتسون (Rob Robertson) <rob@violet.berkeley.edu> و ریچ سالز (Rich $alz)
<rsalz@uunet.uu.net> برای InterNetNews. صفحه راهنما در قالب POD توسط راس آلبری (Russ
Allbery) <eagle@eyrie.org> بازنویسی شده است.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBinn.conf\fR(5)، \fBinnd\fR(8)، \fBnewsfeeds\fR(5)