XML документация с++ в Visual Studio

221

13 ноября 2017, 21:13

Недавно узнал, что /// в Visual Studio используется для создания Xml документации. Также выяснил можно просматривать описание функций с помощью тега <summary>.

Вопрос. Работают ли теги <returns> и <param name="_name_">? Потому что при добавлении их в код, описание не меняется.

Пример кода:

/// <summary>
/// Заполняет массива до конца другой частью массива
/// </summary>
/// <param name="arr">массив требующий заполнения</param>
/// <param name="fullArr">массив, который заполняет arr</param>
/// <param name="startPos">с какой позиции заполнять</param>
/// <returns>заполненный массив</returns>
dynCharArr fillEndOfArr(dynCharArr arr, dynCharArr fullArr, int startPos)
{
    for (int i = startPos; i < fullArr.len; ++i)
       arr.arr[startPos + i] = fullArr.arr[i];
    return arr;
}