'\" t
.\"     Title: AMC-regroupe
.\"    Author: Alexis Bienven\(:ue <paamc@passoire.fr>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 10/24/2014
.\"    Manual: Auto Multiple Choice
.\"    Source: Auto Multiple Choice 1.2.1
.\"  Language: English
.\"
.TH "AMC\-REGROUPE" "1" "10/24/2014" "Auto Multiple Choice 1\&.2\&.1" "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-regroupe \- merge JPEG annotated AMC multiple choice answer sheets to get a PDF file per student\&.
.SH "SYNOPSIS"
.HP \w'\fBauto\-multiple\-choice\fR\ 'u
\fBauto\-multiple\-choice\fR regroupe \-\-projet\ \fIproject\-dir\fR \-\-sujet\ \fIsubject\&.pdf\fR \-\-modele\ \fIfile\-name\-model\fR \-\-fich\-noms\ \fIstudents\-list\&.csv\fR [\-\-noms\-encodage\ \fIencoding\fR] [\-\-compose]
.SH "DESCRIPTION"
.PP
The command
\fBAMC\-regroupe\&.pl\fR
merges annotated AMC multiple choice answer sheets (there is one per page) to get a single PDF file per student\&.
.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))\&.
.RE
.PP
\fB\-\-projet \fR\fB\fIproject\-dir\fR\fR
.RS 4
Gives the project directory\&.
.RE
.PP
\fB\-\-sujet \fR\fB\fIsubject\&.pdf\fR\fR
.RS 4
gives the subject file (as prepared by
\fBAMC-prepare\fR(1))\&. This helps in getting the page size for the subject to make annotated PDF fit this size\&.
.RE
.PP
\fB\-\-fich\-noms \fR\fB\fIstudents\-list\&.csv\fR\fR
.RS 4
sets the students list file name\&.
.RE
.PP
\fB\-\-noms\-encodage \fR\fB\fIencoding\fR\fR
.RS 4
selects an encoding for file
\fIstudents\-list\&.csv\fR
(default is utf\-8)\&.
.RE
.PP
\fB\-\-modele \fR\fB\fIfile\-name\-model\fR\fR
.RS 4
sets a file name model for annotated PDFs\&. In this model, some sequences will be substituted:
.PP
(N)
.RS 4
is replaced by the student\*(Aqs name\&.
.RE
.PP
(ID)
.RS 4
is replaced by the student number\&.
.RE
.PP
(\fICOL\fR)
.RS 4
is replaced by the value of column
\fICOL\fR
in the students list for the curent student\&.
.RE
.sp
The default value is \*(Aq(N)\-(ID)\&.pdf\*(Aq\&.
.RE
.PP
\fB\-\-compose\fR
.RS 4
When using this option, pages for which there is no scan will be replaced by the corresponding page from the corrected answer sheet\&. This option is for example useful when using the separate answer sheet layout: in this case, the annotated answer sheet will not be readable without the pages with the questions\&.
.sp
When using the
\fB\-\-compose\fR
option, one must also use the
\fB\-\-tex\-src\fR
(and optionnaly
\fB\-\-with\fR,
\fB\-\-filter\fR
and
\fB\-\-filtered\-source\fR) option\&.
.RE
.PP
\fB\-\-tex\-src \fR\fB\fImcq\-source\-file\fR\fR
.RS 4
gives the source file for the subject\&.
.RE
.PP
\fB\-\-with \fR\fB\fIlatex\-engine\fR\fR
.RS 4
gives the LaTeX engine (command) to be used to process the (optionaly filtered) source file\&.
\fIlatex\-engine\fR
can be
\fBpdflatex\fR
or
\fBxelatex\fR
for exemple\&.
.RE
.PP
\fB\-\-filter \fR\fB\fIfilter\fR\fR
.RS 4
sets the filter name to transform the MCQ source file into a LaTeX file (see
\fBAMC-prepare\fR(1))\&.
.RE
.PP
\fB\-\-filtered\-source \fR\fB\fImcq\-latex\-file\fR\fR
.RS 4
gives the LaTeX file to make from the source file using specified filter (see
\fBAMC-prepare\fR(1))\&.
.RE
.PP
\fB\-\-debug \fR\fB\fIfile\&.log\fR\fR
.RS 4
gives a file to fill with debugging information\&.
.RE
.SH "AUTHORS"
.PP
\fBAlexis Bienven\(:ue\fR <\&paamc@passoire.fr\&>
.RS 4
Main author
.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-2013 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