Version 4.1.0HEAD4.1.0trunk

4 files changed, 236 insertions, 0 deletions

diff --git a/man/Makefile.am b/man/Makefile.am
new file mode 100644
index 0000000..0d03d5b
--- /dev/null
+++ b/man/Makefile.am
@@ -0,0 +1,6 @@
+
+SUBDIRS = ru
+
+MAN1 = zubr.1
+
+dist_man_MANS = $(MAN1)
diff --git a/man/ru/Makefile.am b/man/ru/Makefile.am
new file mode 100644
index 0000000..fefdd20
--- /dev/null
+++ b/man/ru/Makefile.am
@@ -0,0 +1,8 @@
+
+LANG = ru
+
+mandir = @mandir@/$(LANG)
+
+MAN1 = zubr.1
+
+dist_man_MANS = $(MAN1)
diff --git a/man/ru/zubr.1 b/man/ru/zubr.1
new file mode 100644
index 0000000..ace7ab0
--- /dev/null
+++ b/man/ru/zubr.1
@@ -0,0 +1,116 @@
+.TH ZUBR 1 "Сентябрь 2026" "ZUBR 4.1.0" "Команды пользователя"
+.SH ИМЯ
+zubr \- генератор синтаксических анализаторов LALR(1)
+.SH СИНТАКСИС
+.B zubr
+.RI [ параметры ] " входной-файл"
+.SH ОПИСАНИЕ
+.B ZUBR
+\- генератор синтаксических анализаторов LALR(1). Он читает описание
+грамматики и формирует исходный текст синтаксического анализатора на языке C.
+Входные и выходные текстовые файлы используют UTF-8; внутри ZUBR текст
+представляется в UCS-2 средствами LibMPUIO.
+.PP
+Должен быть указан ровно один входной файл грамматики.
+.SH ПАРАМЕТРЫ
+.TP
+.BI -b prefix
+Задать префикс имён создаваемых выходных файлов. Аргумент можно записать
+непосредственно после параметра или передать следующим аргументом командной
+строки.
+.TP
+.B -d
+Создать файл заголовка с определениями токенов.
+.TP
+.B -l
+Не включать создаваемые директивы \fB#line\fP.
+.TP
+.B -p
+Использовать суффикс \fB.cpp\fP для создаваемого файла исходного текста.
+Этот параметр изменяет только суффикс имени файла и не включает генерацию
+кода C++.
+.TP
+.B -r
+Разделить таблицы синтаксического анализатора, предназначенные только для
+чтения, и его программный код.
+.TP
+.B -s
+Использовать статический класс памяти там, где это предусмотрено в
+создаваемом коде.
+.TP
+.B -t
+Включить в создаваемый синтаксический анализатор поддержку отладки.
+.TP
+.B -v
+Создать файл с описанием синтаксического анализатора и его таблиц.
+.TP
+.BI -B name
+Использовать \fIname\fP как префикс глобальных имён создаваемого
+синтаксического анализатора.
+.TP
+.BI -C filename
+Задать имя создаваемого файла программного кода.
+.TP
+.BI -D filename
+Задать имя создаваемого файла заголовка.
+.TP
+.BI -I filename
+Использовать внешний include-файл для создаваемых определений токенов.
+.TP
+.BI -L funcname
+Использовать \fIfuncname\fP как имя функции лексического анализатора,
+вызываемой создаваемым синтаксическим анализатором.
+.TP
+.BI -P funcname
+Использовать \fIfuncname\fP как имя создаваемой функции синтаксического
+анализатора.
+.TP
+.BI -R filename
+Разделить таблицы, предназначенные только для чтения, и программный код,
+используя \fIfilename\fP как имя файла программной части.
+.TP
+.BI -V filename
+Задать имя файла с описанием синтаксического анализатора и его таблиц.
+.TP
+.BI -o filename
+Задать имя создаваемого файла программного кода. Аргумент можно записать
+непосредственно после параметра или передать следующим аргументом командной
+строки.
+.TP
+.B --help
+Вывести краткую справку по командной строке и завершить работу.
+.TP
+.B --version
+Вывести информацию о версии и завершить работу.
+.SH ПРИМЕЧАНИЯ
+Короткие параметры-флаги
+.BR -d ,
+.BR -l ,
+.BR -p ,
+.BR -r ,
+.BR -s ,
+.BR -t
+и
+.B -v
+можно объединять.
+.PP
+Параметры с необязательными именами файлов или объектов в историческом
+синтаксисе ZUBR, например
+.BR -C ,
+.BR -D ,
+.BR -R
+и
+.BR -V ,
+принимают значение, записанное непосредственно после буквы параметра.
+Краткое описание командной строки установленной версии можно получить с
+помощью
+.BR --help .
+.SH ФАЙЛЫ
+.TP
+.I входной-файл
+Описание грамматики в UTF-8, читаемое ZUBR.
+.SH СМ. ТАКЖЕ
+.BR yacc (1),
+.BR bison (1)
+.SH АВТОР
+Andrey V. Kosteltsev.
diff --git a/man/zubr.1 b/man/zubr.1
new file mode 100644
index 0000000..8c7bf73
--- /dev/null
+++ b/man/zubr.1
@@ -0,0 +1,106 @@
+.TH ZUBR 1 "September 2026" "ZUBR 4.1.0" "User Commands"
+.SH NAME
+zubr \- LALR(1) parser generator
+.SH SYNOPSIS
+.B zubr
+.RI [ options ] " input-file"
+.SH DESCRIPTION
+.B ZUBR
+is an LALR(1) parser generator.  It reads a grammar specification and
+produces C parser source.  Input and output text files use UTF-8; text is
+represented internally by ZUBR as UCS-2 through LibMPUIO.
+.PP
+Exactly one input grammar file is required.
+.SH OPTIONS
+.TP
+.BI -b prefix
+Set the prefix used for generated output files.  The argument may be joined
+to the option or supplied as the next command-line argument.
+.TP
+.B -d
+Produce the generated token/header file.
+.TP
+.B -l
+Omit generated \fB#line\fP directives.
+.TP
+.B -p
+Use the \fB.cpp\fP suffix for the generated code file.  This selects the
+filename suffix only; it does not make ZUBR generate C++ code.
+.TP
+.B -r
+Split read-only parser tables from parser code.
+.TP
+.B -s
+Use static storage where applicable in generated code.
+.TP
+.B -t
+Include parser debugging support in generated code.
+.TP
+.B -v
+Produce the parser description/output file.
+.TP
+.BI -B name
+Use \fIname\fP as the prefix for generated global parser names.
+.TP
+.BI -C filename
+Set the generated code filename.
+.TP
+.BI -D filename
+Set the generated header filename.
+.TP
+.BI -I filename
+Use an external include file for generated token definitions.
+.TP
+.BI -L funcname
+Use \fIfuncname\fP as the lexer function name called by the generated parser.
+.TP
+.BI -P funcname
+Use \fIfuncname\fP as the generated parser function name.
+.TP
+.BI -R filename
+Split read-only tables from parser code and use \fIfilename\fP for the code
+part.
+.TP
+.BI -V filename
+Set the parser description/output filename.
+.TP
+.BI -o filename
+Set the generated code filename.  The argument may be joined to the option
+or supplied as the next command-line argument.
+.TP
+.B --help
+Display command-line help and exit.
+.TP
+.B --version
+Display version information and exit.
+.SH NOTES
+The short flag options
+.BR -d ,
+.BR -l ,
+.BR -p ,
+.BR -r ,
+.BR -s ,
+.BR -t
+and
+.B -v
+may be grouped.
+.PP
+Options taking optional filenames or names in the historical ZUBR syntax,
+such as
+.BR -C ,
+.BR -D ,
+.BR -R
+and
+.BR -V ,
+accept their value joined directly to the option letter.  See
+.B --help
+for the concise command-line summary of the installed version.
+.SH FILES
+.TP
+.I input-file
+UTF-8 grammar specification read by ZUBR.
+.SH SEE ALSO
+.BR yacc (1),
+.BR bison (1)
+.SH AUTHOR
+Andrey V. Kosteltsev.