ГОСТ 19.506—79 Единая система программной документации. Описание языка. Требования к содержанию и оформлению. Unified system for program documentation. Language description. Requirements for contents and form of presentation. УДК 651.7/.78:681.3.06:002:006.354 МКС 35.080. Редакция от 07.11.2023.
1 Общие положения ГОСТ 19.506-79
1.1 Структура и оформление программного документа устанавливаются в соответствии с ГОСТ 19.105—78.
Составление информационной части (аннотации и содержания) является обязательным [из 1.1 ГОСТ 19.506—79]
1.2 Описание языка должно содержать следующие разделы:
- общие сведения;
- элементы языка.
Допускается вводить разделы:
- способы структурирования программы;
- средства обмена данными;
- встроенные элементы;
- средства отладки программы.
В зависимости от особенностей языка допускается объединять отдельные разделы или вводить новые [из 1.2 ГОСТ 19.506—79]
2 Содержание разделов ГОСТ 19.506-79
2.1 В разделе «Общие сведения» должны быть указаны назначение и описание общих характеристик языка, его возможностей, основных областей применения и другие сведения [из 2.1 ГОСТ 19.506—79]
2.2 В разделе «Элементы языка» должно быть указано описание синтаксиса и семантики базовых и составных элементов языка [из 2.2 ГОСТ 19.506—79]
2.3 В разделе «Способы структурирования программы» должны быть указаны способы вызова процедур передачи управления и другие элементы структурирования программы [из 2.3 ГОСТ 19.506—79]
2.4 В разделе «Средства обмена данными» должно быть приведено описание языковых средств обмена данными (например, средства ввода–вывода, внутреннего обмена данными и т. п.) [из 2.4 ГОСТ 19.506—79]
2.8 В разделе «Средства отладки программы» должно быть приведено описание имеющихся в языке средств отладки программ, семантики этих средств, даны рекомендации по их применению [из 2.8 ГОСТ 19.506—79]
2.9 При необходимости содержание разделов должно быть пояснено примерами [из 2.9 ГОСТ 19.506—79]
2.10 В приложения к описанию языка могут быть включены дополнительные материалы (формализованные описания языковых средств, иллюстрации, таблицы, графики, формы бланков и т.п.) [из 2.10 ГОСТ 19.506—79]