======Dev Source Tag======

=====DEV:SOURCE=====

Dump a section of the PHP source being generated by compile time components.

    <dev:source>

        <!-- Some other tags in here to display the generated PHP source for -->

    </dev:source>


====Attributes====

<dev:source raw="true" /> will result the source being displayed exactly as it appears in the compiled template (i.e. more of less unreadable). If the raw attribute is not specified, the tag will display the source with some basic formatting for reability (linefeeds).

====Description====

The [[DevSourceTag]] is a [[CompilerDirectiveTag]]. It is indended for use by developers when building their own tags, to allow them to see the PHP code being generated for the compiled template, as well as general template debugging.

Be warned that you cannot wrap all tags in a <dev:source /> tag, as there may be issues with the nesting level (e.g. an <input /> tag expects to be nested in a <form /> tag - placing it inside a <dev:source /> tag will result in errors).