chiark / gitweb /
wip manpage
[inn-innduct.git] / doc / man / cvtbatch.8
1 .\" $Revision: 5909 $
2 .TH CVTBATCH 8
3 .SH NAME
4 cvtbatch \- convert Usenet batch file to INN format
5 .SH SYNOPSIS
6 .I cvtbatch
7 [
8 .BI \-w " items"
9 ]
10 .SH DESCRIPTION
11 .I Cvtbatch
12 reads standard input as a sequence of lines, converts each line, and
13 writes it to standard output.
14 It is used to convert simple batchfiles that contain just the article
15 name to INN batchfiles that contain additional information about each
16 article.
17 .PP
18 Each line is taken as a storage API token indicating a Usenet article.
19 (Only the first word of each line is parsed; anything following
20 whitespace is ignored.  Lines not starting with a valid token are also
21 silently ignored.)
22 .PP
23 If the input file consists of a series of Message-ID's, then use
24 .IR grephistory (1)
25 with the `\fB`\-s\fP'' flag piped into
26 .IR cvtbatch .
27 .SH OPTIONS
28 .TP
29 .B \-w
30 The `\fB`\-w\fP'' flag specifies how each output line should be written.
31 The items for this flag should be chosen from the ``W'' flag items as
32 specified in
33 .IR newsfeeds (5).
34 They may be chosen from the following set:
35 .PP
36 .RS
37 .nf
38         b       Size of article in bytes
39         f       full pathname of article
40         m       article message-id
41         n       relative pathname of article
42 .fi
43 .RE
44 .SH HISTORY
45 Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.
46 .de R$
47 This is revision \\$3, dated \\$4.
48 ..
49 .R$ $Id: cvtbatch.8 5909 2002-12-03 05:17:18Z vinocur $
50 .SH "SEE ALSO"
51 grephistory(1),
52 inn.conf(5),
53 newsfeeds(5).