AUTO-MULTIPLE-CHOI(1)        Auto Multiple Choice        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>Bienvenue &lt;paamc@passoire.fr&gt;</arg>
             <arg>--text</arg><arg>Voila votre copie corrigee</arg>
             <arg>--subject</arg><arg>QCM</arg>
           </arguments>

AUTHORS
       Alexis Bienvenue <paamc@passoire.fr>
           Main author

       Anirvan Sarkar
           Author and Editor

       Hiroto Kagotani
           Editor

       Frederic Breal
           Author and Editor

       Jean Berard
           Translation from French

       Georges Khaznadar
           Translation from French

COPYRIGHT
       Copyright (C) 2008-2022 Alexis Bienvenue

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


Auto Multiple Choice 1.6.0        2023-02-06             AUTO-MULTIPLE-CHOI(1)