MACROMEDIA ColdFusion MX, Develop Manual, Page: 405 / 860

Using the Code Compatibility Analyzer 405
Note: If you specify inline trace output, and a
cftrace
tag is inside a
cfsilent
tag block, ColdFusion
does not display the trace information in line, but does include it in the standard debugging display.
The following
cftrace
tag displays the information shown in the example output and log entry
in the “About the cftrace tag” section:
<cftrace abort="False" category="UDF End" inline = "True" text = "GetRecords
UDF
call has completed" var = "MyStatus">
Using the Code Compatibility Analyzer
The Code Compatibility Analyzer has two purposes:
•
It can validate your application’s CFML syntax. To do so, the analyzer runs the ColdFusion
compiler on your pages, but does not execute the compiled code. It reports errors that the
compiler encounters.
•
It can identify places where ColdFusion MX might behave differently than previous versions.
The analyzer identifies the following kinds of features:
■
No longer supported Their use results in errors. For example, ColdFusion now generates
an error if you use the
cflog
tag with the
thread="Yes"
attribute.
■
Deprecated They are still available, but their use is not recommended and the they might
not be available in future releases. Deprecated features might also behave differently now
than in previous releases. For example, the
cfservlet
tag is deprecated.
■
Modified behavior
They might behave differently than in previous versions. For example,
the
StructKeyList
function no longer lists the structure key names in alphabetical order.
The analyzer provides information about the incompatibility and its severity, and suggests a
remedy where one is required.
type A ColdFusion logging severity type. The inline trace display and dockable.cfm
output format show a symbol for each type. The default debugging output shows
the type name, which is also used in the log file. The type name must be one of
the following:
Information (default)
Warning
Error
Fatal Information
var The name of a single variable that you want displayed. This attribute can specify a
simple variable, such as a string, or a complex variable, such as a structure name.
Do not surround the variable name in pound signs.
Complex variables are displayed in inline output in
cfdump format; the debugging
display and log file report the number of elements in the complex variable,
instead of any values.
You can use this attribute to display an internal variable that the page does not
normally show, or an intermediate value of a variable before the page processes it
further.
To display a function return value, put the function inside the message. Do not
use the function in the
var attribute, because the attribute cannot evaluate
functions.
Attribute Purpose