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

[Jonathan Nieder]

Public bug reported:

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.

** Affects: git (Ubuntu)
     Importance: Undecided
         Status: New

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

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