Bug 9243 - изменение документа для соответствия реалиям
Summary: изменение документа для соответствия реалиям
Status: CLOSED FIXED
Alias: None
Product: Branch 3.0
Classification: Archive
Component: docs-postfix-kirill (show other bugs)
Version: 3.0
Hardware: all Linux
: P2 normal
Assignee: kirill
QA Contact: at@altlinux.org
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-03-14 17:37 MSK by Artem Zolochevskiy
Modified: 2006-08-30 22:31 MSD (History)
2 users (show)

See Also:


Attachments
мои предложения по измененю (3.44 KB, patch)
2006-03-14 17:38 MSK, Artem Zolochevskiy
no flags Details | Diff
улучшенный патч, синтаксически корректный DocBook (4.17 KB, patch)
2006-03-14 18:56 MSK, kirill
no flags Details | Diff
postfix.xml.diff (6.50 KB, patch)
2006-03-17 05:06 MSK, Dmitry V. Levin
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
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