|
2 | 2 |
|
3 | 3 | Have you been cloning git repositories left and right? Do you wish to keep them automatically up-to date? |
4 | 4 |
|
5 | | -gitman is a manager for git repositories, that are located inside a single directory. |
| 5 | +gitman is a cross-platform manager for git repositories, that are located inside a single directory. |
6 | 6 |
|
7 | 7 | ## Usage |
8 | 8 |
|
9 | | -There are several commands currently supported. |
| 9 | +Arguments: |
10 | 10 |
|
11 | | -* `clone [url: string]`: Clones a git repository to the git repository directory. |
| 11 | +* `clone [url: string]`: Clones one or more git repositories to the git repository directory. (urls seperated by spaces) |
| 12 | + **Example:** `gitman clone https://github.com/nirokay/gitman https://github.com/nirokay/nirokay` |
12 | 13 |
|
13 | | -* `pull`: Pulls every repository's changes. |
| 14 | +* `pull`: Pulls every repository's changes, or only the ones which names are provided. |
| 15 | + **Examples:** `gitman pull` (pulls all repos), `gitman pull gitman nirokay` (only pulls gitman and nirokay repo) |
14 | 16 |
|
15 | 17 | * `help`: Displays a help message. |
16 | 18 |
|
17 | | -* `remove [dir: string]`: Removes the specified directory inside the git-repo directory. |
| 19 | +* `remove [dir: string]`: Removes the specified directory inside the git-repo directory. Can accept mutliple directories to remove. |
| 20 | + **Example:** `gitman remove nirokay gitman` |
18 | 21 |
|
19 | 22 | * `list`: Lists all git repositories. |
20 | 23 |
|
21 | 24 | Some commands may also have aliases, see `help` for more information. |
22 | 25 |
|
| 26 | +## Configuration |
| 27 | + |
| 28 | +There are no configuration files for this program (anymore). You can set a custom git directory by changing the `GITMAN_REPOS_LOCATION` environment variable. |
| 29 | + |
| 30 | +**Example (Linux):** |
| 31 | + |
| 32 | +```bash |
| 33 | +export GITMAN_REPOS_LOCATION="$HOME/Git" |
| 34 | +``` |
| 35 | + |
| 36 | +**Note:** |
| 37 | + |
| 38 | +This will only be available for the current session. Consider putting the string above into your profile/shell rc file. |
| 39 | + |
23 | 40 | ## Changes |
24 | 41 |
|
25 | 42 | See [Changes](CHANGES.md) document. |
26 | 43 |
|
27 | | -## Supported Operating Systems |
| 44 | +## Installation |
28 | 45 |
|
29 | | -Any operating system that is supported by the [nim programming language](https://nim-lang.org) should be supported. |
| 46 | +You will need to have [Nim](https://nim-lang.org) installed, as well as its package-manager nimble. |
30 | 47 |
|
31 | | -This program was tested on GNU/Linux (Manjaro) and Windows 10 (64 bit). |
| 48 | +### nimble installation |
| 49 | + |
| 50 | +You can run `nimble install gitman` to automatically install this program. (SOON!) |
32 | 51 |
|
33 | | -## Compiling from source |
| 52 | +### Compiling from source |
34 | 53 |
|
35 | | -You will need to have [nim](https://nim-lang.org) installed, as well as its package-manager nimble. You can easily build this program by executing `nimble build` or use the Makefile `make build`. |
| 54 | +You can build this program with `nimble build` and move the executable in your path. The latter will be done automatically, if you execute `nimble install` (Verify that the nimble binary directory is in your path!). |
| 55 | + |
| 56 | +## Supported Operating Systems |
36 | 57 |
|
37 | | -If you are running a Linux system, you can install the program with `sudo make install` to `/usr/local/bin/`. |
| 58 | +Any operating system that is supported by the [nim programming language](https://nim-lang.org) should be supported. |
| 59 | + |
| 60 | +This program was tested on GNU/Linux (Manjaro) and Windows 10 (64 bit). |
38 | 61 |
|
39 | 62 | ## Dependancies |
40 | 63 |
|
41 | | -* git (installed and in your environment path *cough cough windows... cough cough*) |
| 64 | +* [git](https://git-scm.com/) |
42 | 65 |
|
43 | | -* nim (not required to run the binary, only for compiling) |
| 66 | +* [Nim](https://nim-lang.org) (not required to run the binary, only for compiling and installing through nimble) |
0 commit comments