commit f447d26b4a79b05fb05ab16410e8acce870f192d from: Stefan Sperling date: Fri Aug 23 13:06:29 2019 UTC sync man pages commit - 91b3da3f7b9f268cef0228f185c163f0d7490b70 commit + f447d26b4a79b05fb05ab16410e8acce870f192d blob - 0e8394b9eed3ab2bfbcb700ffadd52ab470b7858 blob + 384a5c187c0056e9bf21c3eb9e7a9ab948a62519 --- git-repository.5.html +++ git-repository.5.html @@ -69,6 +69,10 @@ A Git repository stores a series of versioned snapshot other commit's parent commit. A commit with multiple parents unites disparate lines of history and is known as a merge commit. +
Tags
+
A tag object associates an user-defined label with + another object, which is typically a commit object. Tag objects also + contains a tag message, as well as author and timestamp information.

Each object is identified by a SHA1 hash calculated over both the object's header and the data stored in the object.

@@ -204,7 +208,7 @@ The particular set of disallowed characters in referen - +
August 18, 2019August 23, 2019 OpenBSD 6.5
blob - 0d40608b27035511e57f1d0217b6d0dbd248360e blob + 8060f9dcb94dab5cbf3d37b435b1395d18ec9304 --- got-worktree.5.html +++ got-worktree.5.html @@ -174,7 +174,7 @@ A Got work tree stores a file hierar - +
August 18, 2019August 23, 2019 OpenBSD 6.5
blob - 565e5a1f6c1ad67800debb217f77b536e5447971 blob + ece46d6f825c02b54fc5b035551436de48af8587 --- got.1.html +++ got.1.html @@ -566,6 +566,53 @@
Short alias for branch.
+
+ [-m message] + [-r repository-path] + [-l] name + [commit]
+
Manage tags in a repository. +

Tags are managed via references which live in the + “refs/tags/” reference namespace. The got + tag command operates on references in this namespace only. + References in this namespace point at tag objects which contain a + pointer to another object, a tag message, as well as author and + timestamp information.

+

Expect one or two arguments and attempt to create a tag with + the given name, and make this tag point at the + given commit. If no commit is specified, default + to the latest commit on the work tree's current branch if invoked in a + work tree, and to a commit resolved via the repository's HEAD reference + otherwise. Otherwise, the expected argument is a commit ID SHA1 hash or + an existing reference or tag name which will be resolved to a commit ID. + An abbreviated hash argument will be expanded to a full SHA1 hash + automatically, provided the abbreviation is unique.

+

The options for got tag are as + follows:

+
+
+ message
+
Use the specified tag message when creating the new tag Without the + -m option, got import + opens a temporary file in an editor where a tag message can be + written.
+
+ repository-path
+
Use the repository at the specified path. If not specified, assume the + repository is located at or above the current working directory. If + this directory is a got work tree, use the + repository path associated with this work tree.
+
+
List all existing tags in the repository instead of creating a new + tag. If this option is used, no other command-line arguments are + allowed.
+
+

By design, the got tag command will + not delete tags or change existing tags. If a tag must be deleted, the + got ref command may be used to delete a tag's + reference. This should only be done if the tag has not already been + copied to another repository.

+
file-path ...
Schedule unversioned files in a work tree for addition to the repository @@ -657,7 +704,7 @@

The options for got commit are as follows:

-
+
message
Use the specified log message when creating the new commit. Without the -m option, got @@ -1031,7 +1078,7 @@

The options for got stage are as follows:

-
+
Instead of staging new changes, list paths which are already staged, along with the IDs of staged blob objects and stage status codes. If paths were provided in the command line show the staged paths among @@ -1124,6 +1171,26 @@
Short alias for unstage.
+
+ [-r repository-path] + object ...
+
Parse and print contents of specified objects to standard output in a + line-based text format. Treat each argument as a reference, a tag name, or + an object ID SHA1 hash. References will be resolved to an object ID. Tag + names will resolved to a tag object. An abbreviated hash argument will be + expanded to a full SHA1 hash automatically, provided the abbreviation is + unique. +

The options for got cat are as + follows:

+
+
+ repository-path
+
Use the repository at the specified path. If not specified, assume the + repository is located at or above the current working directory. If + this directory is a got work tree, use the + repository path associated with this work tree.
+
+
@@ -1140,7 +1207,9 @@ missing email address.
, EDITOR
-
The editor spawned by got commit.
+
The editor spawned by got commit, + got import, or got + tag.
The default limit on the number of commits traversed by got log. If set to zero, the limit is unbounded. @@ -1336,7 +1405,7 @@ Clone an existing Git repository for use with - +
August 18, 2019August 23, 2019 OpenBSD 6.5
blob - d1aa49ad661721837c636c500da417eb77ea35c8 blob + 6216afa959214f368c86ab7952aa3737ba1d6250 --- tog.1.html +++ tog.1.html @@ -349,7 +349,7 @@ The tog utility exits 0 - +
August 18, 2019August 23, 2019 OpenBSD 6.5