Комментарии. В любом месте программы, где разрешен пробел, можно записать пояснительный текст – комментарий

В любом месте программы, где разрешен пробел, можно записать пояснительный текст – комментарий. Он не обрабатывается компилятором и не включается в исполняемый exe-файл. Признак профессионализма программиста – наличие развернутых комментариев в программе.

Комментарии нужны в любой программе, даже если программа не очень объемная и не очень сложная. Обычно молодые и начинающие программисты (первокурсники) весьма самоуверенно пренебрегают этой рекомендацией. И здесь не столь важно, что вашу программу без комментариев будет трудно понять постороннему человеку, например, преподавателю. Преподаватель поймет все. Гораздо весомее тот аргумент, что вы сами через некоторое время ее забудете, и вам придется потратить много времени, чтобы в ней снова разобраться. Как правило, даже выгодно переписать ее заново, но уже с комментариями.

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

Комментарием считается последовательность произвольных фраз, заключенных в символы {. . .} или (* . . .*):

{ это комментарий }

(* это комментарий *)

Поместить комментарий можно между любыми двумя соседними операторами программы или в конце оператора:

x:=x+1; {увеличиваем счетчик на единицу}

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