author | Jan Vrany <jan.vrany@fit.cvut.cz> |
Fri, 21 Sep 2018 23:14:41 +0100 | |
changeset 255 | 6d6880749905 |
parent 36 | 2d53d5e44347 |
permissions | -rw-r--r-- |
12
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
1 |
# Smalltalk/X jv-branch build tool |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
2 |
|
36 | 3 |
This tools allows anyone to rebuild [Smalltalk/X jv-branch][1] from (almost) scratch. It fetches sources |
12
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
4 |
from various repositories, put them together and compile the whole thing. For those without an access to |
36 | 5 |
**stc** and **librun** sources, it automatically downloads latest pre-build versions from [SWING CI server][2]. |
12
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
6 |
|
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
7 |
## A quick quide for the impatient |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
8 |
|
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
9 |
In shell, execute: |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
10 |
|
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
11 |
hg clone https://bitbucket.org/janvrany/stx-goodies-builder-rake stx-jv |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
12 |
cd stx-jv |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
13 |
rake |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
14 |
|
36 | 15 |
Go out for a short or long walk, depending on your internet connection and CPU power. Once `rake` finishes, you have compiled [Smalltalk/X jv-branch][1]yourself. Have fun! |
12
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
16 |
|
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
17 |
## Usage |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
18 |
|
36 | 19 |
For more details on usage please see [wiki][3]. |
12
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
20 |
|
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
21 |
## Disclaimer |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
22 |
|
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
23 |
The internals of these build scripts are mess...emh...convoluted. A lot of hacks accumulated over years. |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
24 |
We aim to clean that up, if time allows. For now, it does its job. |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
25 |
|
36 | 26 |
## Contributing |
27 |
||
28 |
Anyone wishing to help is welcomed! If you encounter a problem. please |
|
29 |
fill in a report to [Smalltalk/X jv-branch bug tracker][4]. |
|
30 |
||
31 |
To contribute, either |
|
32 |
||
33 |
* fork the [repository on BitBucket][5] and [send a pull request][6]. |
|
34 |
* send a patch to [stx-jv@googlegroups.com][7]. |
|
12
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
35 |
|
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
36 |
## License |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
37 |
|
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
38 |
Copyright (c) 2010-now Jan Vrany <jan.vrany (a) fit.cvut.cz> |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
39 |
|
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
40 |
This software is licensed under "MIT license". You may find a full license text in `LICENSE.txt`. |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
41 |
|
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
42 |
[1]: https://swing.fit.cvut.cz/projects/stx-jv/ |
5bd69db5ca2b
Added short README.md and LICENSE.txt
Jan Vrany <jan.vrany@fit.cvut.cz>
parents:
diff
changeset
|
43 |
[2]: https://swing.fit.cvut.cz/jenkins |
36 | 44 |
[3]: https://swing.fit.cvut.cz/projects/stx-jv/wiki/Documentation/BuildingStXWithRakefiles |
45 |
[4]: https://swing.fit.cvut.cz/projects/stx-jv/newticket |
|
46 |
[5]: https://bitbucket.org/janvrany/stx-goodies-builder-rake |
|
47 |
[6]: https://www.atlassian.com/git/tutorials/making-a-pull-request/ |
|
48 |
[7]: https://groups.google.com/forum/#!forum/stx-jv |