> Example: > #* > # @method TRACE Tracing function for logging diagnostic messages > # @param msg STRING Message to send to trace > # @param trace_lvl STRING Level of tracing required to log msg > > Instead of # MODINFO, we start a special comment with #* and keywords are > beginning with @. The "modinfo comment" ends as soon as there is a non > comment line. > > What do you think ?
Sounds good and more compact. However, the parsing engine is written to take each line as a self-contained entry. Each directive's placement in the document affects where it ends up in the parse tree, but each directive line needs to be identifiable as a MODINFO directive in its own right to allow the line-by-line parsing to occur as well as for individual-line parsing. At least that was my original intent. I guess we could deviate or even allow both formats. Perhaps the latter would be the best. > Since I am planning to do more work for the p5ee documention system during > the next time, will take a closer look at your module as soon as I have the > time. I would be interested in helping (as much as I could, anyway). jpt
