<table border="1" cellspacing="0" cellpadding="8">
    <tr>
        <th>Issue</th>
        <td>
            <a href=https://github.com/llvm/llvm-project/issues/57450>57450</a>
        </td>
    </tr>

    <tr>
        <th>Summary</th>
        <td>
            -Wdocumentation warning for valid `img` tag when building in Xcode
        </td>
    </tr>

    <tr>
      <th>Labels</th>
      <td>
            new issue
      </td>
    </tr>

    <tr>
      <th>Assignees</th>
      <td>
      </td>
    </tr>

    <tr>
      <th>Reporter</th>
      <td>
          amja
      </td>
    </tr>
</table>

<pre>
    Hello! Firstly apologies if this is not the right forum for this question. I found very little information online regarding who handles documentation parsing/warning between Clang and Xcode itself. Please close if this is not relevant.

The most direct issue I am seeing is the `HTML start tag prematurely ended, expected attribute name or '>'` warning (which I am pretty sure comes from Clang) being raised when a self-closing `img` tag is used in a header docstring comment of Objective-C code: `/// <img src="filegoeshere" alt="Alt text goes here"/>`. Since self-closing `img` tags are standard HTML, I'm not sure why this is happening.

This warning does not present when using an image tag that is *not* self closing. The problem is, I am unable to do that because this is generated code. The following is less likely to relate to Clang but I will put it anyway:

I'm building DocC documentation for a Swift project. This supports the inclusion of images via markdown syntax: ``. However, this Swift class is exposed to Objective-C so a header is built for it. When the header is generated, it converts the Markdown into HTML, thus creating this self-closing `img` tag.

I already submitted a feedback request to Apple regarding this but I would appreciate any help if this does in fact relate to Clang's documentation parsing system.

Thanks!
</pre>
<img width="1px" height="1px" alt="" src="http://email.email.llvm.org/o/eJx9VF1v4zYQ_DXyyyKGLX_EfvBDmjTIAT20wB1wfaXElcQLRaokZcX_vrOS7SRGr4BBS-Jyd2Z2uIXXp8MLW-uzfEnPJsRkT6Q6b31tOJKpKDUG_5GcT3hmCqZuElU-9K2s0_4_PcdkvJvTF3zsnaYjhxNZk5JlMg6BrZIA8s4ahyxcq6CNq2loPDXKaYty2pd9yy5NoZ0KERFZ_jyo4CS24DQwO3q0Cm84RH-XXqNAimyrOf1lWUWm0nqsN9gDWz4ql-bZ4ilbPEzrdxBqfUykTeAyITb2DA6qpcgsJXFaWGfbxcv3r39QTCpAB1VTFxiUeqQ9ETvNOssfid86pGFNKqVgij4xOdUyQacsv89Wv8u6XdCFUJbvhsaUzVQSKVM6UURSKn0LQarg24ltlu9BX84EZSIqDA2EUCTE74TwmG67MG0tBQQhoPcSaSSuYaU5iMIRyBCLAiI1-Yr-LH4CtTny3SOJntnqQVJB-OlH2eoReSmGMls9ZXleGcu159hwYLySsmnaeLAQh98SyS6dtyUJmG8Xc_pmXMn_gzmSAneI7DTsQSK5yPoFsrVjF0dthuZ0bW2juo5Fy5u-YusishYschj6RqE8SteP1ZUj06qaR8FSo8QC6MoDwrGOSOmMdE7ili74wnKLsBGYtK13Cp8oeVSachRcKkh_BVmz46DEFyLvlKjyuHXD2WIwPxbzKmZCHpgK0fI0OR1GQqnBWEsdHk0C7tOgTmjUR9aTTEVv7Hiznnz5eHOl5MIq-jaYStTw0nZBAwSx7zof0uR2dMlCH7mu1aRPpKNR1Krwqv3gKJ6Q8e3qk2W2-e0_Wr-BJXafvbIfbfDiB8aAEAVHiSZApVVxlAu3yItxwf-jNaN_9zGihOc4iKDHnH5ITwX7e8BVdakDzUrvUPRM8euFinEoczFaavpIZWCo5eoJ26_N-slxcILFOS3Xt2gx92QIUMWsC1W-oqPjiBRKD11nPw7Ascq5w763ONbBqKURB6DNIGS76zAbvYwLXaky3doE3f_FCEW_YuL25ooo9woTL2d8WG63y939_XK9munDSu9XezVLBqP7cPfjc8LLnRLZj8oafTNzxqt1dSCAjgN61gd7aFLqojh2nCm1gdbFHFMIL9YeL393Z1vidRzGQPi8uV9vFrPmsFVFuduivbvVerFfF7tcF8V2o7d7la-rlZpZVbCNB7gRY8fxMM1zGUGbp5k55Is8X-xWi-V2leerud6U-VrvlC6qvKzWOlsvMNKNnQuOuQ_1LBxGSEVfR2xaE1N834RZTe2Yx3LIr_rU-HBQ7U81G-seRtz_Al07hSk">