Okay,
I see we are all heartily sick of this discussion. As Hal says, we should
all do what suits us best. And as Chris says, some kind of common approach
benefits everyone.
I like Hal's new-look FuseDocs. Although they are designed for the FuseBox
explicitly, I can see no reason why they shouldn't be used in non-FuseBox
development. I therefore plan to use them myself, and hope that everyone
else will as well.
I have also seen that some of us feel the need for inline comments as well.
I therefore intend to go on using my proposed syntax for inline comments:
<!---@ Description: this is an inline comment --->
<!---@ Fuseaction: listcurrentUsers: List all current users --->
There is, obviously, no incompatibility between the two. I do my main
Fuse-stub commenting at the top, using Hal's FuseDoc syntax. If I need
inline comments (individual FuseActions, PDL, etc), I can use my inline
syntax.
The Doc parser then needs to integrate the FuseDoc and inline comments into
the parsed structure. I will publish such a parser in the next week or so,
and hook it into my SourceBrowser.
Thanks all for your tolerance,
Lee Bjork Borkman
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.
