Títulos y comentarios de bloques y segmentos



Los comentarios facilitan la lectura del programa de usuario, aumentando así la eficacia en cuanto al funcionamiento y a la posible búsqueda de errores. Los comentarios son una parte importante de la documentación del programa y deberían utilizarse en cualquier caso.

Comentarios para programas KOP, FUP y AWL:

Se dispone de los siguientes comentarios:          

· Título del bloque: título de un bloque (máx. 64 caracteres).
· Comentario del bloque: documenta todo el bloque lógico, como p.ej., la función del bloque
· Título del segmento: título de un segmento (máx. 64 caracteres).
· Comentario de segmento: documenta la función de los diferentes segmentos.
· Columna de comentario de la tabla de declaración de variables: comentarios acerca de los datos locales declarados.
· Comentario del símbolo: comentarios que se introdujeron en la tabla de símbolos para un operando en la definición del nombre.

Títulos de bloques o de segmentos

Para introducir títulos de bloques o de segmentos, sitúe el cursor en los tres signos de interrogación que aparecen a la derecha del nombre del bloque o del segmento (p.ej. Segmento 1 : ???). Se abrirá un campo de texto para introducir el título.
    Éste puede comprender 64 caracteres como máximo. Los comentarios de bloques se refieren al bloque lógico entero. En ellos se puede describir la función de éste último. Los comentarios de segmento se refieren a los diferentes segmentos y describen sus particularidades.

Comentarios de bloques y de segmentos

Los campos de comentario grises se pueden mostrar u ocultar eligiendo el comando de menú Ver > Comentario. Haciendo doble clic en uno de dichos campos se abre el cuadro de texto donde se puede introducir el comentario. Por cada bloque dispone de 64 KB para comentarios de bloques y de segmentos.