Update documentation for .rcfile.
Add the according sections to the POD documentation. Fix some wording. Signed-off-by: Thomas Hochstein <thh@inter.net>
This commit is contained in:
parent
86c0a10044
commit
227afd47f6
110
yapfaq.pl
110
yapfaq.pl
|
@ -553,7 +553,7 @@ yapfaq - Post Usenet FAQs I<(yet another postfaq)>
|
||||||
|
|
||||||
=head1 SYNOPSIS
|
=head1 SYNOPSIS
|
||||||
|
|
||||||
B<yapfaq> [B<-hvpd>] [B<-t> I<newsgroups> | CONSOLE] [B<-f> I<project name>] [B<-s> I<program>]
|
B<yapfaq> [B<-hvpd>] [B<-t> I<newsgroups> | CONSOLE] [B<-f> I<project name>] [B<-s> I<program>] [B<-c> I<.rc file>]
|
||||||
|
|
||||||
=head1 REQUIREMENTS
|
=head1 REQUIREMENTS
|
||||||
|
|
||||||
|
@ -589,7 +589,8 @@ headers as defined in its config file (by default F<yapfaq.cfg>).
|
||||||
|
|
||||||
F<yapfaq.cfg> consists of one or more blocks, separated by C<=====> on
|
F<yapfaq.cfg> consists of one or more blocks, separated by C<=====> on
|
||||||
a single line, each containing the configuration for one FAQ as a set
|
a single line, each containing the configuration for one FAQ as a set
|
||||||
of definitions in the form of I<param = value>.
|
of definitions in the form of I<param = value>. Everything after a "#"
|
||||||
|
sign is ignored so you may comment your configuration file.
|
||||||
|
|
||||||
=over 4
|
=over 4
|
||||||
|
|
||||||
|
@ -685,7 +686,7 @@ This setting is optional.
|
||||||
|
|
||||||
=back
|
=back
|
||||||
|
|
||||||
=head2 Example configuration file
|
=head3 Example configuration file
|
||||||
|
|
||||||
# name of your project
|
# name of your project
|
||||||
Name = 'testpost'
|
Name = 'testpost'
|
||||||
|
@ -741,12 +742,101 @@ This setting is optional.
|
||||||
MID-Format = '<%n-%m.%y@domain.invalid>'
|
MID-Format = '<%n-%m.%y@domain.invalid>'
|
||||||
Supersede = yes
|
Supersede = yes
|
||||||
|
|
||||||
|
=head3 Status Information
|
||||||
|
|
||||||
Information about the last post and about how to form message IDs for
|
Information about the last post and about how to form message IDs for
|
||||||
posts is stored in a file named F<I<project name>.cfg> which will be
|
posts is stored in a file named F<I<project name>.cfg> which will be
|
||||||
generated if it does not exist. Each of those status files will
|
generated if it does not exist. Each of those status files will
|
||||||
contain two lines, the first being the date of the last time the FAQ
|
contain two lines, the first being the date of the last time the FAQ
|
||||||
was posted and the second being the message ID of that incarnation.
|
was posted and the second being the message ID of that incarnation.
|
||||||
|
|
||||||
|
=head2 Runtime Configuration
|
||||||
|
|
||||||
|
Apart from configuring which FAQ(s) to post you may (re)set some
|
||||||
|
runtime configuration variables via the .rcfile (by default
|
||||||
|
F<.yapfaqrc>). F<.yapfaqrc> must contain one definition in the form of
|
||||||
|
I<param = value> on each line; everything after a "#" sign is ignored.
|
||||||
|
|
||||||
|
If you omit some settings they will be set to default values hardcoded
|
||||||
|
in F<yapfaq.pl>.
|
||||||
|
|
||||||
|
B<Please note that all parameter names are case-sensitive!>
|
||||||
|
|
||||||
|
=over 4
|
||||||
|
|
||||||
|
=item B<NNTPServer> = I<NNTP server> (mandatory)
|
||||||
|
|
||||||
|
Host name of the NNTP server to post to. Must be set (or omitted; the
|
||||||
|
default is "localhost"); if set to en empty string, B<yapfaq> falls
|
||||||
|
back to Perl's build-in defaults (contents of environment variables
|
||||||
|
NNTPSERVER and NEWSHOST; if not set, default from Net::Config; if not
|
||||||
|
set, "news" is used).
|
||||||
|
|
||||||
|
=item B<NNTPUser> = I<user name> (optional)
|
||||||
|
|
||||||
|
User name used for authentication with the NNTP server (I<AUTHINFO
|
||||||
|
USER>).
|
||||||
|
|
||||||
|
This setting is optional; if it is not set, I<NNTPPass> is ignored and
|
||||||
|
no authentication is tried.
|
||||||
|
|
||||||
|
=item B<NNTPPass> = I<password> (optional)
|
||||||
|
|
||||||
|
Password used for authentication with the NNTP server (I<AUTHINFO
|
||||||
|
PASS>).
|
||||||
|
|
||||||
|
This setting is optional; it must be set if I<NNTPUser> is present.
|
||||||
|
|
||||||
|
=item B<Sender> = I<Sender header> (optional)
|
||||||
|
|
||||||
|
The Sender header that will be added to every posted message.
|
||||||
|
|
||||||
|
This setting is optional.
|
||||||
|
|
||||||
|
=item B<ConfigFile> = I<configuration file> (mandatory)
|
||||||
|
|
||||||
|
The configuration file defining the FAQ(s) to post. Must be set (or
|
||||||
|
omitted; the default is "yapfaq.cfg").
|
||||||
|
|
||||||
|
=item B<UsePGP> = I<whether to add a digital signature> (optional)
|
||||||
|
|
||||||
|
Boolean value (0 or 1) controlling whether the FAQs will get digitally
|
||||||
|
signed via an X-PGP-Sig header.
|
||||||
|
|
||||||
|
This setting is optional; the default is 0.
|
||||||
|
|
||||||
|
If you have set I<UsePGP> to 1, you must also supply the necessary
|
||||||
|
information on your PGP oder GPG installation; please refer to the
|
||||||
|
sample F<.yapfaqrc> file (see below) for more information on this
|
||||||
|
topic.
|
||||||
|
|
||||||
|
=back
|
||||||
|
|
||||||
|
=head3 Example runtime configuration file
|
||||||
|
|
||||||
|
NNTPServer = 'localhost'
|
||||||
|
NNTPUser = ''
|
||||||
|
NNTPPass = ''
|
||||||
|
Sender = ''
|
||||||
|
ConfigFile = 'yapfaq.cfg'
|
||||||
|
UsePGP = 0
|
||||||
|
|
||||||
|
################################## PGP-Config #################################
|
||||||
|
pgp = '/usr/bin/pgp' # path to pgp
|
||||||
|
PGPVersion = '2' # Use 2 for 2.X 5 for PGP > 2.X and GPG for GPG
|
||||||
|
PGPSigner = '' # sign as who?
|
||||||
|
PGPPass = '' # pgp2 only
|
||||||
|
PathtoPGPPass = '' # pgp2 pgp5 and gpg
|
||||||
|
pgpbegin = '-----BEGIN PGP SIGNATURE-----' # Begin of PGP-Signature
|
||||||
|
pgpend = '-----END PGP SIGNATURE-----' # End of PGP-Signature
|
||||||
|
pgptmpf = 'pgptmp' # temporary file for PGP.
|
||||||
|
pgpheader = 'X-PGP-Sig'
|
||||||
|
|
||||||
|
=head3 Using more than one runtime configuration
|
||||||
|
|
||||||
|
You may use more than one runtime configuration file with the B<-c>
|
||||||
|
option (see below).
|
||||||
|
|
||||||
=head1 OPTIONS
|
=head1 OPTIONS
|
||||||
|
|
||||||
=over 3
|
=over 3
|
||||||
|
@ -802,6 +892,13 @@ Instead of posting the article(s) to Usenet pipe them to the external
|
||||||
I<program> on STDIN (which may post the article(s) then). A return
|
I<program> on STDIN (which may post the article(s) then). A return
|
||||||
value of 0 will be considered success.
|
value of 0 will be considered success.
|
||||||
|
|
||||||
|
=item B<-c> I<.rc file>
|
||||||
|
|
||||||
|
Load another runtime configuration file (.rc file) than F<.yaofaq.rc>.
|
||||||
|
|
||||||
|
You may for example define another usenet server to post your FAQ(s)
|
||||||
|
to or load another configuration file defining (an)other FAQ(s).
|
||||||
|
|
||||||
=back
|
=back
|
||||||
|
|
||||||
=head1 EXAMPLES
|
=head1 EXAMPLES
|
||||||
|
@ -836,6 +933,10 @@ There are no special environment variables used by B<yapfaq>.
|
||||||
|
|
||||||
The script itself.
|
The script itself.
|
||||||
|
|
||||||
|
=item F<.yapfaqrc>
|
||||||
|
|
||||||
|
Runtime configuration file for B<yapfaq>.
|
||||||
|
|
||||||
=item F<yapfaq.cfg>
|
=item F<yapfaq.cfg>
|
||||||
|
|
||||||
Configuration file for B<yapfaq>.
|
Configuration file for B<yapfaq>.
|
||||||
|
@ -864,10 +965,9 @@ version of this program.
|
||||||
|
|
||||||
Thomas Hochstein <thh@inter.net>
|
Thomas Hochstein <thh@inter.net>
|
||||||
|
|
||||||
Original author (until version 0.5b from 2003):
|
Original author (up to version 0.5b, dating from 2003):
|
||||||
Marc Brockschmidt <marc@marcbrockschmidt.de>
|
Marc Brockschmidt <marc@marcbrockschmidt.de>
|
||||||
|
|
||||||
|
|
||||||
=head1 COPYRIGHT AND LICENSE
|
=head1 COPYRIGHT AND LICENSE
|
||||||
|
|
||||||
Copyright (c) 2003 Marc Brockschmidt <marc@marcbrockschmidt.de>
|
Copyright (c) 2003 Marc Brockschmidt <marc@marcbrockschmidt.de>
|
||||||
|
|
Loading…
Reference in a new issue