Installation guide

4.4.10 CFPROCESSINGDIRECTIVE SuppressWhiteSpace Attribute
The CFPROCESSINGDIRECTIVE tag in CFML was introduced in CF5 with an available
SuppressWhiteSpace attribute to control the creation of extra whitespace characters. It is
designed to be used as a tag pair, affecting all code executed within the tag pair.
BlueDragon supports this tag with the following extended capabilities.
There is also an available Administrator setting to turn on whitespace suppression by
default for all pages, and this is available in BlueDragon as within ColdFusion.
BlueDragon’s whitespace suppression is more thorough than ColdFusion’s, which is gen-
erally desirable as it reduces the total size of the HTML response sent to the client. It
may, however, eliminate whitespace where it’s undesirable, such as within JavaScript or
within HTML tags such as
PRE and TEXTAREA. You can vary the whitespace suppression
in such cases by surrounding the tags or text with a
<CFPROCESSINGDIRECTIVE
SUPPRESSWHITESPACE="No"> pair. You can also nest CFPROCESSINGDIRECTIVE tag
pairs.
Also, while in CF5 and CFMX,
CFPROCESSINGDIRECTIVE settings do not apply to
templates included by
CFINCLUDE or called as CFC methods or custom tags/CFMODULE.
BlueDragon does propagate this setting into templates executed this way. Again, this is
generally an enhancement and a desirable feature. It can cause problems with applica-
tions that are not expecting it.
This problem arises with Fusebox applications. Since the core files intentionally turn on
whitespace suppression, in BlueDragon that behavior trickles down to all pages included
from the core files (which in Fusebox is all files in the applications). This unexpected
behavior can cause the challenges described above with respect to JavaScript and tags
such as
PRE and TEXTAREA.
Again, if you have nested templates that you would not want to inherit this behavior,
simply use a
CFPROCESSINGDIRECTIVE tag within that nested template to set the desired
behavior for that template.
Also, just as CFMX introduced the ability to specify the attribute value (“yes” or “no”) as
a variable, BlueDragon also supports that approach.
4.4.11 CFQUERY
4.4.11.1 New PreserveSingleQuotes Attribute
BlueDragon, like ColdFusion, automatically “escapes” single-quote characters within
CFML variables used to create SQL statements within
CFQUERY tags. For example, the
following SQL will work correctly because the single quote within the string, “O’Neil”,
will be escaped before being passed to the database:
<CFSET EmployeeName=”O’Neil”>
<CFQUERY NAME=”employees” DATASOURCE=”MyCompany”>
SELECT * FROM Employees
BlueDragon 6.1 CFML Compatibility and Reference Guide 20