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

    <tr>
        <th>Summary</th>
        <td>
            Documentation flaws in lang-ref of MLIR
        </td>
    </tr>

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

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

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

<pre>
    # The flaws in https://mlir.llvm.org/docs/LangRef/

## 1. op-result
miss a "?", the correct may like
```BNF
op-result            ::= value-id (`:` integer-literal)?
```

## 2. trailing-location
"?" is meaningless, the correct may like
```BNF
trailing-location    ::= `loc` `(` location `)`
```

## 3. symbol-ref-id
does not use in lang-ref, and is wired with the definition of "symbol-ref-attribute" in Builtin Dialect.

## 4. <name> `#` <opNo> syntax
is not defined, the correct may like?
```BNF
value-use ::= value-use `#` integer-literal
```

## 5. Things are not explained in lang-ref, but mentioned
1. location
2. custom-operation-format
</pre>
<img width="1px" height="1px" alt="" src="http://email.email.llvm.org/o/eJyUVNFu6zYM_Rr5hbBhS1HqPPjhtlmAAXd96PoDskXb3GQpkOSm-ftBdpo2bbfhBoYCiOThOSRFFQINFrFh8p7JfabmODrf_BnxBe3gMWudPjeMC3geEXqjTgHIwhjjMTDxg_ED44fJkC-MeZkK5wfGD9p1gfHDT2WHJ-yTT7ln5Y_LyUWCqwpwx9xjmE1cDROFAAoY50wc0skfII4InfMeuwiTOoOhv_ECsy3X7_7xAn-Fgw-_xDF9e3hRZsacNDBep0iRIIBsxAF9biiiV4bxXUp-m-Eb9ryA6BUZskNuXKciOfvmcKEPFGBCZckOBkP4VTVf4G_VsG1pXJcUpLhFEVw9l6vdO_P_ECIKCOepdSb32OekV6N2GMC6CHPA1G6j7JAckghldZJ2Io8aThTHRZbGniwt2V2fevgBVcXoqZ0jLlWxcD-TiWRhT8pgF4tvaG0KYOLBqgmZ-G3VIxax4sEdH126DGcb1esaRSvbhQTqfy31l85eq70OR1L7eWCWu2v-z-Pyv_WVBTyPZIcAyuNCEl-PRiWanwvbzhEmtKmGeOlDVcDtdPECujlEN-XuiH4x5L3zk4qZboTeiZ3KsKm2tSgrKYTMxgZ1vVFVKyu1re96jfqu1JXmskOl7npUGTW85KKUJS_rSgpZtLrdVEJJKZHLTd2zTYmTInN94hmFMGOz5Zu6zoxq0YRlf3Bu8QSLMT0Duc98k2Lydh4C25SGQgzvKJGiwWbvujnJXkf3umHeKpPG6Y-fvz9lszfN7doZKI5zW3RuYvyQUC9_-dG7v7CLjB8WLmkXLVz_CQAA__8TQXaO">