Form Runner configuration with properties-form-runner.xml in config folder

I'm reading about Form Runner configuration here ...

http://wiki.orbeon.com/forms/doc/developer-guide/configuration-properties/configuration-properties-form-runner

"Default values
For the latest configuration, see properties-form-runner.xml".

which links to ... https://github.com/orbeon/orbeon-forms/blob/master/src/resources-packaged/config/properties-form-runner.xml

But I don't see a copy of properties-form-runner.xml in my config folder.  

Is this file in latest orbeon nightly build or does it need to be added to config folder?

Hi,

Orbeon internally uses some kind of "multi-layer file-system" for loading files.
So, if it can not find the file in the config folder, it will look through (all
or some of, I am not sure here) the jar files stored in the lib folder. The file
you are looking for can be found in orbeon-resources-private.jar.
This is actually a very powerful mechanism allowing you to easily override
specific files shipped with Orbein, and still be fairly upgradable (for example,
to change the epilogue behaviour). However it can get confusing as it is hard
to see what "view" on the files Orbeon actually has.
Btw, if you want to edit the configuration, you should not add a custom
properties-form-runner.xml file as that will *overwrite* the default one and
therefore delete all the factory defaults. Instead, add a file called
properties-local.xml to the config folder, which will not override any existing
file, but will be parsed by the config parser to only change the options you
want.

Kind regards,
Ralf

Am Sonntag 16 Januar 2011, um 15:48:39 schrieb DL:

--
You receive this message as a subscriber of the [hidden email] mailing list.
To unsubscribe: mailto:[hidden email]
For general help: mailto:[hidden email]?subject=help
OW2 mailing lists service home page: http://www.ow2.org/wws

Thanks for that helpful explanation.   I keep forgetting that such files are often embedded in core *.jars in lib folder.

I already have properties-local.xml in config folder and as I now understand the process any properties added in there will extend or take preference over the core properties in properties-form-runner.xml.

My reason for exploring this is to adopt the same style across xforms and (HTML/PHP) wrapper content (xforms are embedded in an iframe).