Commit 5e5560e10410aa7dab84154c6cad083c6fd3ef76

Stefan Sperling 2018-08-01T15:04:29

rename got-repository(5) man page to git-repository(5)

diff --git a/got/git-repository.5 b/got/git-repository.5
new file mode 100644
index 0000000..bec518e
--- /dev/null
+++ b/got/git-repository.5
@@ -0,0 +1,91 @@
+.\"
+.\" Copyright (c) 2018 Stefan Sperling <stsp@openbsd.org>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate$
+.Dt GIT-REPOSITORY 5
+.Os
+.Sh NAME
+.Nm git-repository
+.Nd git repository format
+.Sh DESCRIPTION
+A git repository stores a series of versioned snapshots of a file hierarchy.
+.Pp
+The repository's core data model is a directed acyclic graph which
+contains three types of objects as nodes.
+Each object is identified by the SHA-1 hash calculated over the object's
+header plus the content stored in the object.
+The object header names the type of object in an ASCII string, which is
+followed by a space, followed by the size of data in the object encoded
+as an ASCII number string.
+This header is terminated by a
+.Sy NUL
+character.
+.Pp
+The content of tracked files is stored in objects of type
+.Em blob .
+.Pp
+A
+.Em tree
+object points to any number of such blobs, and also to other trees in
+order to form a hierarchy of files and directories.
+.Pp
+A
+.Em commit
+object points to the root element of one tree, and thus records the
+state of this entire tree as a snapshot.
+Commit objects are chained together and thus form a line of history
+of snapshots.
+A given commit can be suceeded by an arbitrary number of subsequent commits,
+such that diverging lines of version control history, known as
+.Em branches ,
+can be represented.
+A commit which preceeds another commit is referred to as that other commit's
+.Em parent commit .
+A commit with multiple parents reunites diverged lines of history and is
+known as a
+.Em merge commit .
+While the data model allows for commits with an arbitrary number of
+parent commits,
+.Xr got 1
+restricts all commits to at most 2 parents in order to discourage chaotic
+branching and merging practices.
+.Pp
+When stored on disk, all objects are compressed with
+.Xr deflate 3 .
+Mulitple objects may be stored together in a
+.Em pack file
+which provides for deltification of object content.
+.Sh FILES
+.Bl -tag -width /etc/rpc -compact
+.It Pa HEAD
+.It Pa ORIG_HEAD
+.It Pa FETCH_HEAD
+.It Pa branches/
+.It Pa config
+.It Pa description
+.It Pa hooks/
+.It Pa index
+.It Pa info
+.It Pa logs/
+.It Pa objects/
+.It Pa packed-refs
+.It Pa refs/
+.El
+.Sh SEE ALSO
+.Xr got 1 ,
+.Xr deflate 3 ,
+.Xr got-worktree 5
+.Sh HISTORY
+The Git repository format was designed by Linus Torvalds in 2005.
diff --git a/got/got-repository.5 b/got/got-repository.5
deleted file mode 100644
index 35d807c..0000000
--- a/got/got-repository.5
+++ /dev/null
@@ -1,99 +0,0 @@
-.\"
-.\" Copyright (c) 2018 Stefan Sperling <stsp@openbsd.org>
-.\"
-.\" Permission to use, copy, modify, and distribute this software for any
-.\" purpose with or without fee is hereby granted, provided that the above
-.\" copyright notice and this permission notice appear in all copies.
-.\"
-.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-.\"
-.Dd $Mdocdate$
-.Dt GOT-REPOSITORY 5
-.Os
-.Sh NAME
-.Nm got-repository
-.Nd format of
-.Xr got 1
-repositories
-.Sh DESCRIPTION
-.Xr got 1
-stores the history of tracked files in a repository which uses
-the same on-disk format as
-.Dq bare
-repositories used by the Git version control system.
-.Pp
-The repository's core data model is a directed acyclic graph which
-contains three types of objects as nodes.
-Each object is identified by the SHA-1 hash calculated over the object's
-header plus the content stored in the object.
-The object header names the type of object in an ASCII string, which is
-followed by a space, followed by the size of data in the object encoded
-as an ASCII number string.
-This header is terminated by a
-.Sy NUL
-character.
-.Pp
-The content of files tracked under version control is stored in objects
-of type
-.Em blob .
-.Pp
-A
-.Em tree
-object points to any number of such blobs, and also to other trees
-in order to form a hierarchy of files and directories.
-.Pp
-A
-.Em commit
-object points to the root element of one tree, and thus records the
-state of this entire tree as a snapshot.
-Commit objects are chained together and thus form a line of history
-of snapshots.
-A given commit can be suceeded by an arbitrary number of subsequent
-commits, such that diverging lines of version control history, known as
-.Em branches ,
-can be represented.
-A commit which preceeds another commit is referred to as that other commit's
-.Em parent commit .
-A commit with multiple parents reunites diverged lines of history and is
-known as a
-.Em merge commit .
-While the data model allows for commits with an arbitrary number of
-parent commits,
-.Xr got 1
-restricts all commits to at most 2 parents in order to discourage chaotic
-branching and merging practices.
-.Pp
-When stored on disk, all objects are compressed with
-.Xr deflate 3 .
-Mulitple objects may be stored together in a
-.Em pack file
-which provides for deltification of object content.
-.Sh FILES
-.Bl -tag -width /etc/rpc -compact
-.It Pa HEAD
-.It Pa ORIG_HEAD
-.It Pa FETCH_HEAD
-.It Pa branches/
-.It Pa config
-.It Pa description
-.It Pa hooks/
-.It Pa index
-.It Pa info
-.It Pa logs/
-.It Pa objects/
-.It Pa packed-refs
-.It Pa refs/
-.El
-.Sh SEE ALSO
-.Xr git 1 ,
-.Xr got 1 ,
-.Xr deflate 3 ,
-.Xr got-worktree 5
-.Sh HISTORY
-The Git repository format was conceived by Linus Torvalds in 2005.
diff --git a/got/got.1 b/got/got.1
index d087539..6126ff5 100644
--- a/got/got.1
+++ b/got/got.1
@@ -36,7 +36,7 @@ the same on-disk format as
 .Dq bare
 repositories used by the Git version control system.
 This repository format is described in
-.Xr got-repository 5 .
+.Xr git-repository 5 .
 .Pp
 .Nm
 is a
@@ -139,7 +139,7 @@ kernel sources from a Git repository at /var/repo/openbsd-src to ~/sys:
 .Pp
 .Dl $ got checkout -p sys /var/repo/openbsd-src ~/sys
 .Sh SEE ALSO
-.Xr got-repository 5
+.Xr git-repository 5
 .Xr got-worktree 5
 .Sh AUTHORS
 .An Stefan Sperling Aq Mt stsp@openbsd.org
diff --git a/tog/tog.1 b/tog/tog.1
index 6fbbf38..317a046 100644
--- a/tog/tog.1
+++ b/tog/tog.1
@@ -28,7 +28,7 @@
 .Nm
 is an interactive read-only browser for git repositories.
 This repository format is described in
-.Xr got-repository 5 .
+.Xr git-repository 5 .
 .Pp
 .Nm
 provides global and command-specific options.
@@ -200,6 +200,6 @@ to a commit object.
 .Sh EXIT STATUS
 .Ex -std tog
 .Sh SEE ALSO
-.Xr got-repository 5
+.Xr git-repository 5
 .Sh AUTHORS
 .An Stefan Sperling Aq Mt stsp@openbsd.org