{"thread":{"id":"35501","subject":"git-subtree manpage missing from git-manpages tarballs","startedAt":"2013-12-08T16:14:39Z","lastAt":"2013-12-09T00:40:30Z","messageCount":3,"participants":["Stefanus Du Toit","Jonathan Nieder"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"231765","messageId":"CABGRy0o3AJLMhmVJL8XAjrnQJd=yuV+1Q=cLToetnhmB0V=hfA@mail.gmail.com","threadId":"35501","inReplyTo":null,"subject":"git-subtree manpage missing from git-manpages tarballs","fromName":"Stefanus Du Toit","fromEmail":"sjdutoit@gmail.com","sentAt":"2013-12-08T16:14:39Z","receivedAt":"2013-12-08T16:14:39Z","isPatch":false,"sender":{"key":"sjdutoit@gmail.com","avatar":null},"body":"The git-subtree manpage is currently missing from the git-manpages\ntarballs at https://code.google.com/p/git-core/.\n\nFor example, https://code.google.com/p/git-core/downloads/detail?name=git-manpages-1.8.5.1.tar.gz\ndoes not include it.\n\nA side effect of this is that \"git help subtree\" fails when using git\ninstalled from homebrew, because the homebrew recipe uses those\ntarballs as its source of documentation.\n\nIs it possible to include the manpage starting with an upcoming\nrelease, or is there a good reason it's excluded?\n\nThanks,\n\nStefanus\n"},{"id":"231772","messageId":"20131208223020.GB9108@google.com","threadId":"35501","inReplyTo":"CABGRy0o3AJLMhmVJL8XAjrnQJd=yuV+1Q=cLToetnhmB0V=hfA@mail.gmail.com","subject":"Re: git-subtree manpage missing from git-manpages tarballs","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2013-12-08T22:30:21Z","receivedAt":"2013-12-08T22:30:21Z","isPatch":false,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Hi,\n\nStefanus Du Toit wrote:\n\n> The git-subtree manpage is currently missing from the git-manpages\n> tarballs at https://code.google.com/p/git-core/.\n>\n> For example, https://code.google.com/p/git-core/downloads/detail?name=git-manpages-1.8.5.1.tar.gz\n> does not include it.\n>\n> A side effect of this is that \"git help subtree\" fails when using git\n> installed from homebrew, because the homebrew recipe uses those\n> tarballs as its source of documentation.\n\ngit-subtree and its documentation are in the contrib/subtree\ndirectory.  contrib/subtree/Makefile includes rules to build\na manpage for it.\n\nIf the homebrew rules are installing the git-subtree command\nfrom there, perhaps they could be tweaked to build the manpage,\ntoo.  What do you think?\n\nAlternatively: I'm not sure what the status of git-subtree\nmaintenance is.  Is there someone taking active enough care\nof it that it would make sense to promote it out of contrib/\nto be a full git command installed by default?\n\nThanks,\nJonathan\n"},{"id":"231776","messageId":"CABGRy0qNqTotQFp+GnCNVEY09ymD2yXHb8YMG0KUhpk975ijSA@mail.gmail.com","threadId":"35501","inReplyTo":"20131208223020.GB9108@google.com","subject":"Re: git-subtree manpage missing from git-manpages tarballs","fromName":"Stefanus Du Toit","fromEmail":"sjdutoit@gmail.com","sentAt":"2013-12-09T00:40:30Z","receivedAt":"2013-12-09T00:40:30Z","isPatch":false,"sender":{"key":"sjdutoit@gmail.com","avatar":null},"body":"Hi Jonathan,\n\nOn Sun, Dec 8, 2013 at 5:30 PM, Jonathan Nieder <jrnieder@gmail.com> wrote:\n> git-subtree and its documentation are in the contrib/subtree\n> directory.  contrib/subtree/Makefile includes rules to build\n> a manpage for it.\n\nThanks - I guess git-manpages generally doesn't include bits from contrib then.\n\n> If the homebrew rules are installing the git-subtree command\n> from there, perhaps they could be tweaked to build the manpage,\n> too.  What do you think?\n\nThe homebrew recipe states:\n\n    # We could build the manpages ourselves, but the build process depends\n    # on many other packages, and is somewhat crazy, this way is easier.\n\nSo while I'm sure it's possible it sounds like the current process is preferred.\n\n> Alternatively: I'm not sure what the status of git-subtree\n> maintenance is.  Is there someone taking active enough care\n> of it that it would make sense to promote it out of contrib/\n> to be a full git command installed by default?\n\nThis would be most excellent; I'm only starting to use subtrees but\nafter some painful experiences with submodules I really like the\nsubtree model so far.\n\nThanks,\n\nStefanus\n"}]}