| OLD | NEW |
| 1 # GYP (Generate Your Projects) User Documentation | 1 # User Documentation |
| 2 | 2 |
| 3 Status: Draft (as of 2009-05-19) | |
| 4 | |
| 5 Mark Mentovai <mark@chromium.org>, | |
| 6 Steven Knight <sgk@chromium.org> | |
| 7 _et al._ | |
| 8 | |
| 9 Modified: 2009-05-19 | |
| 10 | |
| 11 [TOC] | 3 [TOC] |
| 12 | 4 |
| 13 ## Introduction | 5 ## Introduction |
| 14 | 6 |
| 15 This document is intended to provide a user-level guide to GYP. The | 7 This document is intended to provide a user-level guide to GYP. The |
| 16 emphasis here is on how to use GYP to accomplish specific tasks, not on | 8 emphasis here is on how to use GYP to accomplish specific tasks, not on |
| 17 the complete technical language specification. (For that, see the | 9 the complete technical language specification. (For that, see the |
| 18 [LanguageSpecification](LanguageSpecification).) | 10 [LanguageSpecification](LanguageSpecification).) |
| 19 | 11 |
| 20 The document below starts with some overviews to provide context: an | 12 The document below starts with some overviews to provide context: an |
| (...skipping 418 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 439 | 431 |
| 440 The above two examples end up generating equivalent builds, with the | 432 The above two examples end up generating equivalent builds, with the |
| 441 small exception that the `sources` lists will list the files in | 433 small exception that the `sources` lists will list the files in |
| 442 different orders. (The first example defines explicitly where | 434 different orders. (The first example defines explicitly where |
| 443 `linux_specific.cc` appears in the list--perhaps in in the | 435 `linux_specific.cc` appears in the list--perhaps in in the |
| 444 middle--whereas the second example will always tack it on to the end of | 436 middle--whereas the second example will always tack it on to the end of |
| 445 the list.) | 437 the list.) |
| 446 | 438 |
| 447 **Including or excluding files using patterns**: There are more | 439 **Including or excluding files using patterns**: There are more |
| 448 complicated ways to construct a `sources` list based on patterns. See | 440 complicated ways to construct a `sources` list based on patterns. See |
| 449 `TODO(sgk)` below. | 441 `TODO` below. |
| 450 | 442 |
| 451 ### Add a new executable | 443 ### Add a new executable |
| 452 | 444 |
| 453 An executable program is probably the most straightforward type of | 445 An executable program is probably the most straightforward type of |
| 454 target, since all it typically needs is a list of source files, some | 446 target, since all it typically needs is a list of source files, some |
| 455 compiler/linker settings (probably varied by platform), and some library | 447 compiler/linker settings (probably varied by platform), and some library |
| 456 targets on which it depends and which must be used in the final link. | 448 targets on which it depends and which must be used in the final link. |
| 457 | 449 |
| 458 #### Add an executable that builds on all platforms | 450 #### Add an executable that builds on all platforms |
| 459 | 451 |
| (...skipping 489 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 949 setting `product_extension` if you want. Files listed in | 941 setting `product_extension` if you want. Files listed in |
| 950 `mac_bundle_resources` will be copied to the bundle's `Resource` folder | 942 `mac_bundle_resources` will be copied to the bundle's `Resource` folder |
| 951 of the bundle. You can also set | 943 of the bundle. You can also set |
| 952 `process_outputs_as_mac_bundle_resources` to 1 in actions and rules to | 944 `process_outputs_as_mac_bundle_resources` to 1 in actions and rules to |
| 953 let the output of actions and rules be added to that folder (similar to | 945 let the output of actions and rules be added to that folder (similar to |
| 954 `process_outputs_as_sources`). If `product_name` is not set, the bundle | 946 `process_outputs_as_sources`). If `product_name` is not set, the bundle |
| 955 will be named after `target_name`as usual. | 947 will be named after `target_name`as usual. |
| 956 | 948 |
| 957 ### Move files (refactoring) | 949 ### Move files (refactoring) |
| 958 | 950 |
| 959 TODO(sgk) | 951 TODO |
| 960 | 952 |
| 961 ### Custom build steps | 953 ### Custom build steps |
| 962 | 954 |
| 963 TODO(sgk) | 955 TODO |
| 964 | 956 |
| 965 #### Adding an explicit build step to generate specific files | 957 #### Adding an explicit build step to generate specific files |
| 966 | 958 |
| 967 TODO(sgk) | 959 TODO |
| 968 | 960 |
| 969 #### Adding a rule to handle files with a new suffix | 961 #### Adding a rule to handle files with a new suffix |
| 970 | 962 |
| 971 TODO(sgk) | 963 TODO |
| 972 | 964 |
| 973 ### Build flavors | 965 ### Build flavors |
| 974 | 966 |
| 975 TODO(sgk) | 967 TODO |
| OLD | NEW |