1 TODO list for 1.2 setup:
3 - do we need some DO_* variables for the plugins too..
4 - does the nightly do some safe checks while installing?
5 (i.e. query the GUID of the existing full installation we expect to find)
7 short explanation / design doc:
11 Any setup is made from a core and some game packs
12 In the template -> buildable setup process, we give a few parameters to
15 - Put only the binaries or put everything
16 - put / don't put the editor core
17 - put / don't put any game pack
19 To do this, we mostly rely on a search replace in the template code:
21 DO_* are variables telling wether are not a given component is INCLUDED into
22 the setup. We have currently:
24 DO_CORE: editor core content
25 (ex: the central editor binary)
26 DO_CORE_FULL: include the full setup content related to the code
27 (ex: the GtkRadiant manual)
28 DO_GAME_Q3: include binaries for Q3
29 DO_GAME_FULL_Q3: media for the Q3 game pack
31 we search and replace for '<<DO_CORE_BOOL>>' '<<DO_GAME_Q3_BOOL>>' etc.
32 more such variables will be .. DO_GAME_WOLF_BOOL, DO_GAME_Q1_BOOL etc.
33 the *_BOOL are meant to be replaced by '1' or '0'
34 we use equivalents *_BOOL_YESNO that are replaced by 'Yes' and 'No'
35 (those are used for 'include in build setting')
40 the variables DIR_* are holding the install paths for core or game packs
41 DIR_CORE is the install path for the core
42 DIR_GAME_Q3 is the Q3 directory
43 DIR_GAMETOOLS_Q3 is the subdirectory path choosen below Q3 dir to install
46 When the setup executes, it must rely on the stuff included in the setup to
47 prompt the user with the right questions (where do I install the editor,
48 where do I install the Q3 game pack?). This should be tempered by prior
49 selection of what and whatnot to install if necessary. There should always
50 be a 'Default' path that allows installing quickly without answering any
57 this was added afterwards. nightlies are intended to be an upgrade
58 over an existing installation it only holds binaries
60 also adds some specific component and file groups for the media stuff
61 that may have changed since the full setup
64 a matter of 'include in build' configuration again
65 if nightly is on, the *_FULL_* variables will be disabled
66 and the *_NIGHTLY_* ones will be enabled
67 Component Definitions/Default.cdf is the critical file in this operation
69 DO_CORE_BOOL_FULL_YESNO
70 DO_GAME_Q3_BOOL_FULL_YESNO
71 DO_GAME_WOLF_BOOL_FULL_YESNO
72 those three are to disable the media we only put in full setup
74 this is for the specific additions of the nightly setup