# git-subtree manpage missing from git-manpages tarballs 3 messages from 2013-12-08 to 2013-12-09. Participants: Stefanus Du Toit, Jonathan Nieder. Thread: https://gitlist.dev/t/35501 ## Stefanus Du Toit, 2013-12-08 16:14 Subject: git-subtree manpage missing from git-manpages tarballs Message-ID: URL: https://gitlist.dev/e/CABGRy0o3AJLMhmVJL8XAjrnQJd%3DyuV%2B1Q%3DcLToetnhmB0V%3DhfA%40mail.gmail.com ``` The git-subtree manpage is currently missing from the git-manpages tarballs at https://code.google.com/p/git-core/. For example, https://code.google.com/p/git-core/downloads/detail?name=git-manpages-1.8.5.1.tar.gz does not include it. A side effect of this is that "git help subtree" fails when using git installed from homebrew, because the homebrew recipe uses those tarballs as its source of documentation. Is it possible to include the manpage starting with an upcoming release, or is there a good reason it's excluded? Thanks, Stefanus ``` ## Jonathan Nieder, 2013-12-08 22:30 Subject: Re: git-subtree manpage missing from git-manpages tarballs Message-ID: <20131208223020.GB9108@google.com> URL: https://gitlist.dev/e/20131208223020.GB9108%40google.com In-Reply-To: ``` Hi, Stefanus Du Toit wrote: > The git-subtree manpage is currently missing from the git-manpages > tarballs at https://code.google.com/p/git-core/. > > For example, https://code.google.com/p/git-core/downloads/detail?name=git-manpages-1.8.5.1.tar.gz > does not include it. > > A side effect of this is that "git help subtree" fails when using git > installed from homebrew, because the homebrew recipe uses those > tarballs as its source of documentation. git-subtree and its documentation are in the contrib/subtree directory. contrib/subtree/Makefile includes rules to build a manpage for it. If the homebrew rules are installing the git-subtree command from there, perhaps they could be tweaked to build the manpage, too. What do you think? Alternatively: I'm not sure what the status of git-subtree maintenance is. Is there someone taking active enough care of it that it would make sense to promote it out of contrib/ to be a full git command installed by default? Thanks, Jonathan ``` ## Stefanus Du Toit, 2013-12-09 00:40 Subject: Re: git-subtree manpage missing from git-manpages tarballs Message-ID: URL: https://gitlist.dev/e/CABGRy0qNqTotQFp%2BGnCNVEY09ymD2yXHb8YMG0KUhpk975ijSA%40mail.gmail.com In-Reply-To: <20131208223020.GB9108@google.com> ``` Hi Jonathan, On Sun, Dec 8, 2013 at 5:30 PM, Jonathan Nieder wrote: > git-subtree and its documentation are in the contrib/subtree > directory. contrib/subtree/Makefile includes rules to build > a manpage for it. Thanks - I guess git-manpages generally doesn't include bits from contrib then. > If the homebrew rules are installing the git-subtree command > from there, perhaps they could be tweaked to build the manpage, > too. What do you think? The homebrew recipe states: # We could build the manpages ourselves, but the build process depends # on many other packages, and is somewhat crazy, this way is easier. So while I'm sure it's possible it sounds like the current process is preferred. > Alternatively: I'm not sure what the status of git-subtree > maintenance is. Is there someone taking active enough care > of it that it would make sense to promote it out of contrib/ > to be a full git command installed by default? This would be most excellent; I'm only starting to use subtrees but after some painful experiences with submodules I really like the subtree model so far. Thanks, Stefanus ```