gperl - Интернет в облаке

ПРОГРАММА:

ИМЯ

gperl - препроцессор groff для частей Perl в файлах roff

СИНТАКСИС

gperl [-] [--] [ спецификация файла ....]
gperl -h|--Помогите
gperl -v|--версия

ОПИСАНИЕ

Это препроцессор для Грофф(1). Это позволяет добавить Perl(7) код в Грофф(7) файлы.
Результатом Perl часть можно хранить в groff струны or численный регистры на основании
аргументы в последней строке Perl часть.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Пока есть только спецификация файла or разрыв настройки.

спецификация файла это имена файлов или знак минуса - символ для стандартного ввода. Как обычно,
Аргумент -- может использоваться для того, чтобы все последующие аргументы означали имена файлов, даже
если имена начинаются с символа минус -.

Вариант разрыв, когда программа просто записывает запрошенную информацию и
затем останавливается. Все остальные аргументы при этом будут проигнорированы. Эти разрыв варианты
Хери

-h | --Помогите
Распечатайте справочную информацию с кратким описанием параметров для стандартного вывода.

-v | --версия
Распечатать информацию о версии на стандартный вывод.

PERL ЧАСТЕЙ

Perl части в Грофф файлов заключены двумя .Perl запросы с разными аргументами,
начиная и окончание команда.

Начало Perl режим
Стартовый Perl запросить может быть либо без аргументов, либо по запросу, имеющему
срок Начало как единственный аргумент.

* .Perl

* .Perl Начало

Окончание Perl режим без Хранилище
A .Perl командная строка с аргументом, отличным от Начало заканчивает бег Perl часть.
Конечно, было бы разумно добавить аргумент остановить; это возможно, но не
необходимо.

* .Perl остановить

* .Perl другое_чем_начало
Аргумент другое_чем_начало может дополнительно использоваться как Грофф имя строковой переменной для
хранилище - см. следующий раздел.

Окончание Perl режим Хранилище
Полезная особенность gperl хранить один или несколько результатов из Perl Режим.

Выход из Perl часть можно получить с обратными кавычками `...`.

Эта программа собирает всю печать в STDOUT (нормальный стандартный вывод) Perl Распечатать
программа. Этот вывод псевдопечати может состоять из нескольких строк из-за разрывов строк.
\n. Таким образом, результат выполнения Perl должен быть сохранен в массиве Perl с
одна строка для каждого члена массива.

Этот вывод массива Perl может быть сохранен gperl в любом

Грофф струны
создав команду groff .ds

Грофф номер зарегистрироваться
создав команду groff .rn

Режимы хранения можно определить по аргументам окончательной остановки. .Perl команда. Каждый
аргумент .ds меняет режим на Грофф string и .nr меняет режим на Грофф номер
зарегистрироваться для всех следующих выходных частей.

По умолчанию весь вывод сохраняется в виде строк, поэтому .ds на самом деле не нужно перед первым
.nr команда. Это подходит для Грофф(7), поскольку каждый вывод может быть сохранен как Грофф строка,
но регистры номеров могут быть очень ограниченными.

In string Режим, gperl генерирует Грофф string линия хранения
.ds имя_переменной содержание
In номер зарегистрироваться Режим генерируется следующая команда groff
.nr имя_переменной содержание

Мы представляем наборы аргументов ниже. Вы можете добавить в качестве первого аргумента для всех
остановить. Мы опускаем этот дополнительный элемент.

.Perl .ds имя_переменной
Это сохранит 1 строку вывода в строку groff с именем имя_переменной не провела обыск
автоматически созданная команда
.ds имя_переменной выходной

.Perl имя_переменной
If имя_переменной отличается от Начало это эквивалентно предыдущей команде,
потому что строковый режим - это строка с .ds команда. дефолт.

.Perl var_name1 var_name2
Это сохранит 2 выходные строки в именах строк groff var_name1 и var_name2,
потому что режим по умолчанию .ds активен, так что нет .ds необходим аргумент. Из
конечно, это эквивалентно
.Perl .ds var_name1 var_name2
и
.Perl .ds var_name1 .ds var_name2

.Perl .nr var_name1 имя_переменной2
сохраняет обе переменные как переменные числового регистра. gperl генерирует
.nr var_name1 выходная_строка1
.nr var_name2 выходная_строка2

.Perl .nr var_name1 .ds var_name2
сохраняет 1-й аргумент как номер зарегистрироваться а второй как string by
.nr var_name1 выходная_строка1
.ds var_name2 выходная_строка2

Печать к СТДЕРР is без Хранилище
Печать в сторону СТДЕРР, (стандартная ошибка) работает как обычно. Вся информация об ошибках отправляется
к настоящему нормальному стандарт ошибка, без других автоматических хранилищ.

ПРИМЕРЫ

Возможно Perl часть в ROFF файл может выглядеть так:
до
.Перл старт
мой $ result = 'некоторые данные';
print $ result;
.Perl стоп .ds string_var
после

Это сохраняет результат "некоторые данные" в ROFF string под названием string_varтак, что
печатается следующая строка:
.ds string_var некоторые данные
by gperl как пища для грядущих Грофф бежать.

A Perl часть с несколькими выходами это:
.Перл старт
напечатать «первый \ п»;
вывести «вторую строку \ n»;
напечатать «3 \ n»;
.Perl вар1 вар2 .nr вар3
Это сохраняет 3 напечатанные строки в 3 Грофф строки. var1,var2,var3. Итак, следующие Грофф
создаются командные строки:
.ds var1 сначала
.ds var2 вторая строка
.номер вар3 3

Используйте gperl в Интернете с помощью сервисов onworks.net