Многострочные комментарии используются в документации кода для написания длинных и подробных пояснений, охватывающих несколько строк кода. 3 Они полезны для описания сложных функций, алгоритмов или для создания документации к коду. 3

Специальным образом оформленные многострочные комментарии (документирующие комментарии) используются для автоматического создания документации, в первую очередь, к библиотекам функций или классов. 1 Для этого используются генераторы документации, например, такие как javadoc для языка Java, phpDocumentor для PHP, doxygen для C и C++ и другие. 1

В некоторых средах программирования (например, Eclipse, NetBeans, Python, Visual Studio) документирующие комментарии используются в качестве интерактивной подсказки по интерфейсу классов и функций. 1