svn commit: samba r1052 - branches/SAMBA_4_0/source/lib/ldb/man/man3

[Gerald (Jerry) Carter]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

tridge at samba.org wrote:

| I also think that we don't need to tie the source format of the
| programmer docs to the source format of the user docs. You've
| done a great job developing a documentation framework for
| the Samba user docs, but that framework is a bit heavy-weight
| for libraries like tdb or ldb. For those something light-weight
| (like yodl or plain text) is good. This is especially the case
| as there are no internationalisation issues with programmer docs.

Tridge,

This is a really bad idea.  If you want anyone else other
than you to maintain the docs for ldb or another of piece
of Samba, please consider keeping them in Docbook XML.
Yodl is dead (no one uses it) and plain text files are
hard to format & print.





cheers, jerry
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFAxbpIIR7qMdg1EfYRAktwAJ9neCBfedHjviTVJibXaNHWysko5wCfUrAs
JF2b0MqEAQVNz7GjLytVrQ0=
=H1GL
-----END PGP SIGNATURE-----