Re: Managing "comments" in XML documents like any other XML content
I'm trying to make the case for treating code 'comments' written in XMLNot a new idea.
documents as content. That is, I want to tag comments with a <comment>
element instead of "commenting it out" using the SGML comments notation
<!--comment goes here--!>.
It certainly makes sense to have comments you can retrieve with a simple XML parser -- something you can't do with SGML comments. The downside is that you can get in trouble if <comment> isn't a part of your official syntax, whereas SGML comments always work.
ROBOHELP FOR FRAMEMAKER TRIAL NOW AVAILABLE!
RoboHelp for FrameMaker is a NEW online publishing tool for FrameMaker that
lets you easily single-source content to online Help, intranet, and Web. The interface is designed for FrameMaker users, so there is little or no
learning curve and no macro language required! Call 800-718-4407 for competitive pricing or download a trial at: http://www.ehelp.com/techwr-l4
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.
Previous by Author:
Re: So Much for that
Next by Author: Re: deu7ter7an7opic
Previous by Thread: Re: Managing "comments" in XML documents like any other XML content
Next by Thread: Re: Managing "comments" in XML documents like any other XML content
Search our Technical Writing Archives & Magazine