diff options
Diffstat (limited to 'cpp')
| -rwxr-xr-x | cpp/config/PropertyNames.xml | 49 |
1 files changed, 24 insertions, 25 deletions
diff --git a/cpp/config/PropertyNames.xml b/cpp/config/PropertyNames.xml index 5b090c93188..32e3c1de7dc 100755 --- a/cpp/config/PropertyNames.xml +++ b/cpp/config/PropertyNames.xml @@ -17,35 +17,34 @@ several languages (and risk having them go out of sync). Syntax: Root node: properties, no attributes -The root node has 0 or more section elements. section elements must have a -name atttribute which defines a "section label". section elements may also -have a noCmdLine attribute. If noCmdLine has the value of "true", command -line options that match the section label will not be parsed in the -Ice::PropertiesI::parseCommandLineOptions(). If noCmdLine has a value -other than "true" or is omitted, -Ice::PropertiesI::parseCommandLineOptions() will process properties that -match the resepctive section name. - -Each section node has 0 or more property elements. property elements must -have a name attribute. property elements may also have a proxy attribute or -a threadpool attribute. A proxy attribute with the value of "true" cause -additional Ice proxy specific properties to be generated by makeprops.py. -Similarily, a threadpool attribute with the value "true" cause additional -thread pool specific properties to be generated by makeprops.py. See +The root node has 0 or more section elements. Section elements must have a +name atttribute which defines a "section label". Section elements may also +have a noCmdLine attribute. If noCmdLine has the value "true", command +line options that match the section label are not parsed by +Ice::PropertiesI::parseCommandLineOptions(). If noCmdLine has a value +other than "true" or is omitted, Ice::PropertiesI::parseCommandLineOptions() +processes properties that match the resepctive section name. + +Each section node has zero or more property elements. Property elements must +have a name attribute. Property elements may also have a proxy attribute or +a threadpool attribute. A proxy attribute with the value "true" causes +additional Ice proxy-specific properties to be generated by makeprops.py. +Similarily, a threadpool attribute with the value "true" causes additional +thread pool-specific properties to be generated by makeprops.py. See makeprops.py for details on the additional properties that are generated. The property generation triggered by the proxy and threadpool attributes -differ slightly in that the proxy properties are generated in *addition* to +differs slightly in that the proxy properties are generated in *addition* to the property specified in this file, whereas the threadpool properties -generated do not include a property for the original property element in. +generated do not include a property for the original property element. -property elements may also include the deprecated and deprecatedBy -attributes. A property that has a deprecated property with the value of -true will be marked internally as deprecated and Ice may issue warnings if +Property elements may also include the deprecated and deprecatedBy +attributes. A property that has a deprecated property with the value +"true" will be marked internally as deprecated and Ice may issue warnings if a deprecated property is used. The deprecatedBy attribute allows the Ice -runtime to transparently replace the deprecated property name with a +run time to transparently replace the deprecated property name with a new property name that supercedes the deprecated property. -property element name attributes have some additional syntax: The token +Property element name attributes have some additional syntax: The token "<any>" (denoted in valid XML as <any>) is a wildcard and matches any non-empty sequence of non-whitespace characters. @@ -54,8 +53,8 @@ Examples: "Ice.Foo.<any>" allows all properties with that prefix, such as "Ice.Foo.Bar". "Ice.Foo<any>" allows properties such as "Ice.Foo.Bar" and "Ice.FooBar". -Property definitions are translated into each language by makeprops.py. - For example, consider the following definitions: +Property definitions are translated into each language by makeprops.py. +For example, consider the following definitions: <properties> <section name="Ice"> @@ -73,7 +72,7 @@ Property definitions are translated into each language by makeprops.py. </properties> If the source file is called Properties.xml, makeprops.py generates -the code similar to the following for C++ header and source file: +code similar to the following for the C++ header and source file: // // Properties.h |