AUTO-MULTIPLE-CHOI(1)

💌 NAME 💌

auto-multiple-choice-mailing — bestie, this is the one that emails those PDF annotated completed answer sheets straight to your 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 🌸

okay so picture this: the command auto-multiple-choice mailing literally just sends the PDF annotated completed answer sheets to your students, by email, no cap. And where does it get the email addresses from?? the students list file obviously 💅

• --project project-dir — this is where you tell it the project directory, mwah 💖
• --students-list students-list.csv — sets the students list file name, iconic.
• --list-encoding encoding — picks an encoding for the file students-list.csv (the default is utf-8, as it should be ✨).
• --email-column col — tells it which column in the students list file is holding the students' email addresses 👑
• --sender sender-email — sets the sender email. who's sending? you, bestie.
• --cc cc-email-address — sets the carbon copy email address.
• --bcc bcc-email-address — sets the blind carbon copy email address (sneaky, love that for you 🙈).
• --subject subject — sets the subject line 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 the email text. content-type can be text/plain or text/html.
• --attach filename — adds the file filename as an attachment to all the emails sent. use this option several times if you wanna attach multiple files, periodt 🎀
• --transport transport — sets the transport to use. transport can be sendmail or SMTP.
• --debug file.log — gives a file to fill with debugging information (for when it's giving… problems 😭).
• --delay time — sets a delay of time seconds between each sending. patience is a virtue fr fr.

---

🦋 TRANSPORT ARGUMENTS 🦋

depending on the value you used for the argument transport, these following arguments can be added 👇

🌈 Transport sendmail

• --sendmail-path path — sets the path to the sendmail command (it 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 (the default value is 25).
• --smtp-ssl mode — sets the security mode for the SMTP connection. the option mode can be ssl, starttls, or 0 (that last one means unsecured, so… choose wisely bestie).
• --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. yes, the first line, don't get creative 🔑

---

🌟 ARGUMENTS IN A XML FILE 🌟

to avoid encoding problems, you can place some arguments in a XML file and use the --xmlargs file.xml argument as the first command argument. it's giving organised ✨ here's 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.

---

and that's the whole vibe check, bestie 💅 this was Auto Multiple Choice 1.7.0, dated 2025-04-17, living in section 1 of the manual (iykyk). slay, go send those emails 🦋💌✨