| Mike Frysinger | befaec1 | 2016-08-16 00:08:37 -0400 | [diff] [blame] | 1 | # repo |
| 2 | |
| 3 | Repo is a tool built on top of Git. Repo helps manage many Git repositories, |
| 4 | does the uploads to revision control systems, and automates parts of the |
| 5 | development workflow. Repo is not meant to replace Git, only to make it |
| 6 | easier to work with Git. The repo command is an executable Python script |
| 7 | that you can put anywhere in your path. |
| 8 | |
| Mike Frysinger | c102fd5 | 2020-02-15 14:30:06 -0500 | [diff] [blame] | 9 | * Homepage: <https://gerrit.googlesource.com/git-repo/> |
| Mike Frysinger | 4c418bf | 2020-02-24 12:52:49 -0500 | [diff] [blame] | 10 | * Mailing list: [repo-discuss on Google Groups][repo-discuss] |
| Mike Frysinger | 696e0c4 | 2023-06-14 17:08:27 -0400 | [diff] [blame] | 11 | * Bug reports: <https://issues.gerritcodereview.com/issues?q=is:open%20componentid:1370071> |
| Mike Frysinger | c102fd5 | 2020-02-15 14:30:06 -0500 | [diff] [blame] | 12 | * Source: <https://gerrit.googlesource.com/git-repo/> |
| 13 | * Overview: <https://source.android.com/source/developing.html> |
| 14 | * Docs: <https://source.android.com/source/using-repo.html> |
| Mike Frysinger | 3891b75 | 2018-10-05 19:26:15 -0400 | [diff] [blame] | 15 | * [repo Manifest Format](./docs/manifest-format.md) |
| Mike Frysinger | 84e7e16 | 2017-11-10 21:28:41 -0500 | [diff] [blame] | 16 | * [repo Hooks](./docs/repo-hooks.md) |
| Mike Frysinger | befaec1 | 2016-08-16 00:08:37 -0400 | [diff] [blame] | 17 | * [Submitting patches](./SUBMITTING_PATCHES.md) |
| Mike Frysinger | 7ac12a9 | 2019-12-04 18:34:07 -0500 | [diff] [blame] | 18 | * Running Repo in [Microsoft Windows](./docs/windows.md) |
| Mike Frysinger | b57e633 | 2020-02-15 13:49:10 -0500 | [diff] [blame] | 19 | * GitHub mirror: <https://github.com/GerritCodeReview/git-repo> |
| 20 | * Postsubmit tests: <https://github.com/GerritCodeReview/git-repo/actions> |
| Mike Frysinger | 34bc571 | 2019-11-18 02:27:57 -0500 | [diff] [blame] | 21 | |
| Mike Frysinger | 4c418bf | 2020-02-24 12:52:49 -0500 | [diff] [blame] | 22 | ## Contact |
| 23 | |
| 24 | Please use the [repo-discuss] mailing list or [issue tracker] for questions. |
| 25 | |
| 26 | You can [file a new bug report][new-bug] under the "repo" component. |
| 27 | |
| 28 | Please do not e-mail individual developers for support. |
| 29 | They do not have the bandwidth for it, and often times questions have already |
| 30 | been asked on [repo-discuss] or bugs posted to the [issue tracker]. |
| 31 | So please search those sites first. |
| 32 | |
| Mike Frysinger | 34bc571 | 2019-11-18 02:27:57 -0500 | [diff] [blame] | 33 | ## Install |
| 34 | |
| 35 | Many distros include repo, so you might be able to install from there. |
| 36 | ```sh |
| 37 | # Debian/Ubuntu. |
| 38 | $ sudo apt-get install repo |
| 39 | |
| 40 | # Gentoo. |
| 41 | $ sudo emerge dev-vcs/repo |
| 42 | ``` |
| 43 | |
| 44 | You can install it manually as well as it's a single script. |
| 45 | ```sh |
| 46 | $ mkdir -p ~/.bin |
| 47 | $ PATH="${HOME}/.bin:${PATH}" |
| 48 | $ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo |
| 49 | $ chmod a+rx ~/.bin/repo |
| 50 | ``` |
| Mike Frysinger | 4c418bf | 2020-02-24 12:52:49 -0500 | [diff] [blame] | 51 | |
| 52 | |
| Mike Frysinger | 696e0c4 | 2023-06-14 17:08:27 -0400 | [diff] [blame] | 53 | [new-bug]: https://issues.gerritcodereview.com/issues/new?component=1370071 |
| 54 | [issue tracker]: https://issues.gerritcodereview.com/issues?q=is:open%20componentid:1370071 |
| Mike Frysinger | 4c418bf | 2020-02-24 12:52:49 -0500 | [diff] [blame] | 55 | [repo-discuss]: https://groups.google.com/forum/#!forum/repo-discuss |
