git-subtree manpage missing from git-manpages tarballs

git-subtree manpage missing from git-manpages tarballs

[Stefanus Du Toit]

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

Re: git-subtree manpage missing from git-manpages tarballs

[Jonathan Nieder]

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

Re: git-subtree manpage missing from git-manpages tarballs

[Stefanus Du Toit]

Hi Jonathan,

On Sun, Dec 8, 2013 at 5:30 PM, Jonathan Nieder <jrnieder@gmail.com> 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