Bug 9243

Summary: изменение документа для соответствия реалиям
Product: Branch 3.0 Reporter: Artem Zolochevskiy <azol>
Component: docs-postfix-kirillAssignee: kirill <kirill>
Status: CLOSED FIXED QA Contact: at <at>
Severity: normal    
Priority: P2 CC: ldv, vvk
Version: 3.0   
Hardware: all   
OS: Linux   
Attachments:
Description Flags
мои предложения по измененю
none
улучшенный патч, синтаксически корректный DocBook
none
postfix.xml.diff none

Description Artem Zolochevskiy 2006-03-14 17:37:37 MSK
надо подчиcтить документ. к примеру убрать упоминания о несуществующих пакетах
postfix-smtpd, postfix-smtpd-sasl и заменить эту информацию на возможность
использования control
Comment 1 Artem Zolochevskiy 2006-03-14 17:38:49 MSK
Created attachment 1428 [details]
мои предложения по измененю
Comment 2 kirill 2006-03-14 18:56:22 MSK
Created attachment 1429 [details]
улучшенный патч, синтаксически корректный DocBook
Comment 3 kirill 2006-03-14 18:57:24 MSK
Прощу мантейнера посмотреть изменения в тексте на адекватность. 
И может быть ещё дополнить? 
Comment 4 kirill 2006-03-14 19:58:01 MSK
Для контекста: полный текст с уже приложенным моим патчем можно прочесть вот здесь:
http://heap.altlinux.ru/alt-docs/modules/postfix.kirill/

В таком виде пошло в Сизиф. 
Comment 5 Artem Zolochevskiy 2006-03-14 22:51:24 MSK
По мелочам...

1. а не потерялось ли в окончательном варианте "и" между TSL_README SASL_README
в разделе "Почтовый сервер для небольших доменов и сетей" ?

2. не нужно ли  поколдовать с разметкой вокруг "postfix-html" в первом разделе?
Или так и задумано? Хотя в дальнейшем смотрю все названия пакетов выделены особо.
Comment 6 Artem Zolochevskiy 2006-03-14 22:59:09 MSK
и еще...

в разделе "Работа в режиме SMTP-сервера"
---
а в качестве SMTP-сервер должен использоваться какой-то внешний узел сети.
---
подразумевается видимо а в качестве SMTP-сервер_а_ ?
Comment 7 kirill 2006-03-15 09:35:58 MSK
Опечатки поправил, спасибо. 
Подождём теперь комментариев от мантейнера, и тогда обновлю в Сизифе и
сделаю backport в 3.0.

Что касается разметки, то документ этот очень старый, и за время его 
жизни много раз менялось представление о том, что и как нужно размечать. 
Сейчас моя точка зрения -- делать только функциональную разметку, т. е. 
каждый тег для достижения какого-то результата в выводе. Если тег не 
используется, ставить его -- только загромождать документ и тратить время.
Comment 8 Dmitry V. Levin 2006-03-17 05:06:08 MSK
Created attachment 1430 [details]
postfix.xml.diff

Основные изменения:
- замена hash на cdb (согласно изменениям в postfix >= 2.2.4-alt3);
- искоренение упоминаний про postmap/postalias с заменой на "service postfix
reload" (последний знает тип, в то время как первые используют
default_database_type).
Comment 9 kirill 2006-03-20 11:18:33 MSK
> Created an attachment (id=1430) [edit]
> postfix.xml.diff

Спасибо, Дима! Приложил, отправил в Кучу. 
Сегодня соберу для Сизифа. 
Однако сразу возникает вопрос: для 3.0 выкладывать в updates или в 
backports? 
Comment 10 kirill 2006-03-20 12:07:43 MSK
В incoming/Sisyphus отправился docs-postfix-kirill-060320-alt1
Исправленный текст опубликован также на 
http://heap.altlinux.ru/alt-docs/modules/postfix.kirill/
Comment 11 Vladimir V. Kamarzin 2006-03-20 12:43:30 MSK
В разделе "Борьба со спамом и почтовыми вредителями" пример подключения
RBL-листов некрректен, в postfix > 2.0 вместо reject_maps_rbl следует
пользоваться reject_rbl_client some.rbl.tld, т.е. пример должен выглядеть
примерно так:

      smtpd_client_restrictions = permit_mynetworks, reject_rbl_client
relays.ordb.org, reject_rbl_client blackholes.mail-abuse.org
Comment 12 kirill 2006-03-20 12:56:05 MSK
Действительно. Принято в Вашем варианте. 
Подождём, может, ещё какие будут поправки, и обновлю снова.
Comment 13 kirill 2006-04-06 18:51:15 MSD
выложил обновление в 3.0/updates