--- processmail/process.tex 2008/03/23 18:04:51 3.1 +++ processmail/process.tex 2013/10/11 15:39:35 3.2 @@ -1,6 +1,9 @@ -%$Id: process.tex,v 3.1 2008/03/23 18:04:51 boris Exp $ +%$Id: process.tex,v 3.2 2013/10/11 15:39:35 boris Exp $ %$Log: process.tex,v $ -%Revision 3.1 2008/03/23 18:04:51 boris +%Revision 3.2 2013/10/11 15:39:35 boris +%Lev's changes +% +%Revision 3.1 2008-03-23 18:04:51 boris %documentation update % %Revision 3.0 2008-03-23 17:50:50 boris @@ -259,13 +262,17 @@ Subject: Otvety komandy "Stop", 222 \begin{verbatim} ВОПРОС NN: \end{verbatim} -\item По два заголовка подразделов: +\item По три заголовка подразделов: \begin{verbatim} -ЗАСЧИТАНЫ ОТВЕТЫ: +ЗАСЧИТАНО: +\end{verbatim} + +\begin{verbatim} +НЕ ЗАСЧИТАНО: \end{verbatim} и \begin{verbatim} -НЕ ЗАСЧИТАНЫ ОТВЕТЫ: +НЕ ЯСНО: \end{verbatim} \item Каждый ответ имеет формат: \begin{verbatim} @@ -273,11 +280,32 @@ s Текст ответа Текст ответа ... [f] \end{verbatim} -Здесь \prog{s}---один из символов \prog{+} или \prog{-}, +Здесь \prog{s}---один из символов \prog{+}, \prog{-}, или \prog{?}, \prog{f}---частота ответа, которая печатается только если она не равна единице. \end{enumerate} +По умолчанию, заголовки всех подразделов выводятся даже если для данного +вопроса нет ответов, попадающих в какой-либо подраздел (подраздел пуст). +Это предсказуемо и удобно, но не всегда удобочитаемо с точки зрения +читателя-человека, поэтому по желанию возможна генерация промежуточного +или короткого вариантов собрания сочинений. От описанного выше полного +формата они отличаются режимом печати пустых подразделов: +\begin{enumerate} +\item В промежуточном формате подразделы \prog{ЗАСЧИТАНО} и + \prog{НЕ ЗАСЧИТАНО} показываются всегда (даже пустые), а подраздел + \prog{НЕ ЯСНО}---только если он не пуст. +\item В коротком формате все подразделы выводятся только если они + не пусты (исключения для \prog{ЗАСЧИТАНО} и \prog{НЕ ЗАСЧИТАНО} + не делаются). +\end{enumerate} + +По мнению автора, промежуточный формат представляет собой оптимальный +компромисс между читаемостью и полнотой (и действительно, зачем +печатать пару десятков пустых \prog{НЕ ЯСНО} в официальной сводке, +в которой уже давно все ясно?) + + \section{Пользовательский интерфейс} @@ -451,10 +479,10 @@ reminder.pl [-r номер_раунда] Итоговая таблица и собрание сочинений генерируются программами \begin{verbatim} createtable.pl [-d] [-s|-m] [-t table_file] [-o results] -collection.pl [-d] [-t table_file] [-o results] +collection.pl [-d] [-s|-m] [-t table_file] [-o results] \end{verbatim} -Ее ключи имеют то же смысл, что и у программы \prog{processmail.pl}. -Флаг \prog{-s} означает выбор короткой формы таблицы, а флаг \prog{-m} +Ключи имеют тот же смысл, что и у программы \prog{processmail.pl}. +Флаг \prog{-s} означает выбор короткой формы вывода, а флаг \prog{-m} означает выбор промежуточной формы. \section{Программа} @@ -470,7 +498,7 @@ collection.pl [-d] [-t table_file] [-o полями: \begin{description} \item[\prog{regnum}] регистрационный номер - \item[[\prog{numletters}] количество писем с ответами + \item[\prog{numletters}] количество писем с ответами \item[\prog{answers}] ссылка на массив из ответов \item[\prog{score}] общий итог \item[\prog{rating}] общий рейтинг