blob: f93e3d00efdd135d7d6c1126a4416145618614ea (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
|
scalar(1)
=========
NAME
----
scalar - an opinionated repository management tool
SYNOPSIS
--------
[verse]
scalar list
scalar register [<enlistment>]
scalar unregister [<enlistment>]
DESCRIPTION
-----------
Scalar is an opinionated repository management tool. By creating new
repositories or registering existing repositories with Scalar, your Git
experience will speed up. Scalar sets advanced Git config settings,
maintains your repositories in the background, and helps reduce data sent
across the network.
An important Scalar concept is the enlistment: this is the top-level directory
of the project. It usually contains the subdirectory `src/` which is a Git
worktree. This encourages the separation between tracked files (inside `src/`)
and untracked files, such as build artifacts (outside `src/`). When registering
an existing Git worktree with Scalar whose name is not `src`, the enlistment
will be identical to the worktree.
The `scalar` command implements various subcommands, and different options
depending on the subcommand. With the exception of `list`, all subcommands
expect to be run in an enlistment.
COMMANDS
--------
List
~~~~
list::
List enlistments that are currently registered by Scalar. This
subcommand does not need to be run inside an enlistment.
Register
~~~~~~~~
register [<enlistment>]::
Adds the enlistment's repository to the list of registered repositories
and starts background maintenance. If `<enlistment>` is not provided,
then the enlistment associated with the current working directory is
registered.
+
Note: when this subcommand is called in a worktree that is called `src/`, its
parent directory is considered to be the Scalar enlistment. If the worktree is
_not_ called `src/`, it itself will be considered to be the Scalar enlistment.
Unregister
~~~~~~~~~~
unregister [<enlistment>]::
Remove the specified repository from the list of repositories
registered with Scalar and stop the scheduled background maintenance.
SEE ALSO
--------
linkgit:git-maintenance[1].
Scalar
---
Associated with the linkgit:git[1] suite
|
