On Sat, 17 May 2014, Jeremiah Mahler wrote: > I agree that a broken document is an unacceptable failure mode. > > But I do not understand why 'source-highlight' is not an install > requirement for 'git-doc'. If I install 'source-highlight' on > my Debian machine the code looks great. > > apt-get install source-highlight Yes; when I noticed this failure, I asked Jonathan to add source-highlight as a build dependency in Debian (https://bugs.debian.org/745591). But then Ubuntu forked the packaging to revert this change (https://bugs.launchpad.net/bugs/1316810), because source-highlight in the community-supported universe repository is not allowed to be a build dependency of git in the Canonical-supported main repository. So now the Ubuntu package still has broken documentation _and_ it’s lost the ability to automatically synchronize updates from Debian. If we’re going to make Git depend on source-highlight, then we would want to make sure it’s documented in INSTALL and that its absence is properly diagnosed. Maybe then we could make the argument to Canonical that source-highlight should become officially supported in main (https://wiki.ubuntu.com/UbuntuMainInclusionRequirements). But I don’t that would be worth it just to make one page of the API documentation a little more colorful (and it sounds like you agree). Anders -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html