'\" t
.\"     Title: AMC-imprime
.\"    Author: Alexis Bienven\(:ue <paamc@passoire.fr>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2021-01-21
.\"    Manual: Auto Multiple Choice
.\"    Source: Auto Multiple Choice 1.5.0~rc1
.\"  Language: English
.\"
.TH "AMC\-IMPRIME" "1" "2021-01-21" "Auto Multiple Choice 1\&.5\&.0" "Auto Multiple Choice"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
AMC-imprime \- prints AMC multiple choice answer sheets to be distributed to the students
.SH "SYNOPSIS"
.HP \w'\fBauto\-multiple\-choice\fR\ 'u
\fBauto\-multiple\-choice\fR imprime \-\-sujet\ \fIsubject\&.pdf\fR \-\-fich\-nums\ \fInumbers\-file\&.txt\fR \-\-data\ \fIdata\-dir\fR \-\-methode\ \fImethod\fR [where\-to\-print\-arguments...]
.SH "DESCRIPTION"
.PP
The
\fBAMC\-imprime\&.pl\fR
command prints selected copies from a AMC multiple choice answer sheet\&.
.SS "What to print"
.PP
The following arguments describe what to print:
.PP
\fB\-\-sujet \fR\fB\fIsubject\&.pdf\fR\fR
.RS 4
sets the subject file (prepared by
\fBAMC-prepare\fR(1))\&.
.RE
.PP
\fB\-\-fich\-nums \fR\fB\fInumbers\-file\&.txt\fR\fR
.RS 4
gives a file where the numbers of the copies to be printed are written (one number per line)\&. If this argument is not given, all the copies will be printed\&.
.RE
.PP
\fB\-\-data \fR\fB\fIdata\-dir\fR\fR
.RS 4
gives the directory where data files are (see for example
\fBAMC-meptex\fR(1))\&. The layout database in the data directory is used to know at which page of the subject file each copy begins and ends\&.
.RE
.PP
\fB\-\-split\fR
.RS 4
asks to print separate answer sheets separately\&.
.RE
.PP
\fB\-\-answer\-first\fR
.RS 4
asks to reorder the pages of each copy to get the separate answer sheet first\&.
.RE
.SS "Where to print"
.PP
Several printing methods are currently defined:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
with "\fB\-\-methode CUPS\fR",
\fBAMC\-imprime\&.pl\fR
prints to a CUPS printer\&. One print job is sent for each copy, allowing for example to use stapling\&. Use the following options with this method:
.PP
\fB\-\-imprimante \fR\fB\fIprinter\fR\fR
.RS 4
sets the CUPS printer name to print to\&.
.RE
.PP
\fB\-\-options \fR\fB\fIcups\-options\fR\fR
.RS 4
gives CUPS options, in the
\fBopt1=value1,opt2=value2,\&.\&.\&.\fR
format\&.
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
with "\fB\-\-methode file\fR",
\fBAMC\-imprime\&.pl\fR
outputs the answer sheets to files (one for each copy)\&.
.PP
\fB\-\-output \fR\fB\fIfilename\fR\fR
.RS 4
sets the filename for outputs\&. The \*(Aq%e\*(Aq sequence will be replaced by a 4\-digits copy number\&. If
\fIfilename\fR
does not contain \*(Aq%e\*(Aq, the string \*(Aq\-%e\&.pdf\*(Aq will be added at its end\&.
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
with "\fB\-\-methode command\fR",
\fBAMC\-imprime\&.pl\fR
will use a provided command for each copy\&.
.PP
\fB\-\-print\-command \fR\fB\fIcommand\fR\fR
.RS 4
gives the command to be used for printing\&. The
\fIcommand\fR
string will be split at each space character (even when using quotes\&.\&.\&.)\&. The sequence \*(Aq%f\*(Aq will be replaced by a PDF filename (containing the copy to print), and \*(Aq%e\*(Aq will be replaced by the copy number\&.
.RE
.RE
.SS "Other options"
.PP
Other available options:
.PP
\-\-extract\-with \fIcommand\fR
.RS 4
gives the command to use to extract pages from the PDF subject\&. Currently,
\fBpdftk\fR,
\fBgs\fR
and
\fBqpdf\fR
are available\&. The default value is
\fBpdftk\fR, but
\fBqpdf\fR
and then
\fBgs\fR
will be used if the
\fBpdftk\fR
command is not installed\&.
.RE
.SH "AUTHORS"
.PP
\fBAlexis Bienven\(:ue\fR <\&paamc@passoire.fr\&>
.RS 4
Main author
.RE
.PP
\fBAnirvan Sarkar\fR
.RS 4
Author and Editor
.RE
.PP
\fBHiroto Kagotani\fR
.RS 4
Editor
.RE
.PP
\fBFr\('ed\('eric Br\('eal\fR
.RS 4
Author and Editor
.RE
.PP
\fBJean B\('erard\fR
.RS 4
Translation from French
.RE
.PP
\fBGeorges Khaznadar\fR
.RS 4
Translation from French
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2008-2021 Alexis Bienven\(:ue
.br
.PP
This document can be used according to the terms of the GNU General Public License, version 2 or later.
.sp