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 75 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
86 need to be pruned). | 86 need to be pruned). |
87 | 87 |
88 See [design_spec.md](the design spec) for more details and examples; the | 88 See [design_spec.md](the design spec) for more details and examples; the |
89 differences can be subtle. We won't even go into how the `targets` and | 89 differences can be subtle. We won't even go into how the `targets` and |
90 `build_targets` differ from each other or from `compile_targets` and | 90 `build_targets` differ from each other or from `compile_targets` and |
91 `test_targets`. | 91 `test_targets`. |
92 | 92 |
93 The `-b/--builder`, `-c/--config`, `-f/--config-file`, `-m/--master`, | 93 The `-b/--builder`, `-c/--config`, `-f/--config-file`, `-m/--master`, |
94 `-q/--quiet`, and `-v/--verbose` flags work as documented for `mb gen`. | 94 `-q/--quiet`, and `-v/--verbose` flags work as documented for `mb gen`. |
95 | 95 |
| 96 ### `mb audit` |
| 97 |
| 98 `mb audit` is used to track the progress of the GYP->GN migration. You can |
| 99 use it to check a single master, or all the masters we care about. See |
| 100 `mb help audit` for more details (most people are not expected to care about |
| 101 this). |
| 102 |
96 ### `mb gen` | 103 ### `mb gen` |
97 | 104 |
98 `mb gen` is responsible for generating the Ninja files by invoking either GYP | 105 `mb gen` is responsible for generating the Ninja files by invoking either GYP |
99 or GN as appropriate. It takes arguments to specify a build config and | 106 or GN as appropriate. It takes arguments to specify a build config and |
100 a directory, then runs GYP or GN as appropriate: | 107 a directory, then runs GYP or GN as appropriate: |
101 | 108 |
102 ``` | 109 ``` |
103 % mb gen -m tryserver.chromium.linux -b linux_rel //out/Release | 110 % mb gen -m tryserver.chromium.linux -b linux_rel //out/Release |
104 % mb gen -c linux_rel_trybot //out/Release | 111 % mb gen -c linux_rel_trybot //out/Release |
105 ``` | 112 ``` |
(...skipping 166 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
272 run than you expect; running `'mb -v'` will print what it's doing and | 279 run than you expect; running `'mb -v'` will print what it's doing and |
273 run the commands; `'mb -n'` will print what it will do but *not* run | 280 run the commands; `'mb -n'` will print what it will do but *not* run |
274 the commands. | 281 the commands. |
275 | 282 |
276 If you hit weirder things than that, add some print statements to the | 283 If you hit weirder things than that, add some print statements to the |
277 python script, send a question to gn-dev@chromium.org, or | 284 python script, send a question to gn-dev@chromium.org, or |
278 [file a bug](https://crbug.com/new) with the label | 285 [file a bug](https://crbug.com/new) with the label |
279 'mb' and cc: dpranke@chromium.org. | 286 'mb' and cc: dpranke@chromium.org. |
280 | 287 |
281 | 288 |
OLD | NEW |