[BACK]Return to README CVS log [TXT] [DIR] Up to [Local Repository] / processmail

Diff for /processmail/README between versions 2.4 and 3.2

version 2.4, 2005/02/20 03:24:43 version 3.2, 2013/10/11 15:39:35
Line 8 Line 8
 1. УСТАНОВКА И НАСТРОЙКА ПРОГРАММ  1. УСТАНОВКА И НАСТРОЙКА ПРОГРАММ
   
 А. Зайдите на http://internet.chgk.info/boris/processmail и  А. Зайдите на http://internet.chgk.info/boris/processmail и
 скачайте файл processmail.tgz. Распакуйте этот  скачайте файл processmail.zip. Распакуйте этот
 файл на Вашм компьютере. Вы найдете:  файл на Вашм компьютере. Вы найдете:
   
  - README -- этот файл   - README -- этот файл
Line 22 Line 22
      понадобится )       понадобится )
   
 Б. В каждом из файлов processmail.pl, createtable.pl, reminder.pl,  Б. В каждом из файлов processmail.pl, createtable.pl, reminder.pl,
 collection.pl замените первую строку (#!/usr/local/bin/perl) на ссылку  collection.pl замените первую строку (#!/usr/bin/perl) на ссылку
 на положение перла в Вашей системе. Сделайте эти файлы выполняемыми (в  на положение перла в Вашей системе. Сделайте эти файлы выполняемыми (в
 Юниксе это делает chmod a+x *.pl)  Юниксе это делает chmod a+x *.pl)
   
Line 31  collection.pl замените первую строку (#! Line 31  collection.pl замените первую строку (#!
   
 Вот эти параметры задать ОБЯЗАТЕЛЬНО:  Вот эти параметры задать ОБЯЗАТЕЛЬНО:
     
  $NAME[1] и $NAME[2] -- названия зачетов    $NAME[1] и $NAME[2] -- названия зачетов
  $MINQUEST[1], $MAXQUEST[1],  $MINQUEST[2], $MAXQUEST[2] -- номера    $MINQUEST[1], $MAXQUEST[1],  $MINQUEST[2], $MAXQUEST[2] -- номера
       первого и последнего вопросов в каждом зачете        первого и последнего вопросов в каждом зачете
  $FILES[1], $FILES[2] -- названия файлов, куда вы складываете письма    $FILES[1], $FILES[2] -- названия файлов, куда вы складываете письма
       с ответами в каждом зачете.  Э        с ответами в каждом зачете. 
   
   ВНИМАНИЕ: синтаксис переменных $FILES[1] и $FILES[2] изменился по сравнению
             с предыдущей версией скриптов!  Старый файл parameters.pl работать
             НЕ БУДЕТ - необходимо его чуть-чуть поправить.
   
   Вот эти параметры не являются обязательными:
     $NOCOUNT[1], $NOCOUNT[2] -- номера вопросов, которые в каждом зачёте 
         должны идти вне зачёта (например, экспериментальная внезачетная
         бескрылка).  Номера, указанные в $NOCOUNT[1], автоматически 
         добавляются к $NOCOUNT[2] (даже если $NOCOUNT[2] пуст), что является
         удобным и логичным в большинстве случаев.  Если же какой-то из
         номеров из $NOCOUNT[1] нужно *включить обратно* в зачёт во втором
         зачёте, то впишите его в $NOCOUNT[2] со знаком минус.
   
 Вот эти параметры нужны для программы reminder:  Вот эти параметры нужны для программы reminder:
   
  $fromaddress задает Ваш обратный адрес    $fromaddress задает Ваш обратный адрес
  $DK задает название Вашей команды    $DK задает название Вашей команды
  $date -- системная процедура, которая выдает московское время    $date -- системная процедура, которая выдает московское время
     (если Вы не можете его вычислить, напишите просто $date="";)       (если Вы не можете его вычислить, напишите просто $date="";)
  процедуры printheader и printfooter печатают заголовок Вашего    процедуры printheader и printfooter печатают заголовок Вашего
    письма-напоминания на лист z-info        письма-напоминания на лист z-info
   
   
 2. РАБОТА С ПРОГРАММАМИ  2. РАБОТА С ПРОГРАММАМИ
   
Line 71  sprint.mail и stayer.mail. Если от коман Line 85  sprint.mail и stayer.mail. Если от коман
 бросайте туда ВСЕ. Проверьте, что более поздние письма следуют за  бросайте туда ВСЕ. Проверьте, что более поздние письма следуют за
 более ранними.  более ранними.
   
   
 В. Время от времени запускайте   В. Время от времени запускайте 
 reminder.pl -r номер_зачета            reminder.pl -r номер_зачета  
   
 Например,  Например,
 reminder.pl -r 1          reminder.pl -r 1
 или  или
 reminder.pl -r 2          reminder.pl -r 2
   
 Это пошлет на лист z-info сводку о командах, чьи ответы получены. Но  Это пошлет на лист z-info сводку о командах, чьи ответы получены. Но
 не злоупотребляйте сводками, дабы не рассердить Почтмейстера.  не злоупотребляйте сводками, дабы не рассердить Почтмейстера.
   
   
 Г. Когда ответов скопится достаточно, запустите  Г. Когда ответов скопится достаточно, запустите
 processmail.pl  -o scores          processmail.pl  -o scores
 Тогда у Вас получится файл scores примерно такого типа:  Тогда у Вас получится файл scores примерно такого типа:
   
 #1. Frequency: 1. Score: ?  #1. Frequency: 1. Score: ?
Line 94  processmail.pl  -o scores Line 110  processmail.pl  -o scores
   
 Замените "?" на "+" и "-" и запишите файл. Если придут новые письма,  Замените "?" на "+" и "-" и запишите файл. Если придут новые письма,
 бросьте их все в тот же файл (НЕ УБИРАЯ СТАРЫХ!!!).  Команда  бросьте их все в тот же файл (НЕ УБИРАЯ СТАРЫХ!!!).  Команда
 processmail.pl -t scores  -o scores          processmail.pl -t scores  -o scores
 добавит в файл scores ответы, которых Вы еще не оценили.  добавит в файл scores ответы, которых Вы еще не оценили.
   
 Примечания:  Примечания:
 -----------  -----------
 (1) Если файла scores еще не существует, команда  (1) Если файла scores еще не существует, команда
 processmail.pl -t scores  -o scores          processmail.pl -t scores  -o scores
 выдает ошибку. Используйте  выдает ошибку. Используйте
 processmail.pl   -o scores          processmail.pl   -o scores
 (2) НЕ используйте команду типа  (2) НЕ используйте команду типа
 processmail.pl -t scores > scores          processmail.pl -t scores > scores
 Это приведет к уничтожению ваших старых оценок.  Это приведет к уничтожению ваших старых оценок.
   
   
 Д. Когда срок приема ответов истечет, ПРОВЕРЬТЕ ваши оценки. Неприятно  Д. Когда срок приема ответов истечет, ПРОВЕРЬТЕ ваши оценки. Неприятно
 наталкиваться на собственную небрежность, правда?  наталкиваться на собственную небрежность, правда?
   
 Команда  Команда
 createtable.pl  -t scores -o table          createtable.pl  -t scores -o table
 создаст файл table с таблицей результатов, а команда  создаст файл table с таблицей результатов, а команда
 collection.pl  -t scores -o collection          collection.pl  -t scores -o collection
 создаст файл collecton с собранием сочинений.  создаст файл collecton с собранием сочинений.
   
 Если вопросов много, формат вывода команды createtable.pl может  Если вопросов много, формат вывода команды createtable.pl может
 оказаться неудобным.  В этом случае используйте формат  оказаться неудобным.  В этом случае используйте формат
 createtable.pl -s  -t scores -o table          createtable.pl -s  -t scores -o table
 Ключ -s (от Short) выводит ответы в "сжатом" формате.  или
           createtable.pl -m  -t scores -o table
   Ключ -s (от Short) выводит ответы в "сжатом" формате   ("++-+-++-+-++-+-").
   Ключ -m (от Medium) выводит ответы в "среднем" формате ("++-+-  ++-+-  ++-+-").
   
   
   У команды collection.pl тоже есть ключи '-m' и '-s'.  По умолчанию,
   для каждого вопроса выводятся списки всех полученных ответов, разбитые
   на подкатегории "ЗАСЧИТАНО", "НЕ ЗАСЧИТАНО", "НЕ ЯСНО":
           ВОПРОС 1:
           
           ЗАСЧИТАНО:
           
           НЕ ЗАСЧИТАНО:
           - неправильно
           
           НЕ ЯСНО:
           
   (даже если в соответствующей подкатегории нет ответов).
   
   С ключом -s (от Short) печатаются только те подкатегории, в которых
   есть хоть один ответ - а пустые подкатегории ("ЗАСЧИТАНО" и "НЕ ЯСНО"
   в примере выше) не печатаются совсем.  Это компактнее, но менее 
   предсказуемо.
   С ключом -m (от Medium) собрание сочинений будет иметь промежуточный
   вид - подкатегории "ЗАСЧИТАНО" и "НЕ ЗАСЧИТАНО" печатаются всегда 
   (даже если пустые), а "НЕ ЯСНО" - только если в ней что-то есть.
   
   По опыту, наиболее удобный формат для человеческого восприятия 
   собраний сочинений - '-m', хотя это, конечно же, дело вкуса.  
   В любом случае, если ответы в какой-то подкатегории *есть*, то
   они будут напечатаны (т.е. ничего не пропадает, речь только о том,
   как программа себя ведет при отсутствии соответствующих ответов).
   
   
 Перед посылкой на общий лист просмотрите файлы еще раз -- а вдруг  Е. Перед посылкой сгенерированных файлов а общий лист просмотрите 
 ошиблись Вы или я?  файлы еще раз -- а вдруг ошиблись Вы или я?
   
 Вот и все!  Вот и все!
   
   
 3. РАЗНЫЕ РАЗНОСТИ  3. РАЗНЫЕ РАЗНОСТИ
   
 В файле process.tex хранится техническая документация к  В файле process.tex хранится техническая документация к
Line 137  createtable.pl -s  -t scores -o table Line 187  createtable.pl -s  -t scores -o table
 ключом программы печатают массу всякой дополнительной информации --  ключом программы печатают массу всякой дополнительной информации --
 полезной и не очень...  полезной и не очень...
   
   
 4. АВТОР  4. АВТОР
   
 Борис Вейцман, borisv@lk.net  Борис Вейцман, borisv@lk.net
Line 144  createtable.pl -s  -t scores -o table Line 195  createtable.pl -s  -t scores -o table
 Я благодарен Якову Зайдельману, Льву Горенштейну, Алексу Покрасу и  Я благодарен Якову Зайдельману, Льву Горенштейну, Алексу Покрасу и
 Дмитрию Рубинштейну за помощь в разработке этой программы.  Дмитрию Рубинштейну за помощь в разработке этой программы.
   
 $Id$  
   
   $Id$
Removed from v.2.4  
changed lines
  Added in v.3.2

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