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

    <tr>
        <th>Summary</th>
        <td>
            Keep comments associated with requirements of a concept
        </td>
    </tr>

    <tr>
      <th>Labels</th>
      <td>
      </td>
    </tr>

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

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

<pre>
    I found an issue with Doxygen https://github.com/doxygen/doxygen/issues/9569. You cannot add documentation on concept requirements. Then I tried to do something with python-clang (version 15), and indeed it gave no comments.

```c++
/**
 * \brief Defines the requirements of a "source"
 *
 * A source is something that can be read from, for example, an input buffer or a file.
 *
 * \ingroup de-serialization
 *
 */
template<class T>
concept source = requires(T a)
{
        /**
         * \brief Shall try to consume next byte and return it. If it possible to consume another
         *  byte, it shall return std::nullopt, which implies an End-Of-File condition.
         */
        { read_byte(a) } -> std::same_as<std::optional<char>>;
};
```

Becomes

```
CursorKind.TRANSLATION_UNIT, testdata/test.hpp, None
    CursorKind.CONCEPT_DECL, source, /**
 * \brief Defines the requirements of a "source"
 *
 * A source is something that can be read from, for example, an input buffer or a file.
 *
 * \ingroup de-serialization
 *
 */
 CursorKind.TEMPLATE_TYPE_PARAMETER, T, None
 CursorKind.REQUIRES_EXPR, , None
            CursorKind.PARM_DECL, a, None
                CursorKind.TYPE_REF, T, None
 CursorKind.DECL_REF_EXPR, , None
 CursorKind.OVERLOADED_DECL_REF, read_byte, None
 CursorKind.DECL_REF_EXPR, a, None
            CursorKind.NAMESPACE_REF, std, None
            CursorKind.TEMPLATE_REF, same_as, None
 CursorKind.NAMESPACE_REF, std, None
            CursorKind.TEMPLATE_REF, optional, None
```
>From this

```c++
/**
 * Given a cursor that represents a declaration, return the associated
 * comment's source range.  The range may include multiple consecutive comments
 * with whitespace in between.
 */
CINDEX_LINKAGE clang_Cursor_getCommentRange[CXCursor C);
```

Maybe that is not possible, since the requirements is not treated as declarations. Would it be possible to make individual requirements behave more like class members?
</pre>
<img width="1px" height="1px" alt="" src="http://email.email.llvm.org/o/eJzkVktz4rgT_zTi0hWXkcPrwMExZoqahPAnzH9nTpRstbF2ZMkrycmwn35LNhCTyTwOe9uUKshSP3_drW5mrTgoxDkZ3ZHRYsAaV2ozr4RktuFGyEGm-XG-gkI3igNTIKxtEF6EK2Ghvx0PqKB0rrYkigldEro8CFc2WZDritAl70iudq0ES-hyNhrPAviiG8iZUtoB4xy4zpsKlWNOaAVaQa5VjrUDg381wqC_swHsSlSwAmcEcnAauAarK3SlUIfOuvroSq1ucsnUAQidPqOxXuRwROiM0ASY4iAUR-QgHBzYM4LSkOuqU0HCBQnj0_9x2K2c0Du_ulPvb-xX-wmExkBGSWYEFrDAQii04Eq8Mh10AQwIpVY3JkdC6St3T04M3T0I23PMlcx5sCDzQhmHwniYEyi0AfzGqlpi5xoIVTcOsqYo0IA2wKAQEoN3lZFRItTB6KYGjjcWjWBS_N1G4D1673f74bCqJXNIoiSXzFrYkSjtrs5RO3lBosUZBUvodAfMB6FDcXKGM5y9QZSEs2tQn0omJThz9CHPtbJNhaDwm4Ps6LCNqEHXGAXCBbAqfGBrba3IJPZZmNKuRHOtpZXh0RMObKvoJMs67rM7ilUjpa6dp3kpRV6CqGop0Hq8U8VvHoubpZDo1XDh0QuuNFxw855O7toI7julU48HkMkCbkiUvmq0rMI9syRKLke69pKZ9KCXzHjE_TqDOFm87s9Z20_lO8x1hfbd7O4-k8ZYbT4KxYPdNl4_3ce71eN6_2m92nnPHVrHmWOELv02KOvaH6-1wlOKAEBPRvK4TtLNbr9Ik3tPeM77BP7z9dOHaZc-bO7jXbrffdmk-028jR_SXbr11uze4Nvj2qb_-7Tapk_79PNm22H6NhTnvx7XJt4-XOLBfszyhq21bJsuf2GTF-zJfmRTj_Tx_-n2_jFepIv9mcsT9wrjt5X8xI0e2zp-SJ82cXLxw5fV7zBewnPmOxXmDw381zRd6v2K-U3NLo2uwJXi_br-Zdf6IJ5RAYO8NaMrE4O1QduWHAOOuWSmy-g2QO3D6GuTWatzwRzynrxTEyV0Ys91aJg6YAC-cXd7qNgRhMplwxGqRjpRd0-nxbxx4hkvrbgnuO3sL6VwaGvmq9uXsntBVME79ZWs1ov08_5-tf4Yf0ihHQX2HdT7A7qkk7_11pDRXfK5u4LE96afPqIP7JhhB5Ow4EeXc5dpIy1Ujt8_XCdKZ9CjBcz2UbUB_KEb2Y4iGV41rYp99Y5y8Sx4w-S10AxLP7hU2iBI8RWha8QVVhkaS6LlgM8jPotmbIDz4XgaDsPpmEaDck7ZmGHGxmwaTsaT4XAWhmw8KjKc0IJG7HYg5jSkURjR2XA8CmkUDHF6G9IZ0pBjwSYFuQ2xYkIGUj5XgTaHQTvazcfDyWw6kCxDac-DpZl7opusOVhyG0phnX1lc8JJnH9ErC8x7-VVF_Tve8BpxBg0Rs5_MoJ6Laefm9roPzF3_SG0NfafAAAA__8iUGMb">