Skip to content

Commit e253246

Browse files
committed
updated documentation for 2.0.0
1 parent 725e445 commit e253246

2 files changed

Lines changed: 45 additions & 14 deletions

File tree

CHANGES.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,12 @@
1-
# Chnages
1+
# Changes
2+
3+
## 2.0.0
4+
5+
Entire codebase rewritten to be more managable and cleaner.
6+
7+
Behaviour:
8+
9+
* commands like `pull`, `clone` and `remove` can now accept multiple arguments (invalid args will be filtered in certain scenarios)
210

311
## 1.0.1
412

README.md

Lines changed: 36 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,42 +2,65 @@
22

33
Have you been cloning git repositories left and right? Do you wish to keep them automatically up-to date?
44

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.
66

77
## Usage
88

9-
There are several commands currently supported.
9+
Arguments:
1010

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`
1213

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)
1416

1517
* `help`: Displays a help message.
1618

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`
1821

1922
* `list`: Lists all git repositories.
2023

2124
Some commands may also have aliases, see `help` for more information.
2225

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+
2340
## Changes
2441

2542
See [Changes](CHANGES.md) document.
2643

27-
## Supported Operating Systems
44+
## Installation
2845

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.
3047

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!)
3251

33-
## Compiling from source
52+
### Compiling from source
3453

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
3657

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).
3861

3962
## Dependancies
4063

41-
* git (installed and in your environment path *cough cough windows... cough cough*)
64+
* [git](https://git-scm.com/)
4265

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

Comments
 (0)