| commit | author | age | ||
| f13c4c | 1 | Gitblit |
| JM | 2 | ================= |
| 3 | ||
| 85c2e6 | 4 | Gitblit is an open source, pure Java Git solution for managing, viewing, and serving [Git](http://git-scm.com) repositories.<br/> |
| 1f9dae | 5 | More information about Gitblit can be found [here](http://gitblit.com). |
| f13c4c | 6 | |
| JM | 7 | License |
| 8 | ------- | |
| 9 | ||
| 233eb0 | 10 | Gitblit is distributed under the terms of the [Apache Software Foundation license, version 2.0](http://www.apache.org/licenses/LICENSE-2.0).<br/> |
| JM | 11 | The text of the license is included in the file LICENSE in the root of the project. |
| f13c4c | 12 | |
| 85c2e6 | 13 | Java Runtime Requirement |
| f13c4c | 14 | ------------------------------------ |
| JM | 15 | |
| 85c2e6 | 16 | Gitblit requires at Java 6 Runtime Environment (JRE) or a Java 6 Development Kit (JDK). |
| f13c4c | 17 | |
| JM | 18 | Getting help |
| 19 | ------------ | |
| 20 | ||
| 233eb0 | 21 | Read the online documentation available at the [Gitblit website](http://gitblit.com)<br/> |
| JM | 22 | Issues, binaries, & sources @ [Google Code](http://code.google.com/p/gitblit) |
| f13c4c | 23 | |
| JM | 24 | Building Gitblit |
| 25 | ---------------- | |
| 26 | [Eclipse](http://eclipse.org) is recommended for development as the project settings are preconfigured. | |
| 27 | ||
| 28 | 1. Import the gitblit project into your Eclipse workspace.<br/> | |
| 29 | *There will be lots of build errors.* | |
| 30 | 2. Using Ant, execute the `build.xml` script in the project root.<br/> | |
| 31 | *This will download all necessary build dependencies and will also generate the Keys class for accessing settings.* | |
| 32 | 3. Select your gitblit project root and **Refresh** the project, this should correct all build problems. | |
| 1f9dae | 33 | 4. Using JUnit, execute the `com.gitblit.tests.GitBlitSuite` test suite.<br/> |
| JM | 34 | *This will clone some repositories from the web and run through the unit tests.* |
| 35 | 5. Execute the *com.gitblit.Launcher* class to start Gitblit. | |
