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

Martin S. Weber wrote:
> On Sat, Mar 31, 2007 at 02:24:21PM +0200, Zafer Aydogan wrote:
>> Yes, NetBSD documentation has always been a pain.
> 
> Well, it was okay some time back.
> 
>> And trying to help improving is a pain too. You need to send xml diffs !
you preffer .doc diffs or what ? AFAIK freebsd has documentation written in
docbook too.
> 
> And that's where the project lost me as a contributor. You want XML?
> Go find the people who want to edit that. Not me. The translation process
> was a nice check to see whether the original doccos were up-to-date.
> Well, then there was that great technical improvement of bringing
> a uberly verbose <censored> into the project and - oh wonder - a
> lot of work went into - make this possible, make that possible, change
> structure here, change stylesheet there - and less into hey let's keep
> this up to date.
I use docbook and xml in day work and I love it:).
> 
> I still believe in the value of good documentation, I still love
> NetBSD for being the system it is (although it seems technical decisions
> partially went away in favor of political decisions), but I don't
> love the system enough to fight XML.
> 
How do you want to write good netbsd project documentation? latex,openoffice ?
latex is dead for me and openoffice is real pain. from docbook you can generate
html,pdf, man pages and more.. . I it can be possible I want also our manual
pages written in xml/docbook :)) it's far more readable then nroff.

> And I suppose I'm not alone on that plank.
> 
> Regards,
> 
> -Martin
> 

- --
- ---------------------------------------------------------------
Adam Hamsik
ICQ 249727910
jabber haad@jabber.org
- ---------------------------------------------------------------
There are 10 kinds of people in the world. Those who understand
binary numbers, and those who don't.
				
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.7 (NetBSD)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFGDorT9Wt2FT7y228RAlv1AKCeQmP2kC8QJxQnQRB21ZUL1qlSWACeOaCm
YzGggUTmQanSU5hOR9OAzAo=
=QPTP
-----END PGP SIGNATURE-----