4.2 pr: 印刷のためのファイルのページ化とコラム化
prは,それぞれのfile(‘-’は標準入力を意味します)や,
与えられない場合は標準入力をページ化し,オプションで複数列の書式での出
力を標準出力に書き出します.オプションで,全てのfileを結合し一列
ごとに並列に全てを出力します.概要です.
pr [option]... [file]...
デフォルトで,五行のヘッダがそれぞれのページに出力されます.二行の空白
行.日付,ファイル名,そしてページ番号がある行.さらに二行は空白行です.
また,五行の空白行を持つフッタも出力します.-Fオプションで,
三行のヘッダを出力します.最初の二行の空白行は削除されます.フッタは使
用されません.どちらの場合でもデフォルトのpage_lengthは66行です.
テキスト行のデフォルト数は56(-Fが無い場合)から63(-F
がある場合)まで変化します.ヘッダのテキスト行は,‘date
string page’の形式で,行がpage_widthいっぱいになるよ
うにstringの周りにスペースが挿入されます.ここで,dateは日
付(詳細は,-Dや--date-formatオプションを参照してくだ
さい),stringはセンタリングされたヘッダ文字列,そしてpage
はページ番号を示します.LC_MESSAGESロカールカテゴリはpage
の綴りに影響します.デフォルトのCロカールでは‘Page number’
になり,numberは十進数のページ番号です.
入力のフォームフィードは,出力で改ページとなります.複数のフォームフィー
ドは空のページを生成します.
列は同じ幅で,オプションの文字列(デフォルトは‘space’)で分けられて
います.複数列の出力では,-Jオプションを使用していない場合,
行は常にpage_width(デフォルトで72)で切り詰められます.単一列での
出力は,デフォルトでは切り詰められません.その場合,行を切り詰めるため
-Wオプションを使用してください.
以下の変更は,version 1.22iでなされ,それ以降のprのバージョ
ンに適用されています.
- Brian
-
小文字のletter options(-s,-w)には,より良い
POSIX準拠のもので再定義されているものもあります.それ以外の
場合での出力は,他のUnixに適合されたものもあります.これらの変更は,プ
ログラムの以前のバージョンと互換性がありません.
-
new capital letterオプション(-J,-S,
-W)には,小文字のオプションでの予期せぬインターフェースを取り
消すために導入されたものもあります.-Nオプションと二番目の引
数‘+FIRST_PAGE’のlast_pageで,より柔軟性が高くなります.入
力ファイルのフォームフィード設定を詳細に扱うため,-Tオプショ
ンが必要になります.
-
大文字のオプションは,小文字のものに優先します.
-
オプション引数には(-s,-S,-e,-i,
-nと比較して),(POSIX仕様で既に述べられた)前置され
ているオプション文字と分離されている引数を指定することが不可能なものも
あります.
プログラムは以下のオプションを受け入れます.Common optionsも参照
してください.
- ‘+first_page[:last_page]’
- ‘--pages=first_page[:last_page]’
-
ページfirst_pageから出力を開始し,last_pageで停止します.
‘:last_page’が無い場合は,ファイルの終りを暗黙に指定します.
飛ばされたページ数を計算している間,入力ファイルのそれぞれのフォーム
フィードは,結果として新しいページになります.‘+first_page’
がある場合と無い場合のページの数え方は同じです.デフォルトで,入力ファ
イルの最初のページでカウントを開始します(最初のページは出力されません).
行の番号付けは,-Nオプションで変更してもかまいません.
- ‘-column’
- ‘--columns=column’
-
それぞれ単一fileを用いて,-aが使用されない場合は
column列(デフォルトで1)の出力を生成し列を下へ向かって出力します.
列の幅は,columnが増加するに従い,自動的に減少します.
page_widthを増加させるため,-W/-wを使用していない場合も
同様です.このオプションは,いくつかの行を切り詰める可能性があります.
それぞれのページの列の行数は平均化されます.オプション-eと
-iは,複数のテキスト列の出力のためにあります.-Jをと
もに用いると,列の整列と行の切り詰めは停止します.十分な長さの行は,フ
リーフィールド書式に組み込まれ,-Sオプションはフィールドを分
ける可能性があります.-columnは-mオプションと
ともに使用してはいけません.
- ‘-a’
- ‘--across’
-
それぞれ単一fileを用い,列を下ではなく横に出力します.
-columnオプションは,一列以上のcolumnで与える必要
があります.列に適さないほど余りに長い場合,それは切り詰められます.
- ‘-c’
- ‘--show-control-chars’
-
ハット表記で(例えば,‘^G’)を使用して制御文字を出力します.八進数
のバックスラッシュ表記で,その他の印刷不可能な文字を表示します.デフォ
ルトで,印刷不可能な文字は変更されません.
- ‘-d’
- ‘--double-space’
-
ダブルスペースの出力です.
- ‘-D format’
- ‘--date-format=format’
-
formatを使用してヘッダの日付を書式化し,それはコマンド‘date
+format’と同じ慣習を使用します.See date invocation.
‘%’で始まる指示語以外,format内の文字は変更されずに出力され
ます.ヘッダの日付の場所に,例えば--date-format="Monday
morning"のような,任意の文字列を指定するために,このオプションを使用
することが可能です.
POSIXLY_CORRECT環境変数が設定されていない場合,日付の書式はデフォ
ルトで‘%Y-%m-%d %H:%M’です(例えば,‘2001-12-04 23:59’).それ
以外の場合,書式はLC_TIMEロカールカテゴリに依存し,デフォルトは
‘%b %e %H:%M %Y’(例えば,‘Dec 4 23:59 2001’)になります.
- ‘-e[in-tabchar[in-tabwidth]]’
- ‘--expand-tabs[=in-tabchar[in-tabwidth]]’
-
入力のtabをスペースに展開します.オプションの引数
in-tabcharは,入力のタブ文字(デフォルトはTAB文字)です.二番目の
オプション引数in-tabwidthは,入力タブ文字の幅(デフォルトは8)です.
- ‘-f’
- ‘-F’
- ‘--form-feed’
-
出力ページを分けるため,改行の代わりにフォームフィードを使用します.デ
フォルトページの長さの66行は変更されません.しかし,ページごとのテキス
トの行数はデフォルトの56行から63行に変更されます.
- ‘-h HEADER’
- ‘--header=HEADER’
-
ヘッダのファイル名を中央揃えされた文字列headerで置換します.シェ
ルを使用しているとき,headerを引用符で囲むべきで,-hと
はスペースで分離すべきです.
- ‘-i[out-tabchar[out-tabwidth]]’
- ‘--output-tabs[=out-tabchar[out-tabwidth]]’
-
出力上でスペースをtabに置換します.オプション引数
out-tabcharは出力されるタブ文字です(デフォルトはTAB文字です).二
番目のオプション引数out-tabwidthは出力されるタブ文字の幅(デフォ
ルトで8)です.
- ‘-J’
- ‘--join-lines’
-
十分な長さの行に統合します.列オプション-column,
-a -column,または-mとともに使用します.
-W/-wの行の切り詰めを停止します.列の整列は使用されません.
‘-S[string]’とともに使用してもかまいません.-Jは
(-Wと-Sとともに),三列オプションの古い
(POSIX 準拠の)オプション-wと-sを解決するた
めに導入されました.
- ‘-l page_length’
- ‘--length=page_length’
-
ページの長さを,ヘッダ[とフッタ]の行を含めて,page_length行(デフォ
ルトで66)に設定します.page_lengthが10以下(または-Fが3
以下)の場合,ヘッダとフッタは取り除かれ,入力ファイルの全てのフォーム
フィード設定は,-Tオプションが指定されたかのように無視されま
す.
- ‘-m’
- ‘--merge’
-
全てのfileを並列に,それぞれの列に一つに統合して出力します.列に
適さないほど行が長すぎる場合,それは-Jオプションが使用されて
いない限り切り詰められます.--sep-string[=string]を使用
してもかまいません.fileの(フォームフィード設定の)空のページは空
の列を生成しますが,stringで印は付いたままです.結果として,連続
した行の番号付けと,統合されたファイル全体を通じて印が付いた列になりま
す.統合されても完全に空のページになるものは,区切りも行番号もありませ
ん.デフォルトヘッダは‘date page’になり,真中にスペー
スが挿入されます.これで中間の空白部分を満たすため,-hや
--headerオプションとともに使用してもかまいません.
- ‘-n[number-separator[digits]]’
- ‘--number-lines[=number-separator[digits]]’
-
digits桁の行の番号付けを提供します(デフォルトのdigitsは5で
す).複数列の出力では,番号はそれぞれのテキスト列の最初のdigits
列の位置や,-m出力のそれぞれの行だけに生成されます.単一列の
出力では,番号はそれぞれの行に-mが行うように生成します.デフォ
ルトの行カウントの開始は,入力ファイルの最初の行で始まります
(--pageオプションと-Nオプションとは異なり,最初に印
刷される行ではありません).オプション引数number-separatorは,以
下に続くテキストと分離するために行数に後置される文字です.デフォルトの
分離文字はTAB文字です.厳密な意味で,TABは常に単一の列の出力だけに出力
されます.TAB幅はTAB位置で変化し,例えば,左のmargin
が-oオプションで指定された場合は変化します.複数列出力のプロ
パティは,‘equal width of output columns’ (POSIX指定)
で与えられます.TAB幅は,最初の列の値で固定され,左の
marginの値の違いでは変更されません.それは,固定数のスペースが常
にnumber-separator tabの位置に出力されることを意味します.タブ機
能は出力位置に依存します.
- ‘-N line_number’
- ‘--first-line-number=line_number’
-
最初のページに出力される最初の行(ほとんどの場合,入力ファイルの最初で
はありません)を,数字のline_numberで行のカウントを開始します.
- ‘-o margin’
- ‘--indent=margin’
-
それぞれの行をmarginスペースのマージン幅(デフォルトはゼロ)で字下
げします.ページ全体の幅はマージンに-W/-wオプションの
page_width設定を加えたものになります.数字付の単一列の出力では
(-nオプションとは異なり)制限されることによるオーバーフローが
発生するかもしれません.
- ‘-r’
- ‘--no-file-warnings’
-
引数fileが開けなかったとき,警告メッセージを出力しません.(しか
し,終了ステータスはゼロではありません.)
- ‘-s[char]’
- ‘--separator[=char]’
-
単一文字charで列を分けます.charのデフォルトは,
-wを用いないとTAB文字で,-wを用いると‘no
character’になります.-sが無い場合のデフォルトの分離文字は
‘space’に設定されます.-s[char]は,-wが設定され
ていない場合,全ての三列オプション(-COLUMN|‘-a
-COLUMN’|-m)の行の切り詰めを停止します.それは,
POSIX準拠の公式なものです.
- ‘-S string’
- ‘--sep-string[=string]’
-
出力の列を分離するためstringを使用します.-Sオプション
は-sオプションと異なり,-W/-wオプションに対し効果が
ありません.それは行の切り詰めや列の整列に効果がありません.
-S を用いず,-Jを用いると,prはデフォルト
の出力の分離文字のTABを使用します.-Sや-Jを用いない
と,pr は‘space’を使用します(‘-S" "’と同じです).
-Sstringを用るとき,stringを空にしてはいけません.
stringが無い--sep-stringは--sep-string=""と等
価です.
古いシステムでは,prは時代遅れのオプション
-S[string]を代わりにサポートし,stringはオプショ
ンになります.POSIX 1003.1-2001 (see Standards conformance)ではこの古い使用方法を許可していません.移植性がある空の
stringを指定するため,--sep-stringを使用してください.
- ‘-t’
- ‘--omit-header’
-
それぞれのページに,通常のヘッダ[とフッタ]を出力せず,ページの底まで補
充しません(空白行またはフォームフィードを用います).ページ構造は生成さ
れませんが,入力ファイルで設定されているフォームフィードは維持されます.
前もって定義されたページ化は変更されません.-tや-Tは,
他のオプションとともに使用すると便利かもしれません.例えば,‘-t
-e4’は,入力ファイルのTAB文字を四つのスペースに展開しますが,それ以外
の変更を行いません.-tの使用は-hに優先します.
- ‘-T’
- ‘--omit-pagination’
-
ヘッダ[とフッタ]を出力しません.更に,入力ファイルのフォームフィード設
定を全て削除します.
- ‘-v’
- ‘--show-nonprinting’
-
出力できない文字を,八進数のバックスラッシュ表記で出力します.
- ‘-w page_width’
- ‘--width=page_width’
-
複数のテキスト列出力に対してのみ,ページ幅をpage_width文字数に設
定します(page_widthのデフォルトは72です).-s[CHAR]は,
デフォルトページ幅を停止し,すべての行を切り詰め,列を整列します.十分
な長さの行は,列オプションの設定にかかわらずマージされます.
page_width設定が無い場合,おそらく単一列の出力になります.
POSIX準拠の公式なものです.
- ‘-W page_width’
- ‘--page_width=page_width’
-
ページ幅をpage_width文字に設定します.それは列オプションによらず
有効です.-Jが使用されない場合,テキスト行は切り詰められます.
三列オプション(-column,‘-a -column’,または
-m)の一つとともに用いた場合,列の整列は常に使用されます.セパ
レータオプションの-Sや-sは,-Wオプションに
効果がありません.デフォルトは72文字です.‘-W page_width’が
無く,あらゆる列オプションが無い場合,行の切り詰めは行われません(下位
互換を保つためと,よくある仕事に合わせるために定義されています).それ
は,‘-W 72 -J’と等価です.ヘッダ行は常に切り詰められません.
終了ステータスのゼロは成功を示し,ゼロ以外の値は失敗を示します.