Forum OpenACS Improvement Proposals (TIPs): Re: TIP #54 (Proposed) Add an adp tag to handle documenting and commenting adp files.

Collapse
8: Re: TIP #54 (Proposed) Add an adp tag to handle documenting and commenting adp files. (response to 6)
Posted by Tom Jackson on 03/13/04 11:55 PM

Bart: you might refer to the docs on ns_register_adptag first, my examples are how to define a comment tag (or doc tag), in other words it is easy. After defining (registering) the tag, just use it: 

<comment>
@author tom 
@cvs-id $Id$
</comment>

template_tag does a few more nice things on top of ns_register_adptag, but eventually it calls that proc.

Collapse
9: Re: TIP #54 (Proposed) Add an adp tag to handle documenting and commenting adp files. (response to 8)
Posted by Bart Teeuwisse on 03/14/04 12:05 AM
Tom, sure that is how you define and include a custom tag in ADP. And yes, I should have read up on ns_registeradp_tag. I misread you post. :)

Ben, my point is that we shouldn't ignore the content of the tag -all the time-. Instead we should make the documentation available to developers/designers. I think that we should at least outline how the ADP documentation can be used. So that when this TIP gets approved we've decided on format that we can later expand upon with ways to display the documentation.

/Bart