doc/checkout: refer to git-branch(1) as appropriate

Most of description for the branch creation options is
simply cut and paste from git-branch. There are two reasons
to fix this:

  1. It can grow stale with respect to what's in "git
     branch" (which it is now is).

  2. It is not just an implementation detail, but rather the
     desired mental model for the command that we are using
     "git branch" here. Being explicit about that can help
     the user understand what is going on.

It also makes sense to strip the branch creation options
from the synopsis, as they are making it a long,
hard-to-read line. They are still easily discovered by
reading the options list, and --track is explicitly
referenced when branch creation is described.

Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
1 file changed
tree: b968fa9f467c8457f039f7a2c155469f2687a03b
  1. arm/
  2. compat/
  3. contrib/
  4. Documentation/
  5. git-gui/
  6. gitk-git/
  7. gitweb/
  8. mozilla-sha1/
  9. perl/
  10. ppc/
  11. t/
  12. templates/
  13. xdiff/
  14. .gitattributes
  15. .gitignore
  16. .mailmap
  17. abspath.c
  18. alias.c
  19. alloc.c
  20. archive-tar.c
  21. archive-zip.c
  22. archive.c
  23. archive.h
  24. attr.c
  25. attr.h
  26. base85.c
  27. bisect.c
  28. bisect.h
  29. blob.c
  30. blob.h
  31. branch.c
  32. branch.h
  33. builtin-add.c
  34. builtin-annotate.c
  35. builtin-apply.c
  36. builtin-archive.c
  37. builtin-bisect--helper.c
  38. builtin-blame.c
  39. builtin-branch.c
  40. builtin-bundle.c
  41. builtin-cat-file.c
  42. builtin-check-attr.c
  43. builtin-check-ref-format.c
  44. builtin-checkout-index.c
  45. builtin-checkout.c
  46. builtin-clean.c
  47. builtin-clone.c
  48. builtin-commit-tree.c
  49. builtin-commit.c
  50. builtin-config.c
  51. builtin-count-objects.c
  52. builtin-describe.c
  53. builtin-diff-files.c
  54. builtin-diff-index.c
  55. builtin-diff-tree.c
  56. builtin-diff.c
  57. builtin-fast-export.c
  58. builtin-fetch--tool.c
  59. builtin-fetch-pack.c
  60. builtin-fetch.c
  61. builtin-fmt-merge-msg.c
  62. builtin-for-each-ref.c
  63. builtin-fsck.c
  64. builtin-gc.c
  65. builtin-grep.c
  66. builtin-help.c
  67. builtin-http-fetch.c
  68. builtin-init-db.c
  69. builtin-log.c
  70. builtin-ls-files.c
  71. builtin-ls-remote.c
  72. builtin-ls-tree.c
  73. builtin-mailinfo.c
  74. builtin-mailsplit.c
  75. builtin-merge-base.c
  76. builtin-merge-file.c
  77. builtin-merge-ours.c
  78. builtin-merge-recursive.c
  79. builtin-merge.c
  80. builtin-mv.c
  81. builtin-name-rev.c
  82. builtin-pack-objects.c
  83. builtin-pack-refs.c
  84. builtin-prune-packed.c
  85. builtin-prune.c
  86. builtin-push.c
  87. builtin-read-tree.c
  88. builtin-receive-pack.c
  89. builtin-reflog.c
  90. builtin-remote.c
  91. builtin-rerere.c
  92. builtin-reset.c
  93. builtin-rev-list.c
  94. builtin-rev-parse.c
  95. builtin-revert.c
  96. builtin-rm.c
  97. builtin-send-pack.c
  98. builtin-shortlog.c
  99. builtin-show-branch.c
  100. builtin-show-ref.c
  101. builtin-stripspace.c
  102. builtin-symbolic-ref.c
  103. builtin-tag.c
  104. builtin-tar-tree.c
  105. builtin-unpack-objects.c
  106. builtin-update-index.c
  107. builtin-update-ref.c
  108. builtin-upload-archive.c
  109. builtin-verify-pack.c
  110. builtin-verify-tag.c
  111. builtin-write-tree.c
  112. builtin.h
  113. bundle.c
  114. bundle.h
  115. cache-tree.c
  116. cache-tree.h
  117. cache.h
  118. check-builtins.sh
  119. check-racy.c
  120. check_bindir
  121. color.c
  122. color.h
  123. combine-diff.c
  124. command-list.txt
  125. commit.c
  126. commit.h
  127. config.c
  128. config.mak.in
  129. configure.ac
  130. connect.c
  131. convert.c
  132. copy.c
  133. COPYING
  134. csum-file.c
  135. csum-file.h
  136. ctype.c
  137. daemon.c
  138. date.c
  139. decorate.c
  140. decorate.h
  141. delta.h
  142. diff-delta.c
  143. diff-lib.c
  144. diff-no-index.c
  145. diff.c
  146. diff.h
  147. diffcore-break.c
  148. diffcore-delta.c
  149. diffcore-order.c
  150. diffcore-pickaxe.c
  151. diffcore-rename.c
  152. diffcore.h
  153. dir.c
  154. dir.h
  155. editor.c
  156. entry.c
  157. environment.c
  158. exec_cmd.c
  159. exec_cmd.h
  160. fast-import.c
  161. fetch-pack.h
  162. fixup-builtins
  163. fsck.c
  164. fsck.h
  165. generate-cmdlist.sh
  166. git-add--interactive.perl
  167. git-am.sh
  168. git-archimport.perl
  169. git-bisect.sh
  170. git-compat-util.h
  171. git-cvsexportcommit.perl
  172. git-cvsimport.perl
  173. git-cvsserver.perl
  174. git-filter-branch.sh
  175. git-instaweb.sh
  176. git-lost-found.sh
  177. git-merge-octopus.sh
  178. git-merge-one-file.sh
  179. git-merge-resolve.sh
  180. git-mergetool.sh
  181. git-parse-remote.sh
  182. git-pull.sh
  183. git-quiltimport.sh
  184. git-rebase--interactive.sh
  185. git-rebase.sh
  186. git-relink.perl
  187. git-repack.sh
  188. git-request-pull.sh
  189. git-send-email.perl
  190. git-sh-setup.sh
  191. git-stash.sh
  192. git-submodule.sh
  193. git-svn.perl
  194. GIT-VERSION-GEN
  195. git-web--browse.sh
  196. git.c
  197. git.spec.in
  198. graph.c
  199. graph.h
  200. grep.c
  201. grep.h
  202. hash-object.c
  203. hash.c
  204. hash.h
  205. help.c
  206. help.h
  207. http-push.c
  208. http-walker.c
  209. http.c
  210. http.h
  211. ident.c
  212. imap-send.c
  213. index-pack.c
  214. INSTALL
  215. levenshtein.c
  216. levenshtein.h
  217. list-objects.c
  218. list-objects.h
  219. ll-merge.c
  220. ll-merge.h
  221. lockfile.c
  222. log-tree.c
  223. log-tree.h
  224. mailmap.c
  225. mailmap.h
  226. Makefile
  227. match-trees.c
  228. merge-file.c
  229. merge-index.c
  230. merge-recursive.c
  231. merge-recursive.h
  232. merge-tree.c
  233. mktag.c
  234. mktree.c
  235. name-hash.c
  236. object.c
  237. object.h
  238. pack-check.c
  239. pack-redundant.c
  240. pack-refs.c
  241. pack-refs.h
  242. pack-revindex.c
  243. pack-revindex.h
  244. pack-write.c
  245. pack.h
  246. pager.c
  247. parse-options.c
  248. parse-options.h
  249. patch-delta.c
  250. patch-id.c
  251. patch-ids.c
  252. patch-ids.h
  253. path.c
  254. pkt-line.c
  255. pkt-line.h
  256. preload-index.c
  257. pretty.c
  258. progress.c
  259. progress.h
  260. quote.c
  261. quote.h
  262. reachable.c
  263. reachable.h
  264. read-cache.c
  265. README
  266. reflog-walk.c
  267. reflog-walk.h
  268. refs.c
  269. refs.h
  270. remote.c
  271. remote.h
  272. rerere.c
  273. rerere.h
  274. revision.c
  275. revision.h
  276. run-command.c
  277. run-command.h
  278. send-pack.h
  279. server-info.c
  280. setup.c
  281. sha1-lookup.c
  282. sha1-lookup.h
  283. sha1_file.c
  284. sha1_name.c
  285. shallow.c
  286. shell.c
  287. shortlog.h
  288. show-index.c
  289. sideband.c
  290. sideband.h
  291. sigchain.c
  292. sigchain.h
  293. strbuf.c
  294. strbuf.h
  295. string-list.c
  296. string-list.h
  297. symlinks.c
  298. tag.c
  299. tag.h
  300. tar.h
  301. test-chmtime.c
  302. test-ctype.c
  303. test-date.c
  304. test-delta.c
  305. test-dump-cache-tree.c
  306. test-genrandom.c
  307. test-match-trees.c
  308. test-parse-options.c
  309. test-path-utils.c
  310. test-sha1.c
  311. test-sha1.sh
  312. test-sigchain.c
  313. thread-utils.c
  314. thread-utils.h
  315. trace.c
  316. transport.c
  317. transport.h
  318. tree-diff.c
  319. tree-walk.c
  320. tree-walk.h
  321. tree.c
  322. tree.h
  323. unimplemented.sh
  324. unpack-file.c
  325. unpack-trees.c
  326. unpack-trees.h
  327. update-server-info.c
  328. upload-pack.c
  329. usage.c
  330. userdiff.c
  331. userdiff.h
  332. utf8.c
  333. utf8.h
  334. var.c
  335. walker.c
  336. walker.h
  337. wrapper.c
  338. write_or_die.c
  339. ws.c
  340. wt-status.c
  341. wt-status.h
  342. xdiff-interface.c
  343. xdiff-interface.h