История изменений
Исправление GPFault, (текущая версия) :
Может потому что doxygen поощряет возню типа документирования аргументов и возвращаемых значений вместо действительно важных вещей, а в результате получается простыня воды оформленная в стиле интернета 90-х
Неистово плюсую. Синтаксически отдельное описание параметров в doxygen в виде их пересечения - полное снижение читаемости.
Адекватное описание параметров - формулирование описания функции в свободной форме, в котором в подходящих местах эти параметры упоминаются, в том порядке в котором они ложатся на свободную форму этого описания
Исходная версия GPFault, :
Может потому что doxygen поощряет возню типа документирования аргументов и возвращаемых значений вместо действительно важных вещей, а в результате получается простыня воды оформленная в стиле интернета 90-х
Неистово плюсую. синоаксически отдельное описание параметров в doxygen - полное снижение читаемости. Адекватное описание параметров - формулирование описания функции в свободной форме, в котором в подходящих местах эти параметры упоминаются, в том порядке в котором они ложатся на свободную форму этого описания