| OLD | NEW |
| 1 # The MB (Meta-Build wrapper) user guide | 1 # The MB (Meta-Build wrapper) user guide |
| 2 | 2 |
| 3 [TOC] | 3 [TOC] |
| 4 | 4 |
| 5 ## Introduction | 5 ## Introduction |
| 6 | 6 |
| 7 `mb` is a simple python wrapper around the GYP and GN meta-build tools to | 7 `mb` is a simple python wrapper around the GYP and GN meta-build tools to |
| 8 be used as part of the GYP->GN migration. | 8 be used as part of the GYP->GN migration. |
| 9 | 9 |
| 10 It is intended to be used by bots to make it easier to manage the configuration | 10 It is intended to be used by bots to make it easier to manage the configuration |
| (...skipping 156 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 167 | 167 |
| 168 The value of each key is a list of "mixins" that will define what that | 168 The value of each key is a list of "mixins" that will define what that |
| 169 build_config does. Each item in the list must be an entry in the dictionary | 169 build_config does. Each item in the list must be an entry in the dictionary |
| 170 value of the `mixins` key. | 170 value of the `mixins` key. |
| 171 | 171 |
| 172 Each mixin value is itself a dictionary that contains one or more of the | 172 Each mixin value is itself a dictionary that contains one or more of the |
| 173 following keys: | 173 following keys: |
| 174 | 174 |
| 175 * `gyp_configs`: a list of the configurations to build, e.g., | 175 * `gyp_configs`: a list of the configurations to build, e.g., |
| 176 ['Release', 'Release_x64']. | 176 ['Release', 'Release_x64']. |
| 177 * `gyp_crosscompile`: a boolean; if true, GYP_CROSSCOMPILE=1 is set in |
| 178 the environment and passed to GYP. |
| 177 * `gyp_defines`: a string containing a list of GYP_DEFINES. | 179 * `gyp_defines`: a string containing a list of GYP_DEFINES. |
| 178 * `gn_args`: a string containing a list of values passed to gn --args. | 180 * `gn_args`: a string containing a list of values passed to gn --args. |
| 179 * `mixins`: a list of other mixins that should be included. | 181 * `mixins`: a list of other mixins that should be included. |
| 180 * `type`: a string with either the value `gyp` or `gn`; | 182 * `type`: a string with either the value `gyp` or `gn`; |
| 181 setting this indicates which meta-build tool to use. | 183 setting this indicates which meta-build tool to use. |
| 182 | 184 |
| 183 When `mb gen` or `mb analyze` executes, it takes a config name, looks it | 185 When `mb gen` or `mb analyze` executes, it takes a config name, looks it |
| 184 up in the 'configs' dict, and then does a left-to-right expansion of the | 186 up in the 'configs' dict, and then does a left-to-right expansion of the |
| 185 mixins; gyp_defines and gn_args values are concatenated, and type and | 187 mixins; gyp_defines and gn_args values are concatenated, and type and |
| 186 gyp_configs values override each other. | 188 gyp_configs values override each other. |
| (...skipping 49 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 236 run than you expect; running `'mb -v'` will print what it's doing and | 238 run than you expect; running `'mb -v'` will print what it's doing and |
| 237 run the commands; `'mb -n'` will print what it will do but *not* run | 239 run the commands; `'mb -n'` will print what it will do but *not* run |
| 238 the commands. | 240 the commands. |
| 239 | 241 |
| 240 If you hit weirder things than that, add some print statements to the | 242 If you hit weirder things than that, add some print statements to the |
| 241 python script, send a question to gn-dev@chromium.org, or | 243 python script, send a question to gn-dev@chromium.org, or |
| 242 [file a bug](https://crbug.com/new) with the label | 244 [file a bug](https://crbug.com/new) with the label |
| 243 'mb' and cc: dpranke@chromium.org. | 245 'mb' and cc: dpranke@chromium.org. |
| 244 | 246 |
| 245 | 247 |
| OLD | NEW |