@@ -25,37 +25,40 @@ and generally make it more difficult to read our changelists.
25
25
26
26
## Building
27
27
28
- Selenium uses a custom build system called
28
+ Selenium uses a custom build system aptly named
29
29
[ crazyfun] ( https://github.com/SeleniumHQ/selenium/wiki/CrazyFunBuild )
30
30
available on all fine platforms (Linux, Mac, Windows). We are in the
31
31
process of replacing this with
32
32
[ buck] ( http://facebook.github.io/buck/ ) , so don't be alarmed if you
33
33
see some directories carrying multiple build directive files.
34
- crazyfun's build files are called * build.desc* , while buck's are named
35
- simply * BUCK* .
34
+ crazyfun's build files are named * build.desc* ,
35
+ while buck's are named simply * BUCK* .
36
36
37
- To build Selenium, in the same directory as this file, do…
37
+ To build Selenium, in the same directory as this file:
38
38
39
39
``` sh
40
40
./go
41
41
```
42
42
43
- The order of building modules is determined by the ` go ` system itself.
44
- If you want to build an individual module (assuming all dependent
45
- modules have previously been built) try something like:
43
+ The order of building modules is determined by the build system.
44
+ If you want to build an individual module
45
+ (assuming all dependent modules have previously been built)
46
+ try something like:
46
47
47
48
``` sh
48
49
./go //javascript/atoms:test:run
49
50
```
50
51
51
- In this case, ` javascript/atoms ` is the module directory, and ` test ` is a target
52
- in that directory's ` build.desc ` file.
52
+ In this case, ` javascript/atoms ` is the module directory,
53
+ ` test ` is a target in that directory's ` build.desc ` file,
54
+ and ` run ` is the action to run on that target.
53
55
54
- As you see * build targets* scroll past in the log, you may want to run
55
- them individually. ` go ` can run them individually, by target name as
56
- long as ` :run ` is appended (see above).
56
+ As you see * build targets* scroll past in the log,
57
+ you may want to run them individually.
58
+ crazyfun can run them individually,
59
+ by target name as long as ` :run ` is appended (see above).
57
60
58
- To list all available targets, you can append ` -T ` as an option :
61
+ To list all available targets, you can append the ` -T ` flag :
59
62
60
63
``` sh
61
64
./go -T
@@ -67,15 +70,15 @@ Although the plan is to return to a vanilla build of Buck as soon as
67
70
possible, we currently use a fork, hosted at
68
71
https://github.com/shs96c/buck To build using Buck, first clone that
69
72
repo and build using ant. Then add Buck's "bin" directory to your
70
- PATH. Once that's done...
73
+ PATH.
71
74
72
- Obtain a list of all available targets
75
+ To obtain a list of all available targets:
73
76
74
77
``` sh
75
78
buck targets
76
79
```
77
80
78
- Build a particular file:
81
+ And build a particular file:
79
82
80
83
``` sh
81
84
buck build //java/client/src/org/openqa/selenium:webdriver-api
0 commit comments