title: Diagnosing Mac Help keyword indexing?
body: <p>I am having difficulty coaxing the "Help → Search" function of my application to show topics related to the useful (and unique) keywords in my application.  Only one keyword shows up.</p>
  
  <p><strong>Background:</strong> I created several html help pages (examples: <a href="http://www.jimcarson.com/macfizzycalc/index.html" rel="nofollow noreferrer">index</a>, <a href="http://jimcarson.com/macfizzycalc/accuracy.html" rel="nofollow noreferrer">accuracy</a>, <a href="http://jimcarson.com/macfizzycalc/convert.html" rel="nofollow noreferrer">convert</a>) in a subdirectory of my program.  If I invoke the master help, the index.html file shows up fine.  From there, I can click through to any of the other topic pages.  </p>
  
  <p><strong>Problem:</strong> If I try using the keyword search function, only "Accuracy" and a blank indicator (that pulls up the index.html) show up.  I have other keywords like "coordinates" that should point to a specific page, but aren't showing up.  </p>
  
  <p><img src="https://i.stack.imgur.com/3HSWf.png" alt=""></p>
  
  <p><strong>What I've done so far:</strong> In addition to re-skimming the <a href="http://developer.apple.com/library/mac/documentation/Carbon/Conceptual/ProvidingUserAssitAppleHelp/ProvidingUserAssitAppleHelp.pdf" rel="nofollow noreferrer">documentation</a> (which at this time, I am a little bleary-eyed), I have run each page through BBEdit's syntax checker.  I also searched StackOverflow for information related to the problem.  Because the keywords are rather ubiquitous, <a href="https://stackoverflow.com/questions/4426927/what-is-the-help-file-format-for-mac-app">this</a> was the primary topical match, but I'm well-past that.  </p>
  
  <p>The Help Indexer log notes that it's indexed all of the html files, finding KEYWORDS and DESCRIPTION meta tags in each (as recommended by <a href="http://developer.apple.com/library/mac/documentation/Carbon/Conceptual/ProvidingUserAssitAppleHelp/ProvidingUserAssitAppleHelp.pdf" rel="nofollow noreferrer">the Help Book</a>):</p>
  
  <pre><code>droot.html -- File has KEYWORDS meta tag content being indexed.
  gc.html -- File has KEYWORDS meta tag content being indexed.
  index.html -- File has KEYWORDS meta tag content being indexed.
  droot.html -- File has DESCRIPTION meta tag used for abstract.
  gc.html -- File has DESCRIPTION meta tag used for abstract.
  index.html -- Finished parsing
  droot.html -- Finished parsing
  gc.html -- Finished parsing
  (etc)
  </code></pre>
  
  <p>The *.helpindex file in the Release package (<code>?/Contents/Resources/MacFizzyCalcHelp/</code> directory) is ~25k.  I do not know how to inspect its contents, though.</p>
  
  <p><strong>Any thoughts on what I'm missing?</strong></p>