<!DOCTYPE html><html><head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  </head>
  <body>
    <p>I think we could do a combination of the two: say that the value
      of the -I options is forwarded to clang (with a link to [1]), and
      then note the most important parts directly in the guide as well.<br>
    </p>
    <p><br>
    </p>
    <p>Jorn</p>
    <p><br>
    </p>
    <p>[1]:
<a class="moz-txt-link-freetext" href="https://clang.llvm.org/docs/ClangCommandLineReference.html#cmdoption-clang-I-dir">https://clang.llvm.org/docs/ClangCommandLineReference.html#cmdoption-clang-I-dir</a><br>
    </p>
    <p><br>
    </p>
    <div class="moz-cite-prefix">On 17/04/2024 06:53, Sundararajan
      Athijegannathan wrote:<br>
    </div>
    <blockquote type="cite" cite="mid:BL3PR10MB623407931B69948E1F1624CEEA0F2@BL3PR10MB6234.namprd10.prod.outlook.com">
      
      <style type="text/css" style="display:none;">P {margin-top:0;margin-bottom:0;}</style>
      <div class="elementToProof" style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
        Or should we just say that this is equivalent Clang compiler's
        -I option rather than repeating the specification in the
        jextract doc(s)/help?</div>
      <div class="elementToProof" style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
        <br>
      </div>
      <div class="elementToProof" style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
        BTW, even Clang's command line reference does not seem to
        specify/commit to the precise behavior seen/you mentioned...</div>
      <div class="elementToProof" style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
        <br>
      </div>
      <div class="elementToProof" style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
        <a href="https://clang.llvm.org/docs/ClangCommandLineReference.html" id="LPlnk171509" class="OWAAutoLink moz-txt-link-freetext" moz-do-not-send="true">https://clang.llvm.org/docs/ClangCommandLineReference.html</a></div>
      <div class="elementToProof" style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
        <br>
      </div>
      <div class="elementToProof" style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
        -Sundar</div>
      <hr style="display:inline-block;width:98%" tabindex="-1">
      <div id="divRplyFwdMsg" dir="ltr"><font style="font-size:11pt" face="Calibri, sans-serif" color="#000000"><b>From:</b>
          jextract-dev <a class="moz-txt-link-rfc2396E" href="mailto:jextract-dev-retn@openjdk.org"><jextract-dev-retn@openjdk.org></a> on behalf
          of Nir Lisker <a class="moz-txt-link-rfc2396E" href="mailto:nlisker@gmail.com"><nlisker@gmail.com></a><br>
          <b>Sent:</b> 17 April 2024 09:51<br>
          <b>To:</b> <a class="moz-txt-link-abbreviated" href="mailto:jextract-dev@openjdk.org">jextract-dev@openjdk.org</a>
          <a class="moz-txt-link-rfc2396E" href="mailto:jextract-dev@openjdk.org"><jextract-dev@openjdk.org></a><br>
          <b>Subject:</b> New guide --include-dir clarifications</font>
        <div> </div>
      </div>
      <div>
        <div dir="ltr">Hi,
          <div><br>
          </div>
          <div>A couple of points regarding --include-dir in the guide
            that I think are worth mentioning:</div>
          <div>1. The directories are searched in order, so if the same
            header is found in more than one included dirs, only the
            first one is taken. (I think this is correct.)</div>
          <div>2. The directories are *not* searched recursively. Nested
            directories need to be added one by one if required.</div>
          <div><br>
          </div>
          <div>If you agree that these should be added, I don't mind
            making a pull request. I think it's best to add this info
            in the "Running jextract" section.</div>
          <div><br>
          </div>
          <div>- Nir</div>
        </div>
      </div>
    </blockquote>
  </body>
</html>