A maior parte das linguagens de programação modernas permite que o programador insira textos que não façam parte do programa propriamente dito, são comentários adicionais que facilitam a compreensão por parte de quem lê o código.
Conforme vimos na seção comentarios, em Pascal isto é possível com o uso equilibrado dos símbolos: (* e *); { e }; e . Exemplo: <code> (* Este programa faz o calculo do MDC pelo metodo de Euclides *) (* Feito por: Marcos Castilho *) (* Data: 12/05/2009 *) program MDCporEuclides; var a, b, resto: longint; 2 bytes eh pouco para numeros grandes
begin
read (a,b); // os valores lidos devem ser nao nulos
if not ((a = 0) or (b = 0)) then
begin
resto:= a mod b;
while resto <> 0 do // quando resto eh zero temos o MDC em b
begin
a:= b;
b:= resto;
resto:= a mod b;
end;
writeln ('MDC = ', b);
end
else
writeln('O algoritmo nao funciona para entradas nulas');
end. </code>
Algumas dicas para uso dos comentários no código:
Ausência de comentários é ruim, mas o excesso também é! Use o bom senso para decidir os lugares relevantes no código que merecem comentários. Se o código precisa de muitos comentários, provavelmente está mal escrito; Não escreva comentários longos demais, a ideia é manter o código o mais limpo possível; Descrever o comportamento de funções e procedimentos é interessante; Indicar pontos no código que são fundamentais para o bom funcionamento do programa, também é.
