From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <vyt@vzljot.ru>
Date: Fri, 1 Mar 2002 19:28:28 +0300
From: Vyt <vyt@vzljot.ru>
To: devel@altlinux.ru
Message-Id: <20020301192828.26ba3c9c.vyt@vzljot.ru>
In-Reply-To: <20020301171731.GC20427@ramax.spb.ru>
References: <20020301184826.16a3b037.vyt@vzljot.ru>
	<20020301161028.GA9421@home-pool4-65.com2com.ru>
	<20020301171731.GC20427@ramax.spb.ru>
X-Mailer: Sylpheed version 0.7.2 (GTK+ 1.2.10; i586-alt-linux)
Mime-Version: 1.0
Content-Type: multipart/signed; protocol="application/pgp-signature";
 micalg=pgp-sha1; boundary="=.YPyolm+7q3g02H"
Subject: [devel] Re: docs creations
Sender: devel-admin@altlinux.ru
Errors-To: devel-admin@altlinux.ru
X-BeenThere: devel@altlinux.ru
X-Mailman-Version: 2.0
Precedence: bulk
Reply-To: devel@altlinux.ru
List-Help: <mailto:devel-request@altlinux.ru?subject=help>
List-Post: <mailto:devel@altlinux.ru>
List-Subscribe: <http://altlinux.ru/mailman/listinfo/devel>,
	<mailto:devel-request@altlinux.ru?subject=subscribe>
List-Id: <devel.altlinux.ru>
List-Unsubscribe: <http://altlinux.ru/mailman/listinfo/devel>,
	<mailto:devel-request@altlinux.ru?subject=unsubscribe>
List-Archive: <http://altlinux.ru/pipermail/devel/>
Archived-At: <http://lore.altlinux.org/devel/20020301192828.26ba3c9c.vyt@vzljot.ru/>
List-Archive: <http://lore.altlinux.org/devel/>
List-Post: <mailto:devel@altlinux.org>

--=.YPyolm+7q3g02H
Content-Type: text/plain; charset=KOI8-R
Content-Transfer-Encoding: 8bit

On Fri, 1 Mar 2002 20:17:31 +0300
Igor Homyakov <homyakov@ramax.spb.ru> wrote:

<skipped>

> > > Было бы просто здорово, если бы кто-нибудь из корифеев разразился
> > > кратким введением на тему _правильного_ написания документации.
> > > Хотя бы в виде набора ссылок для начинающих...
> > > 
> > > Интересует формат, инструменты, необходимые пакеты из Sisyphus,
> > > приемы. 
> > > 
> > > Из имеющегося обилия сложно выбрать нужное, после ковыряния с
> > > postfix.xml от MhZ смотрю на http://www.docbook.org, чувствую,
> > > что это надолго :)
> > > 
> > 
> > Можно, например, на texinfo.

Плохо выразился - нужно писать документацию не к исходным
текстам, скорее общая, например, к jabber ;)

> На мой взгляд docbook представляеться боллее правильным решением

Спасибо!

Нашел великолепную статью Бориса Тоботраса
http://xtalk.opensource.ru/SGML/SGML-article.html
Он меня не убедил, он меня выразил :)

Похоже, что форматом лучше взять sgml с docbook-dtds, если не
прав - поправьте, pls.

<skipped>

-- 
Regards, Vyt
mailto:  vyt@vzljot.ru
JID:     vyt@vzljot.ru

--=.YPyolm+7q3g02H
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)

iD8DBQE8f6wvd6sY3eC5PjQRAhIqAJ9piU4B19Cy4ulKdOoLCRZ2u208SQCg5c4S
TGJLBtaBACXxPz24q6IfLzU=
=N4hq
-----END PGP SIGNATURE-----

--=.YPyolm+7q3g02H--