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