Okay, I give in.
Due to lack of interest on CF-Talk, let's keep this on the FuseBox list for
now. I still want to insist on a general syntax that is not
FuseBox-specific.
As for PDL, I must admit that I'm a bit of a fan. What I'm looking for,
though, is a general documentation syntax that can be used for PDL's
comment-first development, or PragmaticProgrammers' code-by-contract
development, or any process that you happen to fancy. You could, for
example, have comments like this:
<!---@ PDL: Keep track of current number of resources --->
<!---@ PDL: If another resource is available --->
<!---@ PDL: Allocate a dialog box structure --->
etc
etc
(example from Steve McConnell's Code Complete).
This could be parsed out and displayed along with all your other <!---@
comments.
Just need some way to handle indenting, though I guess you could just put
tabs in the CommentContent??
Lee (Bjork) Borkman
http://bjork.net ColdFusion Tags by Bjork
------------------------------------------------------------------------------
To Unsubscribe visit
http://www.houseoffusion.com/index.cfm?sidebar=lists&body=lists/fusebox or send a
message to [EMAIL PROTECTED] with 'unsubscribe' in the body.
