Gecko [ tanishkshah.com ]

Name	Size	Permission	Date
api-error-handling.adoc	3.73 KB	-rw-r--r--	2025-11-17 16:38
api-error-handling.html	35.21 KB	-rw-r--r--	2026-04-05 23:58
api-index-skel.adoc	432 B	-rw-r--r--	2025-11-17 16:38
api-index.adoc	689 B	-rw-r--r--	2026-04-05 23:58
api-index.html	30.43 KB	-rw-r--r--	2026-04-05 23:59
api-index.sh	714 B	-rw-r--r--	2025-11-17 16:38
api-merge.adoc	1.06 KB	-rw-r--r--	2025-11-17 16:38
api-merge.html	31.51 KB	-rw-r--r--	2026-04-05 23:58
api-parse-options.adoc	13.01 KB	-rw-r--r--	2025-11-17 16:38
api-parse-options.html	49.44 KB	-rw-r--r--	2026-04-05 23:58
api-path-walk.adoc	3.27 KB	-rw-r--r--	2025-11-17 16:38
api-path-walk.html	34.28 KB	-rw-r--r--	2026-04-05 23:58
api-simple-ipc.adoc	4.74 KB	-rw-r--r--	2025-11-17 16:38
api-simple-ipc.html	35.49 KB	-rw-r--r--	2026-04-05 23:58
api-trace2.adoc	43.45 KB	-rw-r--r--	2025-11-17 16:38
api-trace2.html	86.12 KB	-rw-r--r--	2026-04-05 23:58
bitmap-format.adoc	14.66 KB	-rw-r--r--	2025-11-17 16:38
bitmap-format.html	49.31 KB	-rw-r--r--	2026-04-05 23:58
build-systems.adoc	7.96 KB	-rw-r--r--	2025-11-17 16:38
build-systems.html	41.02 KB	-rw-r--r--	2026-04-05 23:58
bundle-uri.adoc	26.12 KB	-rw-r--r--	2025-11-17 16:38
bundle-uri.html	63.08 KB	-rw-r--r--	2026-04-05 23:58
commit-graph.adoc	17.7 KB	-rw-r--r--	2025-11-17 16:38
commit-graph.html	52.61 KB	-rw-r--r--	2026-04-05 23:58
directory-rename-detection.adoc	5.08 KB	-rw-r--r--	2025-11-17 16:38
directory-rename-detection.html	36.33 KB	-rw-r--r--	2026-04-05 23:58
hash-function-transition.adoc	35.45 KB	-rw-r--r--	2025-11-17 16:38
hash-function-transition.html	75.42 KB	-rw-r--r--	2026-04-05 23:58
large-object-promisors.adoc	26.59 KB	-rw-r--r--	2025-11-17 16:38
large-object-promisors.html	62.72 KB	-rw-r--r--	2026-04-05 23:58
long-running-process-protocol.adoc	1.88 KB	-rw-r--r--	2025-11-17 16:38
long-running-process-protocol.html	32.18 KB	-rw-r--r--	2026-04-05 23:58
meson.build	1.49 KB	-rw-r--r--	2025-11-17 16:38
multi-pack-index.adoc	11.31 KB	-rw-r--r--	2025-11-17 16:38
multi-pack-index.html	44.62 KB	-rw-r--r--	2026-04-05 23:58
pack-heuristics.adoc	17.62 KB	-rw-r--r--	2025-11-17 16:38
pack-heuristics.html	54.83 KB	-rw-r--r--	2026-04-05 23:58
packfile-uri.adoc	3.66 KB	-rw-r--r--	2025-11-17 16:38
packfile-uri.html	34.64 KB	-rw-r--r--	2026-04-05 23:58
parallel-checkout.adoc	12.01 KB	-rw-r--r--	2025-11-17 16:38
parallel-checkout.html	44.27 KB	-rw-r--r--	2026-04-05 23:58
partial-clone.adoc	14.59 KB	-rw-r--r--	2025-11-17 16:38
partial-clone.html	48.96 KB	-rw-r--r--	2026-04-05 23:58
platform-support.adoc	8.95 KB	-rw-r--r--	2025-11-17 16:38
platform-support.html	40.71 KB	-rw-r--r--	2026-04-05 23:58
racy-git.adoc	8.91 KB	-rw-r--r--	2025-11-17 16:38
racy-git.html	41.04 KB	-rw-r--r--	2026-04-05 23:58
reftable.adoc	36.65 KB	-rw-r--r--	2025-11-17 16:38
reftable.html	86.46 KB	-rw-r--r--	2026-04-05 23:58
remembering-renames.adoc	29.71 KB	-rw-r--r--	2025-11-17 16:38
remembering-renames.html	65.78 KB	-rw-r--r--	2026-04-05 23:58
repository-version.adoc	3.19 KB	-rw-r--r--	2025-11-17 16:38
repository-version.html	33.92 KB	-rw-r--r--	2026-04-05 23:58
rerere.adoc	6.36 KB	-rw-r--r--	2025-11-17 16:38
rerere.html	38.33 KB	-rw-r--r--	2026-04-05 23:58
scalar.adoc	2.87 KB	-rw-r--r--	2025-11-17 16:38
scalar.html	33.61 KB	-rw-r--r--	2026-04-05 23:58
send-pack-pipeline.adoc	1.92 KB	-rw-r--r--	2025-11-17 16:38
send-pack-pipeline.html	32.41 KB	-rw-r--r--	2026-04-05 23:58
shallow.adoc	2.49 KB	-rw-r--r--	2025-11-17 16:38
shallow.html	32.77 KB	-rw-r--r--	2026-04-05 23:58
sparse-checkout.adoc	46.68 KB	-rw-r--r--	2025-11-17 16:38
sparse-checkout.html	92.36 KB	-rw-r--r--	2026-04-05 23:58
sparse-index.adoc	9.28 KB	-rw-r--r--	2025-11-17 16:38
sparse-index.html	41.79 KB	-rw-r--r--	2026-04-05 23:58
trivial-merge.adoc	4.16 KB	-rw-r--r--	2025-11-17 16:38
trivial-merge.html	35.33 KB	-rw-r--r--	2026-04-05 23:58
unit-tests.adoc	9.8 KB	-rw-r--r--	2025-11-17 16:38
unit-tests.html	50.73 KB	-rw-r--r--	2026-04-05 23:58

Rename

Scalar
======

Scalar is a repository management tool that optimizes Git for use in large
repositories. It accomplishes this by helping users to take advantage of
advanced performance features in Git. Unlike most other Git built-in commands,
Scalar is not executed as a subcommand of 'git'; rather, it is built as a
separate executable containing its own series of subcommands.

Background
----------

Scalar was originally designed as an add-on to Git and implemented as a .NET
Core application. It was created based on the learnings from the VFS for Git
project (another application aimed at improving the experience of working with
large repositories). As part of its initial implementation, Scalar relied on
custom features in the Microsoft fork of Git that have since been integrated
into core Git:

* partial clone,
* commit graphs,
* multi-pack index,
* sparse checkout (cone mode),
* scheduled background maintenance,
* etc

With the requisite Git functionality in place and a desire to bring the benefits
of Scalar to the larger Git community, the Scalar application itself was ported
from C# to C and integrated upstream.

Features
--------

Scalar is comprised of two major pieces of functionality: automatically
configuring built-in Git performance features and managing repository
enlistments.

The Git performance features configured by Scalar (see "Background" for
examples) confer substantial performance benefits to large repositories, but are
either too experimental to enable for all of Git yet, or only benefit large
repositories. As new features are introduced, Scalar should be updated
accordingly to incorporate them. This will prevent the tool from becoming stale
while also providing a path for more easily bringing features to the appropriate
users.

Enlistments are how Scalar knows which repositories on a user's system should
utilize Scalar-configured features. This allows it to update performance
settings when new ones are added to the tool, as well as centrally manage
repository maintenance. The enlistment structure - a root directory with a
`src/` subdirectory containing the cloned repository itself - is designed to
encourage users to route build outputs outside of the repository to avoid the
performance-limiting overhead of ignoring those files in Git.

Design
------

Scalar is implemented in C and interacts with Git via a mix of child process
invocations of Git and direct usage of `libgit.a`. Internally, it is structured
much like other built-ins with subcommands (e.g., `git stash`), containing a
`cmd_<subcommand>()` function for each subcommand, routed through a `cmd_main()`
function. Most options are unique to each subcommand, with `scalar` respecting
some "global" `git` options (e.g., `-c` and `-C`).

Because `scalar` is not invoked as a Git subcommand (like `git scalar`), it is
built and installed as its own executable in the `bin/` directory, alongside
`git`, `git-gui`, etc.