Algoritmos y Programación en Pascal

5.2. Programas claros ⇒ programas de calidad 69
La misma finalidad tiene la colocación adecuada de los comentarios, que no
tienen efecto alguno en el funcionamiento del programa y nos permiten en cambio
incluir explicaciones sobre la finalidad del programa o sobre su funcionamiento.
En el mismo sentido, no está de más volver a recordar que se recomienda
introducir identificadores mnemotécnicos, que sugieren el papel que juegan, facilitando
también la lectura del programa.
El uso apropiado de una clara disposición del texto, la inclusión de comentarios
apropiados, y una buena elección de los identificadores, se conoce como
autodocumentación, y no es ningún lujo superfluo. Por el contrario, se considera
preciso adquirir desde el principio el hábito de desarrollar programas claros y
bien autodocumentados.
5.1.2 Suma de dos números
El siguiente programa halla la suma de dos números enteros:
Program Suma (input, output);
{Pide dos enteros y halla su suma}
var
a, b: integer; {los sumandos}
begin
{Lectura de los datos:}
Write(’Primer número: ’);
ReadLn(a);
Write(’Segundo número: ’);
ReadLn(b);
{Cálculos y resultados:}
WriteLn(a,’ + ’,b,’ = ’,a + b)
end. {Suma}
❡❡
Entradas y salidas claras. Además de la documentación interna del
programa, otra recomendación que debe tenerse en cuenta desde el principio
es que las lecturas de los datos y la salida de los resultados sean claras,
incluyendo para ello los mensajes necesarios y ofreciendo comprobaciones
de que los datos se han leído correctamente.
5.2 Programas claros ⇒ programas de calidad
Una recomendación de gran importancia para lograr que los programas sean
correctos consiste en habituarse a escribirlos de forma clara, diferenciando bien
sus distintos fragmentos para que sean fácilmente identificables y legibles. Otra