.\" Copyright (c) 1991 Keith Muller. .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Keith Muller of the University of California, San Diego. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#)pr.1 8.3 (Berkeley) 4/18/94 .\" %FreeBSD: src/usr.bin/pr/pr.1,v 1.20 2004/07/03 01:28:20 tjr Exp % .\" .\" $FreeBSD$ .\" .Dd July 3, 2004 .Dt PR 1 .Os .Sh 名称 .Nm pr .Nd ファイルの表示 .Sh 書式 .Nm .Bk -words .Op Ar \&+page .Ek .Bk -words .Op Fl Ar column .Ek .Op Fl adFfmprt .Bk -words .Oo .Op Fl e .Op Ar char .Op Ar gap .Oc .Ek .Bk -words .Op Fl L Ar locale .Ek .Bk -words .Op Fl h Ar header .Ek .Bk -words .Oo .Op Fl i .Op Ar char .Op Ar gap .Oc .Ek .Bk -words .Op Fl l Ar lines .Ek .Bk -words .Op Fl o Ar offset .Ek .Bk -words .Oo .Op Fl s .Op Ar char .Oc .Ek .Bk -words .Oo .Op Fl n .Op Ar char .Op Ar width .Oc .Ek .Bk -words .Op Fl w Ar width .Ek .Op - .Op Ar .Sh 解説 .Nm ユーティリティは、テキストファイルをページ単位に整形し、 出力します。複数の入力ファイルが指定された場合はそれぞれについて読み、 整形し、標準出力に書き出します。デフォルトでは、入力ファイルは 1 ページ 66 行に分割され、各ページに以下のものがつきます。 .Bl -bullet .It ページ番号、日付、時間、ファイルのパス名のついた 5 行のヘッダ .It 空行からなる 5 行のトレーラ .El .Pp 標準出力が端末の場合、 .Nm が処理を完了するまで、診断メッセージを出しません. .Pp マルチカラム出力が指定された場合、テキストの各列は同一の幅で出力されます。 デフォルトでテキストの各列は 1 つ以上の .Em で分割されます。入力行がテキストの幅からはみ出るときは切り捨てられます。 単一列の出力の場合は切り捨てられません。 .Sh オプション 以下のオプションの記述において、 column, lines, offset, page, width は 10 進の正の整数で、gap は 10 進の負でない整数です。 .Bl -tag -width 4n .It Ar \&+page 入力を整形したあと、ページ番号 .Ar page から出力をはじめます。 .It Fl Ar column .Ar column 列で出力します (デフォルトは 1)。テキストは 入力ファイルから読んだ順に、各列に垂直に書かれます。このオプションを 指定すると、 .Fl e と .Fl i オプションも指定されたものとみなされます。このオプションは、 .Fl m と一緒に使用することはできません。 .Fl t と一緒に使用すると、出力の表示行数が最小になります (もっと一般的に、追加の整形無しにテキストファイルをカラム化して整形するには、 .Xr rs 1 ユーティリティを参照してください)。 .It Fl a このオプションは .Fl column オプションを変更し、 同一ページで行毎に、順次複数列の出力を行います (例えば, 列数が 2 の場合、最初の入力行を第 1 列先頭、2 番目の入力行を 第 2 列先頭、3 番目の出力を第一列第 2 行にという具合です)。 このオプションを使うには .Fl column オプションの指定が必要です。 .It Fl d ダブルスペースで出力します。入力に .Em を見つけると、続けて余分な .Em を一つ出力します。 .It Fl e Xo .Op Ar char Ns .Op Ar gap .Xc 入力中の各 .Em を、式 .Ar n*gap+1 で表される位置のうちの現在位置の次に大きい列位置まで展開します。 この .Em n は 0 より大きい整数です。 .Ar gap が 0 もしくは省略された場合、デフォルトとして 8 が指定されたことになります。 入力中のすべての .Em キャラクタは、適切な個数の .Em に展開されます。 数字でない文字 .Ar char が指定された場合、この文字がその入力のタブキャラクタとして使われます。 .It Fl F デフォルトの .Em キャラクタシーケンスの代わりに、 改ページに .Em キャラクタを使います。 .It Fl f .Fl F と同じですが、標準出力が端末の場合には最初のページを開始する前に 一時停止します。 .It Fl h Ar header ヘッダ行内のファイル名を、文字列 .Ar header に置き換えます。 .It Fl i Xo .Op Ar char Ns .Op Ar gap .Xc 出力において、2 個以上の空白が、 式 .Ar gap+1 や .Ar 2*gap+1 などの列まで連続していた場合に、 この複数の .Em を .Em で置き換えます。 .Ar gap が 0 もしくは省略された場合、デフォルトとしてタブ位置が 8 列ごとと指定された ことになります。 数字でない文字 .Ar char が指定された場合、それがその出力のタブキャラクタとして使われます。 .It Fl L Ar locale 環境変数のかわりに、引数として指定される .Ar locale を使用します。 ロケールをデフォルト設定にリセットするには、"C" を使用します。 .It Fl l Ar lines ページ長をデフォルトの 66 行のかわりに .Ar lines 行にします。 .Ar lines がヘッダとトレーラの行数の和より大きくないときには、 .Fl t オプションをつけたときのように、ヘッダとトレーラを出力しません。 .It Fl m 複数のファイルの中身をマージします。引数で指定した各ファイルから 読み込まれた一つの行は、同一の幅で並べて書かれます。テキストの列の数は、 引数で指定したファイルのうちのオープンに成功したものの数になります。 マージするファイルの最大値は、ページ幅とプロセスがオープンできる ファイルの最大数に依存します。このオプションを指定すると、 .Fl e と .Fl i オプションも指定されたものとみなされます。 .It Fl n Xo .Op Ar char Ns .Op Ar width .Xc .Ar width 桁の 行番号をつけます。 .Ar width のデフォルト値は 5 です。 各列の .Ar width で指定された位置、 または .Fl m による出力の各行に、行番号がつきます。 .Ar char (数字でない文字)が与えられた場合は、 行番号とテキストの間をその文字で区切ります。 .Ar char のデフォルトは .Em です。 .Ar width より長い行番号は 切り詰められます。 .It Fl o Ar offset 出力の各行の先頭には .Ar offset 個の .Em がつきます。 .Fl o オプションの指定がなければ、デフォルトは 0 になります。 このスペースは出力の幅に追加されます。 .It Fl p 標準出力が端末の場合には、各ページの前に一時停止します。 .Nm は警告文字を標準エラーに書き込み、復改が端末から読み込まれるまで待ちます。 .It Fl r ファイルのオープンに失敗したときのエラーメッセージを出力しません。 .It Fl s Ar char テキストの各列間を、複数個の .Em の代わりに単一の文字 .Ar char で分割します ( .Ar char のデフォルトは .Em です)。 .It Fl t 通常ならば各ページに付加される 5 行の識別ヘッダと 5 行のトレーラを どちらも表示しなくなります。各ファイルの最終行が出力されたあと、 ページの最後までの空白を作らずに、そこで動作をやめてしまいます。 .It Fl w Ar width マルチカラム出力のために、1 行の幅を .Ar width 文字分にします。 .Fl w オプションも .Fl s オプションも指定されなかった場合、デフォルト幅は 72 です。 .Fl w オプションが指定されずに .Fl s オプションが指定された場合は、デフォルト幅は 512 になります。 .It Ar file 表示するファイルのパス名です。 .Ar file が指定されなかった場合、もしくは .Ar file が .Sq Fl だった場合は、標準入力が利用されます。 標準入力が使用されるのは、 .Ar file が指定されなかった場合、もしくは .Ar file が .Sq Fl だった場合のみです。 .El .Pp .Fl s オプションでは、オプション文字 (`s') と その引数 ( .Ar char ) との間を空けることは許されていません。また、 .Fl e , .Fl i , .Fl n は両方の引数が必要で、オプション文字と分割できません。 .Sh エラー .Nm が端末に出力中に割り込みを受け取ると、 保存していたエラーメッセージを スクリーン上に全てフラッシュしてから終了します。 .Sh 診断 .Nm ユーティリティは, 正常終了時には 0 を、 エラー終了時には 1 を返します。 .Pp エラーメッセージは、(出力がリダイレクトされている場合は)整形作業中に、 (端末に出力されている場合は)整形に成功したすべてのファイル出力が完了した後、 標準エラー出力に表示されます。 .Sh 関連項目 .Xr cat 1 , .Xr more 1 , .Xr rs 1 .Sh 規格 .Nm ユーティリティは .St -p1003.1-2001 に準拠しています。 .Sh 歴史 .Nm コマンドは .At v1 に登場しました。 .Sh バグ .Nm ユーティリティは、マルチバイト文字を認識しません。