لا يخفى علينا أن كتابة التعليقات مفيدة جداً للمبرمجين فهي تعمل على تعريف القطعة البرمجية كفائدتها أو ما الغرض منها في حين أنه نسي ما الهدف الذي من أجله كتبها ، وهي لا تؤثر في عمل البرنامج كما نعلم فلا يتم تنفيذها من الأساس لأن البرنامج لا يستطيع قرأتها .
وللتعليقات نوعان اما ان تكون سطرية أي تعليق في سطر واح فقط أو متعددة الأسطر ، مثال :
متعددة الأسطر
/*
* calculate distance and
* circumference for rectangle
*/
var length:Int=5
var width:Int=7
var distance=length * width
println(distance)
var circumference= 2*(length+width)
println(circumference)
سطرية
var num1=5 //value num1
println(num1)
num1--
println(num1)