{"thread":{"id":"45739","subject":"[bug?] docs in Documentation/technical/ do not seem to be distributed","startedAt":"2017-04-19T06:05:27Z","lastAt":"2017-04-20T00:44:07Z","messageCount":4,"participants":["Samuel Lijin","Jonathan Nieder","brian m. carlson"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"317191","messageId":"CAJZjrdWNQFkWwAO_hmHMzVGNNMfynxsvbWufGvRWX8bZD19Epw@mail.gmail.com","threadId":"45739","inReplyTo":null,"subject":"[bug?] docs in Documentation/technical/ do not seem to be distributed","fromName":"Samuel Lijin","fromEmail":"sxlijin@gmail.com","sentAt":"2017-04-19T06:04:39Z","receivedAt":"2017-04-19T06:05:27Z","isPatch":false,"sender":{"key":"sxlijin@gmail.com","avatar":"https://gravatar.com/avatar/01777bf1eae64e2b4dca97dcac182a6abbcf6fd8cb4d5b8fa33edf9f8cc21746?d=mp&s=160"},"body":"It's possible this may have nothing to do with the Git project itself\nbecause I have absolutely no idea how this is handled on the packaging\nside or, possibly, if this is actually intended.\n\nThere are a couple of links floating around in the man pages pointing\nto pages in technical/, such as to technical/api-credentials.html in\ngitcredentials(7) [1]. On the website and man pages for Arch Linux and\nUbuntu, this link is broken.\n\nOn the website, nothing in technical/ seems to be linked to at all.\n(If it is, I didn't spend enough time searching.)\n\nOn Arch (git v2.12.2), this link points at\n/usr/share/doc/git-doc/technical/api-credentials.html; however, this\nfile does not exist:\n\n$ ls /usr/share/doc/git-doc\ngit-subtree.html\n\nOn Ubuntu 16.04 LTS (git v2.11.0 from the git-core PPA), this link\npoints at /usr/share/doc/git/html/technical/api-credentials.html;\nhowever, this file does not exist:\n\n$ ls /usr/share/doc/git/\nchangelog.Debian.gz\nchangelog.gz\ncontrib\ncopyright\nNEWS.Debian.gz\nREADME.Debian\nREADME.emacs\nREADME.md\nREADME.source\nRelNotes\n\n[1] https://github.com/git/git/blob/v2.12.2/Documentation/gitcredentials.txt#L184\n"},{"id":"317248","messageId":"20170419170509.GC28740@aiede.svl.corp.google.com","threadId":"45739","inReplyTo":"CAJZjrdWNQFkWwAO_hmHMzVGNNMfynxsvbWufGvRWX8bZD19Epw@mail.gmail.com","subject":"Re: [bug?] docs in Documentation/technical/ do not seem to be distributed","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2017-04-19T17:05:09Z","receivedAt":"2017-04-19T17:05:25Z","isPatch":false,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Hi,\n\nSamuel Lijin wrote:\n\n> It's possible this may have nothing to do with the Git project itself\n> because I have absolutely no idea how this is handled on the packaging\n> side or, possibly, if this is actually intended.\n>\n> There are a couple of links floating around in the man pages pointing\n> to pages in technical/, such as to technical/api-credentials.html in\n> gitcredentials(7) [1]. On the website and man pages for Arch Linux and\n> Ubuntu, this link is broken.\n\nThis sounds like a packaging bug in Arch Linux and Ubuntu.\n\nThat said, at least in Ubuntu, I am not able to reproduce it.  Do\nyou have the git-doc (or git-all, which depends on git-doc) package\ninstalled?\n\nHope that helps,\nJonathan\n"},{"id":"317258","messageId":"CAJZjrdWey6atV0rQUborVH0mnev5j8q3Qsny1dgr9hj8_Hz5uw@mail.gmail.com","threadId":"45739","inReplyTo":"20170419170509.GC28740@aiede.svl.corp.google.com","subject":"Re: [bug?] docs in Documentation/technical/ do not seem to be distributed","fromName":"Samuel Lijin","fromEmail":"sxlijin@gmail.com","sentAt":"2017-04-19T18:03:09Z","receivedAt":"2017-04-19T18:04:01Z","isPatch":false,"sender":{"key":"sxlijin@gmail.com","avatar":"https://gravatar.com/avatar/01777bf1eae64e2b4dca97dcac182a6abbcf6fd8cb4d5b8fa33edf9f8cc21746?d=mp&s=160"},"body":"On Wed, Apr 19, 2017 at 12:05 PM, Jonathan Nieder <jrnieder@gmail.com> wrote:\n> Hi,\n>\n> Samuel Lijin wrote:\n>\n>> It's possible this may have nothing to do with the Git project itself\n>> because I have absolutely no idea how this is handled on the packaging\n>> side or, possibly, if this is actually intended.\n>>\n>> There are a couple of links floating around in the man pages pointing\n>> to pages in technical/, such as to technical/api-credentials.html in\n>> gitcredentials(7) [1]. On the website and man pages for Arch Linux and\n>> Ubuntu, this link is broken.\n>\n> This sounds like a packaging bug in Arch Linux and Ubuntu.\n>\n> That said, at least in Ubuntu, I am not able to reproduce it.  Do\n> you have the git-doc (or git-all, which depends on git-doc) package\n> installed?\n\nThat was the answer on the Ubuntu machine. Doesn't apply to Arch,\nthough, so I guess I'll reach out upstream there. I've also opened\n#994 on the git/git-scm.com repo for this.\n\nOut of curiosity, do you know why it's distributed like that?\n\nThanks,\nSam\n"},{"id":"317303","messageId":"20170420004355.wlojjb4miudun4ur@genre.crustytoothpaste.net","threadId":"45739","inReplyTo":"CAJZjrdWey6atV0rQUborVH0mnev5j8q3Qsny1dgr9hj8_Hz5uw@mail.gmail.com","subject":"Re: [bug?] docs in Documentation/technical/ do not seem to be distributed","fromName":"brian m. carlson","fromEmail":"sandals@crustytoothpaste.net","sentAt":"2017-04-20T00:43:55Z","receivedAt":"2017-04-20T00:44:07Z","isPatch":false,"sender":{"key":"sandals@crustytoothpaste.net","avatar":"https://avatars.githubusercontent.com/u/497054?v=4"},"body":"On Wed, Apr 19, 2017 at 01:03:09PM -0500, Samuel Lijin wrote:\n> On Wed, Apr 19, 2017 at 12:05 PM, Jonathan Nieder <jrnieder@gmail.com> wrote:\n> > This sounds like a packaging bug in Arch Linux and Ubuntu.\n> >\n> > That said, at least in Ubuntu, I am not able to reproduce it.  Do\n> > you have the git-doc (or git-all, which depends on git-doc) package\n> > installed?\n> \n> That was the answer on the Ubuntu machine. Doesn't apply to Arch,\n> though, so I guess I'll reach out upstream there. I've also opened\n> #994 on the git/git-scm.com repo for this.\n> \n> Out of curiosity, do you know why it's distributed like that?\n\nI expect the answer for Ubuntu is that it's the way that Debian does it.\n\nDebian traditionally distributes documentation in a separate package\nbecause it's architecture independent, and the binaries are not.\nTherefore, including it in the main package would bloat the archive\nsubstantially by including a copy of identical data for each\narchitecture.\n\nDoing it this way also allows people to not install documentation that\nthey don't need, say, on a server.\n-- \nbrian m. carlson / brian with sandals: Houston, Texas, US\n+1 832 623 2791 | https://www.crustytoothpaste.net/~bmc | My opinion only\nOpenPGP: https://keybase.io/bk2204\n"}]}