[Bug 1316810] Re: git-doc: example source snippet is empty in technical/api-hashmap.html

[Anders Kaseorg]

Owww, I’m guessing it’s because Ubuntu doesn’t want a package in main
(git) build-depending on a package in universe (source-highlight).

Options include
• filing a main inclusion report for source-highlight (https://wiki.ubuntu.com/UbuntuMainInclusionRequirements);
• patching the [source] tags out of Documentation/technical/api-hashmap.txt;
• getting upstream to take that patch, which it probably should, given this failure mode;
• or just living with Ubuntu-forked packaging, and watching the Ubuntu version fall farther and farther behind (please please please not again).

Thinking out loud, this is not the first time I wish Debian had Build-
Recommends.


** Bug watch added: Debian Bug tracker #745591
   http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=745591

** Also affects: git (Debian) via
   http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=745591
   Importance: Unknown
       Status: Unknown

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to git in Ubuntu.
https://bugs.launchpad.net/bugs/1316810

Title:
  git-doc: example source snippet is empty in technical/api-hashmap.html

Status in “git” package in Ubuntu:
  New
Status in “git” package in Debian:
  Unknown

Bug description:
  Anders Kaseorg reports[1]:

  I noticed this warning while building git-doc:

      ASCIIDOC technical/api-hashmap.html
  /bin/sh: 1: source-highlight: not found
  asciidoc: WARNING: api-hashmap.txt: line 218: filter non-zero exit code: source-highlight -f xhtml -s c: returned 127
  asciidoc: WARNING: api-hashmap.txt: line 218: no output from filter: source-highlight -f xhtml -s c

  (Actually, I noticed it because it’s fatal on very old Ubuntu releases, 
  but never mind that.)  The effect is that the example source snippet under 
  ‘Usage example’ in /usr/share/doc/git-doc/technical/api-hashmap.html shows 
  up as empty.  That snippet was added in v2.0.0-rc0~166^2~16.

  This can be resolved by adding source-highlight as a build dependency.

  [1] http://bugs.debian.org/745591

  This was fixed in Debian, but Ubuntu trusty reverted the fix:

   git (1:2.0.0~rc0-2ubuntu1) utopic; urgency=medium

     * debian/control: Drop source-highlight build dependency.

  Unfortunately that changelog entry doesn't say why the fix was
  reverted.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/git/+bug/1316810/+subscriptions