commit d8e62599d7ab8b61cb516a9b833f276d7ed7c358 from: Stefan Sperling date: Mon Oct 21 11:32:18 2019 UTC sync man pages commit - 2b499410fbde242112d21b4b4f36174e997ef67f commit + d8e62599d7ab8b61cb516a9b833f276d7ed7c358 blob - ea419e41f960be4631147495cbd2f8c31338e510 blob + be478ca88f2813163f659b1ad60fe5bdcf905c35 --- git-repository.5.html +++ git-repository.5.html @@ -21,13 +21,12 @@ table.head, table.foot { width: 100%; } td.head-rtitle, td.foot-os { text-align: right; } td.head-vol { text-align: center; } - div.Pp { margin: 1ex 0ex; } - div.Nd, div.Bf, div.Op { display: inline; } - span.Pa, span.Ad { font-style: italic; } - span.Ms { font-weight: bold; } - dl.Bl-diag > dt { font-weight: bold; } - code.Nm, code.Fl, code.Cm, code.Ic, code.In, code.Fd, code.Fn, - code.Cd { font-weight: bold; font-family: inherit; } + .Nd, .Bf, .Op { display: inline; } + .Pa, .Ad { font-style: italic; } + .Ms { font-weight: bold; } + .Bl-diag > dt { font-weight: bold; } + code.Nm, .Fl, .Cm, .Ic, code.In, .Fd, .Fn, .Cd { font-weight: bold; + font-family: inherit; } GIT-REPOSITORY(5) @@ -42,14 +41,14 @@

-git-repository — -
Git repository format
+

git-repository — + Git repository format

-A Git repository stores a series of versioned snapshots of a file hierarchy. - Conceptually, the repository's data model is a directed acyclic graph which - contains three types of objects as nodes: +

A Git repository stores a series of versioned snapshots of a file + hierarchy. Conceptually, the repository's data model is a directed acyclic + graph which contains three types of objects as nodes:

Blobs
The content of tracked files is stored in objects of type @@ -80,11 +79,11 @@ A Git repository stores a series of versioned snapshot

-Loose objects are stored as individual files beneath the directory - objects, spread across 256 sub-directories named after - the 256 possible hexadecimal values of the first byte of an object identifier. - The name of the loose object file corresponds to the remaining hexadecimal - byte values of the object's identifier. +

Loose objects are stored as individual files beneath the directory + objects, spread across 256 sub-directories named + after the 256 possible hexadecimal values of the first byte of an object + identifier. The name of the loose object file corresponds to the remaining + hexadecimal byte values of the object's identifier.

A loose object file begins with a header which specifies the type of object as an ASCII string, followed by an ASCII space character, followed by the object data's size encoded as an ASCII number string. The header is @@ -116,10 +115,11 @@ Loose objects are stored as individual files beneath t

-A reference associates a name with an object ID. A prominent use of references - is providing names to branches in the repository by pointing at commit objects - which represent the current tip commit of a branch. Because references may - point to arbitrary object IDs their use is not limited to branches. +

A reference associates a name with an object ID. A prominent use + of references is providing names to branches in the repository by pointing + at commit objects which represent the current tip commit of a branch. + Because references may point to arbitrary object IDs their use is not + limited to branches.

The name is a UTF-8 string with the following disallowed characters: ‘ ’ (space), ~ (tilde), ^ (caret), : (colon), ? (question mark), * (asterisk), [ (opening square bracket), \ @@ -187,29 +187,29 @@ A reference associates a name with an object ID. A pro

-got(1), deflate(3), - SHA1(3), got-worktree(5) +

got(1), deflate(3), + SHA1(3), got-worktree(5)

-The Git repository format was initially designed by Linus Torvalds in 2005 and - has since been extended by various people involved in the development of the - Git version control system. +

The Git repository format was initially designed by Linus Torvalds + in 2005 and has since been extended by various people involved in the + development of the Git version control system.

-The particular set of disallowed characters in reference names is a consequence - of design choices made for the command-line interface of - git(1). The same characters are disallowed by Got for - compatibility purposes. Got additionally prevents users from creating - reference names with a leading - (dash) character, because this is rarely - intended and not considered useful. +

The particular set of disallowed characters in reference names is + a consequence of design choices made for the command-line interface of + git(1). The same characters are disallowed by Got for + compatibility purposes. Got additionally prevents users from creating + reference names with a leading - (dash) character, because this is rarely + intended and not considered useful.

- - + +
October 6, 2019OpenBSD 6.5October 21, 2019OpenBSD 6.6
blob - 02014968e0ad74fa243af47acc00ccd93e8802c1 blob + 246d05b5fa9703a29568fdd11cb9358fef94f448 --- got-worktree.5.html +++ got-worktree.5.html @@ -21,13 +21,12 @@ table.head, table.foot { width: 100%; } td.head-rtitle, td.foot-os { text-align: right; } td.head-vol { text-align: center; } - div.Pp { margin: 1ex 0ex; } - div.Nd, div.Bf, div.Op { display: inline; } - span.Pa, span.Ad { font-style: italic; } - span.Ms { font-weight: bold; } - dl.Bl-diag > dt { font-weight: bold; } - code.Nm, code.Fl, code.Cm, code.Ic, code.In, code.Fd, code.Fn, - code.Cd { font-weight: bold; font-family: inherit; } + .Nd, .Bf, .Op { display: inline; } + .Pa, .Ad { font-style: italic; } + .Ms { font-weight: bold; } + .Bl-diag > dt { font-weight: bold; } + code.Nm, .Fl, .Cm, .Ic, code.In, .Fd, .Fn, .Cd { font-weight: bold; + font-family: inherit; } GOT-WORKTREE(5) @@ -42,16 +41,17 @@

-got-worktree — -
Got worktree format
+

got-worktreeGot + worktree format

-A Got work tree stores a file hierarchy which corresponds to a - versioned snapshot stored in a Git repository. The work tree's meta data is - stored in the .got directory. A work tree is created - with got checkout and is required to make changes to a - Git repository with got(1). +

A Got work tree stores a file hierarchy which + corresponds to a versioned snapshot stored in a Git repository. The work + tree's meta data is stored in the .got directory. A + work tree is created with got checkout and is + required to make changes to a Git repository with + got(1).

A work tree stores the path to its Git repository, the name of a reference to the branch which files were checked out from, and the ID of a commit on this branch known as the base commit.

@@ -167,15 +167,15 @@ A Got work tree stores a file hierar

-got(1), rename(2), - stat(2), umask(2), - lockf(3), git-repository(5) +

got(1), rename(2), + stat(2), umask(2), + lockf(3), git-repository(5)

- - + +
October 6, 2019OpenBSD 6.5October 21, 2019OpenBSD 6.6
blob - fdd7a5ae2f5a036da0b28d9fff1dcc68ce5fab91 blob + d45bc51f501abcb7cb86e0a99517b8a961e34f31 --- got.1.html +++ got.1.html @@ -22,13 +22,12 @@ table.head, table.foot { width: 100%; } td.head-rtitle, td.foot-os { text-align: right; } td.head-vol { text-align: center; } - div.Pp { margin: 1ex 0ex; } - div.Nd, div.Bf, div.Op { display: inline; } - span.Pa, span.Ad { font-style: italic; } - span.Ms { font-weight: bold; } - dl.Bl-diag > dt { font-weight: bold; } - code.Nm, code.Fl, code.Cm, code.Ic, code.In, code.Fd, code.Fn, - code.Cd { font-weight: bold; font-family: inherit; } + .Nd, .Bf, .Op { display: inline; } + .Pa, .Ad { font-style: italic; } + .Ms { font-weight: bold; } + .Bl-diag > dt { font-weight: bold; } + code.Nm, .Fl, .Cm, .Ic, code.In, .Fd, .Fn, .Cd { font-weight: bold; + font-family: inherit; } GOT(1) @@ -43,8 +42,8 @@

-got — -
Game of Trees
+

gotGame of + Trees

@@ -58,10 +57,10 @@

-got is a version control system which stores the history - of tracked files in a Git repository, as used by the Git version control - system. This repository format is described in - git-repository(5). +

got is a version control system which + stores the history of tracked files in a Git repository, as used by the Git + version control system. This repository format is described in + git-repository(5).

got is a “distributed” version control system because every copy of a repository is writeable. Modifications made to files can be synchronized between repositories at any @@ -284,6 +283,10 @@ unversioned item not tracked by got + m + modified file modes (executable bit only) + + N non-existent path specified on the command line @@ -393,8 +396,9 @@

[-C number] [-r repository-path] - [-s] [object1 - object2 | path]
+ [-s] [-w] + [object1 object2 | + path]
When invoked within a work tree with less than two arguments, display uncommitted changes in the work tree. If a path is specified, only show changes within this path. @@ -421,6 +425,8 @@
Show changes staged with got stage instead of showing local changes. This option is only valid when got diff is invoked in a work tree.
+
+
Ignore whitespace-only changes.
@@ -515,10 +521,11 @@

If no options are passed, expect two arguments and attempt to create, or update, the reference with the given name, and make it point at the given - target. The target may be an object ID SHA1 hash - or an existing reference which will be resolved to an object ID. An - abbreviated hash argument will be expanded to a full SHA1 hash - automatically, provided the abbreviation is unique.

+ target. The name must be an absolute reference + name, i.e. it must begin with “refs/”. The target may be + an object ID SHA1 hash or an existing reference which will be resolved + to an object ID. An abbreviated hash argument will be expanded to a full + SHA1 hash automatically, provided the abbreviation is unique.

The options for got ref are as follows:

@@ -719,6 +726,10 @@ A new file was added + + + m + modified file modes (executable bit only)

Files which are not part of the new commit will retain their @@ -1067,6 +1078,58 @@

Short alias for histedit.
+
+ branch
+
Integrate the specified branch into the work tree's + current branch. Files in the work tree are updated to match the contents + on the integrated branch, and the reference of the + work tree's branch is changed to point at the head commit of the + integrated branch. +

Both branches can be considered equivalent after integration + since they will be pointing at the same commit. Both branches remain + available for future work, if desired. In case the integrated + branch is no longer needed it may be deleted with + got branch -d.

+

Show the status of each affected file, using the following + status codes:

+ + + + + + + + + + + + + + + + + + + + + +
Ufile was updated
Dfile was deleted
Anew file was added
~versioned file is obstructed by a non-regular file
!a missing versioned file was restored
+

got integrate will refuse to run if + certain preconditions are not met. Most importantly, the + branch must have been rebased onto the work tree's + current branch with got rebase before it can be + integrated, in order to linearize commit history and resolve merge + conflicts. If the work tree contains multiple base commits it must first + be updated to a single base commit with got + update. If changes have been staged with got + stage, these changes must first be committed with + got commit or unstaged with got + unstage. If the work tree contains local changes, these changes + must first be committed with got commit or + reverted with got revert.

+
+
+
Short alias for integrate.
[-l] [-p] [-F response-script] @@ -1283,13 +1346,14 @@

-The got utility exits 0 on success, - and >0 if an error occurs. +

The got utility exits 0 on success, + and >0 if an error occurs.

-Clone an existing Git repository for use with got. This - step currently requires git(1): +

Clone an existing Git repository for use with + got. This step currently requires + git(1):

$ cd /var/git/
$ git clone --bare @@ -1440,36 +1504,56 @@ Clone an existing Git repository for use with

$ cd /var/git/repo
$ git push origin master
+

In order to merge changes committed to the + “unified-buffer-cache” branch back into the + “master” branch, the “unified-buffer-cache” + branch must first be rebased onto the “master” branch:

+

+
$ got update -b master
+
$ got rebase + unified-buffer-cache
+

Changes on the “unified-buffer-cache” branch can now + be made visible on the “master” branch with + got integrate. Because the rebase operation switched + the work tree to the “unified-buffer-cache” branch, the work + tree must be switched back to the “master” branch before the + “unified-buffer-cache” branch can be integrated into + “master”:

+

+
$ got update -b master
+
$ got integrate + unified-buffer-cache

-tog(1), git-repository(5), - got-worktree(5) +

tog(1), git-repository(5), + got-worktree(5)

-Stefan Sperling - <stsp@openbsd.org> -
-Martin Pieuchot - <mpi@openbsd.org> -
-Joshua Stein - <jcs@openbsd.org> +

Stefan Sperling + <stsp@openbsd.org> +
+ Martin Pieuchot + <mpi@openbsd.org> +
+ Joshua Stein + <jcs@openbsd.org>

-got is a work-in-progress and many commands remain to be - implemented. At present, the user has to fall back on git(1) - to perform many tasks, in particular tasks related to repository - administration and tasks which require a network connection. +

got is a work-in-progress and many + commands remain to be implemented. At present, the user has to fall back on + git(1) to perform many tasks, in particular tasks related + to repository administration and tasks which require a network + connection.

- - + +
October 6, 2019OpenBSD 6.5October 21, 2019OpenBSD 6.6
blob - cca37bf0851a20070c400345449d4db9fb1a2b8b blob + 219b56b401d8442414a26afe15f4bb4535f3e7c3 --- tog.1.html +++ tog.1.html @@ -21,13 +21,12 @@ table.head, table.foot { width: 100%; } td.head-rtitle, td.foot-os { text-align: right; } td.head-vol { text-align: center; } - div.Pp { margin: 1ex 0ex; } - div.Nd, div.Bf, div.Op { display: inline; } - span.Pa, span.Ad { font-style: italic; } - span.Ms { font-weight: bold; } - dl.Bl-diag > dt { font-weight: bold; } - code.Nm, code.Fl, code.Cm, code.Ic, code.In, code.Fd, code.Fn, - code.Cd { font-weight: bold; font-family: inherit; } + .Nd, .Bf, .Op { display: inline; } + .Pa, .Ad { font-style: italic; } + .Ms { font-weight: bold; } + .Bl-diag > dt { font-weight: bold; } + code.Nm, .Fl, .Cm, .Ic, code.In, .Fd, .Fn, .Cd { font-weight: bold; + font-family: inherit; } TOG(1) @@ -42,8 +41,8 @@

-tog — -
Git repository browser
+

togGit + repository browser

@@ -57,9 +56,9 @@

-tog is an interactive read-only browser for Git - repositories. This repository format is described in - git-repository(5). +

tog is an interactive read-only browser + for Git repositories. This repository format is described in + git-repository(5).

tog supports several types of views which display repository data:

@@ -333,28 +332,28 @@

-The tog utility exits 0 on success, - and >0 if an error occurs. +

The tog utility exits 0 on success, + and >0 if an error occurs.

-got(1), git-repository(5), - re_format(7) +

got(1), git-repository(5), + re_format(7)

-Stefan Sperling - <stsp@openbsd.org> -
-Joshua Stein - <jcs@openbsd.org> +

Stefan Sperling + <stsp@openbsd.org> +
+ Joshua Stein + <jcs@openbsd.org>

- - + +
October 6, 2019OpenBSD 6.5October 21, 2019OpenBSD 6.6