procbatch

[Julien ÉLIE]

Hi Florian,

> tonight I got around to finishing the procbatch manual page, which
> you'll find attached

Many thanks for this new documentation.  It is very useful to have.
There was a lack in INN.



> I just wondered if we should perhaps check if -s / -t are being used 
> without -c /-m, and report an error (warn? die?) in that case?

Yes, patch applied.



> =head1 SYNOPSIS
> 
> B<procbatch> [B<-e> I<peer>] [B<-d> I<outdir>] [B<-c>] [B<-s>
> I<spooldir>] [B<-m>] [B<-t> I<backlogdir>] [B<-u>] F<batchfile>

I also added B<-h>, B<-q> and B<-v> to this synopsis line.



> If there are non-zero length files, innfeed has dropped some
> articles, and those dropped article files have to be manually
> processed or those articles will never be sent to peers. To do that,
> first make sure that the file doesn't correspond to a currently
> running innfeed, for example by calling C<ctlinnd flush innfeed!>

That has changed since INN 2.5.0; news.daily now takes care of these
dropped files.

Reworded to:
  ...
  Though B<news.daily> automatically process these files
  (invoking B<procbatch>), it is also possible to do that manually.
  ...



> Simply renaming them to peer1 peer2 peer3 in a running innfeed's
> backlog directory will cause them to be picked up automatically by
> innfeed every 10 minutes (the default value of
> I<backlog-newfile-period> in F<innfeed.conf>).

Reworded to "every I<backlog-newfile-period> seconds (as set in
in F<innfeed.conf>)" so that the documentation remains coherent in case
we change the default value.  Better not duplicate it.



> Put the output file(s) into the directory I<outdir> (defaults to F<<
> <spooltemp> >>).

Reworded to "(defaults to I<pathtmp> as set in F<inn.conf>)".

-- 
Julien ÉLIE

« Encore un peu, et cette histoire finira en queue de poisson ! »
  (Astérix)