M4(1) User Commands M4(1)
NAME
m4 - процессор макросов
SYNOPSIS
m4 [OPTION]... [FILE]...
DESCRIPTION
Обрабатывать макросы в ФАЙЛАХ. Если ФАЙЛ не указан или ФАЙЛ равен `-', читается стандартный ввод.
Обязательные или необязательные аргументы для длинных опций являются обязательными или необязательными для коротких опций.
Режимы работы:
--help отобразить эту справку и выйти
--version
вывести информацию о версии и выйти
-E, --fatal-warnings
один раз: предупреждения становятся ошибками, дважды: остановить выполнение при первой ошибке
-i, --interactive
отключить буферизацию вывода, игнорировать прерывания
-P, --prefix-builtins
добавить префикс `m4_' ко всем встроенным функциям
-Q, --quiet, --silent
подавить некоторые предупреждения для встроенных функций
--warn-macro-sequence[=REGEXP]
предупреждать, если определение макроса соответствует REGEXP,
по умолчанию \$\({[^}]*}\|[0-9][0-9]+\)
-W, --word-regexp=REGEXP
использовать REGEXP для синтаксиса имён макросов
Возможности препроцессора:
-D, --define=NAME[=VALUE]
определить NAME как имеющее VALUE, или пустое значение
-I, --include=DIRECTORY
добавить DIRECTORY в путь включения
-s, --synclines
генерировать строки `#line NUM "FILE"'
-U, --undefine=NAME
отменить определение NAME
Управление ограничениями:
-g, --gnu
переопределить -G для повторного включения расширений GNU
-G, --traditional
подавить все расширения GNU
-H, --hashsize=PRIME
установить размер хэш-таблицы поиска символов [509]
-L, --nesting-limit=NUMBER
изменить лимит вложенности, 0 для неограниченного [0]
Файлы замороженного состояния:
-F, --freeze-state=FILE
создать файл замороженного состояния в FILE в конце
-R, --reload-state=FILE
загрузить замороженное состояние из FILE в начале
Отладка:
-d, --debug[=FLAGS]
установить уровень отладки (без FLAGS подразумевается `aeq')
--debugfile[=FILE]
перенаправить вывод отладки и трассировки в FILE (по умолчанию stderr, отбросить, если пустая строка)
-l, --arglength=NUM
ограничить размер трассировки макросов
-t, --trace=NAME
трассировать NAME при его определении
FLAGS включает в себя:
a показать фактические аргументы
c показать перед сборкой, после сборки и после вызова
e показать расширение
f указать текущее имя входного файла
i показать изменения во входных файлах
l указать текущий номер строки входного файла
p показать результаты поиска путей
q заключить значения в кавычки, если это необходимо, с флагами a или e
t трассировать все вызовы макросов, не только включённые traceon
x добавить уникальный идентификатор вызова макроса, полезно с флагом c
V сокращение для всех вышеуказанных флагов
Если определена, переменная окружения `M4PATH' является списком каталогов, разделённых двоеточиями, которые добавляются после любых, указанных с помощью `-I'.
Код завершения: 0 для успеха, 1 для неудачи, 63 для несоответствия версии замороженного файла или любое значение, переданное макросу m4exit.
AUTHOR
Написал Rene' Seindal.
REPORTING BUGS
Сообщать об ошибках: bug-m4@gnu.org
Домашняя страница GNU M4: <https://www.gnu.org/software/m4/>
Общая помощь по использованию программного обеспечения GNU: <https://www.gnu.org/gethelp/>
COPYRIGHT
Copyright © 2021 Free Software Foundation, Inc. Лицензия GPLv3+: GNU GPL версии 3 или позднее <https://gnu.org/licenses/gpl.html>.
Это свободное программное обеспечение: вы можете изменять и распространять его.
НЕТ НИКАКИХ ГАРАНТИЙ, в той мере, в которой это разрешено законом.
SEE ALSO
Полная документация для m4 поддерживается как руководство Texinfo. Если программы info и m4 правильно установлены на вашем сайте, команда
info m4
должна предоставить вам доступ к полному руководству.
GNU M4 1.4.19 May 2021 M4(1)
M4(1) User Commands M4(1)
NAME
m4 - macro processor
SYNOPSIS
m4 [OPTION]... [FILE]...
DESCRIPTION
Process macros in FILEs. If no FILE or if FILE is `-', standard input
is read.
Mandatory or optional arguments to long options are mandatory or op‐
tional for short options too.
Operation modes:
--help display this help and exit
--version
output version information and exit
-E, --fatal-warnings
once: warnings become errors, twice: stop execution at first er‐
ror
-i, --interactive
unbuffer output, ignore interrupts
-P, --prefix-builtins
force a `m4_' prefix to all builtins
-Q, --quiet, --silent
suppress some warnings for builtins
--warn-macro-sequence[=REGEXP]
warn if macro definition matches REGEXP,
default \$\({[^}]*}\|[0-9][0-9]+\)
-W, --word-regexp=REGEXP
use REGEXP for macro name syntax
Preprocessor features:
-D, --define=NAME[=VALUE]
define NAME as having VALUE, or empty
-I, --include=DIRECTORY
append DIRECTORY to include path
-s, --synclines
generate `#line NUM "FILE"' lines
-U, --undefine=NAME
undefine NAME
Limits control:
-g, --gnu
override -G to re-enable GNU extensions
-G, --traditional
suppress all GNU extensions
-H, --hashsize=PRIME
set symbol lookup hash table size [509]
-L, --nesting-limit=NUMBER
change nesting limit, 0 for unlimited [0]
Frozen state files:
-F, --freeze-state=FILE
produce a frozen state on FILE at end
-R, --reload-state=FILE
reload a frozen state from FILE at start
Debugging:
-d, --debug[=FLAGS]
set debug level (no FLAGS implies `aeq')
--debugfile[=FILE]
redirect debug and trace output to FILE (default stderr, discard
if empty string)
-l, --arglength=NUM
restrict macro tracing size
-t, --trace=NAME
trace NAME when it is defined
FLAGS is any of:
a show actual arguments
c show before collect, after collect and after call
e show expansion
f say current input file name
i show changes in input files
l say current input line number
p show results of path searches
q quote values as necessary, with a or e flag
t trace for all macro calls, not only traceon'ed
x add a unique macro call id, useful with c flag
V shorthand for all of the above flags
If defined, the environment variable `M4PATH' is a colon-separated list
of directories included after any specified by `-I'.
Exit status is 0 for success, 1 for failure, 63 for frozen file version
mismatch, or whatever value was passed to the m4exit macro.
AUTHOR
Written by Rene' Seindal.
REPORTING BUGS
Report bugs to: bug-m4@gnu.org
GNU M4 home page: <https://www.gnu.org/software/m4/>
General help using GNU software: <https://www.gnu.org/gethelp/>
COPYRIGHT
Copyright © 2021 Free Software Foundation, Inc. License GPLv3+: GNU
GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
SEE ALSO
The full documentation for m4 is maintained as a Texinfo manual. If
the info and m4 programs are properly installed at your site, the com‐
mand
info m4
should give you access to the complete manual.
GNU M4 1.4.19 May 2021 M4(1)