Update submodules on '5.6' in qt5
[mirror/qt/qt5.git] / README.git
1 OBTAINING QT5 FROM GIT
2 ======================
3
4  Synopsis
5  ========
6
7  For a more in-depth description on how to build Qt5 from git,
8  please see: http://wiki.qt.io/Building_Qt_5_from_Git
9
10
11  Get The Submodules
12  ==================
13
14  Cloning Qt5 does not automatically clone all submodules.
15  To get the submodules, it is recommended to use the `init-repository' script.
16
17    ./init-repository
18
19  See `./init-repository -help' for full documentation on the many supported
20  options.
21
22
23  Update The Submodules (optional)
24  ================================
25
26  After a plain `git clone' and `init-repository', you will have each submodule
27  checked out to a particular SHA1.  This combination of SHA1s is guaranteed to
28  have passed some basic acceptance testing.
29
30  If (and only if!) you need newer versions of some submodules, you can manually
31  fetch and/or pull and/or reset any modules you like, or use the qt5_tool to
32  pull all modules:
33
34    ./qtrepotools/bin/qt5_tool -p
35
36  NOTE! As soon as you change the SHA1 of any submodule, you are using a
37  combination of modules which is potentially untested and broken!  If you want
38  something which is more likely to compile, stick to the module SHA1s provided
39  in this repository.
40
41
42  Install The Git Grafts (optional)
43  =================================
44
45  If you want to be able to connect the Qt5 and Qt4 development history, you
46  may set up git grafts with the following command:
47
48    git submodule foreach '../qtrepotools/bin/git-qt-grafts <path_to_history>'
49
50
51  Developing and Contributing to Qt
52  ================================
53
54  For more information on how to develop and contribute to Qt, please see:
55  http://wiki.qt.io/Category:Developing_Qt