git-subtree manpage missing from git-manpages tarballs

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

Hi,

Stefanus Du Toit wrote:

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

Hi Jonathan,

On Sun, Dec 8, 2013 at 5:30 PM, Jonathan Nieder <jrnieder@gmail.com> wrote:

Thanks - I guess git-manpages generally doesn't include bits from contrib then.

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.

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