Horrible! Why invent your own markup syntax instead of using XML?
Use something like:
<doc:overview>This xsl page is used to calculate the
factorial of a given number</doc:overview>
Then you can use XSLT to manipulate the documentation.
Other people have done work on stylesheet annotation, I'm sure there's
something you can re-use but I can't point you to it.
but if you look on sourceforge for the docbook stylesheets,
Norm Walsh has some really elegant stuff wrapped in his stylesheets.
NOTICE: The information contained in this email and any attachments is
confidential and may be legally privileged. If you are not the
intended recipient you are hereby notified that you must not use,
disclose, distribute, copy, print or rely on this email's content. If
you are not the intended recipient, please notify the sender
immediately and then delete the email and any attachments from your
RNIB has made strenuous efforts to ensure that emails and any
attachments generated by its staff are free from viruses. However, it
cannot accept any responsibility for any viruses which are
transmitted. We therefore recommend you scan all attachments.
Please note that the statements and views expressed in this email
and any attachments are those of the author and do not necessarily
represent those of RNIB.
RNIB Registered Charity Number: 226227
XSL-List info and archive: http://www.mulberrytech.com/xsl/xsl-list