[xmlroff] Introduction

[Matthew M. <mm...@ma...>]

I'm new to the list, so I'm doing a little introduction. My name is 
Matthew Mackey - everyone calls me Matt - and I'm here to lend what 
help I can to the project. My skill set is mildly eclectic, having a 
good C/C++ and Java foundation with a variety of database and 
multimedia stuff thrown in.

Tony already sent me some ideas about things that could use attention. 
I figure since I like to really get my head around something before I 
dive in, time I spend getting to know the project would be good for 
enhancing the documentation, something that Tony mentioned needs doing.

So one of my first questions would be about what format(s) should the 
documentation be in. I believe (correct me if I'm wrong) I saw javadoc 
style comments/markup in some of the files in my initial glance. So 
that would be one area to continue expanding. But I'm assuming that 
there's a desire for external documentation as well. Perhaps a primer 
of some sort that would cover internal structure for xmlroff developers 
and/or proper usage for those trying to use it in a solution? Should it 
be html? Raw text? (Or even XML and XSL sheets so we can make PDFs of 
it with xmlroff! Okay, I'm getting ahead of myself...)

I'm open to ideas...

Matt