AUTO-MULTIPLE-CHOI(1)

NAME
auto-multiple-choice-mailing - mail PDF annotated completed answer sheets to students

SYNOPSIS

auto-multiple-choice mailing [--xmlargs args.xml] --project project-dir --students-list students-list.csv [--list-encoding encoding] --email-column col --sender sender-email --subject subject --text email-body [--text-content-type content-type] [--debug file.log] [transport arguments...]

DESCRIPTION

The command auto-multiple-choice mailing sends by email the PDF annotated completed answer sheets to the students. Email addresses are taken from the students list file.

--project project-dir
    Gives the project directory.

--students-list students-list.csv
    sets the students list file name.

--list-encoding encoding
    selects an encoding for file students-list.csv (default is utf-8).

--email-column col
    sets the name of the column containing the email addresses of the students in the students list file.

--sender sender-email
    sets the sender email.

--cc cc-email-address
    sets the carbon copy email address.

--bcc bcc-email-address
    sets the blind carbon copy email address.

--subject subject
    sets the subject of the emails to send.

--text email-body
    sets the body text of the emails to send.

--text-content-type content-type
    sets the content-type of email text. content-type may be text/plain or text/html.

--attach filename
    adds file filename as an attachment to all emails sent. Use this option several times to attach multiple files.

--transport transport
    sets the transport to use. transport may be sendmail or SMTP.

--debug file.log
    gives a file to fill with debugging information.

--delay time
    sets a delay of time seconds between each sending.

TRANSPORT ARGUMENTS

Depending on the value used for argument transport, the following arguments can be added:

  Transport sendmail

--sendmail-path path
    sets the path to the sendmail command (defaults to /usr/sbin/sendmail).

  Transport SMTP

--smtp-host host
    sets the SMTP hostname (defaults to smtp).

--smtp-port port
    sets the port to use (default value is 25).

--smtp-ssl mode
    sets the security mode for the SMTP connection. The option mode can be ssl, starttls, or 0 (unsecured).

--smtp-user user
    sets the username for authenticated SMTP.

--smtp-passwd-file file
    gives the path of a file containing the password (as the first line of the file) for authenticated SMTP.

ARGUMENTS IN A XML FILE

To avoid encoding problems, one can place some arguments in a XML file and use the --xmlargs file.xml argument as the first command argument. Here is an example of such a file:

    <?xml version="1.0" encoding="UTF-8"?>
    <arguments>
      <arg>--sender</arg><arg>Bienvenüe &lt;paamc@passoire.fr&gt;</arg>
      <arg>--text</arg><arg>Voilà votre copie corrigée</arg>
      <arg>--subject</arg><arg>QCM</arg>
    </arguments>

AUTHORS

Alexis Bienvenüe <paamc@passoire.fr>
    Main author

Anirvan Sarkar
    Author and Editor

Hiroto Kagotani
    Editor

Frédéric Bréal
    Author and Editor

Jean Bérard
    Translation from French

Georges Khaznadar
    Translation from French

COPYRIGHT
Copyright © 2008-2025 Alexis Bienvenüe

This document can be used according to the terms of the GNU General Public License, version 2 or later.