xref: /aosp_15_r20/external/toolchain-utils/bestflags/README.md (revision 760c253c1ed00ce9abd48f8546f08516e57485fe)
1# bestflags
2
3There is a vast set of compiler flags that can be used to build Chrome for
4ChromeOS. This option space has not been explored before. This directory
5provides an infrastructure to build Chrome with certain flag combinations, test
6it, gather results and prepare a fresh batch of flags to repeat the process. The
7infrastructure supports plug-in modules that implement algorithms for searching
8in the N-Dimensional space of compiler flag combinations.
9
10Currently, three different algorithms are built, namely genetic algorithm, hill
11climbing and negative flag iterative elimination. The module `testing_batch.py`
12contains the testing of these algorithms.
13
14To run the script, type in `python testing_batch.py`.
15
16For further information about the project, please refer to the design document
17at:
18
19https://docs.google.com/a/google.com/document/d/19iE9rhszTWjISBpKJ3qK8uBCoUjs0o4etWDRkyEeUOw/
20
21There is also a presentation slide available at:
22
23https://docs.google.com/a/google.com/presentation/d/13rS9jALXffbP48YsF0-bsqovrVBfgzEud4e-XpavOdA/edit#slide=id.gf880fcd4_180
24