On Mon, Aug 25, 2014 at 04:19:37PM -0400, Dan Espen wrote:
> Very sorry you still don't like the XML format.
> I find it clumsy, but I'm willing to put up with it.
> Personally I almost always go online and read Fvwm man pages
> as HTML. Anything we can come up with that renders HTML
> is good with me.
That's definitely an output format we'll be doing, even with mdoc---to
lose that would be irritating to say the least.
> I want to mention, when I wrote F_CMD_ARGS,
> one of the things I had in mind was to put function
> documentation in the .c files. I envisioned some kind of
> extract run generating the actual man page input.
> I was trying to make the functions easy to find by giving
> them a uniform appearance.
Interesting. Whilst I don't like macros in place of formal function
arguments myself, I can see why you did this, Dan. On the point about
documentation, this is precisely what doxygen allows for. We could
always make use of that---and certainly it would be an interesting
excerise to do, as it would help appraise and justify the existing
functions we have, and help identify any potential cleanups, etc.
I'll add this to the TODO for consideration.
Thanks. :)
-- Thomas Adam
--
"Deep in my heart I wish I was wrong. But deep in my heart I know I am
not." -- Morrissey ("Girl Least Likely To" -- off of Viva Hate.)
