Ограничение в 80 символов в ClangFormat работает с комментариями, начинающимися с @, но не с \ - PullRequest
Новая
       13

Ограничение в 80 символов в ClangFormat работает с комментариями, начинающимися с @, но не с \

0 голосов
/ 12 марта 2020

У меня есть .clang-format с ColumnLimit: '80'. Когда я пишу блоки кислорода для функций, подобных следующим, они аккуратно заключаются в 80 символов: 

    /**
     * @brief Writes out the 80-byte header (in binary STL) for the STL representation of some geometry.
     * @param[out] fileStream - The file to write the header to
     */

Становится: 

    /**
     * @brief Writes out the 80-byte header (in binary STL) for the STL
     * representation of some geometry.
     * @param[out] fileStream - The file to write the header to
     */

Но если я делаю то же самое с \ вместо @ он больше не переносится автоматически, если он повторяется: 

    /**
     * \brief Writes out the 80-byte header (in binary STL) for the STL representation of some geometry.
     * \param[out] fileStream - The file to write the header to
     */

Я должен отметить, что после строк после \ или просто блуждающие блоки комментариев работают нормально , IE, если я сделаю 

/**
 * Here is a really long comment that is greater than 80 characters, notice how it gets wrapped?
 */

Становится: 

/**
 * Here is a really long comment that is greater than 80 characters, notice
 * how it gets wrapped?
 */

Почему это происходит?

Версия Clang: 7.0.1

Моя IDE QTCreator , версия 4.7.2. Я настроил переформатирование файлов при их сохранении, что он делает для всего. (За исключением строк комментариев, начинающихся с \)

...