マニリスト - クラウドでオンライン

プログラム：

NAME

manilist - ソース ディレクトリ内のファイルのステータスをレポートする

SYNOPSIS

マニリスト [ -abcdhnptV ] [ -i ] [ -f マニフェスト ] [ -p 形式でアーカイブしたプロジェクトを保存します． ] [ -s 文字列 ] [ -w
which ] [ -x ] [ -C セパレーター ] [ -I 含まれました ] [ -L コルサイズ ] [ -X 除外 ] [
ファイル or ディレクトリ ]

DESCRIPTION

マニリスト ソース ディレクトリをスキャンし、各ファイルのステータスに関するレポートを作成します。
～に関して最新かどうか パッチレベル.h , それが欠けている場合
MANIFEST.new、および動的に構成できるその他の有用な情報。 それ
MANIFEST.new ファイルを管理し、詳細なリストとステータスを生成するために使用できます。
ディレクトリのグループなど...豊富なオプションのセットにより、 マニリスト 完璧な
低レベルのツール。

パッケージの最上位ディレクトリにある最も単純な呼び出し形式では、
引数、 マニリスト MANIFEST.new をスキャンし、それぞれのステータスに関するレポートを作成します。
そこにリストされているファイル。 各行は状態を示す XNUMX 文字のフラグで始まります。
ファイルの名前の後に続きます。

実際に起こっていることはそれよりも複雑です。 マニリスト MANIFEST.new ファイルをスキャンし、
次に、そこにリストされているすべてのファイルをループします。 内部的に、 マニリスト 包含性を維持する
および除外リスト。どちらもファイルの拡張子を指定します。 たとえば、
C ソースが含まれるように、リストには ('.c'、'.h') と除外 ('.o'、',v') を指定できます。
オブジェクトまたは RCS ファイルは除外されます。 デフォルトでは、除外されたファイルを除くすべてのファイルが使用されます。 いくつかの
後で説明するように、この段階で他の選択を適用することもできます。 それらのための
この選択プロセスを通過したファイルは、レポートに従ってレポートが発行されます。 形式でアーカイブしたプロジェクトを保存します．,
デフォルトでは「交流 %n"。 手紙 A (または最初の「:」文字の前の何か
これは、私たちが話してきたファイル選択の仕様です。 残りは、
書式設定、エスケープ シーケンスをモジュロとしてそのまま出力される文字列。 それは本当に起こります
それ %c はキャラクターフラグであり、 %n 現在のファイルの名前です。

一般的に言えば、 マニリスト 構成可能なレポートを発行するツールと見なされるべきです
一連のファイルをリストから選択するか、ファイルを直接スキャンして、
ディレクトリを参照してそこに何があるかを確認してください...

コマンドラインで引数としてディレクトリまたはファイルのセットを指定することにより、
スキャン領域。これらのファイルまたはディレクトリに関するレポートに限定されます。 もし、するなら
何も指定しないと、マニリストはレポートを現在のディレクトリとそのディレクトリに制限します。
サブディレクトリ。 -t オプションが与えられます。

OPTIONS

マニリスト は次のオプションを認識します。

-a ～についてレポートを作成する を ファイルの指定に関係なく、
含まれました & 除外 サフィックスリスト。

-b 現在のディレクトリがパッケージ ツリーのベース (ルート) であると仮定します。 こうなると
オプションが指定されていません、 マニリスト を探します 。パッケージ 示すファイル
パッケージのルート ディレクトリ (トップとも呼ばれます) であり、それがディレクトリである場合は文句を言います。
見つかりません。

-c MANIFEST.new (または任意のファイル) にリストされているファイルと比較してファイルをチェックします。
経由で指定された -f オプション)、不一致を報告します。 %c マクロ。

-d 含まれるサフィックスリストと除外されるサフィックスリストを標準エラー出力にダンプします。拡張子はスペースです。
別れた。 デフォルトのリストを知る良い方法は、以下を実行することです。 マニリスト -f
/ dev / null -BD。

-f マニフェスト 代替マニフェスト ファイルを指定します。デフォルトでは MANIFEST.new が使用されます。

-h 使用方法のヘルプ メッセージを出力して終了します。

-i エクステンション 含まれるサフィックス リストに新しい拡張子を追加します。 の エクステンション 引数
次のように、サフィックスをスペースで区切ってリストする必要があります。 -i '.ph .pl' 両方を追加するには
.ph & .pl 既存のサフィックスに。 引数は次のようにする必要があることに注意してください。
スペースをシェル解釈から保護するために引用されています。

-n マニフェスト ファイルは使用しないでください。 むしろディレクトリをスキャンして次のように動作します
そこにあるすべてのファイルはすでにマニフェストにリストされていました。

-p 形式でアーカイブしたプロジェクトを保存します． 新しい印刷形式を設定します。次の形式になります。 選択:文字列、と
選択 からのファイルを指定する XNUMX 文字のリストです。
マニフェストはレポートに使用されます。 文字列 として印刷するメッセージである
いくつかのマクロ置換を含むレポート。 コラムも可能です
「|」を指定して書式設定する文字列内で異なる文字列を区切る
見たいコラム。 こちらも参照 -C & -L その他の書式設定パラメータについては、

-s 文字列 特定します 文字列 印刷形式の一部 (「 -p 一般向け
の説明 形式でアーカイブしたプロジェクトを保存します．）。 利用可能なマクロはさらに下にリストされます。
マニュアルページ。

-t 最上位ディレクトリ (ディストリビューションのルート ディレクトリ) から開始します。
現在のディレクトリに関係なく。 あるはずです 。パッケージ ファイルへ
最上位のディレクトリが何であるかを示します。

-w 選択 を指定します。 選択 印刷形式の一部。 利用可能な選択肢
については後で説明します。

-x エクステンション 除外されるサフィックス リストに新しい拡張子を追加します。 の エクステンション 引数
次のように、サフィックスをスペースで区切ってリストする必要があります。 -x '.s .p' 両方を追加するには .s
& .p 既存のリストに追加します。 引数は引用符で囲む必要があることに注意してください。
シェル解釈からスペースを保護します。

-C セパレーター 「|」の代わりに使用される列区切り文字を指定します。
レポート形式文字列内の文字。 デフォルトでは、単一のスペースです。

-I 含まれました レポートに含めるサフィックスの新しいリストを指定します。 これ
元のデフォルトのリストをオーバーライドします（一方、 -i に使用されている 加えます 接尾辞
リスト）。 サフィックスはスペースで区切る必要があります。

-L コルサイズ 列の書式設定を使用する場合 ('|' 文字は列の形式を示すために使用されます)
列)、このオプションは最大列幅を指定するために使用できます。
各幅を単一の「,」で区切ります。 幅を指定しないままにしても、
幅に制限を課します。 たとえば、フォーマット文字列が次の場合、
%n|%d|%t、中央の列を制限することもできます (説明は次のとおりです)。
MANIFEST.new) は 40 文字、名前列 (最初の列) は 15 文字まで
を使用して、最後の文字を制限なしで残します。 -L
15,40、.

-V バージョン番号を出力して終了します。

-X 除外 レポートで除外するサフィックスの新しいリストを指定します。 これ
元のデフォルトのリストをオーバーライドします（一方、 -x に使用されている 加えます 接尾辞
リスト）。 サフィックスはスペースで区切る必要があります。

使用する 書式

の柔軟性 マニリスト 動的書式設定文字列を使用することによってもたらされます。
そのレポートを提供します。 形式を指定することができます。 -p オプションまたは部品のみ
その内: 経由のテキスト文字列 -s そしてファイル選択 -w.

File 選択
書式設定文字列の先頭部分は次のことを示します マニリスト どのファイルを見たいのか
最終報告書。 利用可能なセレクターは次のとおりです。

A 除外されたファイルを除くすべてのファイル (つまり、拡張子が
除外リスト）。 これはデフォルトのアクションです。
a 含まれるファイルおよび/または除外されるすべてのファイル ( ix）。 ファイルが次のとおりであることに注意してください。
含まれても除外されても、レポートには表示されません。
d ディレクトリのみをレポートします。
f ファイルのみのレポート。
i 含まれているファイルのみがリストされます。
m マニフェスト内で見つかったファイルまたはディレクトリのみがリストされます。
n それらのファイルまたはディレクトリのみ マニフェストで見つかったものがリストされます。
x 除外されたファイルのみがリストされます。

複数の文字を指定した場合、結果のレポートは文字の性質によって異なります。
選択。 のために d, f, m & n、論理結合が実行されます。 これは指定することを意味します fd or mn
何も指定しないのと同じですが、効率は低くなります。 マニリスト 強制されます
そうしないとバイパスされるチェックを実行します。 の i & x セレクターは特別です:
デフォルトでは、除外されていないすべてのファイルが報告されます。 指定する x 除外も要求します
ファイル。 指定する i レポートを含まれるファイルに制限します。 両方を同時に使用する
時間（ix) は、含まれるファイルまたは除外されるファイルのレポートを強制します。

マクロ 置換
レポート形式の文字列部分では、次のマクロを使用できます。

%c ファイルのステータスをコード化する文字。
%d マニフェスト ファイルの説明 (存在する場合)。
%n ファイルの名前 (最上位ディレクトリからのパス)。
%s ファイルのサイズ (バイト単位)。
%t 最終変更のタイムスタンプ。

File Status:
　 %c ファイルのステータスをコーディングする単一の文字を与えるマクロは、次のいずれかに展開できます。
以下。
。 ファイルは最新です (次のものではありません) パッチレベル.h).
- ファイルはマニフェストに存在しますが、見つかりません。
> ファイルは最後のパッチ以降に変更されています（より新しい） パッチレベル.h).
+ ファイルは存在しますが、マニフェストにリストされていません。
o ファイルは存在しますが、マニフェストにリストされておらず、より古いものです。 パッチレベル.h
x ファイルはマニフェストにリストされており存在しますが、除外されています。 当然のことながら、これは
がレポートに表示されるのは、 x セレクターはレポート形式で指定されます。
? ファイルはマニフェストにリストされていますが、存在せず、除外されました。

例

コマンド

マニリスト -ct -p 'ni:%n'

ディストリビューションからのソース ファイルのうち、
MANIFEST.新しいファイル。 これには「ソース」ファイル、つまり、
拡張子が包含リストにリストされています。 この制限を望まない場合は、次のように置き換えます。
書式設定文字列 n:%n (除外されたファイルのみが表示されません)。

初期の MANIFEST ファイルを構築するには、以下を使用します。

マニリスト -n -p 'Af:%n' > マニフェスト

最上位ディレクトリから。 最終的には各ファイルの説明を入力することになります。
マニフェストに記載されています。

onworks.net サービスを使用してオンラインでマニリストを使用する