Jonathan-san wrote:
> Yea, but now I will have to learn the dtd and create complex stylesheets.
> Gentlemen. if I may be frank, this is an excercise in technical
> masturbation. If I ever want to redo it all.....than I will. Stylesheets
> do not help, and those that have had to use them know exactly what I am
> talking about.
I use them. And the more I use them, the more I like them. Just look at the
power behind the current Struts' documentation xml, namely DTD and the user
manuals for the tags get generated from a single XML file. The next logical
step is to have that XML file generated from JavaDoc, so that if the
specification of a tag changes, the change can easily be reflected in the DTD
and manual without having to edit external documents.
I'm currently looking at the idea of creating pages in XML that generate JSP
pages (with Struts tags among others) and help HTML files. The help files
can also be processed with FOP for a PDF manual. One source, multiple
integrated, cross referenced outputs.
No, it isn't easy. But for building a complex system where source and
documentation may be managed together, it's a very powerful tool.
MS Word attachments and mail in HTML format (70% of the spam I recieve) get
filtered to /dev/null. I won't touch them. (Why does Outlook's HTML
messages take up to 32 times the plain text size?) In fact, lot of messages
got filtered the past couple of weeks since. Even though most of you have
HTML mail turned off, Outlook assumes that when replying to an HTML message,
you want to send in HTML format, too. Judging form the headers in my spam
log, I belive that Mozilla is equally guilty, so I'm not just picking on MS.
Should proper mail netiquitte be included on the mail subscription page? The
FAQ that comes periodically in the DocBook mailing list spells out proper
quoting technique (snip-quote-reply) rather nicely, and establishes policies
for attachments and cross posting.
--
Michael Westbay
Work: Beacon-IT http://www.beacon-it.co.jp/
Home: http://www.seaple.icc.ne.jp/~westbay
Commentary: http://www.japanesebaseball.com/
