aenf - クラウド上のオンライン

プログラム：

NAME

aegis new file - 変更によって作成される新しいファイルを追加します

SYNOPSIS

イージス -新しいファイル ファイル名...[ オプション...]
イージス -新しいファイル -リスト [ オプション...]
イージス -新しいファイル -ヘルプ

DESCRIPTION

　 イージス -新しいファイル コマンドは、新しいファイルを変更に追加するために使用されます。 名前付きファイルは、
変更のファイルのリストに追加されます。

名前が付けられたファイルごとに、開発ディレクトリに新しいファイルが作成されます (そうでない場合)。
すでに存在します。 ファイルがすでに存在する場合、そのファイルは変更されません。

新しいソース ファイル (シェル スクリプトなど) を実行可能にしたい場合は、次のようにします。
通常のものを使用するだけです chmod(1) コマンド。 ファイルの実行可能ビットのいずれかが次のように設定されている場合、
エーデ(1) ファイルが実行可能ファイルとして記憶され、すべての実行ビット (マイナス
プロジェクトの umask) は後続の関数によって設定されます acp（1）コマンド。

コマンドラインでディレクトリに名前を付けると、ディレクトリツリー全体が検索されます。
新しいファイルの場合。 (注: ドット ファイルや
バイナリ ファイルなので、最初にジャンクをすべて削除する必要があります。) この名前の下のファイル
すでに変更内またはプロジェクト内にあるディレクトリは無視されます。 の
ファイル名_accept & ファイル名_拒否 プロジェクト内のパターン イージス.conf ファイルも
適用される、参照 aepconf（5）詳細については。

ディレクトリ 例
のようなコマンドを実行する場合があります。
$ アーエンフ フーバー/*
aegis: プロジェクト "example": 変更 42: "fubar/glorp" はすでに変更中です
aegis: プロジェクト "例": 変更 42: 致命的なエラーが 1 つ見つかりました。新しいファイルは追加されませんでした
$
示されているように失敗します。 これに対処するにはいくつかの方法がありますが、最も簡単なのは
ディレクトリに名前を付けるだけです。
$ アーエンフ フーバー
aegis: プロジェクト「例」: 変更 42: ファイル「fubar/smiley」を追加
aegis: プロジェクト "example": 変更 42: ファイル "fubar/frownie" を追加
$
また、 find(1) 任意に複雑なファイルを選択するためのコマンドですが、
最初に、上記のコマンドで自動的に除外されるファイルを除外する必要があります。
$ aelcf > 除外する
$ エルプフ >> 除外する
$ find フーバー 型 f | \
grep -v -f 除外する | \
xargs イージス -新しいファイル -v
aegis: プロジェクト「例」: 変更 42: ファイル「fubar/smiley」を追加
aegis: プロジェクト "example": 変更 42: ファイル "fubar/frownie" を追加
$
除外リストを使用していない場合は、 find(1) コマンドは、お使いの環境に合わせて微調整する必要があります。
開発ディレクトリのスタイル。 シンボリックリンク スタイルを使用している場合は、以下を追加する必要があります
　 find -nlink 1 に加えてオプション find 型 f オプションを選択します。
$ find フーバー 型 f -nlinks 1 | \
xargs イージス -新しいファイル -v
aegis: プロジェクト「例」: 変更 42: ファイル「fubar/smiley」を追加
aegis: プロジェクト "example": 変更 42: ファイル "fubar/frownie" を追加
$
フルコピー開発ディレクトリ スタイルを使用している場合は、
上記の除外リスト方法。

File テンプレート
開発ディレクトリに新しいファイルが作成されると、プロジェクトは 設定 ファイルは
新しいファイルのテンプレートを検索しました。 テンプレートが見つかった場合、新しいファイルは
テンプレートに初期化されない場合は、空で作成されます。 見る aepconf（5）詳細
情報を表示します。

最も単純な形式は、次のようなテンプレート ファイルを使用することです。
ファイルテンプレート =
[
{
パターン = [ "*.c" ];
body = "${read_file ${ソーステンプレート/c abs}}";
},
{
パターン = [ "test/*/.sh" ];
body = "${read_file ${ソーステンプレート/テストabs}}";
},
];
ご覧のとおり、テンプレート ファイルはプロジェクト ソースの一部であるため、
適切な著作権表示とラッパー、 等を選択します。 $ソース 置換によりそれらが見つかります。
それらが現在の変更の一部ではない場合 (通常はそうではありません)。

テンプレート ファイル自体には置換が含まれています。 の $ filename 置換は
利用可能で、作成中のファイルの名前が含まれています。 これはで操作できます
適切なファイルの内容を構築する際のさまざまな方法。 見る エースサブ（5）詳細
代替品に関する情報。

コマンドを実行して新しいファイルを作成することもできます。 代わりにこれを行うことができます
本体文字列を指定し、 つまり：
ファイルテンプレート =
[
{
パターン = [ "*" ];
body_command = "perl ${source template.pl abs} $filename";
},
];
このコマンドは、現在のディレクトリを開発ディレクトリの先頭に設定して実行されます。
コマンドがファイルの作成に失敗した場合はエラーになります。 XNUMX つを組み合わせて使用​​できます
テクニック、 ボディ 文字列と ボディコマンド、 お望みならば。

File 名前 制限事項
プロジェクト ファイル名の形式を制限するために使用できるコントロールが多数あります。 すべての
これらのコントロールはプロジェクト構成ファイル内にある場合があります。「」を参照してください。 aepconf（5）詳細
情報。 最も重要なものをここで簡単に説明します。

maximum_filename_length = 整数;
このフィールドは、ファイル名の長さを制限するために使用されます。 すべての新しいファイルには、
これより長いパスコンポーネント。 設定されていない場合、デフォルトは 255 です。 最大限に
移植性を考慮して、これを 14 に設定する必要があります。

posix_filename_charset = ブール値;
このフィールドは、ファイル名に使用できる文字を次の文字のみに制限するために使用できます。
POSIX によって明示的に許可されています。 デフォルトは false 設定されていない場合は、どんな意味でも
オペレーティング システムは、空白文字と高ビットオン文字を除いて許容します。
移植性を最大限に高めるには、これを次のように設定する必要があります。 true.

dos_filename_required = ブール値;
このフィールドは、DOS 8+3 に準拠するようにファイル名を制限するために使用できます。
ファイル名は DOS ファイル名文字セットに制限されます。 デフォルトは false そうでなければ
設定します。

windows_filename_required = ブール値;
このフィールドは、Windows98 に準拠するようにファイル名を制限するために使用できます。
WindowsNT のファイル名の制限と文字セット。 デフォルトは false 設定されていない場合。

shell_safe_filenames = ブール値;
このフィールドは、ファイル名にシェルが含まれないように制限するために使用できます。
特殊文字。 デフォルトは true 設定されていない場合。 このフィールドが次のように設定されている場合、 false,
あなたは使用する必要があります ${引用} コマンド内のファイル名の置換、
シェル特殊文字を含むファイル名に意図しない文字が含まれていないことを確認します。
副作用。 ファイル名に奇妙な文字が含まれていると依存関係が混乱する可能性もあります
メンテナンスツール。

allow_white_space_in_filenames = ブール値;
このフィールドは、ファイル名に空白文字を使用できるようにするために使用できます。 この意志
ファイル名に次の文字を使用できるようにします: バックスペース (BS、\b、0x08)、
水平タブ (HT、\t、0x09)、改行 (NL、\n、0x0A)、垂直タブ (VT、\v、
0x0B)、フォーム フィード (FF、\f、0x0C)、およびキャリッジ リターン (CR、\r、0x0D)。 デフォルトは
設定されていない場合は false。

このフィールドは他のファイル名フィルターをオーバーライドしないことに注意してください。 そうなる
明示的に設定する必要がある シェル_セーフ_ファイル名 = false 同じように。 そうなる
設定する必要があります dos_ファイル名_必須 = false (デフォルト)も同様です。 そうなる
設定する必要があります posix_filename_charset = false (デフォルト)も同様です。

ユーザーは、すべてのファイルで ${quote} 置換を使用するように細心の注意を払う必要があります。
プロジェクト設定のコマンド内の名前。 そしてそれでも、交代
スペースで区切られたファイル名のリストを想定している場合、結果は未定義になります。

allow_non_ascii_filenames = ブール値;
このフィールドは、ASCII で印刷できない文字を含むファイル名を許可するために使用できます。
彼ら。 通常、これは UTF8 またはある種の国際文字セットを意味します。
設定されていない場合、デフォルトは false になります。

このフィールドは他のファイル名フィルターをオーバーライドしないことに注意してください。 そうなる
明示的に設定する必要がある シェル_セーフ_ファイル名 = false 同じように。 そうなる
設定する必要があります dos_ファイル名_必須 = false (デフォルト)も同様です。 そうなる
設定する必要があります posix_filename_charset = false (デフォルト)も同様です。

filename_pattern_accept = [文字列];
このフィールドは、許容されるファイル名のパターンのリストを指定するために使用されます。
設定されていない場合のデフォルトは「*」です。

ファイル名_パターン_拒否 = [文字列];
このフィールドは、受け入れられないファイル名のパターンのリストを指定するために使用されます。

お困りの方は 注： Aegis はまた、基礎となるファイル システムを参照して、その概念を決定します。
最大ファイルサイズ。 ファイルシステムの最大ファイルサイズが以下の場合
最大ファイル名の長さ、ファイルシステムが勝ちます。 これは、たとえば、次のような場合に発生する可能性があります。
Linux UMSDOS ファイル システムを使用するか、NFS が古い V7 をマウントしている場合
ファイルシステム。 設定 最大ファイル名の長さ この場合、255 に変更しても、
実際、基礎となるファイル システムの制限ははるかに小さい (それぞれ 12 と 14)。

開発ディレクトリ (またはプロジェクト全体) が次のファイル名を持つファイルシステム上にある場合
制限があるか、異種ビルドの一部がそのような環境で行われる場合、
Aegis が何であるかを伝えるのに役立ちます (プロジェクトを使用) 設定 ファイルのフィールド)
プロジェクトがより寛容な環境に基づいて構築される状況に遭遇しないようにする
ただし、より制限された環境では不可解なエラーが発生して失敗します。

開発ディレクトリが日常的に Linux UMSDOS ファイルシステム上にある場合は、次のようにします。
おそらく設定した方が良いでしょう dos_ファイル名_必須 = true、また、
開発ディレクトリのテンプレート 分野。 さまざまなWindowsによるヘテロジニアス開発
環境によってはこれが必要になる場合もあります。

File 名前 解釈
aegisプログラムは、ファイル名からプロジェクトファイル名を判別しようとします。
コマンドラインで指定します。 すべてのファイル名は、相対的なものとしてaegisプロジェクト内に保存されます
ベースラインディレクトリツリーのルートに移動します。 開発ディレクトリと
統合ディレクトリはこのベースラインディレクトリの影であるため、これらの相対名
こちらもお申し込みください。 コマンドラインで指定されたファイルは、最初に絶対パスに変換されます
必要であれば。 次に、それらはベースラインパスである開発ディレクトリと比較されます。
パス、およびベースライン相対名を決定するための統合ディレクトリパス。 です
指定されたファイルがこれらのディレクトリツリーのいずれかの外にある場合はエラーになります。

　 -BAse_RElative オプションを使用すると、相対ファイル名を次のように解釈できます。
ベースラインパスを基準にしています。 絶対ファイル名は引き続きさまざまなファイル名と比較されます
ベースライン相対名を決定するためのパス。

　 Relative_filename_preference ユーザー構成ファイルで変更するために使用される場合があります
このデフォルトの動作。 見る aeuconf（5）詳細については。

を変える、 　 タイプ of a File
ファイルの種類を変更する場合（たとえば、テストからソースファイルに、または バイス
その逆）最初に使用することにより、XNUMXつの変更としてそれを行うことができます アーム（1）XNUMX回の変更で
アーエンフ（1）または えんと（1）XNUMX番目の変更で、または同じで両方のステップを組み合わせることができます
変化する。 を使用することを忘れないでください アーム -ノーホワイトアウト オプションまたはあなたは最も独特な新しいを取得します
ファイルテンプレート。

File Action 調整
このコマンドを実行すると、最初に変更ファイルがプロジェクトファイルと照合されます。 もしも
不整合がある場合、ファイルアクションは次のように調整されます。

createファイルが作成されているが、別の変更セットが統合されている場合。
ファイルを作成します。まだ開発中の変更セットのファイルアクションは次のようになります。
「変更」に調整。

変更ファイルが変更されているが、削除する別の変更セットが統合されている場合
ファイル、まだ開発中の変更セットのファイルアクションは
「作成」に調整。

removeファイルが削除されているが、削除する別の変更セットが統合されている場合
ファイルの場合、ファイルはまだ開発中の変更セットから削除されます。

通知ですよ
　 新しいファイルコマンド 設定されている場合、プロジェクト構成ファイルで実行されます。 The 事業_-
ファイルコマンド 設定されている場合、および最近統合が行われた場合にも実行されます。 見る
aepconf（5）詳細については。

テスト 相関関係

「aegis -Test -SUGgest」コマンドは、aegis に適切な回帰を提案させるために使用できます。
変更内のソース ファイルに基づいて、変更をテストします。 これは自動的に
テスト作業を関連テストに集中させ、回帰テストの数を削減します。
バグが持ち込まれていないことを確信する必要があります。

テスト相関は「aegis -Integrate_Pass」コマンドによって生成されます。
変更内の各テストを変更内の各ソース ファイルに関連付けます。 したがって、それぞれの
ソース ファイルには、過去に関連付けられたテストのリストが蓄積されます。
これはコード カバレッジ分析ほど正確ではありませんが、妥当な近似値です。
練習。

　 acp（1）と アーエンフ(1) コマンドは、ファイルを変更に関連付けるために使用されます。 彼らがいる間、
積極的に関連付けを実行しません。これらは、によって使用されるファイルです。 アイパス（1）と
食べる(1) どのソース ファイルがどのテストに関連付けられているかを判断します。

ホイール試乗 相関 正確さ
テストの相関関係が正確で、テストが均等であると仮定します。
関数空間全体に分散すると、 1/数値 チャンスがある
関連するテストは「aegis -Test -SUGgest」によって実行されていません 数" 指図。 小さな
テストの重み付けにノイズが追加されるため、予期しないことが発生することがあります。
同じテストが毎回実行されるわけではありません。

テスト相関の精度は、以下を確保することで向上できます。

· それぞれの変更は、不必要なファイルを含めることなく、重点を置く必要があります。 これ
偽の相関関係を回避します。

· 新しい機能の各項目は、個別の変更として追加する必要があります。
いくつか一緒に。 これにより、テストと機能が強く相関します。

· 各バグは、複数の変更をまとめて修正するのではなく、個別の変更で修正する必要があります。 これ
テストと機能には強い相関関係があります。

· ファイルを移動すると、テストの相関関係が失われます。 これは、相関関係が
名前。

テストがソース ファイルと正確に関連付けられる最善の方法は、変更が加えられたときです。
テストと、テスト対象の機能に関連する正確なファイルが含まれています。 それも
偽のファイルが多数あると、相関関係のテストの有用性が弱まります。

OPTIONS

次のオプションが理解されます

-建てる
このオプションは、ビルド中にファイルが構築されることを指定するために使用できます。
（多くの場合、統合ビルドのみ）その履歴が保持されるようにします。 これは
生成されたファイルの履歴が保存されるパッチ ファイルの生成に役立ちます。
重要。 この方法で作成されたファイルは、変更内容にコピーできない場合がありますが、
それらは削除される可能性があります。 可能な限り、このタイプのファイルの使用は避けてください。

-BAse_RElative
このオプションを使用すると、相対ファイル名が相対ファイル名と見なされるようになります。
ソースツリーのベース。 見る aeuconf（5）対応するユーザーの場合
好み。

-CURRENT_RElative
このオプションを使用すると、相対ファイル名が相対ファイル名と見なされるようになります。
現在のディレクトリ。 これは通常、デフォルトです。 見る aeuconf（5）
対応するユーザー設定。

-変化する 数
このオプションは、プロジェクト内の特定の変更を指定するために使用できます。 見る
イージス（1）このオプションの完全な説明。

-設定済み
このオプションは、ファイルが Aegis プロジェクトであることを指定するために使用できます。
設定ファイル。 デフォルトのプロジェクト構成ファイルは次のように呼ばれます。 イージス.conf,
ただし、任意のファイル名を使用できます。 複数のファイルを使用することもできます。
コンテンツを複数のファイルに分割します。すべてのファイルがこのタイプである必要があります。

-ヘルプ
このオプションは、使用方法に関する詳細情報を取得するために使用できます。 イージス
プログラム。

-保つ
このオプションは、通常削除されるファイルやディレクトリを保持するために使用できます。
コマンドに置き換えられました。 デフォルトはユーザーのものです 削除ファイルの設定 そうでなければ
指定、参照 aeuconf（5）詳細については。

-No_Keep
このオプションは、ファイルやディレクトリが確実に削除されるようにするために使用できます。
またはコマンドに置き換えられます。 デフォルトはユーザーのものです 削除ファイルの設定 そうでなければ
指定、参照 aeuconf（5）詳細については。

-リスト
このオプションは、このコマンドに適したサブジェクトのリストを取得するために使用できます。
リストは予想よりも一般的かもしれません。

-Not_Logging
このオプションは、出力とエラーの自動ログを無効にするために使用できます。
ファイル。 これは、複数のaegisコマンドがシェルで組み合わされている場合に便利です。
スクリプト。

-事業 名
このオプションは、関心のあるプロジェクトを選択するために使用できます。 いいえの場合 -事業
オプションが指定されている場合、 AEGIS_PROJECT 環境変数が参照されます。 もしも
それは存在しません、ユーザーの $ HOME / .aegisrc ファイルはデフォルトで検査されます
プロジェクトフィールド（を参照） aeuconf（5）詳細については）。 それが存在しない場合は、
ユーザーが単一のプロジェクト内の変更のみに取り組んでいる場合、プロジェクト
nameのデフォルトはそのプロジェクトです。 それ以外の場合はエラーです。

-テンプレート
このオプションは、新しいファイル テンプレートを使用することを指定するために使用できます。
ファイルがすでに存在する場合。

-No_TEMplate
このオプションは、新しいファイル テンプレートを使用しないことを指定するために使用できます。
ファイルが存在しない場合でも（空のファイルが作成されます）。

-簡潔
このオプションを使用して、リストに最低限の
情報。 これは通常、シェルスクリプトに役立ちます。

-詳細
このオプションは、aegisがより多くの出力を生成するようにするために使用できます。 デフォルトではイージス
エラー時にのみ出力を生成します。 と一緒に使用する場合 -リスト オプションこのオプション
列見出しが追加されます。

-待って このオプションは、アクセスロックを待機するようにAegisコマンドを要求するために使用できます。
すぐに入手することはできません。 デフォルトはユーザーのものです ロック待機設定
指定されていない場合は、を参照してください。 aeuconf（5）詳細については。

-いいえ_お待ちください
このオプションは、アクセス時に致命的なエラーを発行するようにAegisコマンドを要求するために使用できます
ロックをすぐに取得することはできません。 デフォルトはユーザーのものです
ロック待機設定 指定されていない場合は、を参照してください。 aeuconf（5）詳細については。

参照 イージス（1）すべてのaegisコマンドに共通のオプション。

すべてのオプションは省略できます。 略語は大文字として文書化されていますが、
すべての小文字とアンダースコア（_）はオプションです。 連続して使用する必要があります
オプションの文字のシーケンス。

すべてのオプションでは大文字と小文字が区別されません。大文字または小文字、あるいは
両方の組み合わせ、ケースは重要ではありません。

例：引数「-project」、「-PROJ」、「-p」はすべて、
-事業 オプション。 引数「-prj」は連続しているため理解できません
オプションの文字は提供されませんでした。

オプションおよびその他のコマンドライン引数は、コマンドラインで任意に混在させることができます。
関数セレクターの後。

GNUの長いオプション名は理解されています。 すべてのオプション名が イージス 長いです、
これは、余分な先頭の「-」を無視することを意味します。 NS "--オプション=値「コンベンションも
理解した。

推奨 ALIAS

このコマンドの推奨エイリアスは次のとおりです。
csh% エイリアス aenf 'aegis -nf \!* -v'
sh$ aenf(){aegis -nf "$@" -v}

エラー

変更が含まれていない場合はエラーです さ 発展した でのみ停止させることができます。
変更が現在のユーザーに割り当てられていない場合はエラーになります。
ファイルがすでに変更の一部である場合はエラーです。
ファイルがすでにベースラインの一部である場合、エラーになります。
コマンドラインで指定したファイルが通常のファイルではなく、
ディレクトリ。 (シンボリック リンクまたは特殊ファイルが必要な場合は、ビルド時に作成します。)

EXIT ステータス

　 イージス コマンドは、エラーが発生するとステータス1で終了します。 NS イージス コマンドはのみ
エラーがない場合は、ステータス0で終了します。

ENVIRONMENT 変数

見る イージス（1）このコマンドに影響を与える可能性のある環境変数のリスト。 見る
aepconf（5）プロジェクト構成ファイルの場合 プロジェクト固有 設定方法のフィールド
Aegisによって実行されるすべてのコマンドの環境変数。

onworks.net サービスを使用してオンラインで aenf を使用する