schleuder 2.2.1 → 2.2.2

data/lib/schleuder/processor.rb

@@ -123,7 +123,7 @@ module Schleuder
       end
 
       if Schleuder.list.config.receive_encrypted_only && !mail.in_encrypted
-        self.bounce_or_drop 'not encrypted', "This address accepts only messages encrypted with this key:\n#{Schleuder.list.key}", mail, message
+        self.bounce_or_drop 'not encrypted', "This address accepts only messages encrypted with this key:\n#{Schleuder.list.key}", mail
       end
 
       if Schleuder.list.config.receive_authenticated_only && !(mail.from_member || mail.from_admin)

data/lib/schleuder/schleuder_config.rb

@@ -57,16 +57,16 @@ module Schleuder
 
     ### END OF CONFIG OPTIONS
 
-    def initialize(config_file=nil, fromfile=true)
-      if config_file && config_file.is_a?(String)
-        @conf_dir = File.dirname(config_file)
-      elsif config_file.nil?
+    def initialize(config=nil)
+      if config && config.is_a?(String)
+        @conf_dir = File.dirname(config)
+      elsif config.nil?
         @conf_dir = '/etc/schleuder'
-        config_file = File.join(@conf_dir,'schleuder.conf')
+        config = File.join(@conf_dir,'schleuder.conf')
       end
 
-      # overload with config_file 
-      super(config_file, fromfile)
+      # overload with config
+      super(config)
     end
   end
 end

data/lib/schleuder/storage.rb

@@ -33,18 +33,32 @@ module Schleuder
       @schleuder_attributes ||= {}
     end
 
-    # If +input+ is String or Hash it will be used to fill instance variables
-    # fromfile = whether to load the information from file
-    def initialize(input=nil, fromfile=true)
+    # If +input+ is String, we read the file at the given path.
+    # If +input+ is Hash, it will be used to fill instance variables.
+    def initialize(input=nil)
       if input.kind_of?(Hash)
         overload_from_hash!(input)
-      elsif input.kind_of?(String) && fromfile
+      elsif input.kind_of?(String)
         overload_from_file!(input)
-      else
+      elsif !input.nil?
         raise "Unknown input: #{input.class}"
       end
     end
 
+    def to_hash
+      self.class.default_schleuder_attributes.keys.inject({}) do |res, key|
+        val = send(key)
+        res[key] = if val.is_a?(Array)
+          val.collect { |e| e.respond_to?(:to_hash) ? e.to_hash : e }
+        elsif val.respond_to?(:to_hash)
+          val.to_hash
+        else
+          val
+        end
+        res
+      end
+    end
+
     private
 
     # Load content from +filename+ and overwrite existing instance variables of
@@ -66,19 +80,5 @@ module Schleuder
         end
       end
     end
-
-    def to_hash
-      self.class.default_schleuder_attributes.keys.inject({}) do |res, key|
-        val = send(key)
-        res[key] = if val.is_a?(Array)
-          val.collect { |e| e.respond_to?(:to_hash) ? e.to_hash : e }
-        elsif val.respond_to?(:to_hash)
-          val.to_hash
-        else
-          val
-        end
-        res
-      end
-    end
   end
 end

data/lib/schleuder/version.rb

@@ -1,3 +1,3 @@
 module Schleuder
-  VERSION = '2.2.1'
+  VERSION = '2.2.2'
 end

data/man/schleuder-newlist.8

@@ -7,31 +7,34 @@
 \fBschleuder\-newlist\fR \- create new Schleuder mailing list
 .
 .SH "SYNOPSIS"
-schleuder\-newlist \fILISTADDRESS\fR \e [\-realname \fI\e\'Foo\e List\e\'\fR]
+\fBschleuder\-newlist\fR [\-c \fIbaseconfig\fR] \fInewlist@example\.net\fR
 .
 .br
-\e [\-adminaddress \fIlistadmin@example\.net\fR]
+\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~[\-realname "\fIFoo List\fR"]
 .
 .br
-\e [\-initmember \fImember1@example\.net\fR
+\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~[\-adminaddress \fIlistadmin@example\.net\fR]
 .
 .br
-\e \e \-initmemberkey \fI/path/to/initmember_publickey\fR]
+\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~[\-initmember \fImember1@example\.net\fR
 .
 .br
-\e [\-privatekeyfile \fI/path/to/privatekey\fR
+\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\-initmemberkey \fIpath\-to\-initmember\-publickey\fR]
 .
 .br
-\e \e \-publickeyfile \fI/path/to/publickey\fR
+\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~[\-privatekeyfile \fIpath\-to\-privatekey\fR
 .
 .br
-\e \e \-passphrase \fIkey_passphrase\fR]
+\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\-publickeyfile \fIpath\-to\-publickey\fR
 .
 .br
-\e [\-mailuser mail]
+\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\-passphrase "\fIkey passphrase\fR"]
 .
 .br
-\e [\-nointeractive]
+\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~[\-mailuser \fIschleuder\fR]
+.
+.br
+\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~\~[\-nointeractive]
 .
 .SH "DESCRIPTION"
 \fBschleuder\-newlist\fR automates the creation of new Schleuder mailing lists\. For more information on Schleuder, please look at \fBschleuder\fR(8)\.
@@ -47,34 +50,47 @@ If no \fB\-privatekeyfile\fR, \fB\-publickeyfile\fR and \fB\-passphrase\fR are p
 .
 .SH "OPTIONS"
 .
-.IP "\(bu" 4
-\fB\-realname\fR \fI\'Foo List\'\fR: Specify the name of the mailing list\.
+.TP
+\fB\-c\fR \fIpath\-to\-schleuder\-configuration\fR:
 .
-.IP "\(bu" 4
-\fB\-adminaddress\fR \fIlistadmin@example\.net\fR: Specify the email address of a list administrator\. This address will be notified of errors, and depending on configuration may also be allowed to send restricted email commands\.
+.IP
+Specify an alternate configuration directory than the default \fB/etc/schleuder\fR\.
 .
-.IP "\(bu" 4
-\fB\-initmember\fR \fImember1@example\.net\fR: Specify the first subscribed list member address\. Can be the same as the administrator address\. This option must be accompanied by \fB\-initmemberkey\fR\.
+.TP
+\fB\-realname\fR "\fIFoo List\fR"
+Specify the name of the mailing list\.
 .
-.IP "\(bu" 4
-\fB\-initmemberkey\fR \fI/path/to/initmember_publickey\fR: Specify the path to first subscribed list member public key\. \fB\-initmember\fR must also be specified\.
+.TP
+\fB\-adminaddress\fR \fIlistadmin@example\.net\fR
+Specify the email address of a list administrator\. This address will be notified of errors, and depending on configuration may also be allowed to send restricted email commands\.
 .
-.IP "\(bu" 4
-\fB\-privatekeyfile\fR \fI/path/to/privatekey\fR: Specify the path to a previously\-generated private key for the list\. This option must be accompanied by \fB\-publickeyfile\fR and \fB\-passphrase\fR\.
+.TP
+\fB\-initmember\fR \fImember1@example\.net\fR
+Specify the first subscribed list member address\. Can be the same as the administrator address\. This option must be accompanied by \fB\-initmemberkey\fR\.
 .
-.IP "\(bu" 4
-\fB\-publickeyfile\fR \fI/path/to/publickey\fR Specify the path to a previously\-generated public key for the list\. This option must be accompanied by \fB\-privatekeyfile\fR and \fB\-passphrase\fR\.
+.TP
+\fB\-initmemberkey\fR \fIpath\-to\-initmember\-publickey\fR
+Specify the path to first subscribed list member public key\. \fB\-initmember\fR must also be specified\.
 .
-.IP "\(bu" 4
-\fB\-passphrase\fR \fI\'key passphrase\'\fR Specify the passphrase needed to access the private key specified in \fB\-privatekeyfile\fR\. This option must be accompanied by \fB\-publickeyfile\fR as well\.
+.TP
+\fB\-privatekeyfile\fR \fIpath\-to\-privatekey\fR
+Specify the path to a previously\-generated private key for the list\. This option must be accompanied by \fB\-publickeyfile\fR and \fB\-passphrase\fR\.
 .
-.IP "\(bu" 4
-\fB\-mailuser\fR \fIschleuder\fR Specify the system user account under which \fBschleuder\fR(8) will be executed\. (when run as root, this defaults to "schleuder")
+.TP
+\fB\-publickeyfile\fR \fIpath\-to\-publickey\fR
+Specify the path to a previously\-generated public key for the list\. This option must be accompanied by \fB\-privatekeyfile\fR and \fB\-passphrase\fR\.
 .
-.IP "\(bu" 4
-\fB\-nointeractive\fR When specified, no questions will be asked to complete missing information\.
+.TP
+\fB\-passphrase\fR "\fIkey passphrase\fR"
+Specify the passphrase needed to access the private key specified in \fB\-privatekeyfile\fR\. This option must be accompanied by \fB\-publickeyfile\fR as well\.
 .
-.IP "" 0
+.TP
+\fB\-mailuser\fR \fIschleuder\fR
+Specify the system user account under which \fBschleuder\fR(8) will be executed (when run as root, this defaults to \fBschleuder\fR)\.
+.
+.TP
+\fB\-nointeractive\fR
+When specified, no questions will be asked to complete missing information\.
 .
 .SH "EXAMPLES"
 This creates a new list called \fBtest1\fR with the initial member \fBfoo@bar\.ch\fR\. A new keypair will be generated for the list\.
@@ -111,69 +127,26 @@ The list test2 will be created, a keypair from the following files with the pass
 .IP "" 0
 .
 .SH "FILES"
-/etc/schleuder/schleuder\.conf
-.
-.IP "" 4
-.
-.nf
-
-Global Schleuder configuration
-.
-.fi
 .
-.IP "" 0
-.
-.P
-/etc/schleuder/default\-list\.conf
+.TP
+\fB/etc/schleuder/schleuder\.conf\fR
+global Schleuder configuration
 .
-.IP "" 4
+.TP
+\fB/etc/schleuder/default\-list\.conf\fR
+default list settings
 .
-.nf
-
-Default list settings
+.TP
+\fB/var/schleuderlists/\fR\fIHOSTNAME\fR\fB/\fR\fILISTNAME\fR
+list internal data
 .
-.fi
+.TP
+\fB/var/schleuderlists/\fR\fIHOSTNAME\fR\fB/\fR\fILISTNAME\fR\fB/list\.conf\fR
+list settings
 .
-.IP "" 0
-.
-.P
-/var/schleuderlists/HOSTNAME/LISTNAME
-.
-.IP "" 4
-.
-.nf
-
-List internal data
-.
-.fi
-.
-.IP "" 0
-.
-.P
-/var/schleuderlists/HOSTNAME/LISTNAME/list\.conf
-.
-.IP "" 4
-.
-.nf
-
-List settings
-.
-.fi
-.
-.IP "" 0
-.
-.P
-/var/schleuderlists/HOSTNAME/LISTNAME/members\.conf
-.
-.IP "" 4
-.
-.nf
-
-List susbcribers\.
-.
-.fi
-.
-.IP "" 0
+.TP
+\fB/var/schleuderlists/\fR\fIHOSTNAME\fR\fB/\fR\fILISTNAME\fR\fB/members\.conf\fR
+list susbcribers
 .
 .P
 All configuration files are formatted as YAML\. See \fIhttp://www\.yaml\.org/\fR for more details\.
@@ -184,8 +157,11 @@ Known bugs are listed on the Schleuder website\.
 .SH "SEE ALSO"
 \fBschleuder\fR(8), \fBaliases\fR(5), \fBgnupg\fR(7)\.
 .
-.P
-Schleuder website: \fIhttp://schleuder\.nadir\.org/\fR
+.TP
+Schleuder website
+\fIhttp://schleuder\.nadir\.org/\fR
 .
-.P
-YAML website: \fIhttp://www\.yaml\.org/\fR
+.TP
+YAML website
+\fIhttp://www\.yaml\.org/\fR
+

data/man/schleuder.8

@@ -4,13 +4,13 @@
 .TH "SCHLEUDER" "8" "June 2012" "" ""
 .
 .SH "NAME"
-\fBSchleuder\fR \- A groups email gateway\.
+\fBschleuder\fR \- a groups email gateway
 .
 .SH "SYNOPSIS"
-schleuder \fILISTADDRESS\fR < EMAIL
+\fBschleuder\fR [\-c \fIbaseconfig\fR] \fIlistaddress\fR < \fIemail\fR
 .
-.P
-schleuder \-test [\fILISTADDRESS\fR]
+.br
+\fBschleuder\fR [\-c \fIbaseconfig\fR] \-test [\fIlistaddress\fR]
 .
 .SH "DESCRIPTION"
 Schleuder is a groups email gateway: subscribers can communicate encrypted (and pseudonymously) among themselves, receive emails from non\-subscribers and send emails to non\-subscribers via the list\.
@@ -22,22 +22,19 @@ Schleuder takes care of all decryption and encryption, stripping of headers, for
 Email cryptography is handled by using GnuPG\. Schleuder understands all common encapsulation formats: \fBinline\fR, \fBmultipart/encrypted\fR and \fBmultipart/signed\fR\.
 .
 .P
-\fBschleuder\fR(8) is usually called in delivery mode by a \fIMail Transport Agent\fR with an incoming email piped to its standard input\. For more informations on how to integrate Schleuder with your existing mail setup, please look at the Schleuder website: http://schleuder\.nadir\.org/
-.
-.P
-If run with the \fB\-test\fR option Schleuder checks that the setup and basic settings are in a workable state\.
+schleuder(8) is usually called in delivery mode by a \fIMail Transport Agent\fR with an incoming email piped to its standard input\. For more informations on how to integrate Schleuder with your existing mail setup, please look at the Schleuder website: \fIhttp://schleuder\.nadir\.org/\fR
 .
 .P
-\fBschleuder\-newlist\fR(8) automates the creation of new mailing lists\.
+schleuder\-newlist(8) automates the creation of new mailing lists\.
 .
 .SH "AUTOMATIC SENDING OF LIST PUBLIC KEY"
-To receive the public key of the mailing list anybody can send an email to the special list address which includes \-sendkey as a postfix
+To receive the public key of the mailing list anybody can send an email to the special list address which includes \fB\-sendkey\fR as a postfix:
 .
 .IP "" 4
 .
 .nf
 
-listname\-sendkey@example\.com
+listname\-sendkey@example\.org
 .
 .fi
 .
@@ -47,354 +44,373 @@ listname\-sendkey@example\.com
 Schleuder will reply with the public key of the list without forwarding the request to the list\-members\.
 .
 .SH "EMAIL COMMANDS"
-Schleuder provides some special commands for advanced features to be used by list\-members\. Generally they are called by keywords written into the first non\-blank line of an email\. Schleuder scans for those keywords in every incoming email that is encrypted and validly signed by a list\-admin or —— if allowed by the list\'s configuration —— a list\-member\.
-.
-.P
-Administrative commands (membership and key management) must be sent to the request\-address or the list, which includes \-request as a postfix: listname\-request@example\.org
+Schleuder provides some special commands for advanced features to be used by list\-members\. Generally they are called by keywords written into the first non\-blank line of an email\. Schleuder scans for those keywords in every incoming email that is encrypted and validly signed by a list\-admin or \(em if allowed by the list\'s configuration \(em a list\-member\.
 .
 .P
-Communicative commands (resending) must be sent to the normal list\-address\.Resending is a list\-command, that means it is only allowed in emails sent over the mailing list\.
-.
-.P
-To receive the list of members send:
+Administrative commands (membership and key management) must be sent to the request\-address or the list, which includes \fB\-request\fR as a postfix:
 .
 .IP "" 4
 .
 .nf
 
-X\-LIST\-MEMBERS
-
-You will receive a list of list\-admins and list\-members, and their public
-keys (or the lack thereof)\.
+listname\-request@example\.org
 .
 .fi
 .
 .IP "" 0
 .
 .P
-To see details on one list\-member, including his/her public key:
+Communicative commands (resending) must be sent to the normal list\-address\.
 .
-.P
-X\-GET\-MEMBER: you@example\.net
+.SS "Membership management"
+Resending is a list\-command, that means it is only allowed in emails sent over the mailing list\.
 .
-.P
-To add a member:
+.TP
+To receive the list of members send:
 .
 .IP "" 4
 .
 .nf
 
-     X\-ADD\-MEMBER: you@example\.net mime
-     \-\-\-\-\-BEGIN PGP PUBLIC KEY BLOCK\-\-\-\-\-
-     Version: GnuPG v1\.4\.9 (GNU/Linux)
-
-     mQGiBEjVO7oRBADQvT6wtD2IzzIiK0NbrcilCKCp4MWb8cYXTXguwPQI6y0Nerz4
-     dsK6J0X1Vgeo02tqA4xd3EDK8rdqL2yZfl/2egH8+85R3gDk+kqkfEp4pwCgp6VO
-     [\.\.\.]
-     pNlF/qkaWwRb048h+iMrW21EkouLKTDPFkdFbapV2X5KJZIcfhO1zEbwc1ZKF3Ju
-     Q9X5GRmY62hz9SCZnsC0jeYAni8OUQV9NXfXlS/vePBUnOL08NQB
-     =xTv3
-     \-\-\-\-\-END PGP PUBLIC KEY BLOCK\-\-\-\-\-
-
-`mime` could also be `plain` (for receiving `inline`\-encapsulated messages)
-or be skipped (then the list\'s default setting is used)\.
-
-The public key block is also optional\.
+X\-LIST\-MEMBERS
 .
 .fi
 .
 .IP "" 0
 .
-.P
-To delete a member from the list:
+.IP
+You will receive a list of list\-admins and list\-members, and their public keys (or the lack thereof)\.
+.
+.TP
+To see details on one list\-member, including his/her public key:
 .
 .IP "" 4
 .
 .nf
 
-      X\-DELETE\-MEMBER:  you@example\.net
-
-Please note that this doesn\'t delete any public keys\.
+X\-GET\-MEMBER: you@example\.net
 .
 .fi
 .
 .IP "" 0
-To receive the list of public keys known to the list
+
+.
+.TP
+To unsubscribe from the mailing\-list:
 .
 .IP "" 4
 .
 .nf
 
-     X\-LIST\-KEYS
+X\-UNSUBSCRIBE
 .
 .fi
 .
 .IP "" 0
 .
-.P
-To receive a certain public key known to the list
+.IP
+This will remove the member associated with the sender\'s signing key\.
+.
+.TP
+To add a member:
 .
 .IP "" 4
 .
 .nf
 
-     X\-GET\-KEY: foobar@example\.com
+X\-ADD\-MEMBER: you@example\.net mime
+\-\-\-\-\-BEGIN PGP PUBLIC KEY BLOCK\-\-\-\-\-
+Version: GnuPG v1\.4\.9 (GNU/Linux)
 
-     You can also specify a KeyID, or parts of it, as long as it identifies
-     the key distinctly\.
+mQGiBEjVO7oRBADQvT6wtD2IzzIiK0NbrcilCKCp4MWb8cYXTXguwPQI6y0Nerz4
+dsK6J0X1Vgeo02tqA4xd3EDK8rdqL2yZfl/2egH8+85R3gDk+kqkfEp4pwCgp6VO
+[\.\.\.]
+pNlF/qkaWwRb048h+iMrW21EkouLKTDPFkdFbapV2X5KJZIcfhO1zEbwc1ZKF3Ju
+Q9X5GRmY62hz9SCZnsC0jeYAni8OUQV9NXfXlS/vePBUnOL08NQB
+=xTv3
+\-\-\-\-\-END PGP PUBLIC KEY BLOCK\-\-\-\-\-
 .
 .fi
 .
 .IP "" 0
 .
-.P
-To add a public key to the list
+.IP
+\fBmime\fR could also be \fBplain\fR (for receiving \fBinline\fR\-encapsulated messages) or be skipped (then the list\'s default setting is used)\.
+.
+.IP
+The public key block is also optional\.
+.
+.TP
+To delete a member from the list:
 .
 .IP "" 4
 .
 .nf
 
-     X\-ADD\-KEY:
-     \-\-\-\-\-BEGIN PGP PUBLIC KEY BLOCK\-\-\-\-\-
-     Version: GnuPG v1\.4\.9 (GNU/Linux)
-
-     mQGiBEjVO7oRBADQvT6wtD2IzzIiK0NbrcilCKCp4MWb8cYXTXguwPQI6y0Nerz4
-     dsK6J0X1Vgeo02tqA4xd3EDK8rdqL2yZfl/2egH8+85R3gDk+kqkfEp4pwCgp6VO
-     [\.\.\.]
-     pNlF/qkaWwRb048h+iMrW21EkouLKTDPFkdFbapV2X5KJZIcfhO1zEbwc1ZKF3Ju
-     Q9X5GRmY62hz9SCZnsC0jeYAni8OUQV9NXfXlS/vePBUnOL08NQB
-     =xTv3
-     \-\-\-\-\-END PGP PUBLIC KEY BLOCK\-\-\-\-\-
+X\-DELETE\-MEMBER:  you@example\.net
 .
 .fi
 .
 .IP "" 0
 .
-.P
-To delete a key from the list\'s keyring:
+.IP
+Please note that this doesn\'t delete any public keys\.
+.
+.SS "Key management"
+.
+.TP
+To receive the list of public keys known to the list:
 .
 .IP "" 4
 .
 .nf
 
-    X\-DELETE\-KEY: 0xDEADBEEF
-
-    You can also specify an email address, as long as it identifies the key
-    distinctly\.
+X\-LIST\-KEYS
 .
 .fi
 .
 .IP "" 0
-Resending is a list\-command, that means it is only allowed in emails sent over the mailing list\.
+
 .
-.P
-To send out an email to an external recipient (encrypted if possible, otherwise in the clear)
+.TP
+To receive a certain public key known to the list:
 .
 .IP "" 4
 .
 .nf
 
-     X\-RESEND: emailaddress@example\.net
+X\-GET\-KEY: foobar@example\.com
 .
 .fi
 .
 .IP "" 0
 .
-.P
-Or to send it only if encryption is available
+.IP
+You can also specify a KeyID, or parts of it, as long as it identifies the key distinctly\.
+.
+.TP
+To add a public key to the list:
 .
 .IP "" 4
 .
 .nf
 
-     X\-RESEND\-ENCRYPTED\-ONLY: emailaddress@example\.net
+X\-ADD\-KEY:
+\-\-\-\-\-BEGIN PGP PUBLIC KEY BLOCK\-\-\-\-\-
+Version: GnuPG v1\.4\.9 (GNU/Linux)
+
+mQGiBEjVO7oRBADQvT6wtD2IzzIiK0NbrcilCKCp4MWb8cYXTXguwPQI6y0Nerz4
+dsK6J0X1Vgeo02tqA4xd3EDK8rdqL2yZfl/2egH8+85R3gDk+kqkfEp4pwCgp6VO
+[\.\.\.]
+pNlF/qkaWwRb048h+iMrW21EkouLKTDPFkdFbapV2X5KJZIcfhO1zEbwc1ZKF3Ju
+Q9X5GRmY62hz9SCZnsC0jeYAni8OUQV9NXfXlS/vePBUnOL08NQB
+=xTv3
+\-\-\-\-\-END PGP PUBLIC KEY BLOCK\-\-\-\-\-
 .
 .fi
 .
 .IP "" 0
+
 .
-.P
-To specify multiple recipients separate the addresses with spaces or specify the command multiple times:
+.TP
+To delete a key from the list\'s keyring:
 .
 .IP "" 4
 .
 .nf
 
-             X\-RESEND: you@example\.net me@example\.net
-    or
-
-             X\-RESEND: you@example\.net
-             X\-RESEND: me@example\.net
-
-    With the first format don\'t let your Mail User Agent break long lines!
+X\-DELETE\-KEY: 0xDEADBEEF
 .
 .fi
 .
 .IP "" 0
 .
-.SH "EXIT STATUS"
-0
+.IP
+You can also specify an email address, as long as it identifies the key distinctly\.
+.
+.SS "Resending"
+Resending is a list\-command, that means it is only allowed in emails sent over the mailing list\.
+.
+.TP
+To send out an email to an external recipient (encrypted if possible, otherwise in the clear):
 .
 .IP "" 4
 .
 .nf
 
-Incoming email was processed without errors\.
-
-Configuration is correct in test mode\.
+X\-RESEND: emailaddress@example\.net
 .
 .fi
 .
 .IP "" 0
+
 .
-.P
-1
+.TP
+Or to send it only if encryption is available:
 .
 .IP "" 4
 .
 .nf
 
-Internal failure in incoming email processing\.
-
-Bad configuration in test mode\.
+X\-RESEND\-ENCRYPTED\-ONLY: emailaddress@example\.net
 .
 .fi
 .
 .IP "" 0
+
 .
-.P
-100
+.TP
+To specify multiple recipients separate the addresses with spaces or specify the command multiple times:
 .
 .IP "" 4
 .
 .nf
 
-Unable to decrypt the received message\.
-
-Unable to verify the signature when configured to only accept signed
-messages\.
-
-Message is cleartext when only encrypted messages are allowed\.
-
-Message is not authenticated as coming from a list\-member when
-authentication is required\.
+X\-RESEND: you@example\.net me@example\.net
 .
 .fi
 .
 .IP "" 0
 .
-.SH "FILES"
-/etc/schleuder/schleuder\.conf
+.IP
+or
 .
 .IP "" 4
 .
 .nf
 
-Global Schleuder configuration
+X\-RESEND: you@example\.net
+X\-RESEND: me@example\.net
 .
 .fi
 .
 .IP "" 0
 .
-.P
-/etc/schleuder/default\-list\.conf
+.IP
+With the first format don\'t let your Mail User Agent break long lines!
 .
-.IP "" 4
+.SS "Misc\."
 .
-.nf
-
-Default list settings
-.
-.fi
+.IP "\(bu" 4
+To know which version of Schleuder is installed: X\-GET\-VERSION
 .
 .IP "" 0
 .
-.P
-/var/schleuderlists/LISTNAME/list\.conf
+.SH "OPTIONS"
 .
-.IP "" 4
+.TP
+\fB\-c\fR \fIpath\-to\-schleuder\-configuration\fR
+Specify an alternate configuration directory than the default \fB/etc/schleuder\fR\.
 .
-.nf
-
-List settings
+.TP
+\fB\-test\fR
+Instead of processing an incoming email, specifying this flag will make Schleuder verify that the setup and basic settings are in a workable state\.
 .
-.fi
+.TP
+\fB\-h\fR
+Display usage and exit\.
 .
-.IP "" 0
+.SH "EXIT STATUS"
 .
-.P
-/var/schleuderlists/LISTNAME/members\.conf
+.TP
+0
+Incoming email was processed without errors\.
 .
-.IP "" 4
+.IP
+Configuration is correct in test mode\.
 .
-.nf
-
-List susbcribers\.
-
-Each member must have the email\-attribute set\. All other attributes are
-optional\.
-
-The following attributes are available:
-
- * mime: defines the \'pgp\-variant\' to send to the member, possible values are
-   `MIME` (for pgp/mime\-formatted mail according to RFC 3156), and `PLAIN` (for
-    inline\-pgp)\. The fallback\-default for this is defined in the
-    list\.conf\.
- * encrypted_only: schleuder tries to encrypt every outgoing email\. If
-   that is not possible under some conditions it sends the email
-   unecrypted\. If this attribute is set the member will never receive
-   unencrypted emails; the member will be skipped if encrypting is not
-   possible\.
-
-Example:
-
-     \- email: you@example\.net
-     \- email: me@example\.org
-       mime: PLAIN
-     \- email: them@example\.com
-       encrypted_only: true
+.TP
+1
+Internal failure in incoming email processing\.
 .
-.fi
+.IP
+Bad configuration in test mode\.
 .
-.IP "" 0
+.TP
+100
+Unable to decrypt the received message\.
 .
-.P
-/var/schleuderlists/HOSTNAME/LISTNAME
+.IP
+Unable to verify the signature when configured to only accept signed messages\.
 .
-.IP "" 4
+.IP
+Message is cleartext when only encrypted messages are allowed\.
 .
-.nf
-
-List internal data
+.IP
+Message is not authenticated as coming from a list\-member when authentication is required\.
 .
-.fi
+.SH "FILES"
+.
+.IP "\(bu" 4
+\fB/etc/schleuder/schleuder\.conf\fR: global Schleuder configuration
+.
+.IP "\(bu" 4
+\fB/etc/schleuder/default\-list\.conf\fR: default list settings
+.
+.IP "\(bu" 4
+\fB/var/schleuderlists/\fR\fILISTNAME\fR\fB/list\.conf\fR: list settings
+.
+.IP "\(bu" 4
+\fB/var/schleuderlists/\fR\fILISTNAME\fR\fB/members\.conf\fR: list susbcribers\.
+.
+.IP
+Each member must have the email\-attribute set\. All other attributes are optional\.
+.
+.IP
+The following attributes are available:
+.
+.IP "\(bu" 4
+\fBmime\fR: defines the \'pgp\-variant\' to send to the member, possible values are \fBMIME\fR (for pgp/mime\-formatted mail according to RFC 3156), and \fBPLAIN\fR (for inline\-pgp)\. The fallback\-default for this is defined in the \fBlist\.conf\fR\.
+.
+.IP "\(bu" 4
+\fBencrypted_only\fR: schleuder tries to encrypt every outgoing email\. If that is not possible under some conditions it sends the email unecrypted\. If this attribute is set the member will never receive unencrypted emails; the member will be skipped if encrypting is not possible\.
 .
 .IP "" 0
 .
-.P
-/var/log/schleuder
+.IP
+Example:
 .
 .IP "" 4
 .
 .nf
 
-Schleuder logs directory
+\- email: you@example\.net
+\- email: me@example\.org
+  mime: PLAIN
+\- email: them@example\.com
+  encrypted_only: true
 .
 .fi
 .
 .IP "" 0
+
+.
+.IP "\(bu" 4
+\fB/var/schleuderlists/\fR\fIHOSTNAME\fR\fB/\fR\fILISTNAME\fR: list internal data
+.
+.IP "\(bu" 4
+\fB/var/log/schleuder\fR: Schleuder logs directory
+.
+.IP "" 0
 .
 .P
 All configuration files are formatted as YAML\. See \fIhttp://www\.yaml\.org/\fR for more details\.
 .
 .SH "BUGS"
-Known bugs are listed on the Schleuder bugtracker at https://git\.codecoop\.org/projects/schleuder\fBschleuder\-newlist\fR(8), \fBgnupg\fR(7)\.
+Known bugs are listed on the Schleuder bugtracker at \fIhttps://git\.codecoop\.org/projects/schleuder\fR
 .
-.P
-Schleuder website: \fIhttp://schleuder\.nadir\.org/\fR
+.SH "SEE ALSO"
+\fBschleuder\-newlist\fR(8), \fBgnupg\fR(7)\.
 .
-.P
-Webschleuder website: \fIhttp://webschleuder\.nadir\.org/\fR (web interface to schleuder)
+.TP
+Schleuder website
+\fIhttp://schleuder\.nadir\.org/\fR
 .
-.P
-YAML website: \fIhttp://www\.yaml\.org/\fR
+.TP
+Webschleuder website
+\fIhttp://webschleuder\.nadir\.org/\fR (web interface to schleuder)
+.
+.TP
+YAML website
+\fIhttp://www\.yaml\.org/\fR
+