4 * [Generated from choices, 08 November 1995]
7 #pragma include_only_once
8 #pragma force_top_level
13 /*----- Overview ----------------------------------------------------------*
21 /* --- choices_useChoices --- *
23 * On entry: R0 == 0 to disable use of `Choices', >0 to enable, or <0 to
26 * On exit: R0 == previous setting
28 * Use: This call allows an application to determine whether its
29 * user-configurable resources are looked for in Acorn's
30 * `Choices' directory, or only in the application's directory.
32 * An application would typically make this call after parsing
33 * its command-line options, to allow a Network Manager to
34 * enable the `Choices' support.
37 extern routine choices_useChoices;
39 /* --- choices_find --- *
41 * On entry: R0 == pointer to resource filename
42 * R1 == pointer to buffer to build filename in
44 * bit 0 == file will be written to (use Choices$Write)
46 * On exit: R0 == pointer to filename
47 * R1 == pointer to terminating NULL
48 * CS if the file was found, else CC
50 * Use: Locates a user-configurable resource file. The search order
51 * depends on (a) whether the file will be written (bit 0 of R2)
52 * and (b) whether the use of Acorn's `Choices' system is
55 * The search order is as follows:
57 * * Choices:appName.leaf / <Choices$Write>.appName.leaf
60 * (i.e. it looks in the `Choices' structure first, and if that
61 * fails, it will use res_find).
64 extern routine choices_find;
66 /*----- That's all, folks -------------------------------------------------*/