critcl - クラウドでオンライン

プログラム：

NAME

critcl - CriTcl アプリケーション

SYNOPSIS

クリティカル ?オプション...？ ?file...？

_________________________________________________________________

DESCRIPTION

ようこそ C ランタイム In Tcl, 臨界点 略して、C拡張パッケージを構築するシステム
Tclスクリプトに埋め込まれたCコードから、オンザフライでTclを作成したいすべての人のために
彼らのコードはより速くなります。

このドキュメントは、 クリティカル 指図。 その対象読者は
を使用してパッケージをビルドする必要がある人々 クリティカル 展開用。 を含むパッケージの作成者
埋め込まれた C コードは、このドキュメントを無視できます。 全体の概要が必要な場合
システムの代わりに、行って読んでください 概要 に 臨界点.

このアプリケーションは、CriTcl のアプリケーション層にあります。

*================*
|アプリケーション |
| | クリティカル |
| | クリティカル::アプリ |
*================*

+----------------+
|コアパッケージ |
| | クリティカル |
| | クリティカル::ユーティリティ |
+----------------+

+----------------+
|サポートパッケージ|
| | スタブ::* |
| | MD5、プラットフォーム |
| | ... |
+----------------+

アプリケーションは、次の一般的なコマンド ラインをサポートしています。

クリティカル ?オプション...？ ?file...？
サポートされているオプションの正確なセット、その意味、および相互作用については、
申し込み オプション 下。 より多くの例については、セクションを参照してください
に関するドキュメントの「Building Critcl Packages」 使い方 臨界点.

お申込み OPTIONS

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

-v

- バージョン
これらのオプションにより、critcl はそのバージョンを (Linuxで言うところのstdout） そして終了します。

-I path
このオプションは、コンパイル中に使用する追加のグローバル インクルード パスを指定します。
の.critcl" ファイル。これが複数回指定されている場合は、すべての値が使用されます。

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 下）。

-L path
このオプションは、リンク中に使用する追加のグローバル ライブラリ検索パスを指定します。
の.critcl" ファイル。これが複数回指定されている場合は、すべての値が使用されます。

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 下）。

-キャッシュ path
このオプションは、結果キャッシュとして使用するディレクトリへのパスを指定します。 そうでない場合
デフォルトは "〜/.critcl/"、または、パッケージの生成時 (を参照)
オプション -パッケージ 以下）、「〜/.critcl/.」を複数回指定すると、
最後の値が使用されます。

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 下）。

-クリーン 指定すると、結果キャッシュが空になります。つまり、見つかったすべてのファイルとディレクトリが空になります。
内部は削除されます) コンパイルが始まる前に。

このオプションは、パッケージの生成時には関係ありません (オプションを参照してください)。 -パッケージ 以下）なぜなら
このモードは、一意で空の結果キャッシュから始まります。

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 下）。

-config path
このオプションは、カスタム構成ファイルへのパスを指定します。
独自のターゲット仕様を使用します。 指定されていない場合は、ハードワイヤードのデフォルト
代わりに、システム コアに組み込まれた構成が使用されます。 複数指定時
回最後の値が使用されます。

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 下）。

-デバッグ モード
このオプションは、デバッグを伴うコンパイルをアクティブにします。 以下のモードを受け入れます。 いつ
複数回指定すると、すべてのモードの組み合わせが使用されます。

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 下）。

メモリ このモードは、Tcl を介して行われた割り当てのメモリ デバッグをアクティブにします。
芯。

を示すマークを追加しました
このモードは、すべての建物をアクティブにします」.c" デバッグ シンボルを含むファイル。

を このモードは両方をアクティブにします メモリ & を示すマークを追加しました.

-無効にする 名
このオプションは、カスタム ビルド構成オプションの値を設定します 名 〜へ false.
「-with-」と同等です名 0」。

情報は、次のいずれかの場合にのみ検証されます。.critcl" 実際に入力ファイル
カスタムビルド構成オプションを定義して使用します 名.

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 下）。

-有効 名
このオプションは、カスタム ビルド構成オプションの値を設定します 名 〜へ true.
「-with-」と同等です名 1」。

情報は、次のいずれかの場合にのみ検証されます。.critcl" 実際に入力ファイル
カスタムビルド構成オプションを定義して使用します 名.

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 下）。

-力 ファイルの共有ライブラリであっても、指定されたコンパイルが常に行われる場合
すでに存在します。 この効果は、次のようにキャッシュを消去することで実現できます (上記を参照)。
ただし、ファイルの破棄は怠惰であり、ファイルを破棄しません。
私たちが構築しているものとは無関係です。

このオプションは、パッケージの生成時には関係ありません (オプションを参照してください)。 -パッケージ 以下）なぜなら
このモードは、一意で空の結果キャッシュから始まります。

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 下）。

-助けて このオプションにより、システムはコマンド ライン構文に関する短いヘルプを出力します。
およびオプションを選択してから、アプリケーションを終了します。

-保つ このオプションにより、システムは「.c" での実行によって生成されたファイル
結果キャッシュ。 パッケージの生成時 (オプションを参照) -パッケージ 以下）これも防止します
実行で使用された一意の結果キャッシュの削除。 このオプションは意図されたものです
のデバッグ用 クリティカル 検査が必要な場合があります。
生成された C コード。

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 下）。

-libdir path
このオプションは、オプションで生成されたパッケージのパスを指定します -パッケージ
保存されます。 また、次のように、ライブラリを検索するためのパスも指定します -L。 時
複数回指定された場合、最後の値が使用されます。 特に指定がない場合は、
デフォルト、 "リブ"、が使用されます。これが相対パスであることに注意してください。結果は次の場所に配置されます。
現在の作業ディレクトリ。

-includeir path
このオプションは、生成されたパッケージ ヘッダーが保存されるパスを指定します。
また、インクルード ファイルを検索するパスも指定します。 -I. 指定時
複数回、最後の値が宛先として使用されますが、以前の値はすべて
インクルード検索パスに保持されます。 何も指定しない場合はデフォルトで、
"include"、が使用されます。これが相対パスであることに注意してください。結果は
現在の作業ディレクトリ。

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 下）。

-パッケージ アプリケーションのデフォルト モードは、".critcl" にリストされているファイル
コマンド ラインで実行し、結果キャッシュに結果を保存します。 基本的に、
重要なパッケージをキャッシュして、これらを使用するのに必要な時間を短縮します
パッケージ。

このオプションは、他のモードの XNUMX つであるパッケージ生成を有効にします。 このモードでは、
入力ファイルは通常どおり最初に処理されますが、その後はバンドルされます
単一のライブラリと追加のファイルが生成され、このライブラリを次のように使用できるようになります
通常の Tcl パッケージ。

オプション -お茶、以下を参照して、最後のモードである TEA 生成を呼び出します。 両方のオプションの場合、
すなわち -パッケージ & -お茶 最後に指定されたものが勝ちます。

このモードでは、オプション -クリーン & -力 は無関係であり、無視されます。 対照的に、
オプション -libdir これと -お茶 モード。

このオプションが指定されている場合、引数の後の最初のファイル引数のベース名
options は、生成するパッケージの名前として使用されます。 その延長なら
file は共有ライブラリを示します ("。そう"".sl"".dylib"、および"のDLL"） それも
入力ファイルのセットから削除されました。 あ」.tcl" ファイルは入力の一部として保持されます。
拡張子のない単一のファイルは、実際には「.tcl"拡張子。A
拡張子のないファイルですが、後続の他の入力ファイルはの名前のように扱われます
適切な共有ライブラリであり、入力ファイルのセットから削除されます。

例：
=> パッケージ名: foo
=> 入力ファイル: foo.tcl
=> パッケージ名: foo
=> 入力ファイルは: bar.tcl
=> パッケージ名: foo
=> 入力ファイル: foo.tcl
=> パッケージ名: foo
=> 入力ファイルは: bar.tcl

-公演 このオプションが指定されている場合、システムはの構成を出力します。
選択されたターゲット (Linuxで言うところのstdout） そして終了します。 ターゲットの選択は影響を受ける可能性があります
オプションを通して -目標 （下記参照）。

-すべて表示する
このオプションを指定すると、システムは選択した全体を印刷します。
構成ファイルから (Linuxで言うところのstdout） そして終了します。 構成ファイルの選択により、
オプションによって影響を受ける -config （上記を参照）。

-目標 名
このオプションは、ビルド ターゲットのデフォルトの選択をユーザーの選択で上書きします。
複数回指定すると、最後の値が使用されます。 名前付きターゲットが存在する必要があります
選択した構成ファイルで。 オプションを使用 -ターゲット (下記参照) のリストを取得する
許容可能なターゲット。 構成ファイルの選択は、
オプション -config （上記を参照）。

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 下）。

-ターゲット
このオプションを指定すると、システムは既知のすべてのリストを出力します。
選択した構成ファイルからのターゲット (Linuxで言うところのstdout） そして終了します。 の選択
設定ファイルは、オプションによって影響を受ける可能性があります -config （上記を参照）。

-お茶 オプションに類似 -パッケージただし、呼び出されたモードはバイナリを生成しません。
しかし、".critcl" ファイル、そのコンパニオン ファイル、および
必要なサポート コードのほとんどを備えた TEA に似たビルド システム (コピーを含む)
critcl パッケージの)。

両方のオプションの場合、つまり -パッケージ & -お茶 最後に指定されたものが勝ちます。

このモードでは、オプション -I, -L, -クリーン, -力, -キャッシュ, -includeir, -有効,
-無効にする, -FOO付き は無関係であり、無視されます。 対照的に、オプション -libdir
これと -パッケージ モード。

このオプションが指定されている場合、引数の後の最初のファイル引数のベース名
options は、生成するパッケージの名前として使用されます。 その延長なら
file は共有ライブラリを示します ("。そう"".sl"".dylib"、および"のDLL"） それも
入力ファイルのセットから削除されました。 あ」.tcl" ファイルは入力の一部として保持されます。
拡張子のない単一のファイルは、実際には「.tcl"拡張子。A
拡張子のないファイルですが、後続の他の入力ファイルはの名前のように扱われます
適切な共有ライブラリであり、入力ファイルのセットから削除されます。

例：
=> パッケージ名: foo
=> 入力ファイル: foo.tcl
=> パッケージ名: foo
=> 入力ファイルは: bar.tcl
=> パッケージ名: foo
=> 入力ファイル: foo.tcl
=> パッケージ名: foo
=> 入力ファイルは: bar.tcl

-名前付き 値
このオプションは、カスタム ビルド構成オプションの値を設定します 名 〜へ 値.

情報は、次のいずれかの場合にのみ検証されます。.critcl" 実際に入力ファイル
カスタムビルド構成オプションを定義して使用します 名.

このオプションは、TEA パッケージの生成時には関係ありません (オプションを参照)。 -お茶 上記）。

PACKAGE 構造

critcl によって生成されたパッケージには、次の基本構造があります。

+- pkgIndex.tcl
+- クリティカル-rt.tcl
+- license.terms (オプション)
|
+- tcl (オプション)
| | +-
|
+-
+-

ノート

[1]ファイル「pkgIndex.tcl" は、Tcl が期待する標準パッケージ インデックス ファイルです。
パッケージ管理。 パッケージの検索中に供給され、
ファイルとともに Tcl にパッケージ化し、それらを処理する方法を説明します。

[2]ファイル「critcl-rt.tcl" は、によって使用される共通コードを含むヘルパー ファイルです。
"pkgIndex.tcl" タスクを実行します。

[3]ファイル「ライセンス条項" はオプションで、".critcl" ファイル
パッケージは使用されたコマンドから生成されます クリティカル::ライセンス パッケージを宣言する
作者とライセンス。

[4] コマンドで宣言されたすべてのファイル critcl::tソース サブディレクトリに配置されます
"TCL".

[5] critcl によって生成された共有ライブラリは、プラットフォーム固有のサブ
ディレクトリにあります。

全体の構造、特に最後のポイントにより、後で結果をマージできます
(同じパッケージとバージョン) 複数のターゲット プラットフォームを XNUMX つのディレクトリに
トップディレクトリを相互にコピーするだけで、競合のない構造になります。 の
競合する可能性のあるファイルのみがと "TCL" ディレクトリであり、これらについては
それらがターゲット間で同一であることを知っています。 このようなマージの結果は次のようになります。

+- pkgIndex.tcl
+- クリティカル-rt.tcl
+- license.terms (オプション)
|
+- tcl (オプション)
| | +-
|
+-
| | +-
+-
| | +-
+-
+-

CHANGES FOR VERSION 2.1

[1] バグ修正 critcl::tソース 相対パスを
相対ではなく、現在の作業ディレクトリ ".critcl" ファイルを使用して
このタイプの他のすべてのコマンドと同様に、コマンド。

[2] 内部を修正し、複数の ".critcl" ファイルへ
それらの間で漏れます。 特に、 クリティカル::tk はグローバル構成オプションではありません
もう。

[3]コマンド修正 クリティカル::ライセンス モード「コンパイル＆実行」でヌル操作になる、
エラーをスローする代わりに。

[4] 「コンパイル & 実行」結果キャッシュに対する critcl アプリケーションの干渉を修正しました。
in -パッケージ 完全に別の（デフォルトでは一時的な）モードを使用することにより、モード
そのモードのディレクトリ。

[5] に変更されるバグを修正.critcl" ファイルはモードの再構築に至りませんでした
「コンパイルして実行」。 関連するすべての API コマンドで、UUID の変更が保証されるようになりました。

[6] のバックエンド処理のバグを修正 クリティカル::デバッグ のコンパニオン c ソース
「.critcl" ファイルはデバッグ オプション付きでコンパイルされませんでしたが、".critcl" ファイル
ありました。

[7] バグ修正 クリティカル::デバッグ モード「すべて」の認識を妨げた
コマンドの最初の引数ではありません。

[8] バグ修正プリロード.c" 非 Windows プラットフォームでのコンパイルを妨げます。

[9] コマンド名の名前空間修飾子の処理における長年のバグを修正
の引数 critcl::cproc & critcl::cコマンド. 指定できるようになりました
問題のない完全修飾コマンド名。

[10] 拡張/再加工 critcl::tソース "を宣言する標準的な方法であること.tcl"
コンパニオン ファイルは、「コンパイル & 実行」モードでも使用できます。

[11] 拡張/再加工 critcl::tソース "の使用を許可する.critcl" ファイルを独自のものとして
Tcl コンパニオン ファイル。

[12]拡張 クリティカル::フレームワーク OS X ビルド ターゲットを内部的にチェックし、無視する
そうでない場合の宣言。

[13]拡張 クリティカル::失敗 " で複数回呼び出せるようにする.critcl"ファイル。
最初の呼び出しは、ビルドがまだ行われていない場合は強制的に結果を取得します。 さらに遠く
呼び出しは、最初の呼び出しのキャッシュされた結果を返します。

[14] 環境変数 CC の扱いを決定するコードに拡張
コンパイラ、コンパイラ ファイルへのパスの処理 (つまり、削除) に使用するコンパイラ
拡張子、およびコンパイラ自体の後に指定されたコンパイラ オプション。
コンパイラの素の名前。

[15] プリロードされたライブラリの検索を処理するコードを拡張して、そのパスを出力します。
これにより、検索失敗のデバッグが容易になります。

[16] 新しいコマンド クリティカル::tcl Tclのバージョンを最小限に宣言するために使用できます
"をビルドして実行する必要があります.critcl" ファイルとパッケージ。そうでない場合のデフォルトは 8.4
宣言した。 すべての Tcl 8.4、8.5、
と8.6。

[17] 新しいコマンド クリティカル::ロード " のビルドとロードを強制します.critcl"ファイル。これは
Critcl のデフォルトの lazy-build-&-load-on-demand スキームをオーバーライドする公式の方法
モード「コンパイル＆実行」用。

Note 使った後のこと クリティカル::ロード / クリティカル::失敗 "で.critcl"ファイルではない
そのファイルで critcl コマンドを使用できなくなりました。 これを行うと、エラーがスローされます。

[18] 使用する「#line」プラグマの生成を拡張 info フレーム （利用可能な場合）～
C コンパイラに正確な行番号を ".critcl" ファイル
警告とエラーの報告。

[19]拡張 クリティカル::チェック のビルド時のチェックをデバッグするのに役立つロギング
環境に加えて、ラベル付けを提供する追加のオプションの引数。

[20] 新しいコマンドを追加 critcl::checklink 環境をチェックしようとするだけでなく、
コードのコンパイルだけでなく、そのリンク可能性も。

[21] 新しいコマンドを追加 クリティカル::メッセージ コマンドなどのメッセージング用 クリティカル::エラー ためのものです
エラー報告。 同様に、これはパッケージのユーザーが許可されているフックです
オーバーライド。 モードで使用されるデフォルトの実装 コンパイル & ラン 何もしません。 の
モードの実装 生成する パッケージ メッセージを標準出力に出力します。

想定される使用は、によって決定された結果の報告のためです。 クリティカル::チェック &
critcl::checklink ビルド中、問題が発生した場合のデバッグに役立ちます
小切手付き。

[22] の引数処理の内部を公開 critcl::proc 上級者向け
ユーザー。 新しいコマンドは

【1] クリティカル::引数名

【2] critcl::argcnames

【3] critcl::argcsignature

【4] critcl::argvardecls

【5] critcl::argconversion

セクションをご覧ください 高機能 組み込み C Code クリティカル のパッケージドキュメント
詳細。

[23] critcl パッケージをインターセプトに拡張 パッケージ 提供します ファイルを記録します->
パッケージ名のマッピング。 さらに、その他の内部変更により、名前空間を使用できるようになりました
適切なパス名と init 関数を使用しながらパッケージ名を変更します。

[24] 未使用コマンドを削除 クリティカル::最適化 & クリティカル::インクルード.

[25] 落とした -lib Critcl アプリケーションからのモード。

[26] Tcl 8.3 以前のサポートの残りを削除しました。

CHANGES FOR VERSION 3

[1] コマンド クリティカル::プラットフォーム バージョン 2.1 で非推奨となり、
クリティカル::ターゲットプラットフォーム、互換性のために保持されています。 現在は削除されています。

[2] コマンド Critcl::コンパイル済み バージョン 2.1 で保持され、セマンティクスは
互換性のために、その矛盾。 この矛盾が解消され、
コマンドの目に見えるセマンティクスをその名前に合わせて変更します。

[3] バージョン 3 への変更が必要になったのは、XNUMX つの互換性のない表示があったためです。
上に変更します。

[4] 新しいオプションを処理するコードでアプリケーション パッケージを拡張 -お茶。 指定する
このオプションは、critcl が TEA パッケージを生成する、つまりラップする特別なモードを呼び出します。
ディレクトリ階層への入力とそれを提供するサポート ファイル
そっくりなビルドシステム。

この新しいオプションと、 -パッケージ、お互いを除外します。 両方が指定されている場合は、最後に使用されたもの
オプションが優先されます。

生成されたパッケージ ディレクトリ階層は、ほとんど自己完結型ですが、完全ではありません。
Tcl の動作するインストールだけでなく、動作するインストールも必要です。
パッケージの md5 & コマンドライン. これらは両方ともによって提供されます Tcllib バンドル。
必須ではありませんが、インストールすることをお勧めします。
md5 の動作を高速化します。 クリプトキット, tclibcまたは トフ.

[5] 新しいコマンドで critcl パッケージを拡張 クリティカル::スキャン への道をたどる
".critcl" ファイルを静的にスキャンし、ライセンス、バージョン、リストを返します
関連ファイル、インポートされた API のリスト、開発者が指定したカスタムのリスト
構成オプション。 このデータは、説明されている TEA ラッピングの基礎です。
上記。

これはペイロードのない 静的な スキャン。 他のビルド モードでは、
".critcl" ファイルを作成し、アセンブルされた C コードに関してプラットフォーム固有の決定を行います。
コンパニオン ファイルなど。TEA ラップ モードはプラットフォームを作成する立場にありません。
具体的な決定。 必要と思われるものすべてをラップする必要があります
実際に建てるとき。 したがって、静的スキャン。 ただし、これには独自のセットがあります
問題、すなわち、コンパニオンの動的構造を把握できないこと
ファイルパス、少なくともそれ自体。 したがって：

[6] コマンドを使用して、critcl ベースのパッケージで使用される API を拡張しました critcl::所有者。 同時に
このコマンドは、静的スキャナーで説明されている通常のビルド モードでは無視されます。
上記は、ラップする必要があるコンパニオン ファイルの名前として引数を取ります
TEA パッケージに含まれており、それ以外の場合はスキャナーで把握できませんでした。
への動的パスのため critcl::tソース, クリティカル::ソース、調達する
直接、または単に付属のデータファイルです。

[7] コマンドを使用して、critcl ベースのパッケージで使用される API を拡張しました critcl::api
スタブ テーブルの管理、その使用、および/または宣言とエクスポート。

セクションをご覧ください スタブ 表 マネジメント クリティカル のパッケージドキュメント
詳細。

[8] コマンドを使用して、critcl ベースのパッケージで使用される API を拡張しました critcl::userconfig
開発者が指定したカスタム構成オプションの管理用
使用および/または宣言。

セクションをご覧ください カスタム 完成に向けてあなたの背中を押してくれる、執筆のための持続可能で本物のモーメンタムを作り出す。 　 クリティカル パッケージドキュメント
詳細については。

[9] コマンドを使用して、critcl ベースのパッケージで使用される API を拡張しました
クリティカル::説明, クリティカル::概要, クリティカル::件名, クリティカル::メタ,
クリティカル::ビルド要件 に関する/に関するTEApotメタデータの宣言用
パッケージ。

セクションをご覧ください パッケージ Meta 且つ クリティカル のパッケージドキュメント
詳細。

CHANGES FOR VERSION 3.0.1

[1] あちこちのバグ修正。 詳細に：

[2] Tcl バージョン要件の記録を修正。 パッケージ名とバージョンを保持する
一緒に、生成されたメタデータと生成されたパッケージロードコマンドを解読します。

[3] ビルド スクリプトの修正: TEA のインストールまたはラッピング時に、不足しているスクリプトを生成
ディレクトリ

[4] ウィンドウが開いたときにアプリケーションを適切に終了するようにビルド スクリプトを修正しました。
GUI は (X) ボタンで閉じます。

[5] メイン ビルド スクリプトに組み込まれていた 8.5-ism (open wb) を削除しました。

[6] サンプル ビルド スクリプトを変更して、出力を異なるものに分けました。
空行を追加して例 (およびパッケージ) を追加します。

[7] stack::c の例のバグ修正: コンパニオン ファイルで使用する API 宣言を含めます。

[8] ドキュメントの拡張: C の作業インストールの必要性を指摘
コンパイラ。

[9] 使用されるマニフェスト ファイルを処理するために Windows ターゲット定義とコードを拡張
最新の MS 開発環境によって。 このコードは両方を処理することに注意してください
可能性、マニフェストを使用する環境、およびマニフェストを使用しない (より古い) 環境。

[10] Windows 64 ビット ターゲットの定義とコードを拡張して、
ヘルパー ライブラリ "bufferoverflowU.lib" をコンパイルしてリンクを再構成する
適当に命令。 ライブラリが存在する場合は、リンクする必要があると想定しています。
ライブラリが存在するが必要でない場合、これは害にはなりません。 ただ余分です。
環境変数 LIB で指定されたパスでライブラリを検索します。

CHANGES FOR VERSION 3.0.2

[1] auto_index に配置されたコマンドがコンパイル アンド ラン モードで実行されない問題を修正しました。
Tcl の [unknown] コマンドで見つかりました。

[2] 配列キーの不一致により、クライアント データと削除機能の使用が中断される問題を修正しました。
手順。 Jos DeCoster による報告、パッチ付き。

[3] コマンドラインオプションを実装 -L、オプションと同等 -I、ライブラリのみ
検索パス。

[4] github の問題 5 と 8 を修正しました。不足している変数 ::errorInfo を回避します。 これ
常に存在する必要がありますが、Tcl のリビジョンがあるようです。
この仮定に違反します。

CHANGES FOR VERSION 3.0.3

[1] build.tcl スクリプトの例について、github の問題 5 と 8 を修正しました。 周りの作業
変数 ::errorInfo がありません。 常に存在する必要がありますが、あるようです
この仮定に違反する Tcl のリビジョン。

CHANGES FOR VERSION 3.0.4

[1] 受信コードが読み込まれるときのパッケージの initname の生成を修正しました
stdin であり、適切なパスがありません。

[2] github の問題 11 を修正しました。現在、Windows では -L の代わりに /LIBPATH を使用しています (libinclude
構成設定)。

[3] -l オプションの -l:path 形式を処理するように critcl を拡張しました。 GNU ld 2.22+ はこれを処理します
パスをそのまま検索します。 プレーンな -l として静的ライブラリを指定する場合に適しています
静的よりも優先して共有ライブラリを探します。 critcl は現在、次のように処理します。
古い GNU ld はそれを理解していませんし、さまざまなベンダー固有のリンカも理解していません。

[4] github の問題 #12 を修正しました。 Critcl は現在、使用中の MSVC のバージョンを判別し、
さまざまなリンク デバッグ オプションを切り替えます。 の取り扱いを簡素化
bufferoverflowU.lib も、同じメカニズムを利用して XNUMX つを折りたたむ
構成セクションを XNUMX つに戻します。

[5] 回避するために、生成された C コードへの #line プラグマの挿入を作り直しました。
さまざまなコンパイラによって課される行番号引数の制限、およびより多くの
正確。

[6] 引数の処理を修正。 オプション -libdir は、引数として -L も暗黙指定するようになりました。

[7] オプション -show (critcl::showconfig) のパスをリストします。
データの取得元の構成ファイル。 構成のデバッグに適しています
処理。

[8] 埋め込みドキュメントを再生成するターゲットを含むビルド スクリプトを拡張し、
および図を作成し、リリースを生成します。

CHANGES FOR VERSION 3.0.5

[1] C コードを指定したときにトリガーされる #line プラグマの新しいコードのバグを修正しました
先頭の空白なし。

[2] ドキュメントを拡張して、ライセンス、ソース検索、
インストーラー、開発者ガイド。

CHANGES FOR VERSION 3.0.6

[1] github の問題 10 を修正しました。critcl アプリケーションが適切な終了コードを提供するようになりました (1)
常に成功 (ステータス 0) を示すのではなく、ビルドの失敗時に。

[2] github の問題 13 を修正しました。リリース ビルドの bufferoverflowU.lib の処理は、
デバッグ ビルドの処理と矛盾します。 同じように扱われるようになりました
(条件付き) どちらの場合も。

[3] ドキュメントの整理。主にインストール ガイドと、
githubの

CHANGES FOR VERSION 3.0.7

[1] によって生成されたコードを修正 critcl::c++コマンド. 発行されたコードは、非
静的文字列テーブル Tcl_GetIndexFromObj、契約に違反して、
テーブルには固定アドレスが必要です。 これは、待っていた思い出のスマッシュでした
起こる。 一般的な問題について警告してくれた Brian Griffin に感謝します。

CHANGES FOR VERSION 3.1

[1] 新しい上位パッケージを追加 critcl::iasoc.

このパッケージは、データをインタープリターに関連付けるコードの作成を簡素化します
Tcl経由 Tcl_(Get|Set)AssocData() API。 ユーザーは自分のデータに集中できます。
これをサポートするために必要なすべてのボイラープレート C コードは、パッケージによって生成されます。

このパッケージは、コアに追加されたいくつかの新機能を使用します クリティカル
パッケージ、以下を参照してください。

[2] 上位パッケージの追加 クリティカル::クラス.

このパッケージは、クラスとインスタンスを持つ C レベル オブジェクトの作成を簡素化します。
コマンド。 ユーザーは、クラス変数とインスタンス変数を使用してクラス定義を作成できます
および -TclOO クラスに似たメソッド。必要なボイラープレート C コードがすべて
パッケージによって生成されたこれをサポートします。

このパッケージは、コアに追加されたいくつかの新機能を使用します クリティカル
パッケージ、以下を参照してください。

[3] TEApot メタデータを処理するための API を拡張しました。 コマンドを追加しました クリティカル::メタ? 〜へ
格納された情報を照会します。 現在想定されている主な用途は、
構築された名前で使用するための、ユーティリティコマンドによる現在のパッケージの名前。 この
パッケージの静的スキャンにより、特定の情報が常に利用可能
最初の critcl コマンドの実行時にファイル。

新しいパッケージ critcl::iasoc & クリティカル::クラス （上記を参照）はこれのユーザーです


[4] コマンドでAPIを拡張し、 critcl::name2c、変換のプロセスを公開する
ベース名、ネームスペース、および C ネームスペースへの Tcl 名。 これにより、より高いレベルの
と同じタイプの C 識別子を生成するコード ジェネレーター クリティカル そのもの。

新しいパッケージ クリティカル::クラス (上記参照) は、このコマンドのユーザーです。

[5] コマンドでAPIを拡張し、 クリティカル::ソース、にある critcl コマンドの実行
現在のファイルのコンテキスト内の別のファイル。 これにより、管理が容易になります
ユーザーがより簡単にコードを分割できるようにするため、より大きなコード本体の
複数のパッケージを生成することなく、小さなチャンクを消化します。

[6] 前項に関連して、コレクションを流用するコマンドで API を拡張
生成された C コードをメモリに格納します。 これにより、コマンドの使用が容易になります。
より高いレベルのコード ジェネレーターに埋め込まれた C コード。

セクションを参照してください 上級者： 転用 提供されているコマンドの詳細については、

新しいパッケージ クリティカル::クラス (上記参照) は、これらの機能のユーザーです。

[7] 開発者が適切な C を生成するのに役立つコマンドで API を拡張
＃ライン ディレクティブ。 これにより、高レベルのコード ジェネレーターが生成および挿入できるようになります。
コード内のコンパイルエラーが適切であることを保証する独自のディレクティブ
帰属します。

セクションを参照してください 上級者： 会場 管理 提供されているコマンドの詳細については、

新しいパッケージ critcl::iasoc & クリティカル::クラス （上記を参照）はこれらのユーザーです
施設。

[8] カスタム引数を定義する機能をユーザーに提供するコマンドで API を拡張
および結果タイプ ::critcl::cproc.

セクションを参照してください 上級者： 拡張 cproc 提供されているコマンドの詳細については、

CHANGES FOR VERSION 3.1.1

[1] あちこちのバグ修正。 詳細に：

[2] のwrong#argsエラーの生成を修正 critcl::cproc および派生コード
(クリティカル::クラス cproc ベースのメソッド)。 引数がない場合は NULL を使用し、取る
オフセットを考慮します。

[3] パッケージ名の扱いを修正 クリティカル::クラス. それらが含まれている可能性があることを忘れていました
名前空間の区切り。 バージョン 1.0.1 にバンプ。

[4]拡張 クリティカル::クラス わかりやすくするために、インスタンスの作成時にエラー メッセージが生成されました。
バージョン 1.0.2 にバンプ。

CHANGES FOR VERSION 3.1.2

[1] 強化。 詳細に：

[2]拡張 critcl::cproc 限定された方法で、オプションの引数を処理できるようにします。
これは自動的に利用可能になります クリティカル::クラス cproc ベースのメソッドも同様です。

[3] バグ修正 割り当てる Tcl 8.4 のエミュレーション。 未使用の変数を
空の文字列。 エミュレーション パッケージのバンプ バージョン ラサイン84 1.0.1へ。

CHANGES FOR VERSION 3.1.3

[1] 強化。 詳細に：

[2] "Pascal String" の新しい引数型 "pstring" を追加しました。これはカウントされた文字列です。
文字列ポインタと文字列長の組み合わせ。

[3] 新しいメソッドを追加 critcl::argtype のサポート & ::critcl::argsupport 定義して使用する
引数の型をサポートする追加のコード。ここでは、上記の「pstring」によって使用されます
必要な構造を定義します。

[4] パッケージ内の準バグ修正 クリティカル::クラス & critcl::iasoc. AS のプラグマ
メタ データ スキャナーを使用して、テンプレート ファイルがパッケージの一部であることを確認します。
バージョンはそれぞれ 1.0.4 と 1.0.1 に上がりました。

CHANGES FOR VERSION 3.1.4

[1] パッケージ内のバグ修正 クリティカル::クラス. 次の場合、クラス構造にダミー フィールドを生成します。
クラスにはクラス変数がありません。 この変更がなければ、構造は空になります。
また、多くのコンパイラはそのような型を処理できません。

[2] win64 設定を壊すタイプミスを修正。

[3] 問題 #16、コマンドのドキュメントのタイプミスを修正 クリティカル::クラス.

CHANGES FOR VERSION 3.1.5

[1] 問題 #19 を修正しました。 MSVC のバージョン番号を抽出する正規表現を作成
ドイツ語システムで動作するように、より一般的です。 これはそうでなければならないかもしれません
他の Windows ロケールについては、将来再訪します。

[2] 問題 #20 を修正しました。 少なくとも UNIX エミュレーションでは、オプション -tea が Windows で動作するようになりました
msys/mingw のような環境。

CHANGES FOR VERSION 3.1.6

[1] 問題 #21 を修正しました。 スタブテーブルポインタ変数のマルチ定義は
これまでに見たすべての C リンカについて、C++ リンカはこれをまったく好まなかった。
この変数セットが一度だけ生成されるようにコードを作り直しました。
組み立てるすべてのピースのラッパー。

[2] 問題 #22 のコマンド識別子引数の処理を修正
critcl::cコマンド, critcl::cproc, critcl::cdata. Tcl を適切に許可するようになりました
それらから適切な内部 C 識別子を生成します。

この一部として、コマンドの署名 critcl::name2c かわった。 今のコマンド
XNUMX つではなく XNUMX つの値のリストを提供します。 新しい値が追加されました
終わり。

パッケージの実装をさらに調整 クリティカル::クラス、のユーザー
critcl::name2c. このパッケージは現在バージョン 1.0.6 であり、critcl 3.1.6 が必要です。

最後に、オプションの誤った処理を修正しました -cname in critcl::cコマンド,
critcl::cproc.

[3] 問題 #23 を修正しました。

CHANGES FOR VERSION 3.1.7

[1] 問題 #24 を修正しました。 で見つかったコンパイラ警告を抽出して無条件に表示します。
ビルドログ。 ビルドを引き起こさずに、ユーザーが警告を見逃すのを防ぎます
失敗しても、まだ問題がある可能性があります。

[2] 新機能。 出力フック。 メッセージング以外のすべてのユーザー出力は、
command クリティカル::印刷、およびユーザーは critcl を使用するときにそれをオーバーライドできます
パッケージとしてのアプリケーション。

[3] Ashok P. Nadkarni による新機能。 プラットフォーム構成は、から値を継承できます。
それらの前に定義された構成。

CHANGES FOR VERSION 3.1.8

[1] Tcl 8.4 用に生成されたパッケージ インデックスの問題を修正しました。 コマンドのリストに参加する
改行ではなくセミコロンで。

[2] 修正中に考慮し忘れていたユースケースが持ち上がった問題 #26 を修正しました
バグ #21 (critcl 3.1.6 を参照)。

CHANGES FOR VERSION 3.1.9

[1] 問題 #27 を修正しました。 欠落しているさまざまな代替 Linux およびプラットフォーム定義を追加
OS X ターゲット。

[2] 問題 #28 を修正しました。 linux-{32,64}-* でリンクするために欠落していた -mXX フラグを追加しました
ターゲット。

[3] 問題 #29 を修正しました。 処理における生の「cheaders」情報の使用を置き換えました
そこから派生した適切なインクルード ディレクティブを含む「cdefines」。

[4] Andrew Shadura によって拒否されたプル リクエスト #30 の背後にある問題を修正しました。 動的に
Tcl ヘッダー ファイルからスタブ変数宣言を抽出し、生成します。
パッケージコードで使用する変数定義を一致させます。 生成されたコードは
critcl 独自のヘッダーのコピーが存在する場合でも、常にヘッダーと一貫性が保たれるようになりました。
システムヘッダーに置き換えられました。

[5] 問題 #31 を修正しました。 変更 (コメント) を含む、Andrew Shadura による承認済みパッチ
critcl の OS パッケージ システムとの統合が容易になり、critcl のコピーが置き換えられます。
独自の Tcl ヘッダー。

[6] 問題 #32 を修正しました。 Andrew Shadura によるマージされたプル リクエスト。 色々誤字
ドキュメントとコメント。

[7] 問題 #33 を修正しました。 ドットで始まるファイルをより適切に処理します。

作者

ジャン・クロード・ウィップラー、スティーブ・ランダース、アンドレアス・クプリーズ

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