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 

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).

To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to