Diff for /processmail/process.tex between versions 3.1 and 3.2

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}] общий рейтинг

Removed from v.3.1  
changed lines
  Added in v.3.2


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>