AUTO-MULTIPLE-CHOI(1)

📦
version 1.7.0 · 3 versions
, in arch rolling, debian trixie, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 AUTO-MULTIPLE-CHOI(1) — the auto-multiple-choice-imprime glow-up 💖

okay bestie, so this is the page for auto-multiple-choice-imprime, which is the little command inside Auto Multiple Choice (the manpage header literally just calls it AUTO-MULTIPLE-CHOI(1), iykyk) that prints AMC multiple choice answer sheets so you can hand them out to your students. she's giving print-shop energy, no cap. ✨

🌸 NAME 🌸

auto-multiple-choice-imprime — prints AMC multiple choice answer sheets to be distributed to the students 🖨️🎀

✨ SYNOPSIS ✨

auto-multiple-choice imprime --sujet subject.pdf
                     --fich-nums numbers-file.txt --data data-dir
                     --methode method [where-to-print-arguments...]

like… that's the shape of it. subject, numbers file, data dir, method, and then whatever print-where arguments go with your chosen method. slay. 💅

🦋 DESCRIPTION 🦋

the auto-multiple-choice imprime command prints the copies you actually picked, out of an AMC multiple choice answer sheet. not all of them, not random ones — selected ones. main character selection behaviour fr fr. 🌟

🎀 What to print 🎀

these arguments are the "okay so WHAT are we printing" squad:

  • --sujet subject.pdf — sets the subject file (the one that was prepared by auto-multiple-choice-prepare(1)). this is your whole exam blueprint bestie. 📄
  • --fich-nums numbers-file.txt — gives a file where the numbers of the copies to be printed are written, one number per line. if you don't pass this argument, all the copies will be printed — every single one, no filter, no chill. 🙈
  • --data data-dir — gives the directory where data files live (peep auto-multiple-choice-meptex(1) for an example 👀). the layout database inside the data directory is what tells it at which page of the subject file each copy begins and ends. lowkey essential.
  • --split — asks to print separate answer sheets separately. like, on their own. separate-separate. 🫶
  • --answer-first — asks to reorder the pages of each copy so that the separate answer sheet comes first. answer sheet girlies rise. 👑

🖨️ Where to print 🖨️

several printing methods are currently defined, and picking one is your whole vibe check:

  • with --methode CUPS, auto-multiple-choice imprime prints to a CUPS printer. one print job is sent for each copy, which allows you to do stuff like use stapling. iconic. use these options with this method:
    • --imprimante printer — sets the CUPS printer name to print to. 💖
    • --options cups-options — gives CUPS options, in the opt1=value1,opt2=value2,... format. commas go brrr. 🔥
  • with --methode file, auto-multiple-choice imprime outputs the answer sheets to files — one for each copy, cute and tidy. 🗂️
    • --output filename — sets the filename for outputs. the %e sequence will be replaced by a 4-digits copy number. if filename does not contain %e, the string -%e.pdf will be added at its end. yes, it does that automatically, bestie, don't fight it. 🍓
  • with --methode command, auto-multiple-choice imprime will use a provided command for each copy. your command, your rules. ✨
    • --print-command command — gives the command to be used for printing. heads up: the command string will be split at each space character — even when using quotes… 😭 so quoting won't save you, fr. the sequence %f will be replaced by a PDF filename (containing the copy to print), and %e will be replaced by the copy number. 🎯

🌈 Other options 🌈

other available options, the little bonus round:

  • --extract-with command — gives the command to use to extract pages from the PDF subject. currently, pdftk, gs and qpdf are available. the default value is pdftk, but qpdf and then gs will be used if the pdftk command is not installed. so it's got a whole backup-plan lineup, we love a prepared queen. 👑

👑 AUTHORS 👑

the legends behind all this:

  • 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 © 2008-2025 Alexis Bienvenüe

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

bestie reminder: every flag, every default, every %e and %f matters here. no guessing, no vibes-based printing. 💅

and that's the whole page, periodt. 🎀 this was Auto Multiple Choice version 1.7.0, dated 2025-04-17, dropping under the AUTO-MULTIPLE-CHOI(1) header — thanks for reading, ily, go print some answer sheets. 🫶💖

📦 where this page comes from