注释代码使用模板

image.png

c/c++模板

/**
 * \brief Loads an item by name from this linker.
 *
 * \param linker the linker to load from
 * \param module the name of the module to get
 * \param name the name of the field to get
 * \param item where to store the extracted item
 *
 * \return An error is returned if the item isn't defined or has more than one
 * definition, or `NULL` is returned and `item` is filled in otherwise.
 */

或者

/**
 * @brief Loads an item by name from this linker.
 *
 * @param linker the linker to load from
 * @param module the name of the module to get
 * @param name the name of the field to get
 * @param item where to store the extracted item
 *
 * @return An error is returned if the item isn't defined or has more than one
 * definition, or `NULL` is returned and `item` is filled in otherwise.
 */