--- processmail/process.tex 2005/02/20 03:24:43 2.7 +++ processmail/process.tex 2008/03/23 18:04:51 3.1 @@ -1,5 +1,11 @@ -%$Id: process.tex,v 2.7 2005/02/20 03:24:43 boris Exp $ +%$Id: process.tex,v 3.1 2008/03/23 18:04:51 boris Exp $ %$Log: process.tex,v $ +%Revision 3.1 2008/03/23 18:04:51 boris +%documentation update +% +%Revision 3.0 2008-03-23 17:50:50 boris +%Added Lev's corrections +% %Revision 2.7 2005/02/20 03:24:43 boris %Wrote readme % @@ -57,7 +63,7 @@ \title{Программа для обработки писем в ИГП и ИЧБ} \author{Boris Veytsman, \texttt{borisv@lk.net}} -\date{Февраль 2005} +\date{Март 2008} \maketitle \thispagestyle{empty} \tableofcontents @@ -203,7 +209,7 @@ Subject: Otvety komandy "Stop", 222 \subsection{Формат таблицы результатов} -У таблицы результатов есть два формата. +У таблицы результатов есть три формата. \begin{enumerate} \item Длинный формат \begin{verbatim} @@ -212,6 +218,19 @@ Subject: Otvety komandy "Stop", 222 436 + + + + + + + + + + + + 12.02 359 Venera II [...] \end{verbatim} + +\item Промежуточный формат +\begin{verbatim} + N 12345 67890 12 О Р КОМАНДА + 111 +++++ +++++ ++ 12.04 359 Марсиане + 436 +++++ +++++ ++ 12.04 359 Venera II +[...] +Рейтинг + 1 2 3 4 5 6 7 8 9 10 11 12 +24 21 34 24 41 43 18 31 26 32 36 29 +\end{verbatim} + + \item Короткий формат \begin{verbatim} N 123456789012 О Р КОМАНДА @@ -229,6 +248,9 @@ Subject: Otvety komandy "Stop", 222 таблица ``Рейтинг''. В графе ``О'' стоят набранные командой очки в данном зачёте (до десятичной точки) и в предыдущем (после точки). +При печати незачетных вопросов взятый вопрос помечается буквой +\prog{X}, а невзятый, как обычно, \prog{-}. + \subsection{Формат собрания сочинений} Собрание ответов на каждый вопрос имеет следующую структуру: @@ -267,6 +289,8 @@ s Текст ответа Настройки программы хранятся в файле \prog{parameters.pl}. Пример этого файла приведен ниже: \begin{verbatim} +# В этом файле собраны ЛОКАЛЬНЫЕ параметры -- "настройки" +# # Количество зачётов $ROUNDS=2; @@ -286,9 +310,21 @@ $NAME[1]="Спринт"; $MINQUEST[1]=1; $MAXQUEST[1]=12; -# Файлы раунда. Следующий перекрывает предыдущий: +# Файлы раунда. Следующий перекрывает предыдущий. +# Список заключён в квадратные скобки, отдельные файлы разделены ЗАПЯТЫМИ. +# $FILES[1] = [ "sprint.mail", "sprint-extra.mail" ]; +# +# ВНИМАНИЕ: формат этого параметра изменился с предыдущей версии! + +$FILES[1]= [ 'sprint.mail' ]; + +# Внезачётные вопросы раунда. В квадратных скобках, номера разделены ЗАПЯТЫМИ. +# Во втором раунде эти вопросы тоже будут вне зачёта (но можно будет и +# учесть, см. ниже описание $NOCOUNT[2]). +# $NOCOUNT[1] = []; +# $NOCOUNT[1] = [ 2, 3, 4 ]; -$FILES[1]='sprint.mail'; +$NOCOUNT[1]= []; # Второй раунд @@ -302,10 +338,24 @@ $NAME[2]="Стайер"; $MINQUEST[2]=1; $MAXQUEST[2]=18; -# Файлы раунда. Следующий перекрывает предыдущий. Файлы разделены -# ПРОБЕЛАМИ +# Список заключён в квадратные скобки, отдельные файлы разделены ЗАПЯТЫМИ. +# $FILES[2] = [ 'predvarit.mail', 'osnovn.mail' ]; +# +# ВНИМАНИЕ: формат этого параметра изменился с предыдущей версии! + +$FILES[2]= [ 'stayer.mail' ]; + +# Внезачётные вопросы в этом раунде. В квадратных скобках, через ЗАПЯТУЮ. +# Этот список ДОБАВЛЯЕТСЯ к уже перечисленным в $NOCOUNT[1]. Однако +# если вы хотите исключить какой-то из ранее указанных вопросов (например, +# в гипотетической ситуации "вопрос номер 5 был исправлен слишком поздно, +# поэтому в Спринте не учитывается, а для Стайера используется"), то +# укажите его номер со знаком минус: "3 -5 6" +# $NOCOUNT[2] = []; +# $NOCOUNT[2] = [ 3, -5, 6 ]; + +$NOCOUNT[2]= []; -$FILES[2]='stayer.mail'; ######################################################### # Теперь общие настройки @@ -320,12 +370,13 @@ $address = 'z-info@chgk.info'; # # Обратный адрес дежурной команды и ее название # -$fromaddress = 'borisv@lk.net'; +$fromaddress = 'Boris Veytsman '; $DK = '"Дракоша"'; # # $date -- системная процедура, которая вычисляет МОСКОВСКОЕ # время. В Линуксе zdump это делает хорошо. В других операционных -# системах надо как-то исхитряться... +# системах надо как-то исхитряться... На самый худой конец, используйте +# $date=''; # $date = "export TZ='Europe/Moscow'; date"; @@ -362,7 +413,6 @@ Good luck END } - \end{verbatim} @@ -400,11 +450,12 @@ reminder.pl [-r номер_раунда] Итоговая таблица и собрание сочинений генерируются программами \begin{verbatim} -createtable.pl [-d] [-s] [-t table_file] [-o results] +createtable.pl [-d] [-s|-m] [-t table_file] [-o results] collection.pl [-d] [-t table_file] [-o results] \end{verbatim} Ее ключи имеют то же смысл, что и у программы \prog{processmail.pl}. -Флаг \prog{-s} означает выбор короткой формы таблицы. +Флаг \prog{-s} означает выбор короткой формы таблицы, а флаг \prog{-m} +означает выбор промежуточной формы. \section{Программа} @@ -439,7 +490,9 @@ collection.pl [-d] [-t table_file] [-o \section{Благодарности} Я благодарен Якову Зайдельману, Льву Горенштейну, Алексу Покрасу и -Дмитрию Рубинштейну за помощь в разработке этой программы. +Дмитрию Рубинштейну за помощь в разработке этой программы. Версия~3 +программы (поддержка незачетных вопросов и промежуточного формата +таблицы) была написана Львом Горенштейном. \end{document}