ref: c188c740ec6629d3915864ea11d6bbade5598e30
parent: 34814c675be8a8f324fbc7594ad862506db455d9
author: Ori Bernstein <[email protected]>
date: Sun Nov 29 13:33:35 EST 2020
manpage: add config example, fix formatting I forgot the keys and values for configuring the username and email, so I added an example to jog my memory. Furthermore, .TP had gotten misused, garbling the end of the documentation.
--- a/git.1.man
+++ b/git.1.man
@@ -532,12 +532,14 @@
.PP
In order to create a new repository, run
.B git/init:
-
+.PP
.EX
git/init myrepo
.EE
+.PP
To clone an existing repository from a git server, run:
+.PP
.EX
git/clone git://github.com/Harvey-OS/harvey
cd harvey
@@ -546,14 +548,29 @@
git/push
.EE
+.PP
+To set a user and email for commits, run:
+.PP
+.EX
+% mkdir $home/lib/git
+% >$home/lib/git/config echo '
+[user]
+ name = Ori Bernstein
+ email = [email protected]'
+.EE
+
.SH FILES
-.TP .git
-.TP .git/config
-.TP $home/lib/git/config
+.TP
+$repo/.git
+The full git repository.
+.TP
+$repo/.git/config
+The configuration file for a repository.
+.TP
+$home/lib/git/config
+The global configuration for git.
+The contents of this file are used as fallbacks for the per-repository config.
-.SH SOURCE
-.B /sys/src/cmd/git
-
.SH SEE ALSO
.IR hg (1)
.IR replica (1)
@@ -564,9 +581,7 @@
.SH BUGS
.PP
Repositories with submodules are effectively read-only.
-
.PP
There are a some of missing commands, features, and tools, such as git/rebase
-
.PP
git/compat only works within a git repository.