Documentation: revise top of git man page

I'm afraid I'll be accused of trying to suck all the jokes and the
personality out of the git documentation.  I'm not!  Really!

That said, "man git" is one of the first things a new user is likely try,
and it seems a little cruel to start off with a somewhat obscure joke
about the architecture of git.

So instead I'm trying for a relatively straightforward description of what
git does, and what features distinguish it from other systems, together
with immediate links to introductory documentation.

I also did some minor reorganization in an attempt to clarify the
classification of commands.  And revised a bit for conciseness (as is
obvious from the diffstat--hopefully I didn't cut anything important).

Signed-off-by: J. Bruce Fields <bfields@citi.umich.edu>
Signed-off-by: Junio C Hamano <junkio@cox.net>
1 file changed
tree: 5d89b88a238cf6e7dee173ada543f55cb816b160
  1. arm/
  2. compat/
  3. contrib/
  4. Documentation/
  5. mozilla-sha1/
  6. ppc/
  7. t/
  8. templates/
  9. xdiff/
  10. .gitignore
  11. apply.c
  12. blame.c
  13. blob.c
  14. blob.h
  15. cache.h
  16. cat-file.c
  17. check-ref-format.c
  18. checkout-index.c
  19. clone-pack.c
  20. combine-diff.c
  21. commit-tree.c
  22. commit.c
  23. commit.h
  24. config.c
  25. connect.c
  26. convert-objects.c
  27. copy.c
  28. COPYING
  29. csum-file.c
  30. csum-file.h
  31. ctype.c
  32. daemon.c
  33. date.c
  34. delta.h
  35. describe.c
  36. diff-delta.c
  37. diff-files.c
  38. diff-index.c
  39. diff-stages.c
  40. diff-tree.c
  41. diff.c
  42. diff.h
  43. diffcore-break.c
  44. diffcore-delta.c
  45. diffcore-order.c
  46. diffcore-pathspec.c
  47. diffcore-pickaxe.c
  48. diffcore-rename.c
  49. diffcore.h
  50. entry.c
  51. environment.c
  52. exec_cmd.c
  53. exec_cmd.h
  54. fetch-clone.c
  55. fetch-pack.c
  56. fetch.c
  57. fetch.h
  58. fsck-objects.c
  59. generate-cmdlist.sh
  60. get-tar-commit-id.c
  61. git-add.sh
  62. git-am.sh
  63. git-annotate.perl
  64. git-applymbox.sh
  65. git-applypatch.sh
  66. git-archimport.perl
  67. git-bisect.sh
  68. git-branch.sh
  69. git-checkout.sh
  70. git-cherry.sh
  71. git-clone.sh
  72. git-commit.sh
  73. git-compat-util.h
  74. git-count-objects.sh
  75. git-cvsexportcommit.perl
  76. git-cvsimport.perl
  77. git-cvsserver.perl
  78. git-diff.sh
  79. git-fetch.sh
  80. git-fmt-merge-msg.perl
  81. git-format-patch.sh
  82. git-grep.sh
  83. git-log.sh
  84. git-lost-found.sh
  85. git-ls-remote.sh
  86. git-merge-octopus.sh
  87. git-merge-one-file.sh
  88. git-merge-ours.sh
  89. git-merge-recursive.py
  90. git-merge-resolve.sh
  91. git-merge-stupid.sh
  92. git-merge.sh
  93. git-mv.perl
  94. git-parse-remote.sh
  95. git-prune.sh
  96. git-pull.sh
  97. git-push.sh
  98. git-rebase.sh
  99. git-relink.perl
  100. git-repack.sh
  101. git-request-pull.sh
  102. git-rerere.perl
  103. git-reset.sh
  104. git-resolve.sh
  105. git-revert.sh
  106. git-rm.sh
  107. git-send-email.perl
  108. git-sh-setup.sh
  109. git-shortlog.perl
  110. git-svnimport.perl
  111. git-tag.sh
  112. git-verify-tag.sh
  113. GIT-VERSION-GEN
  114. git-whatchanged.sh
  115. git.c
  116. git.spec.in
  117. gitk
  118. gitMergeCommon.py
  119. hash-object.c
  120. http-fetch.c
  121. http-push.c
  122. http.c
  123. http.h
  124. ident.c
  125. imap-send.c
  126. index-pack.c
  127. index.c
  128. init-db.c
  129. INSTALL
  130. local-fetch.c
  131. ls-files.c
  132. ls-tree.c
  133. mailinfo.c
  134. mailsplit.c
  135. Makefile
  136. merge-base.c
  137. merge-index.c
  138. merge-tree.c
  139. mktag.c
  140. mktree.c
  141. name-rev.c
  142. object.c
  143. object.h
  144. pack-check.c
  145. pack-objects.c
  146. pack-redundant.c
  147. pack.h
  148. pager.c
  149. patch-delta.c
  150. patch-id.c
  151. path.c
  152. peek-remote.c
  153. pkt-line.c
  154. pkt-line.h
  155. prune-packed.c
  156. quote.c
  157. quote.h
  158. read-cache.c
  159. read-tree.c
  160. README
  161. receive-pack.c
  162. refs.c
  163. refs.h
  164. repo-config.c
  165. rev-list.c
  166. rev-parse.c
  167. revision.c
  168. revision.h
  169. rsh.c
  170. rsh.h
  171. run-command.c
  172. run-command.h
  173. send-pack.c
  174. server-info.c
  175. setup.c
  176. sha1_file.c
  177. sha1_name.c
  178. shell.c
  179. show-branch.c
  180. show-index.c
  181. ssh-fetch.c
  182. ssh-pull.c
  183. ssh-push.c
  184. ssh-upload.c
  185. strbuf.c
  186. strbuf.h
  187. stripspace.c
  188. symbolic-ref.c
  189. tag.c
  190. tag.h
  191. tar-tree.c
  192. tar.h
  193. test-date.c
  194. test-delta.c
  195. tree-diff.c
  196. tree-walk.c
  197. tree-walk.h
  198. tree.c
  199. tree.h
  200. unpack-file.c
  201. unpack-objects.c
  202. update-index.c
  203. update-ref.c
  204. update-server-info.c
  205. upload-pack.c
  206. usage.c
  207. var.c
  208. verify-pack.c
  209. write-tree.c