Class some_struct

test_files/comments.cpp:33–54

An example struct from which these commands will hang. @brief This is a sample brief. @warning This is a sample warning. @par header This is a sample paragraph. @hyde-owner fosterbrereton @see [Slides](https://llvm.org/devmtg/2012-11/Gribenko_CommentParsing.pdf) from an LLVM dev meeting chat on the comment parsing feature

/// @hyde-owner fosterbrereton
/// @see [Slides](https://llvm.org/devmtg/2012-11/Gribenko_CommentParsing.pdf) from an LLVM dev meeting chat on the comment parsing feature
struct some_struct {
    virtual ~some_struct() = delete;

    /// This is a longer description of this function that does things as well as it does.
    /// Notice how long this comment is! So impressive. 💥
    /// @brief A function that does a thing, and does it well.
    /// @param[in] input an input parameter
    /// @param[in,out] input_output a bidirectional parameter
    /// @param[out] output an output parameter
    /// @pre An example precondition.
    /// @post An example postcondition.
    /// @return Some additional value.
    /// @throw `std::runtime_error` if the function actually _can't_ do the thing. Sorry!
    /// @todo This really could use some cleanup. Although, its implementation doesn't exist...
    /// @warning This function may be very expensive to run. Do not call it inside a loop.
    int some_function(int input, int& input_output, int& output);

    /// A virtual function that intends to be overridden.
    virtual void virtual_function();

    int _x{0}; ///< A trailing comment that documents `_x`.
};

/// Notice how many of the comments for this structure are inherited from its superclass.
/// @brief This is a sample brief for `some_other_struct`