Важной составляющей хорошей программы является встроенная доку­ментация - комментарии. Даже если вы используете в своих PL/SQL-программах удобную модульную структуру и «говорящие» названия, этого обычно бывает недостаточно для того, чтобы обеспечить полное понимание сложной программы.

PL/SQL поддерживает два вида комментариев: однострочные и много­строчные.

Синтаксис однострочного комментария

Однострочный комментарий начинается двумя дефисами (--), между которыми не может стоять пробел или какой-либо другой символ. Весь текст после двойного дефиса и до физического конца строки восприни­мается как комментарий и игнорируется компилятором. Если двойной дефис стоит в начале строки, то вся строка является комментарием.

В следующем операторе IF для пояснения его логики использован од­нострочный комментарий:

IF salary < min_salary (2003) --Функция возвращает минимал.годовую зарплату.