GL(1)

✨ GL(1) — like, the manual page, bestie ✨

okay so this is the manual page for gl from the General Commands Manual — a whole version control system sitting on top of Git, and I'm gonna walk you through every single bit of it. no skipping. grab a snack 🍓

---

🌸 NAME 🌸

gl</purgle> — a version control system on top of Git. that's it, that's the vibe. it's giving "git but make it make sense" 💅

---

🦋 SYNOPSIS 🦋

okay bestie here's the whole menu, verbatim, don't touch anything:

gl track file...
gl track -h

gl untrack file...
gl untrack -h

gl status path...
gl status -h

gl diff [-e file...] [-i file...] [-o file...]
gl diff -h

gl commit [-m message] [-p] [-e file...] [-i file...] [-o file...]
gl commit -h

gl branch [-r] [-v]
gl branch [-v] [-dp point] -c branch...
gl branch [-v] -d branch...
gl branch -sh commit_id
gl branch -su branch
gl branch -uu
gl branch -h

gl tag [-r]
gl tag [-ci commit_id] -c tag...
gl tag -d tag...
gl tag -h

gl checkout [-cp commit_id] files...
gl checkout -h

gl merge src
gl merge -a
gl merge -h

gl resolve file...
gl resolve -h

gl fuse [-ip commit_id] [-e commit_id...] [-o commit_id...] src
gl fuse -a
gl fuse -h

gl remote
gl remote -c remote remote_url
gl remote -d remote
gl remote -h

gl publish dst_branch
gl publish -h

gl switch [-mo] branch
gl switch -h

gl init [repo]
gl init -h

gl history [-c] [-v] [-b branch_name] [-l limit]
gl history -h

gl -h
gl --version

like, look at it. so organized. main character energy fr fr 👑

---

💖 DESCRIPTION 💖

so the gl utility is a version control system built on top of Git. that's the whole concept. it takes Git and wraps it in something your brain can actually hold onto 🫶

the gl utility accepts the following commands, and I'm listing all of them, no cap:

• track — Start tracking changes to files. 🎀
• untrack — Stop tracking changes to files. bye bestie 👋
• status — Show the status of the repository.
• diff — Show the status of the repository.
• commit — Save changes to the local repository. By default all tracked modified files are committed. To customize the set of files to be committed use the only, exclude, and include flags.
  • -m — Specify the commit message.
  • -p, --partial — Interactively select segments of files to commit. so you can be picky about it, lowkey iconic ✨
• branch — List, create, edit, or delete branches.
  • -c, --create — Create the specified branch(es).
  • -d, --delete — Delete the specified branch(es).
  • -dp, -divergent-point — The commit from which to “branch out”.
  • -sh, --set-head — Set the head of the current branch.
  • -su, --set-upstream — Set the upstream branch of the current branch.
  • -uu, --unset-upstream — Unset the upstream branch of the current branch.
  • -v — Be verbose, output the head of each branch.
• tag — List, create, or delete tags.
  • -c, --create — Create tag(s).
  • -ci, --commit — Specify the commit to tag.
  • -d, --delete — Delete tag(s).
  • -r, --remote — List remote tags in addition to local ones.
• checkout — Checkout the committed versions of the specified files.
  • -cp, --commit-point — The commit point to checkout the files as.
• merge — Merge the divergent changes of one branch onto another.
  • -a — Abort the merge in progress.
• resolve — Mark files with conflicts as resolved. we love a problem-solver 💜
• fuse — Fuse the divergent changes of a branch onto the current branch. By default all divergent changes from the given source branch are fused. To customize the set of commits to fuse use the only and exclude flags.
  • -a, --abort — Abort the fuse in progress.
  • -ip, --insertion-point — The divergent changes will be inserted after the specified commit.
• remote — List, create, edit, or delete remotes.
  • -c, --create — Create a remote.
  • -d, --delete — Delete a remote.
• publish — Publish commits upstream. 📤
• switch — Switch branches.
  • -mo, --move-over — Move the uncommitted changes made to the current branch to the destination branch.
• init — Create an empty Gitless repository or create one from an existing remote repository.
• history — Show the commit history.
  • -b, --branch — The branch to show the history of.
  • -c, --compact — Output the history in a compact format.
  • -l, --limit — Limit the number of commits displayed.
  • -v, --verbose — Be verbose, output the diffs of the commits.

---

💅 COMMON OPTIONS 💅

these ones hit different — the following options have a similar meaning for various commands:

• -e, --exclude — Exclude the specified files; the files must be tracked and modified.
• -h, --help — Display a help message.
• -i, --include — Include the specified files; the files must be untracked.
• -o, --only — Use only the specified files; the files must be tracked and modified.

---

🌈 ENVIRONMENT 🌈

the gl utility makes use of the following environment variables, if specified. (yes, if — they're optional bestie, no pressure)

• EDITOR — Specify the editor to use for composing commit messages; default: “vim”.
• PAGER — Specify the pager to be used if the core.pager setting is not specified in the Git configuration; default: “less -r -f”. If the pager to be executed is actually less(1), the -r and -f flags are appended to its arguments.

⭐ heads up: that less detail is conditional. it only appends -r and -f if the pager being executed is actually less(1). iykyk.

---

🎀 FILES 🎀

the operation of the gl utility is influenced by the same configuration files that git(1) uses; see the “FILES” section of the git-config(1) documentation. so like, if you already know your git config files, you already know these. periodt. 💖

---

🌸 EXAMPLES 🌸

Please see the Gitless website at https://gitless.com/.

(not me sending you straight to the website 😭 that's the whole example section, bestie, go look at the real thing)

---

🦋 DIAGNOSTICS 🦋

the gl utility exits 0 on success, and >0 if an error occurs. so like — zero is the slay outcome, anything above zero means something went sideways 💀

---

👑 SEE ALSO 👑

git(1)

that's the one and only. the origin story. 🫶

---

💜 AUTHORS 💜

Santiago Perez De Rosso ⟨sperezde@csail.mit.edu⟩

This manual page was written for the Debian project by Peter Pentchev ⟨roam@ringlet.net⟩

---

and that's the whole page bestie, you ate it, every flag, every default, every little ⟨ bracket, all of it, no cap ✨

Debian — November 13, 2016 — GL(1) 🎀 that's the source, the version and the date, all wrapped up in a little bow. mwah 💅