title: Is there a way to document all the used definitions next the #include <header.h> file they are defined in?
body: <p>How can you list all externally functions/variables/types used within your program next to the header file <code>#include</code> they are defined in?</p>
  <p>I am trying to achieve something like this...</p>
  <pre class="lang-c prettyprint-override"><code>#includes &lt;blah.h&gt; // getBlah, BLAH_CONST, isBlah
  </code></pre>
  <p><strong>Why:</strong>
  I am maintaining some large and old C (and C++) libraries with many dependencies on other libraries. Each file can contain upwards of 50+ <code>#includes</code> and identifying what header file a specific function belongs to is difficult to identify. Also, due to unique circumstances traditional IDE's do not work many with our operating system and/or size of includes path is massive.</p>
  <p><strong>Example:</strong></p>
  <pre class="lang-c prettyprint-override"><code>// Currently 
  #include &lt;teama_dateinfo_accessor.h&gt;
  #include &lt;teamb_calendar_accessor.h&gt;
  
  bool isLeapYear(year: int) {
    struct Year yearInfo = getYearInfo(year); // &lt;- ?? where is this being defined
    return yearInfo.isLeapYear;
  }
  bool isTaxMonth(month: int) {
    struct Month monthInfo = lookUpMonth(month); // &lt;- ?? where is this being defined
    return monthInfor.areTaxesDue;
  }
  </code></pre>
  <pre class="lang-c prettyprint-override"><code>// Trying to Achieve 
  #include &lt;teama_dateinfo_accessor.h&gt; // getYearInfo, Year
  #include &lt;teamb_calendar_accessor.h&gt; // lookUpMonth, Month
  
  bool isLeapYear(year: int) {
    struct Year yearInfo = getYearInfo(year);
    return yearInfo.isLeapYear;
  }
  bool isTaxMonth(month: int) {
    struct Month monthInfo = lookUpMonth(month);
    return monthInfor.areTaxesDue;
  }
  </code></pre>
  <p>Inspired by JavaScript &amp; Python syntax for <code>imports</code>.</p>
  <pre class="lang-js prettyprint-override"><code>import { getYearInfo, Year } from 'teama_dateinfo_accessor';
  </code></pre>
  <pre class="lang-py prettyprint-override"><code>from teamb_calendar_accessor import lookUpMonth, Month
  </code></pre>