04_Использование_языков_высокого_уровня_Информ_материал_СПО_ч4 (1268620), страница 6
Текст из файла (страница 6)
Оглавление должно содержатьназвание каждого модуля, их описание и содержание.Вводные комментарии могут быть к модулю-файлу или к подпрограмме (назначение,входные и выходные параметры, способы их передачи, память).Пояснительные комментарии используются для пояснения отдельных программныхфрагментов.4.4.2.
Выбор символических именИмена должны быть выбраны так, чтобы они наилучшим образом определяли тевеличины, которым они предназначены. Избегать схожих имен и подобных по написаниюсимволов. Запрещено использование ключевых слов в качестве имени.Если самостоятельно необходимо придумать аббревиатуру, то это можно сделать,сократив имя. При этом, число символов в сокращении должно быть не менее трех, ваббревиатуру должны быть включены первые буквы слов, причем согласные важнеегласных. Иногда разумно разделять символы аббревиатуры знаком «подчеркивание»(«__») или выделять большой буквой.
Числовые значения лучше помещать в конце имени.4.4.3. Другие приемы улучшения читаемости программы1) Пропуск строк — позволяет логически разделить группы команд. Рекомендуется делатьпропуск строки за командой безусловного перехода, указывая на нарушениепоследовательного выполнения команд.2) Пробелы следует ставить везде, это приводит к улучшению читаемости программы;обычно ставятся в перечислениях.DB 1, 11, 123, 0A3h, …………………………….3) Упорядочивание списков по алфавиту облегчает поиск имени в списке.EXTRN Data (ALPHA, CHI, DELTA, BETA, EPSIL, ETA, PHI, OMEGA)EXTRN Data(GAMMA, MU, KAPPA, LAMBDA)EXTRN Data(ALPHA, BETA, CHI, DELTA, EPSIL)…………………………………………………….4) Скобки улучшают восприятие порядка выполнения операторов.5) Форматный ввод строк.Например:1метка:_13_31;_комментарийMOVLCALL_19……………Файл STARTUP.A51:.