1
2Each library [arg FOO] is searched for in the directories listed below, in the order
3listed.  The search stops at the first existing path.
4
5Additional notes:
6
7[list_begin itemized]
8[item] [var platform] is the placeholder for the target platform of the package.
9[item] The extension [file .so] is the placeholder for whatever actual extension is used by the target platform for its shared libraries.
10[item] The search is relative to the current working directory.
11[list_end]
12
13And now the paths, depending on the exact form of the library name:
14
15[list_begin definitions]
16[comment %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%]
17[def FOO]
18[list_begin enumerated]
19[enum] FOO.so
20[enum] FOO/FOO.so
21[enum] FOO/[var platform]/FOO.so
22[list_end]
23
24[comment %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%]
25[def PATH/FOO]
26The exact set searched depends on the existence of
27directory [file PATH/FOO]. If it exists, critcl searches
28
29[list_begin enumerated]
30[enum] FOO.so
31[enum] PATH/FOO/FOO.so
32[enum] PATH/FOO/[var platform]/FOO.so
33[list_end]
34
35Otherwise it searches
36
37[list_begin enumerated]
38[enum] FOO.so
39[enum] PATH/FOO.so
40[enum] PATH/[var platform]/FOO.so
41[list_end]
42
43instead.
44
45[comment %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%]
46[def /PATH/FOO]
47Even when specifying FOO with an absolute path the first path searched
48is relative to the current working directory.
49
50[list_begin enumerated]
51[enum] FOO.so
52[enum] /PATH/FOO.so
53[enum] /PATH/[var platform]/FOO.so
54[list_end]
55[list_end]
56