Commit ddd8fa65 authored by Daniel Himmelein's avatar Daniel Himmelein

readme

parent debf37c4
## Repo for Microsoft Windows and Linux ##
## Git-repo for Windows and Linux ## This is E.S.R.Labs Repo - just like Google Repo but this one also runs under Microsoft Windows.
For more information, see [Version Control with Repo and Git](http://source.android.com/source/version-control.html).
This is a portable version (Windows 7+, Linux) of the [git-repo](http://source.android.com/source/version-control.html) tool. Repo is a repository management tool that Google built on top of Git. Repo unifies many Git repositories when necessary,
does the uploads to a revision control system, and automates parts of the development workflow.
Repo is not meant to replace Git, only to make it easier to work with Git in the context of multiple repositories.
The repo command is an executable Python script that you can put anywhere in your path.
In working with the source files, you will use Repo for across-network operations.
For example, with a single Repo command you can download files from multiple repositories into your local working directory.
Git-repo was developed by Google for their Android platform in order to manage multiple Git repositories with a single tool. ### Setup steps for Microsoft Windows ###
For example it is possible to view the changes of all configured git repositories with a single command: repo diff.
Since the original git-repo tool is supposed to work only on Linux systems, therefore uses platform dependent features, 1. Download and install Git
Windows users have no viable solution for handling huge progjects which include many git repositories. * [Git](http://git-scm.com/downloads)
* Add Git to your path environment variable: C:\Program Files (x86)\Git\cmd;C:\Program Files (x86)\Git\bin;
The mainly used, platform dependet features are: symbolic links as well as the creation of new child processes with fork(). 2. Download and install Python
* [Python 3+](http://python.org/download/releases/3.3.0/)
* Add Python to your path environment variable: C:\Python33;
3. Download and install Repo either using the Windows Command Shell or Git Bash
* #### Windows Command Shell ####
md %USERPROFILE%\bin
curl https://raw.github.com/esrlabs/git-repo/master/repo > %USERPROFILE%/bin/repo
curl https://raw.github.com/esrlabs/git-repo/master/repo.cmd > %USERPROFILE%/bin/repo.cmd
### Requirements ### * #### Git Bash ####
mkdir ~/bin
* [Python 3.3+](http://python.org/download/releases/3.3.0/) curl https://raw.github.com/esrlabs/git-repo/master/repo > ~/bin/repo
* [Git](http://git-scm.com/) curl https://raw.github.com/esrlabs/git-repo/master/repo.cmd > ~/bin/repo.cmd
* Windows 7+ or Linux
### Setup ###
#### Windows ####
* Add to Windows environment variable PATH
* full additions (explained further on)
;C:\Python33C;\Program Files (x86)\Git\cmd;C:\Program Files (x86)\Git\bin;%USERPROFILE%
* Python3.3
* Git cmd folder
* Git bin folder
* repo script default path
* Download repo script
curl https://raw.github.com/esrlabs/git-repo/master/repo > %USERPROFILE%/repo
curl https://raw.github.com/esrlabs/git-repo/master/repo > %USERPROFILE%/repo.cmd
* Add Repo to your path environment variable: %USERPROFILE%\bin;
#### Linux #### #### Setup steps for Linux ####
* Add to environment variable PATH * Add to environment variable PATH
* repo bin folder (separator is ':') * repo bin folder (separator is ':')
...@@ -62,26 +58,6 @@ The mainly used, platform dependet features are: symbolic links as well as the c ...@@ -62,26 +58,6 @@ The mainly used, platform dependet features are: symbolic links as well as the c
sudo update-alternatives --config python sudo update-alternatives --config python
### Usage ### ### Usage ###
For more detailed instructions regarding usage, visit [git-repo](http://source.android.com/source/version-control.html). For more detailed instructions regarding usage, visit [git-repo](http://source.android.com/source/version-control.html).
Since this version does not break any features of the original repo, the following instructions are exactly the same
found on the referenced Android [git-repo](http://source.android.com/source/version-control.html) tool page.
* setup a git repository (url refered to as $MANIFEST), containing a manifest file similar to Androids [default.xml](https://android.googlesource.com/platform/manifest/+/master/default.xml)
* Change to the root folder of your project
* Initialize repo with the manifest url
repo init -u $MANIFEST
* Sync to get all repositories
repo sync
* do stuff in git repositories..
* view diff, status, .. (in root folder)
repo status
repo diff
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment