Each library [arg FOO] named for preload will be searched at the
locations listed below, in the order listed, and the search will stop
on the first existing path.
Additional notes:
[list_begin itemized]
[item] [var platform] is the placeholder for the target platform of the package.
[item] The extension [file .so] is the placeholder for whatever actual extension is used by the target platform for its shared libraries.
[item] Note how the search is relative to the current working directory.
[list_end]
And now the paths, depending on the exact form of the library name:
[list_begin definitions]
[def FOO]
[list_begin enumerated]
[enum] FOO.so
[enum] FOO/FOO.so
[enum] FOO/[var platform]/FOO.so
[list_end]
[def PATH/FOO]
For this form the exact set searched depends on the existence of
directory [file PATH/FOO]. If it does not exist critcl searches
[list_begin enumerated]
[enum] FOO.so
[enum] PATH/FOO.so
[enum] PATH/[var platform]/FOO.so
[list_end]
Otherwise it searches
[list_begin enumerated]
[enum] FOO.so
[enum] PATH/FOO/FOO.so
[enum] PATH/FOO/[var platform]/FOO.so
[list_end]
instead.
[def /PATH/FOO]
XXX preload - /path/foo - search paths ?
[list_end]