avm-tools 0.49.0 → 0.54.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (391) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +8 -0
  3. data/lib/avm/data/package/dump.rb +1 -1
  4. data/lib/avm/git/auto_commit_path.rb +49 -0
  5. data/lib/avm/git/issue/complete/_commits.rb +1 -4
  6. data/lib/avm/git/issue/complete/_git_subrepos.rb +20 -0
  7. data/lib/avm/git/issue/complete/_local_branch.rb +4 -7
  8. data/lib/avm/git/issue/complete/_push.rb +1 -1
  9. data/lib/avm/git/issue/complete/_test.rb +1 -1
  10. data/lib/avm/git/issue/complete/_validations.rb +1 -0
  11. data/lib/avm/git/issue/complete/_working_tree.rb +5 -2
  12. data/lib/avm/git/subrepo_check.rb +39 -0
  13. data/lib/avm/git/subrepo_check/parent.rb +51 -0
  14. data/lib/avm/git/subrepo_check/remote.rb +89 -0
  15. data/lib/avm/git/subrepo_check/show_result.rb +33 -0
  16. data/lib/avm/git/subrepo_checks.rb +59 -0
  17. data/lib/avm/instances/configuration/_rubocop.rb +1 -1
  18. data/lib/avm/rails/runners/runner.rb +48 -0
  19. data/lib/avm/result.rb +13 -3
  20. data/lib/avm/ruby/gems.rb +11 -0
  21. data/lib/avm/ruby/gems/generator.rb +168 -0
  22. data/lib/avm/ruby/rubocop/_gemfile.rb +1 -1
  23. data/lib/avm/stereotypes/eac_webapp_base0/runner/data/dump.rb +1 -1
  24. data/lib/avm/tools/runner/eac_rails_base0/runner.rb +14 -0
  25. data/lib/avm/tools/runner/eac_redmine_base0/runner.rb +2 -31
  26. data/lib/avm/tools/runner/git/auto_commit.rb +56 -0
  27. data/lib/avm/tools/runner/git/deploy.rb +2 -2
  28. data/lib/avm/tools/runner/git/subrepo.rb +22 -0
  29. data/lib/avm/tools/runner/git/subrepo/check.rb +51 -0
  30. data/lib/avm/tools/runner/ruby/gems.rb +22 -0
  31. data/lib/avm/tools/runner/ruby/gems/generate.rb +50 -0
  32. data/lib/avm/tools/version.rb +1 -1
  33. data/lib/eac_launcher.rb +0 -3
  34. data/lib/eac_launcher/git/base.rb +10 -26
  35. data/lib/eac_launcher/git/base/underlying.rb +11 -9
  36. data/template/avm/ruby/gems/generator/gemspec.template +18 -0
  37. data/template/avm/ruby/gems/generator/root_lib.template +7 -0
  38. data/template/avm/ruby/gems/generator/static/Gemfile +5 -0
  39. data/template/avm/ruby/gems/generator/static/spec/rubocop_spec.rb +7 -0
  40. data/template/avm/ruby/gems/generator/static/spec/spec_helper.rb +100 -0
  41. data/template/avm/ruby/gems/generator/version.template +5 -0
  42. data/vendor/gems/eac_git/Gemfile +5 -0
  43. data/vendor/gems/eac_git/eac_git.gemspec +19 -0
  44. data/vendor/gems/eac_git/lib/eac_git.rb +7 -0
  45. data/vendor/gems/eac_git/lib/eac_git/executables.rb +44 -0
  46. data/vendor/gems/eac_git/lib/eac_git/local.rb +57 -0
  47. data/vendor/gems/eac_git/lib/eac_git/local/subrepo.rb +48 -0
  48. data/vendor/gems/eac_git/lib/eac_git/local/subrepo/config.rb +43 -0
  49. data/vendor/gems/eac_git/lib/eac_git/remote.rb +19 -0
  50. data/vendor/gems/eac_git/lib/eac_git/remote/ls_result.rb +20 -0
  51. data/vendor/gems/eac_git/lib/eac_git/rspec.rb +17 -0
  52. data/vendor/gems/eac_git/lib/eac_git/version.rb +5 -0
  53. data/vendor/gems/eac_git/spec/lib/eac_git/executables_spec.rb +13 -0
  54. data/vendor/gems/eac_git/spec/rubocop_spec.rb +7 -0
  55. data/vendor/gems/eac_git/spec/spec_helper.rb +103 -0
  56. data/vendor/gems/eac_git/vendor/git-subrepo/Changes +110 -0
  57. data/vendor/gems/eac_git/vendor/git-subrepo/Intro.pod +509 -0
  58. data/vendor/gems/eac_git/vendor/git-subrepo/License +21 -0
  59. data/vendor/gems/eac_git/vendor/git-subrepo/Makefile +82 -0
  60. data/vendor/gems/eac_git/vendor/git-subrepo/Meta +28 -0
  61. data/vendor/gems/eac_git/vendor/git-subrepo/ReadMe.pod +698 -0
  62. data/vendor/gems/eac_git/vendor/git-subrepo/doc/comparison.swim +35 -0
  63. data/vendor/gems/eac_git/vendor/git-subrepo/doc/git-subrepo.swim +608 -0
  64. data/vendor/gems/eac_git/vendor/git-subrepo/doc/intro-to-subrepo.swim +387 -0
  65. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/Changes +15 -0
  66. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/License +21 -0
  67. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/Makefile +45 -0
  68. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/Meta +28 -0
  69. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/ReadMe.pod +77 -0
  70. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/bin/bash+ +43 -0
  71. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/doc/bash+.swim +61 -0
  72. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/lib/bash+.bash +92 -0
  73. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/man/man1/bash+.1 +134 -0
  74. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/man/man3/bash+.3 +134 -0
  75. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/test/base.t +12 -0
  76. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/test/fcopy.t +22 -0
  77. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/test/lib/foo/bar.bash +3 -0
  78. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/test/lib/foo/foo.bash +3 -0
  79. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/test/source-bash+-std.t +18 -0
  80. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/test/source-bash+.t +23 -0
  81. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/test/test.bash +70 -0
  82. data/vendor/gems/eac_git/vendor/git-subrepo/ext/bashplus/test/use.t +19 -0
  83. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/Changes +15 -0
  84. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/License +21 -0
  85. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/Makefile +20 -0
  86. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/Meta +30 -0
  87. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ReadMe.pod +115 -0
  88. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/doc/test-more.swim +89 -0
  89. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/Changes +15 -0
  90. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/License +21 -0
  91. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/Makefile +45 -0
  92. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/Meta +28 -0
  93. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/ReadMe.pod +77 -0
  94. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/bin/bash+ +43 -0
  95. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/doc/bash+.swim +61 -0
  96. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/lib/bash+.bash +92 -0
  97. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/man/man1/bash+.1 +134 -0
  98. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/man/man3/bash+.3 +134 -0
  99. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/test/base.t +12 -0
  100. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/test/fcopy.t +22 -0
  101. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/test/lib/foo/bar.bash +3 -0
  102. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/test/lib/foo/foo.bash +3 -0
  103. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/test/source-bash+-std.t +18 -0
  104. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/test/source-bash+.t +23 -0
  105. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/test/test.bash +70 -0
  106. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/bashplus/test/use.t +19 -0
  107. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/Changes +15 -0
  108. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/License +21 -0
  109. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/Makefile +37 -0
  110. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/Meta +28 -0
  111. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/ReadMe.pod +66 -0
  112. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/doc/test-tap.swim +48 -0
  113. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/lib/test/tap.bash +153 -0
  114. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/man/man3/test-tap.3 +119 -0
  115. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/bail_out.t +13 -0
  116. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/done.t +10 -0
  117. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/fail.t +20 -0
  118. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/fail_fast.t +15 -0
  119. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/helper.bash +9 -0
  120. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/pass.t +9 -0
  121. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/plan.t +10 -0
  122. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/skip_all.t +20 -0
  123. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/tap.t +13 -0
  124. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/test/bail.t +14 -0
  125. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/test/fail.t +7 -0
  126. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/test/fail_fast.t +12 -0
  127. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/test/skip-all-init.t +8 -0
  128. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/ext/test-tap-bash/test/test/skip-all-plan.t +9 -0
  129. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/lib/test/more.bash +95 -0
  130. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/man/man3/test-more.3 +173 -0
  131. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/test/fail.t +20 -0
  132. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/test/more.t +20 -0
  133. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/test/pass.t +9 -0
  134. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/test/setup +8 -0
  135. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/test/skip_all.t +11 -0
  136. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/test/test/fail1.t +12 -0
  137. data/vendor/gems/eac_git/vendor/git-subrepo/ext/test-more-bash/test/test/skip_all.t +10 -0
  138. data/vendor/gems/eac_git/vendor/git-subrepo/lib/git-subrepo +1901 -0
  139. data/vendor/gems/eac_git/vendor/git-subrepo/lib/git-subrepo.d/bash+.bash +1 -0
  140. data/vendor/gems/eac_git/vendor/git-subrepo/lib/git-subrepo.d/help-functions.bash +339 -0
  141. data/vendor/gems/eac_git/vendor/git-subrepo/man/man1/git-subrepo.1 +743 -0
  142. data/vendor/gems/eac_git/vendor/git-subrepo/note/0.4.0 +12 -0
  143. data/vendor/gems/eac_git/vendor/git-subrepo/note/AllGitCmds +148 -0
  144. data/vendor/gems/eac_git/vendor/git-subrepo/note/Cases +32 -0
  145. data/vendor/gems/eac_git/vendor/git-subrepo/note/Commands +33 -0
  146. data/vendor/gems/eac_git/vendor/git-subrepo/note/Dags +199 -0
  147. data/vendor/gems/eac_git/vendor/git-subrepo/note/Gists +7 -0
  148. data/vendor/gems/eac_git/vendor/git-subrepo/note/Links +25 -0
  149. data/vendor/gems/eac_git/vendor/git-subrepo/note/Plugins +10 -0
  150. data/vendor/gems/eac_git/vendor/git-subrepo/note/Spec +39 -0
  151. data/vendor/gems/eac_git/vendor/git-subrepo/note/Story1 +57 -0
  152. data/vendor/gems/eac_git/vendor/git-subrepo/note/ToDo +55 -0
  153. data/vendor/gems/eac_git/vendor/git-subrepo/note/design.swim +137 -0
  154. data/vendor/gems/eac_git/vendor/git-subrepo/note/design2.swim +85 -0
  155. data/vendor/gems/eac_git/vendor/git-subrepo/note/init-test +38 -0
  156. data/vendor/gems/eac_git/vendor/git-subrepo/note/pull-dance.txt +18 -0
  157. data/vendor/gems/eac_git/vendor/git-subrepo/note/recreate-rebase-conflict.sh +56 -0
  158. data/vendor/gems/eac_git/vendor/git-subrepo/note/subtree-rebase-fail-example/test.bash +29 -0
  159. data/vendor/gems/eac_git/vendor/git-subrepo/note/test-subrepo-push.sh +69 -0
  160. data/vendor/gems/eac_git/vendor/git-subrepo/note/test.sh +58 -0
  161. data/vendor/gems/eac_git/vendor/git-subrepo/pkg/bin/generate-completion.pl +210 -0
  162. data/vendor/gems/eac_git/vendor/git-subrepo/pkg/bin/generate-help-functions.pl +89 -0
  163. data/vendor/gems/eac_git/vendor/git-subrepo/share/completion.bash +42 -0
  164. data/vendor/gems/eac_git/vendor/git-subrepo/share/enable-completion.sh +50 -0
  165. data/vendor/gems/eac_git/vendor/git-subrepo/share/git-completion.bash +2738 -0
  166. data/vendor/gems/eac_git/vendor/git-subrepo/share/zsh-completion/_git-subrepo +81 -0
  167. data/vendor/gems/eac_git/vendor/git-subrepo/test/branch-all.t +41 -0
  168. data/vendor/gems/eac_git/vendor/git-subrepo/test/branch-rev-list-one-path.t +43 -0
  169. data/vendor/gems/eac_git/vendor/git-subrepo/test/branch-rev-list.t +47 -0
  170. data/vendor/gems/eac_git/vendor/git-subrepo/test/branch.t +52 -0
  171. data/vendor/gems/eac_git/vendor/git-subrepo/test/clean.t +43 -0
  172. data/vendor/gems/eac_git/vendor/git-subrepo/test/clone-annotated-tag.t +45 -0
  173. data/vendor/gems/eac_git/vendor/git-subrepo/test/clone.t +107 -0
  174. data/vendor/gems/eac_git/vendor/git-subrepo/test/compile.t +19 -0
  175. data/vendor/gems/eac_git/vendor/git-subrepo/test/config.t +58 -0
  176. data/vendor/gems/eac_git/vendor/git-subrepo/test/encode.t +91 -0
  177. data/vendor/gems/eac_git/vendor/git-subrepo/test/error.t +171 -0
  178. data/vendor/gems/eac_git/vendor/git-subrepo/test/fetch.t +43 -0
  179. data/vendor/gems/eac_git/vendor/git-subrepo/test/gitignore.t +61 -0
  180. data/vendor/gems/eac_git/vendor/git-subrepo/test/init.t +64 -0
  181. data/vendor/gems/eac_git/vendor/git-subrepo/test/issue29.t +98 -0
  182. data/vendor/gems/eac_git/vendor/git-subrepo/test/issue95.t +98 -0
  183. data/vendor/gems/eac_git/vendor/git-subrepo/test/issue96.t +96 -0
  184. data/vendor/gems/eac_git/vendor/git-subrepo/test/pull-all.t +38 -0
  185. data/vendor/gems/eac_git/vendor/git-subrepo/test/pull-merge.t +113 -0
  186. data/vendor/gems/eac_git/vendor/git-subrepo/test/pull-message.t +88 -0
  187. data/vendor/gems/eac_git/vendor/git-subrepo/test/pull-new-branch.t +58 -0
  188. data/vendor/gems/eac_git/vendor/git-subrepo/test/pull-ours.t +90 -0
  189. data/vendor/gems/eac_git/vendor/git-subrepo/test/pull-theirs.t +82 -0
  190. data/vendor/gems/eac_git/vendor/git-subrepo/test/pull-twice.t +44 -0
  191. data/vendor/gems/eac_git/vendor/git-subrepo/test/pull-worktree.t +40 -0
  192. data/vendor/gems/eac_git/vendor/git-subrepo/test/pull.t +99 -0
  193. data/vendor/gems/eac_git/vendor/git-subrepo/test/push-after-init.t +51 -0
  194. data/vendor/gems/eac_git/vendor/git-subrepo/test/push-force.t +56 -0
  195. data/vendor/gems/eac_git/vendor/git-subrepo/test/push-new-branch.t +61 -0
  196. data/vendor/gems/eac_git/vendor/git-subrepo/test/push-no-changes.t +29 -0
  197. data/vendor/gems/eac_git/vendor/git-subrepo/test/push-squash.t +56 -0
  198. data/vendor/gems/eac_git/vendor/git-subrepo/test/push.t +176 -0
  199. data/vendor/gems/eac_git/vendor/git-subrepo/test/reclone.t +45 -0
  200. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/bar/HEAD +1 -0
  201. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/bar/config +4 -0
  202. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/bar/objects/1f/0c4b264caed0126814a0ede851a1e0b4e16ae6 +0 -0
  203. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/bar/objects/87/46903fdb1b9c2101377880125917c2e05b4d69 +0 -0
  204. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/bar/objects/94/c86ffc745232d89f78c6f895e11e71272518db +0 -0
  205. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/bar/objects/c6/76c57b6576743fa56278527aa60ebd2e202a7c +0 -0
  206. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/bar/objects/e6/9de29bb2d1d6434b8b29ae775ad8c2e48c5391 +0 -0
  207. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/bar/objects/f6/2a8ff3feadf39b0a98f1a86ec6d1eb33858ee9 +0 -0
  208. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/bar/refs/heads/master +1 -0
  209. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/bar/refs/tags/A +1 -0
  210. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/foo/HEAD +1 -0
  211. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/foo/config +4 -0
  212. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/foo/objects/a0/f4cdaaf533a936296cdebbed8206c3b9ededa8 +0 -0
  213. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/foo/objects/e2/1291a1ad392a9d4c51dd9586804f1467b28afd +0 -0
  214. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/foo/objects/e6/9de29bb2d1d6434b8b29ae775ad8c2e48c5391 +0 -0
  215. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/foo/refs/heads/master +1 -0
  216. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/HEAD +1 -0
  217. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/config +5 -0
  218. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/11/523f5dcf03b4c89b592dc8a3d0308f68da2386 +0 -0
  219. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/14/2addf8ec5f37334e837440122c62f2c68a29ad +0 -0
  220. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/32/5180321750a21cd7a4e7ecda319e557a4f6a09 +2 -0
  221. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/3d/918c6901c02f43af5d31779dd5e1f9166aeb36 +0 -0
  222. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/3e/4cb596066dce63ba4d047abddb677389b65e19 +0 -0
  223. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/4b/6e53022e7a04f07887697e4f3d7c377fd9822b +0 -0
  224. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/58/931fc1bd559b59c41ea738fc7ad04f9ad01bd3 +0 -0
  225. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/5e/c0c28e1b806f25efdca18fcf7a74b49c3755bd +0 -0
  226. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/75/fa6584e748f57eff06eebdc55e9ac21d4fcbf2 +1 -0
  227. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/80/2d5edbd5e1cb7fca82b5bd38e7c8a0a496fb20 +0 -0
  228. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/94/7b3d714c38791e95ad6f928b48c98bb8708acd +0 -0
  229. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/95/e1f2df3f4d5f3d7a60588c25a7ca8a913d3c2a +1 -0
  230. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/b1/5f4a7666baf40d949548ead946a3370e273479 +0 -0
  231. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/c3/ee8978c4c5d84c3b7d00ba8e5906933d027882 +0 -0
  232. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/c8/b0bffbc405ef3fad7354ff833fbec36d67ddfa +3 -0
  233. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/dd/8bdb934ec848137f011fe423b185505c343626 +2 -0
  234. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/e2/9be58c767cfeb27235c995d293a7d71aac0135 +2 -0
  235. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/ee/1224401fc6aac595145fa727dcf6706ac8aec1 +1 -0
  236. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/objects/f1/cc1a657b2e805c400f5dcaaa76bd29c6178b1b +0 -0
  237. data/vendor/gems/eac_git/vendor/git-subrepo/test/repo/init/refs/heads/master +1 -0
  238. data/vendor/gems/eac_git/vendor/git-subrepo/test/setup +205 -0
  239. data/vendor/gems/eac_git/vendor/git-subrepo/test/status.t +68 -0
  240. data/vendor/gems/eac_git/vendor/git-subrepo/test/submodule.t +45 -0
  241. data/vendor/gems/eac_ruby_utils/Gemfile +16 -0
  242. data/vendor/gems/eac_ruby_utils/MIT-LICENCE +16 -0
  243. data/vendor/gems/eac_ruby_utils/README.rdoc +3 -0
  244. data/vendor/gems/eac_ruby_utils/eac_ruby_utils.gemspec +24 -0
  245. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils.rb +6 -0
  246. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/arguments_consumer.rb +81 -0
  247. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/by_reference.rb +23 -0
  248. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/common_concern.rb +68 -0
  249. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/common_constructor.rb +133 -0
  250. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/configs.rb +74 -0
  251. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/configs/file.rb +66 -0
  252. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console.rb +5 -0
  253. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/configs.rb +135 -0
  254. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/docopt_runner.rb +39 -0
  255. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/docopt_runner/_class_methods.rb +18 -0
  256. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/docopt_runner/_doc.rb +25 -0
  257. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/docopt_runner/_settings.rb +19 -0
  258. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/docopt_runner/_subcommands.rb +139 -0
  259. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/speaker.rb +133 -0
  260. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/speaker/_class_methods.rb +39 -0
  261. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/speaker/_constants.rb +14 -0
  262. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/speaker/list.rb +63 -0
  263. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/console/speaker/node.rb +26 -0
  264. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/contextualizable.rb +16 -0
  265. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/core_ext.rb +5 -0
  266. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/custom_format.rb +53 -0
  267. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/envs.rb +23 -0
  268. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/envs/base_env.rb +28 -0
  269. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/envs/command.rb +169 -0
  270. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/envs/command/extra_options.rb +54 -0
  271. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/envs/executable.rb +51 -0
  272. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/envs/file.rb +22 -0
  273. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/envs/local_env.rb +17 -0
  274. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/envs/process.rb +19 -0
  275. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/envs/spawn.rb +32 -0
  276. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/envs/ssh_env.rb +72 -0
  277. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/filesystem_cache.rb +53 -0
  278. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/fs.rb +9 -0
  279. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/fs/extname.rb +30 -0
  280. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/fs/temp.rb +52 -0
  281. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/fs/temp/directory.rb +16 -0
  282. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/fs/temp/file.rb +34 -0
  283. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/fs/traversable.rb +47 -0
  284. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/fs/traverser.rb +74 -0
  285. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/fs_cache.rb +11 -0
  286. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/listable.rb +17 -0
  287. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/listable/class_methods.rb +14 -0
  288. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/listable/instance_methods.rb +30 -0
  289. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/listable/integer_list.rb +23 -0
  290. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/listable/list.rb +93 -0
  291. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/listable/lists.rb +59 -0
  292. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/listable/string_list.rb +19 -0
  293. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/listable/symbol_list.rb +19 -0
  294. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/listable/value.rb +38 -0
  295. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/on_clean_ruby_environment.rb +12 -0
  296. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/options_consumer.rb +62 -0
  297. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patch.rb +11 -0
  298. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches.rb +4 -0
  299. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/class.rb +4 -0
  300. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/class/common_constructor.rb +9 -0
  301. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/enumerable.rb +4 -0
  302. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/enumerable/boolean_combinations.rb +45 -0
  303. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/hash.rb +5 -0
  304. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/hash/options_consumer.rb +10 -0
  305. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/hash/sym_keys_hash.rb +10 -0
  306. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/module.rb +4 -0
  307. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/module/common_concern.rb +10 -0
  308. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/module/console_speaker.rb +10 -0
  309. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/module/listable.rb +10 -0
  310. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/module/patch.rb +9 -0
  311. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/module/require_sub.rb +9 -0
  312. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/module/simple_cache.rb +10 -0
  313. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/object.rb +5 -0
  314. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/object/asserts.rb +14 -0
  315. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/object/if_present.rb +19 -0
  316. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/object/template.rb +16 -0
  317. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/object/to_pathname.rb +15 -0
  318. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/pathname.rb +4 -0
  319. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/pathname/basename_sub.rb +9 -0
  320. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/regexp.rb +4 -0
  321. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/regexp/if_match.rb +16 -0
  322. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/time.rb +4 -0
  323. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/time/default_time_zone_set.rb +5 -0
  324. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/patches/time/local_time_zone.rb +25 -0
  325. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/paths_hash.rb +93 -0
  326. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/require_sub.rb +54 -0
  327. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/rspec.rb +9 -0
  328. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/rspec/conditional.rb +38 -0
  329. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/rspec/stubbed_ssh.rb +44 -0
  330. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/ruby.rb +9 -0
  331. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/ruby/command.rb +31 -0
  332. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/ruby/on_clean_environment.rb +26 -0
  333. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/settings_provider.rb +65 -0
  334. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/simple_cache.rb +42 -0
  335. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/templates.rb +9 -0
  336. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/templates/directory.rb +110 -0
  337. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/templates/file.rb +50 -0
  338. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/templates/searcher.rb +55 -0
  339. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/templates/variable_not_found_error.rb +7 -0
  340. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/templates/variable_providers.rb +25 -0
  341. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/templates/variable_providers/base.rb +23 -0
  342. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/templates/variable_providers/entries_reader.rb +25 -0
  343. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/templates/variable_providers/generic.rb +25 -0
  344. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/templates/variable_providers/hash.rb +29 -0
  345. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/version.rb +5 -0
  346. data/vendor/gems/eac_ruby_utils/lib/eac_ruby_utils/yaml.rb +96 -0
  347. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/arguments_consumer_spec.rb +17 -0
  348. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/common_concern_spec.rb +42 -0
  349. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/common_constructor_spec.rb +37 -0
  350. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/configs_spec.rb +31 -0
  351. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/console/configs_spec.rb +14 -0
  352. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/console/docopt_runner_spec.rb +136 -0
  353. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/console/speaker_spec.rb +36 -0
  354. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/custom_format_spec.rb +60 -0
  355. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/envs/executable_spec.rb +37 -0
  356. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/envs/ssh_env_spec.rb +25 -0
  357. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/filesystem_cache_spec.rb +32 -0
  358. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/fs/extname_spec.rb +18 -0
  359. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/fs/temp/temp_spec.rb +12 -0
  360. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/fs/temp_spec.rb +52 -0
  361. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/listable_spec.rb +212 -0
  362. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/options_consumer_spec.rb +45 -0
  363. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/patches/enumerable/boolean_combinations_spec.rb +39 -0
  364. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/patches/hash/options_consumer_spec.rb +17 -0
  365. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/patches/hash/sym_keys_hash_spec.rb +13 -0
  366. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/patches/module/console_speaker_spec.rb +13 -0
  367. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/patches/module/listable_spec.rb +13 -0
  368. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/patches/module/simple_cache_spec.rb +13 -0
  369. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/patches/object/if_present_spec.rb +13 -0
  370. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/patches/object/template_spec.rb +23 -0
  371. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/patches/object/template_spec_files/path/my_stub_with_template +1 -0
  372. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/patches/pathname/basename_sub_spec.rb +17 -0
  373. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/paths_hash_spec.rb +49 -0
  374. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/require_sub_spec.rb +19 -0
  375. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/require_sub_spec/stubbed_module_a.rb +6 -0
  376. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/require_sub_spec/stubbed_not_module.rb +6 -0
  377. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/ruby_spec.rb +22 -0
  378. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/settings_provider_spec.rb +46 -0
  379. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/simple_cache_spec.rb +102 -0
  380. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/templates/file_spec.rb +35 -0
  381. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/templates/file_spec_files/expected_content +2 -0
  382. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/templates/file_spec_files/source.template +2 -0
  383. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/templates/searcher_spec.rb +30 -0
  384. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/templates/searcher_spec_files/path1/subdir1/file1.template +1 -0
  385. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/templates/searcher_spec_files/path1/subdir1/file2 +1 -0
  386. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/templates/searcher_spec_files/path2/subdir1/file3.template +1 -0
  387. data/vendor/gems/eac_ruby_utils/spec/lib/eac_ruby_utils/yaml_spec.rb +75 -0
  388. data/vendor/gems/eac_ruby_utils/spec/locales/pt-BR.yml +55 -0
  389. data/vendor/gems/eac_ruby_utils/spec/rubocop_check_spec.rb +7 -0
  390. data/vendor/gems/eac_ruby_utils/spec/spec_helper.rb +12 -0
  391. metadata +391 -6
@@ -0,0 +1 @@
1
+ vendor/gems/eac_git/vendor/git-subrepo/lib/git-subrepo.d/../../ext/bashplus/lib/bash+.bash
@@ -0,0 +1,339 @@
1
+ #!/usr/bin/env bash
2
+
3
+ # DO NOT EDIT. This file generated by pkg/bin/generate-help-functions.pl.
4
+
5
+ set -e
6
+
7
+ help:all() {
8
+ cat <<'...'
9
+ branch branch <subdir>|--all [-f] [-F]
10
+ clean clean <subdir>|--all|--ALL [-f]
11
+ clone clone <repository> [<subdir>] [-b <branch>] [-f] [-m <msg>] [-e] [--method <merge|rebase>]
12
+ commit commit <subdir> [<subrepo-ref>] [-m <msg>] [-e] [-f] [-F]
13
+ config config <subdir> <option> [<value>] [-f]
14
+ fetch fetch <subdir>|--all [-r <remote>] [-b <branch>]
15
+ help help [<command>|--all]
16
+ init init <subdir> [-r <remote>] [-b <branch>] [--method <merge|rebase>]
17
+ pull pull <subdir>|--all [-M|-R|-f] [-m <msg>] [-e] [-b <branch>] [-r <remote>] [-u]
18
+ push push <subdir>|--all [<branch>] [-r <remote>] [-b <branch>] [-M|-R] [-u] [-f] [-s] [-N]
19
+ status status [<subdir>|--all|--ALL] [-F] [-q|-v]
20
+ upgrade upgrade
21
+ version version [-q|-v]
22
+ ...
23
+ }
24
+
25
+ help:branch() {
26
+ cat <<'...'
27
+
28
+ Usage: git subrepo branch <subdir>|--all [-f] [-F]
29
+
30
+
31
+ Create a branch with local subrepo commits.
32
+
33
+ Scan the history of the mainline for all the commits that affect the `subdir`
34
+ and create a new branch from them called `subrepo/<subdir>`.
35
+
36
+ This is useful for doing `pull` and `push` commands by hand.
37
+
38
+ Use the `--force` option to write over an existing `subrepo/<subdir>` branch.
39
+
40
+ The `branch` command accepts the `--all`, `--fetch` and `--force` options.
41
+ ...
42
+ }
43
+
44
+ help:clean() {
45
+ cat <<'...'
46
+
47
+ Usage: git subrepo clean <subdir>|--all|--ALL [-f]
48
+
49
+
50
+ Remove artifacts created by `fetch` and `branch` commands.
51
+
52
+ The `fetch` and `branch` operations (and other commands that call them)
53
+ create temporary things like refs, branches and remotes. This command
54
+ removes all those things.
55
+
56
+ Use `--force` to remove refs. Refs are not removed by default because they
57
+ are sometimes needed between commands.
58
+
59
+ Use `--all` to clean up after all the current subrepos. Sometimes you might
60
+ change to a branch where a subrepo doesn't exist, and then `--all` won't find
61
+ it. Use `--ALL` to remove any artifacts that were ever created by subrepo.
62
+
63
+ To remove ALL subrepo artifacts:
64
+
65
+ git subrepo clean --ALL --force
66
+
67
+ The `clean` command accepts the `--all`, `--ALL`, and `--force` options.
68
+ ...
69
+ }
70
+
71
+ help:clone() {
72
+ cat <<'...'
73
+
74
+ Usage: git subrepo clone <repository> [<subdir>] [-b <branch>] [-f] [-m <msg>] [-e] [--method <merge|rebase>]
75
+
76
+
77
+ Add a repository as a subrepo in a subdir of your repository.
78
+
79
+ This is similar in feel to `git clone`. You just specify the remote repo
80
+ url, and optionally a sub-directory and/or branch name. The repo will be
81
+ fetched and merged into the subdir.
82
+
83
+ The subrepo history is /squashed/ into a single commit that contains the
84
+ reference information. This information is also stored in a special file
85
+ called `<subdir>/.gitrepo`. The presence of this file indicates that the
86
+ directory is a subrepo.
87
+
88
+ All subsequent commands refer to the subrepo by the name of the /subdir/.
89
+ From the subdir, all the current information about the subrepo can be
90
+ obtained.
91
+
92
+ The `--force` option will "reclone" (completely replace) an existing subdir.
93
+
94
+ The `--method` option will decide how the join process between branches are
95
+ performed. The default option is merge.
96
+
97
+ The `clone` command accepts the `--branch=` `--edit`, `--force` and
98
+ `--message=` options.
99
+ ...
100
+ }
101
+
102
+ help:commit() {
103
+ cat <<'...'
104
+
105
+ Usage: git subrepo commit <subdir> [<subrepo-ref>] [-m <msg>] [-e] [-f] [-F]
106
+
107
+
108
+ Add subrepo branch to current history as a single commit.
109
+
110
+ This command is generally used after a hand-merge. You have done a `subrepo
111
+ branch` and merged (rebased) it with the upstream. This command takes the
112
+ HEAD of that branch, puts its content into the subrepo subdir and adds a new
113
+ commit for it to the top of your mainline history.
114
+
115
+ This command requires that the upstream HEAD be in the `subrepo/<subdir>`
116
+ branch history. That way the same branch can push upstream. Use the
117
+ `--force` option to commit anyway.
118
+
119
+ The `commit` command accepts the `--edit`, `--fetch`, `--force` and
120
+ `--message=` options.
121
+ ...
122
+ }
123
+
124
+ help:config() {
125
+ cat <<'...'
126
+
127
+ Usage: git subrepo config <subdir> <option> [<value>] [-f]
128
+
129
+
130
+ Read or update configuration values in the subdir/.gitrepo file.
131
+
132
+ Because most of the values stored in the .gitrepo file are generated you
133
+ will need to use `--force` if you want to change anything else then the
134
+ `method` option.
135
+
136
+ Example to update the `method` option for a subrepo:
137
+
138
+ git subrepo config foo method rebase
139
+ ...
140
+ }
141
+
142
+ help:fetch() {
143
+ cat <<'...'
144
+
145
+ Usage: git subrepo fetch <subdir>|--all [-r <remote>] [-b <branch>]
146
+
147
+
148
+ Fetch the remote/upstream content for a subrepo.
149
+
150
+ It will create a Git reference called `subrepo/<subdir>/fetch` that points at
151
+ the same commit as `FETCH_HEAD`. It will also create a remote called
152
+ `subrepo/<subdir>`. These are temporary and you can easily remove them with
153
+ the subrepo `clean` command.
154
+
155
+ The `fetch` command accepts the `--all`, `--branch=` and `--remote=` options.
156
+ ...
157
+ }
158
+
159
+ help:help() {
160
+ cat <<'...'
161
+
162
+ Usage: git subrepo help [<command>|--all]
163
+
164
+
165
+ Same as `git help subrepo`. Will launch the manpage. For the shorter usage,
166
+ use `git subrepo -h`.
167
+
168
+ Use `git subrepo help <command>` to get help for a specific command. Use
169
+ `--all` to get a summary of all commands.
170
+
171
+ The `help` command accepts the `--all` option.
172
+ ...
173
+ }
174
+
175
+ help:init() {
176
+ cat <<'...'
177
+
178
+ Usage: git subrepo init <subdir> [-r <remote>] [-b <branch>] [--method <merge|rebase>]
179
+
180
+
181
+ Turn an existing subdirectory into a subrepo.
182
+
183
+ If you want to expose a subdirectory of your project as a published subrepo,
184
+ this command will do that. It will split out the content of a normal
185
+ subdirectory into a branch and start tracking it as a subrepo. Afterwards
186
+ your original repo will look exactly the same except that there will be a
187
+ `<subdir>/.gitrepo` file.
188
+
189
+ If you specify the `--remote` (and optionally the `--branch`) option, the
190
+ values will be added to the `<subdir>/.gitrepo` file. The `--remote` option
191
+ is the upstream URL, and the `--branch` option is the upstream branch to push
192
+ to. These values will be needed to do a `git subrepo push` command, but they
193
+ can be provided later on the `push` command (and saved to `<subdir>/.gitrepo`
194
+ if you also specify the `--update` option).
195
+
196
+ Note: You will need to create the empty upstream repo and push to it on your
197
+ own, using `git subrepo push <subdir>`.
198
+
199
+ The `--method` option will decide how the join process between branches
200
+ are performed. The default option is merge.
201
+
202
+ The `init` command accepts the `--branch=` and `--remote=` options.
203
+ ...
204
+ }
205
+
206
+ help:pull() {
207
+ cat <<'...'
208
+
209
+ Usage: git subrepo pull <subdir>|--all [-M|-R|-f] [-m <msg>] [-e] [-b <branch>] [-r <remote>] [-u]
210
+
211
+
212
+ Update the subrepo subdir with the latest upstream changes.
213
+
214
+ The `pull` command fetches the latest content from the remote branch pointed
215
+ to by the subrepo's `.gitrepo` file, and then tries to merge the changes into
216
+ the corresponding subdir. It does this by making a branch of the local
217
+ commits to the subdir and then merging or rebasing (see below) it with the
218
+ fetched upstream content. After the merge, the content of the new branch
219
+ replaces your subdir, the `.gitrepo` file is updated and a single 'pull'
220
+ commit is added to your mainline history.
221
+
222
+ The `pull` command will attempt to do the following commands in one go:
223
+
224
+ git subrepo fetch <subdir>
225
+ git subrepo branch <subdir>
226
+ git merge/rebase subrepo/<subdir>/fetch subrepo/<subdir>
227
+ git subrepo commit <subdir>
228
+ # Only needed for a consequential push:
229
+ git update-ref refs/subrepo/<subdir>/pull subrepo/<subdir>
230
+
231
+ In other words, you could do all the above commands yourself, for the same
232
+ effect. If any of the commands fail, subrepo will stop and tell you to finish
233
+ this by hand. Generally a failure would be in the merge or rebase part, where
234
+ conflicts can happen. Since Git has lots of ways to resolve conflicts to your
235
+ personal tastes, the subrepo command defers to letting you do this by hand.
236
+
237
+ When pulling new data, the method selected in clone/init is used. This has
238
+ no effect on the final result of the pull, since it becomes a single commit.
239
+ But it does affect the resulting `subrepo/<subdir>` branch, which is often
240
+ used for a subrepo `push` command. See 'push' below for more information.
241
+ If you want to change the method you can use the `config` command for this.
242
+
243
+ When you pull you can assume a fast-forward strategy (default) or you can
244
+ specify a `--rebase`, `--merge` or `--force` strategy. The latter is the same
245
+ as a `clone --force` operation, using the current remote and branch.
246
+
247
+ Like the `clone` command, `pull` will squash all the changes (since the last
248
+ pull or clone) into one commit. This keeps your mainline history nice and
249
+ clean. You can easily see the subrepo's history with the `git log` command:
250
+
251
+ git log refs/subrepo/<subdir>/fetch
252
+
253
+ The set of commands used above are described in detail below.
254
+
255
+ The `pull` command accepts the `--all`, `--branch=`, `--edit`, `--force`,
256
+ `--message=`, `--remote=` and `--update` options.
257
+ ...
258
+ }
259
+
260
+ help:push() {
261
+ cat <<'...'
262
+
263
+ Usage: git subrepo push <subdir>|--all [<branch>] [-r <remote>] [-b <branch>] [-M|-R] [-u] [-f] [-s] [-N]
264
+
265
+
266
+ Push a properly merged subrepo branch back upstream.
267
+
268
+ This command takes the subrepo branch from a successful pull command and
269
+ pushes the history back to its designated remote and branch. You can also use
270
+ the `branch` command and merge things yourself before pushing if you want to
271
+ (although that is probably a rare use case).
272
+
273
+ The `push` command requires a branch that has been properly merged/rebased
274
+ with the upstream HEAD (unless the upstream HEAD is empty, which is common
275
+ when doing a first `push` after an `init`). That means the upstream HEAD is
276
+ one of the commits in the branch.
277
+
278
+ By default the branch ref `refs/subrepo/<subdir>/pull` will be pushed, but
279
+ you can specify a (properly merged) branch to push.
280
+
281
+ After that, the `push` command just checks that the branch contains the
282
+ upstream HEAD and then pushes it upstream.
283
+
284
+ The `--force` option will do a force push. Force pushes are typically
285
+ discouraged. Only use this option if you fully understand it. (The `--force`
286
+ option will NOT check for a proper merge. ANY branch will be force pushed!)
287
+
288
+ The `push` command accepts the `--all`, `--branch=`, `--dry-run`, `--force`,
289
+ `--merge`, `--rebase`, `--remote=`, `--squash` and `--update` options.
290
+ ...
291
+ }
292
+
293
+ help:status() {
294
+ cat <<'...'
295
+
296
+ Usage: git subrepo status [<subdir>|--all|--ALL] [-F] [-q|-v]
297
+
298
+
299
+ Get the status of a subrepo. Uses the `--all` option by default. If the
300
+ `--quiet` flag is used, just print the subrepo names, one per line.
301
+
302
+ The `--verbose` option will show all the recent local and upstream commits.
303
+
304
+ Use `--ALL` to show the subrepos of the subrepos (ie the "subsubrepos"), if
305
+ any.
306
+
307
+ The `status` command accepts the `--all`, `--ALL`, `--fetch`, `--quiet` and
308
+ `--verbose` options.
309
+ ...
310
+ }
311
+
312
+ help:upgrade() {
313
+ cat <<'...'
314
+
315
+ Usage: git subrepo upgrade
316
+
317
+
318
+ Upgrade the `git-subrepo` software itself. This simply does a `git pull` on
319
+ the git repository that the code is running from. It only works if you are on
320
+ the `master` branch. It won't work if you installed `git-subrepo` using `make
321
+ install`; in that case you'll need to `make install` from the latest code.
322
+ ...
323
+ }
324
+
325
+ help:version() {
326
+ cat <<'...'
327
+
328
+ Usage: git subrepo version [-q|-v]
329
+
330
+
331
+ This command will display version information about git-subrepo and its
332
+ environment. For just the version number, use `git subrepo --version`. Use
333
+ `--verbose` for more version info, and `--quiet` for less.
334
+
335
+ The `version` command accepts the `--quiet` and `--verbose` options.
336
+ ...
337
+ }
338
+
339
+ # vim: set sw=2 lisp:
@@ -0,0 +1,743 @@
1
+ .\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
2
+ .\"
3
+ .\" Standard preamble:
4
+ .\" ========================================================================
5
+ .de Sp \" Vertical space (when we can't use .PP)
6
+ .if t .sp .5v
7
+ .if n .sp
8
+ ..
9
+ .de Vb \" Begin verbatim text
10
+ .ft CW
11
+ .nf
12
+ .ne \\$1
13
+ ..
14
+ .de Ve \" End verbatim text
15
+ .ft R
16
+ .fi
17
+ ..
18
+ .\" Set up some character translations and predefined strings. \*(-- will
19
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20
+ .\" double quote, and \*(R" will give a right double quote. \*(C+ will
21
+ .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22
+ .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23
+ .\" nothing in troff, for use with C<>.
24
+ .tr \(*W-
25
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26
+ .ie n \{\
27
+ . ds -- \(*W-
28
+ . ds PI pi
29
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
31
+ . ds L" ""
32
+ . ds R" ""
33
+ . ds C` ""
34
+ . ds C' ""
35
+ 'br\}
36
+ .el\{\
37
+ . ds -- \|\(em\|
38
+ . ds PI \(*p
39
+ . ds L" ``
40
+ . ds R" ''
41
+ . ds C`
42
+ . ds C'
43
+ 'br\}
44
+ .\"
45
+ .\" Escape single quotes in literal strings from groff's Unicode transform.
46
+ .ie \n(.g .ds Aq \(aq
47
+ .el .ds Aq '
48
+ .\"
49
+ .\" If the F register is >0, we'll generate index entries on stderr for
50
+ .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51
+ .\" entries marked with X<> in POD. Of course, you'll have to process the
52
+ .\" output yourself in some meaningful fashion.
53
+ .\"
54
+ .\" Avoid warning from groff about undefined register 'F'.
55
+ .de IX
56
+ ..
57
+ .nr rF 0
58
+ .if \n(.g .if rF .nr rF 1
59
+ .if (\n(rF:(\n(.g==0)) \{\
60
+ . if \nF \{\
61
+ . de IX
62
+ . tm Index:\\$1\t\\n%\t"\\$2"
63
+ ..
64
+ . if !\nF==2 \{\
65
+ . nr % 0
66
+ . nr F 2
67
+ . \}
68
+ . \}
69
+ .\}
70
+ .rr rF
71
+ .\" ========================================================================
72
+ .\"
73
+ .IX Title "STDIN 1"
74
+ .TH STDIN 1 "January 2020" "Generated by Swim v0.1.48" "Git Submodule Alternative"
75
+ .\" For nroff, turn off justification. Always turn off hyphenation; it makes
76
+ .\" way too many mistakes in technical documents.
77
+ .if n .ad l
78
+ .nh
79
+ .SH "Name"
80
+ .IX Header "Name"
81
+ git-subrepo \- Git Submodule Alternative
82
+ .SH "Synopsis"
83
+ .IX Header "Synopsis"
84
+ .Vb 1
85
+ \& git subrepo \-h # Help Overview
86
+ \&
87
+ \& git subrepo clone <remote\-url> [<subdir>]
88
+ \& git subrepo init <subdir>
89
+ \& git subrepo pull <subdir>
90
+ \& git subrepo push <subdir>
91
+ \&
92
+ \& git subrepo fetch <subdir>
93
+ \& git subrepo branch <subdir>
94
+ \& git subrepo commit <subdir>
95
+ \& git subrepo config <subdir>
96
+ \&
97
+ \& git subrepo status [<subdir>]
98
+ \& git subrepo clean <subdir>
99
+ \&
100
+ \& git subrepo help [<command> | \-\-all]
101
+ \& git subrepo version
102
+ \& git subrepo upgrade
103
+ .Ve
104
+ .SH "Description"
105
+ .IX Header "Description"
106
+ This git command \*(L"clones\*(R" an external git repo into a subdirectory of your
107
+ repo. Later on, upstream changes can be pulled in, and local changes can be
108
+ pushed back. Simple.
109
+ .SH "Benefits"
110
+ .IX Header "Benefits"
111
+ This command is an improvement from \f(CW\*(C`git\-submodule\*(C'\fR and \f(CW\*(C`git\-subtree\*(C'\fR; two
112
+ other git commands with similar goals, but various problems.
113
+ .PP
114
+ It assumes there are 3 main roles of people interacting with a repo, and
115
+ attempts to serve them all well:
116
+ .IP "\(bu" 4
117
+ \&\fBowner\fR \- The person who authors/owns/maintains a repo.
118
+ .IP "\(bu" 4
119
+ \&\fBusers\fR \- People who are just using/installing the repo.
120
+ .IP "\(bu" 4
121
+ \&\fBcollaborators\fR \- People who commit code to the repo and subrepos.
122
+ .PP
123
+ The \f(CW\*(C`git\-subrepo\*(C'\fR command benefits these roles in the following ways:
124
+ .IP "\(bu" 4
125
+ Simple and intuitive commandline usage (with tab completion).
126
+ .IP "\(bu" 4
127
+ Users get your repo and all your subrepos just by cloning your repo.
128
+ .IP "\(bu" 4
129
+ Users do not need to install \f(CW\*(C`git\-subrepo\*(C'\fR, ever.
130
+ .IP "\(bu" 4
131
+ Collaborators do not need to install unless they want to push/pull.
132
+ .IP "\(bu" 4
133
+ Collaborators know when a subdir is a subrepo (it has a \f(CW\*(C`.gitrepo\*(C'\fR file).
134
+ .IP "\(bu" 4
135
+ The \f(CW\*(C`.gitrepo\*(C'\fR file never gets pushed back to the subrepo upstream.
136
+ .IP "\(bu" 4
137
+ Well named branches and remotes are generated for manual operations.
138
+ .IP "\(bu" 4
139
+ Owners do not deal with the complications of keeping submodules in sync.
140
+ .IP "\(bu" 4
141
+ Subrepo repositories can contain subrepos themselves.
142
+ .IP "\(bu" 4
143
+ Branching with subrepos JustWorks™.
144
+ .IP "\(bu" 4
145
+ Different branches can have different subrepos in different states, etc.
146
+ .IP "\(bu" 4
147
+ Moving/renaming/deleting a subrepo subdir JustWorks™.
148
+ .IP "\(bu" 4
149
+ You can \f(CW\*(C`init\*(C'\fR an existing subdirectory into a subrepo.
150
+ .IP "\(bu" 4
151
+ Your git history is kept squeaky clean.
152
+ .IP "\(bu" 4
153
+ Upstream history (clone/pull) is condensed into a single commit.
154
+ .IP "\(bu" 4
155
+ Pulls can use a \f(CW\*(C`merge\*(C'\fR, \f(CW\*(C`rebase\*(C'\fR or \f(CW\*(C`force\*(C'\fR strategies.
156
+ .IP "\(bu" 4
157
+ You can see the subrepo history with \f(CW\*(C`git log subrepo/<subdir>/fetch\*(C'\fR.
158
+ .IP "\(bu" 4
159
+ Commits pushed back upstream are \fBnot\fR condensed (by default).
160
+ .IP "\(bu" 4
161
+ Trivial to try any subrepo operations and then reset back.
162
+ .IP "\(bu" 4
163
+ No configuration required.
164
+ .IP "\(bu" 4
165
+ Does not introduce history that messes up other git commands.
166
+ .IP "\(bu" 4
167
+ Fixes known rebase failures with \f(CW\*(C`git\-subtree\*(C'\fR.
168
+ .SH "Installation"
169
+ .IX Header "Installation"
170
+ The best short answer is:
171
+ .PP
172
+ .Vb 2
173
+ \& git clone https://github.com/ingydotnet/git\-subrepo /path/to/git\-subrepo
174
+ \& echo \*(Aqsource /path/to/git\-subrepo/.rc\*(Aq >> ~/.bashrc
175
+ .Ve
176
+ .PP
177
+ The complete \*(L"Installation Instructions\*(R" can be found below.
178
+ .PP
179
+ Note: git-subrepo needs a git version (> 2.7) that supports worktree:s.
180
+ .SH "Commands"
181
+ .IX Header "Commands"
182
+ All the \fBsubrepo\fR commands use names of actual Git commands and try to do
183
+ operations that are similar to their Git counterparts. They also attempt to
184
+ give similar output in an attempt to make the subrepo usage intuitive to
185
+ experienced Git users.
186
+ .PP
187
+ Please note that the commands are \fInot\fR exact equivalents, and do not take
188
+ all the same arguments. Keep reading…
189
+ .ie n .IP """git subrepo clone <repository> [<subdir>] [\-b <branch>] [\-f] [\-m <msg>] [\-e] [\-\-method <merge|rebase>]""" 4
190
+ .el .IP "\f(CWgit subrepo clone <repository> [<subdir>] [\-b <branch>] [\-f] [\-m <msg>] [\-e] [\-\-method <merge|rebase>]\fR" 4
191
+ .IX Item "git subrepo clone <repository> [<subdir>] [-b <branch>] [-f] [-m <msg>] [-e] [--method <merge|rebase>]"
192
+ Add a repository as a subrepo in a subdir of your repository.
193
+ .Sp
194
+ This is similar in feel to \f(CW\*(C`git clone\*(C'\fR. You just specify the remote repo url,
195
+ and optionally a sub-directory and/or branch name. The repo will be fetched
196
+ and merged into the subdir.
197
+ .Sp
198
+ The subrepo history is \fIsquashed\fR into a single commit that contains the
199
+ reference information. This information is also stored in a special file
200
+ called \f(CW\*(C`<subdir>/.gitrepo\*(C'\fR. The presence of this file indicates that the
201
+ directory is a subrepo.
202
+ .Sp
203
+ All subsequent commands refer to the subrepo by the name of the
204
+ \&\fIsubdir\fR. From the subdir, all the current information about the subrepo
205
+ can be obtained.
206
+ .Sp
207
+ The \f(CW\*(C`\-\-force\*(C'\fR option will \*(L"reclone\*(R" (completely replace) an existing subdir.
208
+ .Sp
209
+ The \f(CW\*(C`\-\-method\*(C'\fR option will decide how the join process between branches are
210
+ performed. The default option is merge.
211
+ .Sp
212
+ The \f(CW\*(C`clone\*(C'\fR command accepts the \f(CW\*(C`\-\-branch=\*(C'\fR \f(CW\*(C`\-\-edit\*(C'\fR, \f(CW\*(C`\-\-force\*(C'\fR and \f(CW\*(C`\-\-
213
+ message=\*(C'\fR options.
214
+ .ie n .IP """git subrepo init <subdir> [\-r <remote>] [\-b <branch>] [\-\-method <merge|rebase>]""" 4
215
+ .el .IP "\f(CWgit subrepo init <subdir> [\-r <remote>] [\-b <branch>] [\-\-method <merge|rebase>]\fR" 4
216
+ .IX Item "git subrepo init <subdir> [-r <remote>] [-b <branch>] [--method <merge|rebase>]"
217
+ Turn an existing subdirectory into a subrepo.
218
+ .Sp
219
+ If you want to expose a subdirectory of your project as a published subrepo,
220
+ this command will do that. It will split out the content of a normal
221
+ subdirectory into a branch and start tracking it as a subrepo. Afterwards your
222
+ original repo will look exactly the same except that there will be a \f(CW\*(C`<subdir>/.gitrepo\*(C'\fR file.
223
+ .Sp
224
+ If you specify the \f(CW\*(C`\-\-remote\*(C'\fR (and optionally the \f(CW\*(C`\-\-branch\*(C'\fR) option, the
225
+ values will be added to the \f(CW\*(C`<subdir>/.gitrepo\*(C'\fR file. The \f(CW\*(C`\-\-remote\*(C'\fR
226
+ option is the upstream \s-1URL,\s0 and the \f(CW\*(C`\-\-branch\*(C'\fR option is the upstream branch
227
+ to push to. These values will be needed to do a \f(CW\*(C`git subrepo push\*(C'\fR command,
228
+ but they can be provided later on the \f(CW\*(C`push\*(C'\fR command (and saved to \f(CW\*(C`<subdir>/.gitrepo\*(C'\fR if you also specify the \f(CW\*(C`\-\-update\*(C'\fR option).
229
+ .Sp
230
+ Note: You will need to create the empty upstream repo and push to it on your
231
+ own, using \f(CW\*(C`git subrepo push <subdir>\*(C'\fR.
232
+ .Sp
233
+ The \f(CW\*(C`\-\-method\*(C'\fR option will decide how the join process between branches are
234
+ performed. The default option is merge.
235
+ .Sp
236
+ The \f(CW\*(C`init\*(C'\fR command accepts the \f(CW\*(C`\-\-branch=\*(C'\fR and \f(CW\*(C`\-\-remote=\*(C'\fR options.
237
+ .ie n .IP """git subrepo pull <subdir>|\-\-all [\-M|\-R|\-f] [\-m <msg>] [\-e] [\-b <branch>] [\-r <remote>] [\-u]""" 4
238
+ .el .IP "\f(CWgit subrepo pull <subdir>|\-\-all [\-M|\-R|\-f] [\-m <msg>] [\-e] [\-b <branch>] [\-r <remote>] [\-u]\fR" 4
239
+ .IX Item "git subrepo pull <subdir>|--all [-M|-R|-f] [-m <msg>] [-e] [-b <branch>] [-r <remote>] [-u]"
240
+ Update the subrepo subdir with the latest upstream changes.
241
+ .Sp
242
+ The \f(CW\*(C`pull\*(C'\fR command fetches the latest content from the remote branch pointed
243
+ to by the subrepo's \f(CW\*(C`.gitrepo\*(C'\fR file, and then tries to merge the changes into
244
+ the corresponding subdir. It does this by making a branch of the local commits
245
+ to the subdir and then merging or rebasing (see below) it with the fetched
246
+ upstream content. After the merge, the content of the new branch replaces your
247
+ subdir, the \f(CW\*(C`.gitrepo\*(C'\fR file is updated and a single 'pull' commit is added to
248
+ your mainline history.
249
+ .Sp
250
+ The \f(CW\*(C`pull\*(C'\fR command will attempt to do the following commands in one go:
251
+ .Sp
252
+ .Vb 6
253
+ \& git subrepo fetch <subdir>
254
+ \& git subrepo branch <subdir>
255
+ \& git merge/rebase subrepo/<subdir>/fetch subrepo/<subdir>
256
+ \& git subrepo commit <subdir>
257
+ \& # Only needed for a consequential push:
258
+ \& git update\-ref refs/subrepo/<subdir>/pull subrepo/<subdir>
259
+ .Ve
260
+ .Sp
261
+ In other words, you could do all the above commands yourself, for the same
262
+ effect. If any of the commands fail, subrepo will stop and tell you to finish
263
+ this by hand. Generally a failure would be in the merge or rebase part, where
264
+ conflicts can happen. Since Git has lots of ways to resolve conflicts to your
265
+ personal tastes, the subrepo command defers to letting you do this by hand.
266
+ .Sp
267
+ When pulling new data, the method selected in clone/init is used. This has no
268
+ effect on the final result of the pull, since it becomes a single commit. But
269
+ it does affect the resulting \f(CW\*(C`subrepo/<subdir>\*(C'\fR branch, which is often
270
+ used for a subrepo \f(CW\*(C`push\*(C'\fR command. See 'push' below for more information. If
271
+ you want to change the method you can use the \f(CW\*(C`config\*(C'\fR command for this.
272
+ .Sp
273
+ When you pull you can assume a fast-forward strategy (default) or you can
274
+ specify a \f(CW\*(C`\-\-rebase\*(C'\fR, \f(CW\*(C`\-\-merge\*(C'\fR or \f(CW\*(C`\-\-force\*(C'\fR strategy. The latter is the
275
+ same as a \f(CW\*(C`clone \-\-force\*(C'\fR operation, using the current remote and branch.
276
+ .Sp
277
+ Like the \f(CW\*(C`clone\*(C'\fR command, \f(CW\*(C`pull\*(C'\fR will squash all the changes (since the last
278
+ pull or clone) into one commit. This keeps your mainline history nice and
279
+ clean. You can easily see the subrepo's history with the \f(CW\*(C`git log\*(C'\fR command:
280
+ .Sp
281
+ .Vb 1
282
+ \& git log refs/subrepo/<subdir>/fetch
283
+ .Ve
284
+ .Sp
285
+ The set of commands used above are described in detail below.
286
+ .Sp
287
+ The \f(CW\*(C`pull\*(C'\fR command accepts the \f(CW\*(C`\-\-all\*(C'\fR, \f(CW\*(C`\-\-branch=\*(C'\fR, \f(CW\*(C`\-\-edit\*(C'\fR, \f(CW\*(C`\-\-force\*(C'\fR,
288
+ \&\f(CW\*(C`\-\-message=\*(C'\fR, \f(CW\*(C`\-\-remote=\*(C'\fR and \f(CW\*(C`\-\-update\*(C'\fR options.
289
+ .ie n .IP """git subrepo push <subdir>|\-\-all [<branch>] [\-r <remote>] [\-b <branch>] [\-M|\-R] [\-u] [\-f] [\-s] [\-N]""" 4
290
+ .el .IP "\f(CWgit subrepo push <subdir>|\-\-all [<branch>] [\-r <remote>] [\-b <branch>] [\-M|\-R] [\-u] [\-f] [\-s] [\-N]\fR" 4
291
+ .IX Item "git subrepo push <subdir>|--all [<branch>] [-r <remote>] [-b <branch>] [-M|-R] [-u] [-f] [-s] [-N]"
292
+ Push a properly merged subrepo branch back upstream.
293
+ .Sp
294
+ This command takes the subrepo branch from a successful pull command and
295
+ pushes the history back to its designated remote and branch. You can also use
296
+ the \f(CW\*(C`branch\*(C'\fR command and merge things yourself before pushing if you want to
297
+ (although that is probably a rare use case).
298
+ .Sp
299
+ The \f(CW\*(C`push\*(C'\fR command requires a branch that has been properly merged/rebased
300
+ with the upstream \s-1HEAD\s0 (unless the upstream \s-1HEAD\s0 is empty, which is common
301
+ when doing a first \f(CW\*(C`push\*(C'\fR after an \f(CW\*(C`init\*(C'\fR). That means the upstream \s-1HEAD\s0 is
302
+ one of the commits in the branch.
303
+ .Sp
304
+ By default the branch ref \f(CW\*(C`refs/subrepo/<subdir>/pull\*(C'\fR will be pushed,
305
+ but you can specify a (properly merged) branch to push.
306
+ .Sp
307
+ After that, the \f(CW\*(C`push\*(C'\fR command just checks that the branch contains the
308
+ upstream \s-1HEAD\s0 and then pushes it upstream.
309
+ .Sp
310
+ The \f(CW\*(C`\-\-force\*(C'\fR option will do a force push. Force pushes are typically
311
+ discouraged. Only use this option if you fully understand it. (The \f(CW\*(C`\-\-force\*(C'\fR
312
+ option will \s-1NOT\s0 check for a proper merge. \s-1ANY\s0 branch will be force pushed!)
313
+ .Sp
314
+ The \f(CW\*(C`push\*(C'\fR command accepts the \f(CW\*(C`\-\-all\*(C'\fR, \f(CW\*(C`\-\-branch=\*(C'\fR, \f(CW\*(C`\-\-dry\-run\*(C'\fR, \f(CW\*(C`\-\-
315
+ force\*(C'\fR, \f(CW\*(C`\-\-merge\*(C'\fR, \f(CW\*(C`\-\-rebase\*(C'\fR, \f(CW\*(C`\-\-remote=\*(C'\fR, \f(CW\*(C`\-\-squash\*(C'\fR and \f(CW\*(C`\-\-
316
+ update\*(C'\fR options.
317
+ .ie n .IP """git subrepo fetch <subdir>|\-\-all [\-r <remote>] [\-b <branch>]""" 4
318
+ .el .IP "\f(CWgit subrepo fetch <subdir>|\-\-all [\-r <remote>] [\-b <branch>]\fR" 4
319
+ .IX Item "git subrepo fetch <subdir>|--all [-r <remote>] [-b <branch>]"
320
+ Fetch the remote/upstream content for a subrepo.
321
+ .Sp
322
+ It will create a Git reference called \f(CW\*(C`subrepo/<subdir>/fetch\*(C'\fR that
323
+ points at the same commit as \f(CW\*(C`FETCH_HEAD\*(C'\fR. It will also create a remote
324
+ called \f(CW\*(C`subrepo/<subdir>\*(C'\fR. These are temporary and you can easily remove
325
+ them with the subrepo \f(CW\*(C`clean\*(C'\fR command.
326
+ .Sp
327
+ The \f(CW\*(C`fetch\*(C'\fR command accepts the \f(CW\*(C`\-\-all\*(C'\fR, \f(CW\*(C`\-\-branch=\*(C'\fR and \f(CW\*(C`\-\-
328
+ remote=\*(C'\fR options.
329
+ .ie n .IP """git subrepo branch <subdir>|\-\-all [\-f] [\-F]""" 4
330
+ .el .IP "\f(CWgit subrepo branch <subdir>|\-\-all [\-f] [\-F]\fR" 4
331
+ .IX Item "git subrepo branch <subdir>|--all [-f] [-F]"
332
+ Create a branch with local subrepo commits.
333
+ .Sp
334
+ Scan the history of the mainline for all the commits that affect the \f(CW\*(C`subdir\*(C'\fR
335
+ and create a new branch from them called \f(CW\*(C`subrepo/<subdir>\*(C'\fR.
336
+ .Sp
337
+ This is useful for doing \f(CW\*(C`pull\*(C'\fR and \f(CW\*(C`push\*(C'\fR commands by hand.
338
+ .Sp
339
+ Use the \f(CW\*(C`\-\-force\*(C'\fR option to write over an existing \f(CW\*(C`subrepo/<subdir>\*(C'\fR branch.
340
+ .Sp
341
+ The \f(CW\*(C`branch\*(C'\fR command accepts the \f(CW\*(C`\-\-all\*(C'\fR, \f(CW\*(C`\-\-fetch\*(C'\fR and \f(CW\*(C`\-\-force\*(C'\fR options.
342
+ .ie n .IP """git subrepo commit <subdir> [<subrepo\-ref>] [\-m <msg>] [\-e] [\-f] [\-F]""" 4
343
+ .el .IP "\f(CWgit subrepo commit <subdir> [<subrepo\-ref>] [\-m <msg>] [\-e] [\-f] [\-F]\fR" 4
344
+ .IX Item "git subrepo commit <subdir> [<subrepo-ref>] [-m <msg>] [-e] [-f] [-F]"
345
+ Add subrepo branch to current history as a single commit.
346
+ .Sp
347
+ This command is generally used after a hand-merge. You have done a \f(CW\*(C`subrepo
348
+ branch\*(C'\fR and merged (rebased) it with the upstream. This command takes the \s-1HEAD\s0
349
+ of that branch, puts its content into the subrepo subdir and adds a new commit
350
+ for it to the top of your mainline history.
351
+ .Sp
352
+ This command requires that the upstream \s-1HEAD\s0 be in the \f(CW\*(C`subrepo/<subdir>\*(C'\fR
353
+ branch history. That way the same branch can push upstream. Use the \f(CW\*(C`\-\-force\*(C'\fR
354
+ option to commit anyway.
355
+ .Sp
356
+ The \f(CW\*(C`commit\*(C'\fR command accepts the \f(CW\*(C`\-\-edit\*(C'\fR, \f(CW\*(C`\-\-fetch\*(C'\fR, \f(CW\*(C`\-\-force\*(C'\fR and \f(CW\*(C`\-\-
357
+ message=\*(C'\fR options.
358
+ .ie n .IP """git subrepo status [<subdir>|\-\-all|\-\-ALL] [\-F] [\-q|\-v]""" 4
359
+ .el .IP "\f(CWgit subrepo status [<subdir>|\-\-all|\-\-ALL] [\-F] [\-q|\-v]\fR" 4
360
+ .IX Item "git subrepo status [<subdir>|--all|--ALL] [-F] [-q|-v]"
361
+ Get the status of a subrepo. Uses the \f(CW\*(C`\-\-all\*(C'\fR option by default. If the \f(CW\*(C`\-\-
362
+ quiet\*(C'\fR flag is used, just print the subrepo names, one per line.
363
+ .Sp
364
+ The \f(CW\*(C`\-\-verbose\*(C'\fR option will show all the recent local and upstream commits.
365
+ .Sp
366
+ Use \f(CW\*(C`\-\-ALL\*(C'\fR to show the subrepos of the subrepos (ie the
367
+ \&\*(L"subsubrepos\*(R"), if any.
368
+ .Sp
369
+ The \f(CW\*(C`status\*(C'\fR command accepts the \f(CW\*(C`\-\-all\*(C'\fR, \f(CW\*(C`\-\-ALL\*(C'\fR, \f(CW\*(C`\-\-fetch\*(C'\fR, \f(CW\*(C`\-\-quiet\*(C'\fR
370
+ and \f(CW\*(C`\-\-verbose\*(C'\fR options.
371
+ .ie n .IP """git subrepo clean <subdir>|\-\-all|\-\-ALL [\-f]""" 4
372
+ .el .IP "\f(CWgit subrepo clean <subdir>|\-\-all|\-\-ALL [\-f]\fR" 4
373
+ .IX Item "git subrepo clean <subdir>|--all|--ALL [-f]"
374
+ Remove artifacts created by \f(CW\*(C`fetch\*(C'\fR and \f(CW\*(C`branch\*(C'\fR commands.
375
+ .Sp
376
+ The \f(CW\*(C`fetch\*(C'\fR and \f(CW\*(C`branch\*(C'\fR operations (and other commands that call them)
377
+ create temporary things like refs, branches and remotes. This command removes
378
+ all those things.
379
+ .Sp
380
+ Use \f(CW\*(C`\-\-force\*(C'\fR to remove refs. Refs are not removed by default because they
381
+ are sometimes needed between commands.
382
+ .Sp
383
+ Use \f(CW\*(C`\-\-all\*(C'\fR to clean up after all the current subrepos. Sometimes you might
384
+ change to a branch where a subrepo doesn't exist, and then \f(CW\*(C`\-\-all\*(C'\fR won't find
385
+ it. Use \f(CW\*(C`\-\-ALL\*(C'\fR to remove any artifacts that were ever created by subrepo.
386
+ .Sp
387
+ To remove \s-1ALL\s0 subrepo artifacts:
388
+ .Sp
389
+ .Vb 1
390
+ \& git subrepo clean \-\-ALL \-\-force
391
+ .Ve
392
+ .Sp
393
+ The \f(CW\*(C`clean\*(C'\fR command accepts the \f(CW\*(C`\-\-all\*(C'\fR, \f(CW\*(C`\-\-ALL\*(C'\fR, and \f(CW\*(C`\-\-force\*(C'\fR options.
394
+ .ie n .IP """git subrepo config <subdir> <option> [<value>] [\-f]""" 4
395
+ .el .IP "\f(CWgit subrepo config <subdir> <option> [<value>] [\-f]\fR" 4
396
+ .IX Item "git subrepo config <subdir> <option> [<value>] [-f]"
397
+ Read or update configuration values in the subdir/.gitrepo file.
398
+ .Sp
399
+ Because most of the values stored in the .gitrepo file are generated you
400
+ will need to use \f(CW\*(C`\-\-force\*(C'\fR if you want to change anything else then the
401
+ \&\f(CW\*(C`method\*(C'\fR option.
402
+ .Sp
403
+ Example to update the \f(CW\*(C`method\*(C'\fR option for a subrepo:
404
+ .Sp
405
+ .Vb 1
406
+ \& git subrepo config foo method rebase
407
+ .Ve
408
+ .ie n .IP """git subrepo help [<command>|\-\-all]""" 4
409
+ .el .IP "\f(CWgit subrepo help [<command>|\-\-all]\fR" 4
410
+ .IX Item "git subrepo help [<command>|--all]"
411
+ Same as \f(CW\*(C`git help subrepo\*(C'\fR. Will launch the manpage. For the shorter usage,
412
+ use \f(CW\*(C`git subrepo \-h\*(C'\fR.
413
+ .Sp
414
+ Use \f(CW\*(C`git subrepo help <command>\*(C'\fR to get help for a specific command. Use
415
+ \&\f(CW\*(C`\-\-all\*(C'\fR to get a summary of all commands.
416
+ .Sp
417
+ The \f(CW\*(C`help\*(C'\fR command accepts the \f(CW\*(C`\-\-all\*(C'\fR option.
418
+ .ie n .IP """git subrepo version [\-q|\-v]""" 4
419
+ .el .IP "\f(CWgit subrepo version [\-q|\-v]\fR" 4
420
+ .IX Item "git subrepo version [-q|-v]"
421
+ This command will display version information about git-subrepo and its
422
+ environment. For just the version number, use \f(CW\*(C`git subrepo \-\-version\*(C'\fR. Use
423
+ \&\f(CW\*(C`\-\-verbose\*(C'\fR for more version info, and \f(CW\*(C`\-\-quiet\*(C'\fR for less.
424
+ .Sp
425
+ The \f(CW\*(C`version\*(C'\fR command accepts the \f(CW\*(C`\-\-quiet\*(C'\fR and \f(CW\*(C`\-\-verbose\*(C'\fR options.
426
+ .ie n .IP """git subrepo upgrade""" 4
427
+ .el .IP "\f(CWgit subrepo upgrade\fR" 4
428
+ .IX Item "git subrepo upgrade"
429
+ Upgrade the \f(CW\*(C`git\-subrepo\*(C'\fR software itself. This simply does a \f(CW\*(C`git pull\*(C'\fR
430
+ on the git repository that the code is running from. It only works if you
431
+ are on the \f(CW\*(C`master\*(C'\fR branch. It won't work if you installed \f(CW\*(C`git\-subrepo\*(C'\fR
432
+ using \f(CW\*(C`make install\*(C'\fR; in that case you'll need to \f(CW\*(C`make install\*(C'\fR from the
433
+ latest code.
434
+ .SH "Command Options"
435
+ .IX Header "Command Options"
436
+ .ie n .IP """\-h""" 4
437
+ .el .IP "\f(CW\-h\fR" 4
438
+ .IX Item "-h"
439
+ Show a brief view of the commands and options.
440
+ .ie n .IP """\-\-help""" 4
441
+ .el .IP "\f(CW\-\-help\fR" 4
442
+ .IX Item "--help"
443
+ Gives an overview of the help options available for the subrepo command.
444
+ .ie n .IP """\-\-version""" 4
445
+ .el .IP "\f(CW\-\-version\fR" 4
446
+ .IX Item "--version"
447
+ Print the git-subrepo version. Just the version number. Try the \f(CW\*(C`version\*(C'\fR
448
+ command for more version info.
449
+ .ie n .IP """\-\-all"" (""\-a"")" 4
450
+ .el .IP "\f(CW\-\-all\fR (\f(CW\-a\fR)" 4
451
+ .IX Item "--all (-a)"
452
+ If you have multiple subrepos, issue the command to all of them (if
453
+ applicable).
454
+ .ie n .IP """\-\-ALL"" (""\-A"")" 4
455
+ .el .IP "\f(CW\-\-ALL\fR (\f(CW\-A\fR)" 4
456
+ .IX Item "--ALL (-A)"
457
+ If you have subrepos that also have subrepos themselves, issue the command to
458
+ \&\s-1ALL\s0 of them. Note that the \f(CW\*(C`\-\-ALL\*(C'\fR option only works for a subset of the
459
+ commands that \f(CW\*(C`\-\-all\*(C'\fR works for.
460
+ .ie n .IP """\-\-branch=<branch\-name>"" (""\-b <branch\-name>"")" 4
461
+ .el .IP "\f(CW\-\-branch=<branch\-name>\fR (\f(CW\-b <branch\-name>\fR)" 4
462
+ .IX Item "--branch=<branch-name> (-b <branch-name>)"
463
+ Use a different upstream branch-name than the remote \s-1HEAD\s0 or the one saved in
464
+ \&\f(CW\*(C`.gitrepo\*(C'\fR locally.
465
+ .ie n .IP """\-\-dry\-run"" (""\-N"")" 4
466
+ .el .IP "\f(CW\-\-dry\-run\fR (\f(CW\-N\fR)" 4
467
+ .IX Item "--dry-run (-N)"
468
+ For the push command, do everything up until the push and then print out the
469
+ actual \f(CW\*(C`git push\*(C'\fR command needed to finish the operation.
470
+ .ie n .IP """\-\-edit"" (""\-e"")" 4
471
+ .el .IP "\f(CW\-\-edit\fR (\f(CW\-e\fR)" 4
472
+ .IX Item "--edit (-e)"
473
+ Edit the commit message before committing.
474
+ .ie n .IP """\-\-fetch"" (""\-F"")" 4
475
+ .el .IP "\f(CW\-\-fetch\fR (\f(CW\-F\fR)" 4
476
+ .IX Item "--fetch (-F)"
477
+ Use this option to fetch the upstream commits, before running the command.
478
+ .ie n .IP """\-\-force"" (""\-f"")" 4
479
+ .el .IP "\f(CW\-\-force\fR (\f(CW\-f\fR)" 4
480
+ .IX Item "--force (-f)"
481
+ Use this option to force certain commands that fail in the general case.
482
+ .Sp
483
+ \&\s-1NOTE:\s0 The \f(CW\*(C`\-\-force\*(C'\fR option means different things for different commands.
484
+ Read the command specific doc for the exact meaning.
485
+ .ie n .IP """\-\-merge"" (""\-M"")" 4
486
+ .el .IP "\f(CW\-\-merge\fR (\f(CW\-M\fR)" 4
487
+ .IX Item "--merge (-M)"
488
+ Use a \f(CW\*(C`merge\*(C'\fR strategy to include upstream subrepo commits on a pull (or
489
+ setup for push).
490
+ .ie n .IP """\-\-message=<message>"" (""\-m <message>"")" 4
491
+ .el .IP "\f(CW\-\-message=<message>\fR (\f(CW\-m <message>\fR)" 4
492
+ .IX Item "--message=<message> (-m <message>)"
493
+ Specify your own commit message on the command line.
494
+ .ie n .IP """\-\-rebase"" (""\-R"")" 4
495
+ .el .IP "\f(CW\-\-rebase\fR (\f(CW\-R\fR)" 4
496
+ .IX Item "--rebase (-R)"
497
+ Use a \f(CW\*(C`rebase\*(C'\fR strategy to include upstream subrepo commits on a pull (or
498
+ setup for push).
499
+ .ie n .IP """\-\-remote=<remote\-url>"" (""\-r <remote\-url>"")" 4
500
+ .el .IP "\f(CW\-\-remote=<remote\-url>\fR (\f(CW\-r <remote\-url>\fR)" 4
501
+ .IX Item "--remote=<remote-url> (-r <remote-url>)"
502
+ Use a different remote-url than the one saved in \f(CW\*(C`.gitrepo\*(C'\fR locally.
503
+ .ie n .IP """\-\-squash"" (""\-s"")" 4
504
+ .el .IP "\f(CW\-\-squash\fR (\f(CW\-s\fR)" 4
505
+ .IX Item "--squash (-s)"
506
+ Squash all commits on a push into one new commit.
507
+ .ie n .IP """\-\-update"" (""\-u"")" 4
508
+ .el .IP "\f(CW\-\-update\fR (\f(CW\-u\fR)" 4
509
+ .IX Item "--update (-u)"
510
+ If \f(CW\*(C`\-\-branch\*(C'\fR or \f(CW\*(C`\-\-remote\*(C'\fR are used, and the command updates the
511
+ \&\f(CW\*(C`.gitrepo\*(C'\fR file, include these values to the update.
512
+ .SH "Output Options"
513
+ .IX Header "Output Options"
514
+ .ie n .IP """\-\-quiet"" (""\-q"")" 4
515
+ .el .IP "\f(CW\-\-quiet\fR (\f(CW\-q\fR)" 4
516
+ .IX Item "--quiet (-q)"
517
+ Print as little info as possible. Applicable to most commands.
518
+ .ie n .IP """\-\-verbose"" (""\-v"")" 4
519
+ .el .IP "\f(CW\-\-verbose\fR (\f(CW\-v\fR)" 4
520
+ .IX Item "--verbose (-v)"
521
+ Print more information about the command execution and results. Applicable to
522
+ most commands.
523
+ .ie n .IP """\-\-debug"" (""\-d"")" 4
524
+ .el .IP "\f(CW\-\-debug\fR (\f(CW\-d\fR)" 4
525
+ .IX Item "--debug (-d)"
526
+ Show the actual git (and other) commands being executed under the hood.
527
+ Applicable to most commands.
528
+ .ie n .IP """\-\-DEBUG"" (""\-x"")" 4
529
+ .el .IP "\f(CW\-\-DEBUG\fR (\f(CW\-x\fR)" 4
530
+ .IX Item "--DEBUG (-x)"
531
+ Use the Bash \f(CW\*(C`set \-x\*(C'\fR option which prints every command before it is
532
+ run. \s-1VERY\s0 noisy, but extremely useful in deep debugging. Applicable to
533
+ all commands.
534
+ .SH "Environment Variables"
535
+ .IX Header "Environment Variables"
536
+ The \f(CW\*(C`git\-subrepo\*(C'\fR command exports and honors some environment variables:
537
+ .ie n .IP """GIT_SUBREPO_ROOT""" 4
538
+ .el .IP "\f(CWGIT_SUBREPO_ROOT\fR" 4
539
+ .IX Item "GIT_SUBREPO_ROOT"
540
+ This is set by the \f(CW\*(C`.rc\*(C'\fR file, if you use that method to install / enable \f(CW\*(C`git\-
541
+ subrepo\*(C'\fR. It contains the path of the \f(CW\*(C`git\-subrepo\*(C'\fR repository.
542
+ .ie n .IP """GIT_SUBREPO_RUNNING""" 4
543
+ .el .IP "\f(CWGIT_SUBREPO_RUNNING\fR" 4
544
+ .IX Item "GIT_SUBREPO_RUNNING"
545
+ This variable is exported when \f(CW\*(C`git\-subrepo\*(C'\fR is running. It is set to the pid
546
+ of the \f(CW\*(C`git\-subrepo\*(C'\fR process that is running. Other processes, like git hooks
547
+ for instance, can use this information to adjust accordingly.
548
+ .ie n .IP """GIT_SUBREPO_COMMAND""" 4
549
+ .el .IP "\f(CWGIT_SUBREPO_COMMAND\fR" 4
550
+ .IX Item "GIT_SUBREPO_COMMAND"
551
+ This variable is exported when \f(CW\*(C`git\-subrepo\*(C'\fR is running. It is set to the
552
+ name of the \f(CW\*(C`git\-subrepo\*(C'\fR subcommand that is running.
553
+ .ie n .IP """GIT_SUBREPO_PAGER""" 4
554
+ .el .IP "\f(CWGIT_SUBREPO_PAGER\fR" 4
555
+ .IX Item "GIT_SUBREPO_PAGER"
556
+ Use this to specify the pager to use for long output commands. Defaults to
557
+ \&\f(CW$PAGER\fR or \f(CW\*(C`less\*(C'\fR.
558
+ .ie n .IP """GIT_SUBREPO_QUIET""" 4
559
+ .el .IP "\f(CWGIT_SUBREPO_QUIET\fR" 4
560
+ .IX Item "GIT_SUBREPO_QUIET"
561
+ Set this for quiet (\f(CW\*(C`\-q\*(C'\fR) output.
562
+ .ie n .IP """GIT_SUBREPO_VERBOSE""" 4
563
+ .el .IP "\f(CWGIT_SUBREPO_VERBOSE\fR" 4
564
+ .IX Item "GIT_SUBREPO_VERBOSE"
565
+ Set this for verbose (\f(CW\*(C`\-v\*(C'\fR) output.
566
+ .ie n .IP """GIT_SUBREPO_DEBUG""" 4
567
+ .el .IP "\f(CWGIT_SUBREPO_DEBUG\fR" 4
568
+ .IX Item "GIT_SUBREPO_DEBUG"
569
+ Set this for debugging (\f(CW\*(C`\-d\*(C'\fR) output.
570
+ .SH "Installation Instructions"
571
+ .IX Header "Installation Instructions"
572
+ There are currently 3 ways to install \f(CW\*(C`git\-subrepo\*(C'\fR. For all of them you need
573
+ to get the source code from GitHub:
574
+ .PP
575
+ .Vb 1
576
+ \& git clone https://github.com/ingydotnet/git\-subrepo /path/to/git\-subrepo
577
+ .Ve
578
+ .PP
579
+ The first installation method is preferred: \f(CW\*(C`source\*(C'\fR the \f(CW\*(C`.rc\*(C'\fR file. Just
580
+ add a line like this one to your shell startup script:
581
+ .PP
582
+ .Vb 1
583
+ \& source /path/to/git\-subrepo/.rc
584
+ .Ve
585
+ .PP
586
+ That will modify your \f(CW\*(C`PATH\*(C'\fR and \f(CW\*(C`MANPATH\*(C'\fR, and also enable command
587
+ completion.
588
+ .PP
589
+ The second method is to do these things by hand. This might afford you more
590
+ control of your shell environment. Simply add the \f(CW\*(C`lib\*(C'\fR and \f(CW\*(C`man\*(C'\fR
591
+ directories to your \f(CW\*(C`PATH\*(C'\fR and \f(CW\*(C`MANPATH\*(C'\fR:
592
+ .PP
593
+ .Vb 3
594
+ \& export GIT_SUBREPO_ROOT="/path/to/git\-subrepo"
595
+ \& export PATH="/path/to/git\-subrepo/lib:$PATH"
596
+ \& export MANPATH="/path/to/git\-subrepo/man:$MANPATH"
597
+ .Ve
598
+ .PP
599
+ See below for info on how to turn on Command Completion.
600
+ .PP
601
+ The third method is a standard system install, which puts \f(CW\*(C`git\-subrepo\*(C'\fR next
602
+ to your other git commands:
603
+ .PP
604
+ .Vb 1
605
+ \& make install # Possibly with \*(Aqsudo\*(Aq
606
+ .Ve
607
+ .PP
608
+ This method does not account for upgrading and command completion yet.
609
+ .SS "Windows"
610
+ .IX Subsection "Windows"
611
+ This command is known to work in these Windows environments:
612
+ .IP "\(bu" 4
613
+ Git for Windows \*(-- <https://git\-for\-windows.github.io/>
614
+ .IP "\(bu" 4
615
+ Babun \*(-- <http://babun.github.io/>
616
+ .IP "\(bu" 4
617
+ Cygwin \*(-- <https://www.cygwin.com/>
618
+ .PP
619
+ Let us know if there are others that it works (or doesn't work) in.
620
+ .SH "Testing"
621
+ .IX Header "Testing"
622
+ The \f(CW\*(C`git\-subrepo\*(C'\fR repository comes with a extensive test suite. You can
623
+ run it with:
624
+ .PP
625
+ .Vb 1
626
+ \& make test
627
+ .Ve
628
+ .PP
629
+ or if you don't have \f(CW\*(C`make\*(C'\fR on your system:
630
+ .PP
631
+ .Vb 1
632
+ \& prove \-v test
633
+ .Ve
634
+ .SH "Upgrading"
635
+ .IX Header "Upgrading"
636
+ If you used the \f(CW\*(C`.rc\*(C'\fR or \f(CW\*(C`PATH\*(C'\fR method of installation, just run this to
637
+ upgrade \f(CW\*(C`git\-subrepo\*(C'\fR:
638
+ .PP
639
+ .Vb 1
640
+ \& git subrepo upgrade
641
+ .Ve
642
+ .PP
643
+ Or (same thing):
644
+ .PP
645
+ .Vb 2
646
+ \& cd /path/to/git\-subrepo
647
+ \& git pull
648
+ .Ve
649
+ .PP
650
+ If you used \f(CW\*(C`make install\*(C'\fR method, then run this again (after \f(CW\*(C`git pull\*(C'\fR):
651
+ .PP
652
+ .Vb 1
653
+ \& make install # Possibly with \*(Aqsudo\*(Aq
654
+ .Ve
655
+ .SH "Command Completion"
656
+ .IX Header "Command Completion"
657
+ The \f(CW\*(C`git subrepo\*(C'\fR command supports \f(CW\*(C`<TAB>\*(C'\fR\-based command completion. If
658
+ you don't use the \f(CW\*(C`.rc\*(C'\fR script (see Installation, above), you'll need to
659
+ enable this manually to use it.
660
+ .SS "In Bash"
661
+ .IX Subsection "In Bash"
662
+ If your Bash setup does not already provide command completion for Git, you'll
663
+ need to enable that first:
664
+ .PP
665
+ .Vb 1
666
+ \& source <Git completion script>
667
+ .Ve
668
+ .PP
669
+ On your system, the Git completion script might be found at any of the
670
+ following locations (or somewhere else that we don't know about):
671
+ .IP "\(bu" 4
672
+ \&\f(CW\*(C`/etc/bash_completion.d/git\*(C'\fR
673
+ .IP "\(bu" 4
674
+ \&\f(CW\*(C`/usr/share/bash\-completion/git\*(C'\fR
675
+ .IP "\(bu" 4
676
+ \&\f(CW\*(C`/usr/share/bash\-completion/completions/git\*(C'\fR
677
+ .IP "\(bu" 4
678
+ \&\f(CW\*(C`/opt/local/share/bash\-completion/completions/git\*(C'\fR
679
+ .IP "\(bu" 4
680
+ \&\f(CW\*(C`/usr/local/etc/bash_completion.d/git\*(C'\fR
681
+ .IP "\(bu" 4
682
+ \&\f(CW\*(C`~/.homebrew/etc/bash_completion.d/git\*(C'\fR
683
+ .PP
684
+ In case you can't find any of these, this repository contains a copy of the
685
+ Git completion script:
686
+ .PP
687
+ .Vb 1
688
+ \& source /path/to/git\-subrepo/share/git\-completion.bash
689
+ .Ve
690
+ .PP
691
+ Once Git completion is enabled (whether you needed to do that manually or
692
+ not), you can turn on \f(CW\*(C`git\-subrepo\*(C'\fR completion with a command like this:
693
+ .PP
694
+ .Vb 1
695
+ \& source /path/to/git\-subrepo/share/completion.bash
696
+ .Ve
697
+ .SS "In zsh"
698
+ .IX Subsection "In zsh"
699
+ In the Z shell (zsh), you can manually enable \f(CW\*(C`git\-subrepo\*(C'\fR completion by
700
+ adding the following line to your \f(CW\*(C`~/.zshrc\*(C'\fR, \fBbefore\fR the \f(CW\*(C`compinit\*(C'\fR
701
+ function is called:
702
+ .PP
703
+ .Vb 1
704
+ \& fpath=(\*(Aq/path/to/git\-subrepo/share/zsh\-completion\*(Aq $fpath)
705
+ .Ve
706
+ .SH "Status"
707
+ .IX Header "Status"
708
+ The git-subrepo command has been in use for well over a year and seems to get
709
+ the job done. Development is still ongoing but mostly just for fixing bugs.
710
+ .PP
711
+ Trying subrepo out is simple and painless (this is not \f(CW\*(C`git submodule\*(C'\fR).
712
+ Nothing is permanent (if you do not push to shared remotes). ie You can always
713
+ play around and reset back to the beginning without pain.
714
+ .PP
715
+ This command has a test suite (run \f(CW\*(C`make test\*(C'\fR), but surely has many bugs. If
716
+ you have expertise with Git and subcommands, please review the code, and file
717
+ issues on anything that seems wrong.
718
+ .PP
719
+ If you want to chat about the \f(CW\*(C`git\-subrepo\*(C'\fR command, join \f(CW\*(C`#gitcommands\*(C'\fR on
720
+ \&\f(CW\*(C`irc.freenode.net\*(C'\fR.
721
+ .SH "Notes"
722
+ .IX Header "Notes"
723
+ .IP "\(bu" 4
724
+ Works on \s-1POSIX\s0 systems: Linux, \s-1BSD, OSX,\s0 etc.
725
+ .IP "\(bu" 4
726
+ Works on various Windows environments. See \*(L"Windows\*(R" section above.
727
+ .IP "\(bu" 4
728
+ The \f(CW\*(C`git\-subrepo\*(C'\fR repo itself has 2 subrepos under the \f(CW\*(C`ext/\*(C'\fR subdirectory.
729
+ .IP "\(bu" 4
730
+ Written in (very modern) Bash, with full test suite. Take a look.
731
+ .IP "\(bu" 4
732
+ A \f(CW\*(C`.gitrepo\*(C'\fR file never is in the top level dir (next to a \f(CW\*(C`.git/\*(C'\fR dir).
733
+ .SH "Authors"
734
+ .IX Header "Authors"
735
+ .IP "\(bu" 4
736
+ Ingy döt Net <ingy@ingy.net>
737
+ .IP "\(bu" 4
738
+ Magnus Carlsson <grimmymail@gmail.com>
739
+ .SH "License and Copyright"
740
+ .IX Header "License and Copyright"
741
+ The \s-1MIT\s0 License (\s-1MIT\s0)
742
+ .PP
743
+ Copyright (c) 2013\-2020 Ingy döt Net