PR(1)                 Справочник основных команд FreeBSD                 PR(1)

НАЗВАНИЕ
     pr -- печать файлов

СИНТАКСИС
     pr [+page] [-column] [-adFfmprt] [[-e] [char] [gap]] [-L locale]
        [-h header] [[-i] [char] [gap]] [-l lines] [-o offset] [[-s] [char]]
        [[-n] [char] [width]] [-w width] [-] [файл ...]

ОПИСАНИЕ
     Утилита pr является фильтром для разбиения на страницы и печати текстовых
     файлов.  При указании нескольких входных файлов каждый из них читается,
     форматируется и записывается на стандартный вывод.  По умолчанию ввод
     разбивается на страницы длиной 66 строк, каждая с:

        5-строчным заголовком с указанием номера страницы, даты, времени и
         полного имени файла.

        5-строчной нижней частью, состоящей из пустых строк.

     Если стандартный вывод связан с терминалом, вывод диагностических сообще-
     ний подавляется до окончания полной обработки утилитой pr.

     При указании вывода в несколько столбцов, текстовые строки имеют одинако-
     вую длину.  По умолчанию текстовые столбцы разделяются по крайней мере
     одним <пробелом>.  Входные строки, не помещающиеся в колонку текста, усе-
     каются.  Строки не усекаются при выводе в одну колонку.

ПАРАМЕТРЫ
     В последующем описании параметров столбцы, строки, отступы, страницы и
     ширина являются положительными десятичными целыми числами, а промежуток
     выражается неотрицательным десятичным целым числом.

     +page
           Начать вывод со страницы номер page форматированного ввода.

     -column
           Формировать вывод в несколько колонок, количество которых задаётся
           параметром column (по умолчанию в 1) и текст в которые помещается
           вертикально в том порядке, в котором он следует во входном файле.
           Предполагается использование параметров -e и -i.  Этот параметр не
           должен использоваться совместно с -m.  При использовании с опцией
           -t для вывода используется минимальное количество строк.  (Для раз-
           биения на колонки и изменения формы вывода текстовых файлов в более
           общем виде без дополнительного форматирования обратитесь к утилите
           rs(1) .)

     -a    Изменяет действие параметра -column таким образом, что колонки
           заполняются строками со страницы по кругу.  (то есть в случае двух
           колонок первая входная строка озаглавливает колонку 1, вторая
           колонку 2, третья строка помещается во вторую строку колонки 1 и
           так далее).  Эта опция требует использования параметра -column.

     -d    Производит вывод с двойным интервалом.  Для каждого символа
           <newline>, встреченного в вводе, выводится ещё один дополнительный
           символ <newline>.

     -e [char][gap]
           Заменяет каждый символ <tab> из входного потока перемещением на
           позицию, соответствующую следующей колонке, определяемую по формуле
           n*gap+1, где n - целое число > 0.  Если gap равен нулю или опущен,
           то его значение по умолчанию равно 8.  Все символы <tab> во входном
           потоке заменяются соответствующим количеством <пробелов>.  Если
           указан любой нецифровой символ char, то он воспринимается как вход-
           ной символ табуляции.

     -F    Использовать последовательность <прогон страницы> для вывода новых
           страниц, вместо поведения по умолчанию, при котором используется
           последовательность символов <newline>.

     -f    То же, что и -F, но перед началом вывода первой страницы выдержива-
           ется пауза, если стандартный вывод является терминалом.

     -h header
           Использовать строку header для замены file name в строке заголовка.

     -i [char][gap]
           В выводе заменять несколько <пробелов> на символы <tab>, если два и
           более соседних <пробела> достигают позиций колонок gap+1, 2*gap+1,
           и так далее.  Если gap равен нулю или опущен, по умолчанию символ
           <tab> связывается с каждой восьмой вертикальной позицией.  Если
           указан любой нецифровой символ char, то он используется для вывода
           символа <tab>.

     -L locale
           Использовать настройки локализации locale, указанные в качестве
           параметра, вместо установленных в окружении.  Задайте "C" для
           использования настроек локализации по умолчанию.

     -l lines
           Переопределить значение длины страницы по умолчанию 66, используя в
           качестве длины значение lines.  Если значение lines не превышает
           суммы длин заголовка и нижней части (в строках), то утилита pr
           подавляет вывод как заголовка, так и нижней части, как при исполь-
           зовании опции -t.

     -m    Объединить содержимое нескольких файлов.  Каждый файл из указанных
           в командной строке, строчка за строчкой, выводится в отдельную
           колонку текста одинаковой ширины.  Количество текстовых колонок
           зависит от количества успешно открытых файлов, указанных в качестве
           параметров.  Максимальное количество объединённых файлов зависит от
           ширины страницы и ограничения на количество файлов, открытых одним
           процессом.  Предполагается использование опций -e и -i.

     -n [char][width]
           Обеспечить width строк для нумерации строк.  Значение по умолчанию
           для width, если оно не задано, равно 5.  Номер занимает первые
           width колонок каждой текстовой колонки или каждую строку с номером
           -m.  Если задаётся символ char (любой нецифровой символ), то он
           добавляется к номеру строки для отделения от последующего вывода.
           Символом, используемым для char по умолчанию, является <tab>.
           Номера строк, превышающие width символов, отсекаются.

     -o offset
           Каждая строка вывода предваряется offset <пробелами>.  Если пара-
           метр -o не указан, его значением по умолчанию принимается ноль.
           Пробел добавляется к ширине выводимой строки.

     -p    Выдерживать паузу перед каждой страницей, если стандартный вывод
           является терминалом.  pr будет выдавать предупреждающий символ в
           стандартный файл ошибок и ждать нажатия перевода каретки с терми-
           нала.

     -r    Не выдавать диагностических сообщений об ошибках открытия файлов.

     -s char
           Разделять колонки текста одним символом char вместо соответствую-
           щего количества <пробелов> (значением по умолчанию для char явля-
           ется символ <tab> ).

     -t    Не печатать ни верхние пять идентификационных строк заголовка, ни
           нижние пять строк, обычно выводимые на каждой странице.  Завершить
           печать после последней строки каждого файла без пропуска пробелов в
           конце страницы.

     -w width
           Установить длину строки равной width символов в столбце только для
           вывода текста в несколько столбцов.  Если параметр -w не указан и
           отсутствует опция -s, то длина строки по умолчанию равна 72.  Если
           опция -w не указана, но указана -s, то длина строки по умолчанию
           равна 512.

     file  Имя файла для печати.  Если операнд file не указан, или если в
           качестве file указан `-', то используется стандартный ввод.  Стан-
           дартный ввод используется, если только не задан операнд file или
           если в качестве file указан `-'.

     Опция -s не позволяет разделять символ опции от его аргумента, и опции
     -e, -i, и -n требуют, чтобы оба аргумента, если они есть, не отделялись
     от символа опции.

СТАТУС ЗАВЕРШЕНИЯ
     Утилита pr возвращает 0 при успешном завершении работы и 1, если были
     ошибки.

     Сообщения об ошибках выводятся в стандартный файл ошибок во время печати
     (если вывод перенаправляется) или после полного успешного завершения
     вывода файла (при выводе на терминал).

ДИАГНОСТИКА
     Если в процессе вывода на терминал утилита pr получает прерывание, то
     перед завершением работы все накопленные сообщения об ошибках сбрасыва-
     ются на экран.

СМОТРИ ТАКЖЕ
     cat(1), more(1), rs(1)

СТАНДАРТЫ
     Утилита pr соответствует стандарту IEEE Std 1003.1-2001 (``POSIX.1'')

ИСТОРИЯ
     Утилита pr появилась в Version 1 AT&T UNIX.

ПРОБЛЕМЫ
     Утилита pr не распознаёт мультибайтовые символы.

FreeBSD 6.2                       3 июля 2001                      FreeBSD 6.2