• if the first two letters of a variable name are upper case, leave them unchanged (e.g. URL remains as URL)
• otherwise ensure the first character becomes lower-case.

• s1 if that is a non-empty string (i.e. length>0);
• otherwise it is s2 if that is a non-empty string .
• otherwise it is s3. This can be used to construct a default.

• the initial indentation is 0 (which is appropriate for dumping a complete XML document, starting with the root element)
• the column position of attributes - which is 36 as of this writing.

• the original inputString is returned as the value of the method
• in verbose logging level, a log will be made of the reason for the exception, but this will not abort the build.

• what the initial indent of this sequence should be. This does not affect the attributeTabPosition - attributes will output in the specified column if possible.
• the attribute tab position (i.e. the column position on which attributes are output)

• if only we could write this syntax in Velocity. For example, $this.getAttributeOrProperty( "description" ) is the same as $this.description.

• it is preceded by a lower-case or numeric letter, or
• it is the last in the sequence of capital letters and followed by a lower-case letter.

• getCapsAndSeparatorName( "boy-band", "_" )="Boy_Band" // JavaClass form="BoyBand"
• getCapsAndSeparatorName( "XYZCorp", " " )="XYZ Corp" // "C" is last in sequence of capital letters
• getCapsAndSeparatorName( "XYZ.Corp", "/" )="XYZ.Corp" // no change - last in sequence not followed by letter

• $newArrayList (from getNewArrayList)
• $newHashMap (from getNewHashMap)
• $newListMap (from getNewListMap)
• $newTreeMap (from getNewTreeMap)
• $getNewControl(from getNewControl)

• in the parent chain
• in 'system.properties' for the applicable meta-models
• in the build properties (e.g. build.jwp).

1. capitalise the first character of the name
2. find disallowed characters - XML characters that are not allowed in Java ('.', ':' and '-')
3. remove these characters and capitalise the next character, if any
4. leave the case of characters within the body of the name that do not follow a separator unchanged

• removes punctuation characters
• capitalises the letter following a word break (which is either punctuation or numerics) For example, "n.A-s_t2y" becomes "nAST2Y"

• getNameCapitalised()
• getJavaClassName()
• getJavaVarName()
• getXmlName()

• as a HashMap, with 'put(Object,Object)' to insert key/value pairs, and 'get(Object)' to retrieve them
• as an ArrayList. By iterating through the ArrayList, the keys can be accessed in the order in which they were put in. Given an entry from the this ArrayList, the value must be accessed via 'get( key )'.

• you can use the '#' character as a literal
• calls to macros are ignored during the rendering.

    if( $text)
         $renderedText

• the 'x' component is the major engine version level - 1,2,3,... This is changed when (and if) a major new feature is introduced into the engine. Version 3 introduced patterns and the original version of controls based on Java. Version 4 introduced Java/Velocity controls and object-oriented features (such as methods on objects) into Velocity.
• the 'y' component is the minor engine version level, starting with 0. At this level, a change in the 'y' component implies the introduction of, or change in, minor features. The '0' minor level is the first distributed build of a major version.
• the 'z' component is the distributed build number within the major/minor level, starting with 0.
• the optional 'h' component is present if there is a problem with the x.y.z distribution and identifies hot fixes, starting with 1.

• initial capital letters are made lower cases
• capital letters in the remainder of the input name are also made lower case, but a '-; is inserted before them ... unless there is already a '-' there, in which case this is omitted - to avoid synthetic double '-'s.

• perform additional initialisation
• do more complex validation checks than is possible with the expressions.

• the fully-qualified class name (i.e. with the package), e.g. "uk.co.nte.jw.components.businessObject.DataView"
• the final (last '.' piece) of the class name e.g. "DataView"

• 'addon' if 'inputCSList' is empty (i.e. null or "")
• 'inputCSList' if 'addon' is empty
• otherwise, the concatenation of 'inputCSList', 'separator' and 'addon'.

    #set( $result = "" )
    #foreach( $whatever )
        #set( $result = $this.list( $result, ", ", $whatever.property ) )
    #end

1. = error
2. = warning
3. = info
4. = verbose
5. = debug These values are also defined in antLogLevel* properties in resources/base/control/system.properties

• perform additional initialisation
• do more complex validation checks than is possible with the expressions.

• you can use the '#' character as a literal
• calls to macros are ignored during the rendering
• you cannot define local methods (because the # in '#method()' is taken as a literal), so only methods defined on objects via component.methods or .control files are recognised.

    $this.renderString( "filter-expression", filterExpressionProperty );

• if the value is set more than once, it concatenates the values set (with a ',' separator). This allows the 'sourcePattern' to be used to hold a list of the patterns that have created or altered an object
• it adds the property to the list of set attributes so that the property comes out on the xmlDump.

• getXmlDump()getXmlDump() (the aggregate metaModel after patterns have fired)
• the setAttributes() list.

• chooses the correct quote type
• replaces <& by the correct XML values

• stringToXMLAttr( null ) = [ empty string ]
• stringToXMLAttr( "" ) = [ empty string ]
• stringToXMLAttr( "\"" ) = '"'
• stringToXMLAttr( "'" ) = "'"
• stringToXMLAttr( "&<\">" ) = "&amp;&lt;&quot;>"