shithub: git9

Info  •  Files  •  Log  •  Branches

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 = ori@eigenstate.org'

+.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.