critcl - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

critcl - Ứng dụng CriTcl

SYNOPSIS

phê bình ?tùy chọn...? ?hồ sơ...?

_________________________________________________________________

MÔ TẢ

Chào mừng đến với C Runtime In Tcl, CriTcl gọi tắt là một hệ thống để xây dựng các gói mở rộng C
cho Tcl một cách nhanh chóng, từ mã C được nhúng trong các tập lệnh Tcl, dành cho tất cả những ai muốn tạo
mã của họ đi nhanh hơn.

Tài liệu này là tài liệu tham khảo cho phê bình yêu cầu. Đối tượng dự kiến ​​của nó là
mọi người phải xây dựng các gói bằng cách sử dụng phê bình để triển khai. Nhà văn của các gói với
mã C nhúng có thể bỏ qua tài liệu này. Nếu bạn đang cần một cái nhìn tổng thể về tổng thể
thay vào đó, hãy truy cập và đọc Giới thiệu Đến CriTcl.

Ứng dụng này nằm trong Lớp ứng dụng của CriTcl.

* ================ *
| Ứng dụng |
| phê bình |
| critcl :: ứng dụng |
* ================ *

+ ---------------- +
| Gói cốt lõi |
| phê bình |
| critcl :: dùng |
+ ---------------- +

+ ---------------- +
| Gói hỗ trợ |
| sơ khai :: * |
| md5, nền tảng |
| ... |
+ ---------------- +

Ứng dụng hỗ trợ dòng lệnh chung sau:

phê bình ?tùy chọn...? ?hồ sơ...?
Tập hợp chính xác các tùy chọn được hỗ trợ, ý nghĩa và sự tương tác của chúng được trình bày chi tiết trong
phần Các Ứng Dụng Các lựa chọn phía dưới. Để có một tập hợp các ví dụ lớn hơn, vui lòng xem phần
"Xây dựng các gói Critcl" trong tài liệu về Sử dụng CriTcl.

ỨNG DỤNG LỰA CHỌN

Các tùy chọn sau đây được hiểu

-v

--phiên bản
Các tùy chọn này khiến critcl in phiên bản của nó để tiêu chuẩn và sau đó thoát ra.

-I con đường
Tùy chọn này chỉ định một đường dẫn bao gồm toàn cầu bổ sung để sử dụng trong quá trình biên dịch
của ".critcl". Tất cả các giá trị được sử dụng nếu điều này được chỉ định nhiều lần.

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà dưới đây).

-L con đường
Tùy chọn này chỉ định một đường dẫn tìm kiếm thư viện toàn cầu bổ sung để sử dụng trong quá trình liên kết
của ".critcl". Tất cả các giá trị được sử dụng nếu điều này được chỉ định nhiều lần.

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà dưới đây).

-bộ đệm con đường
Tùy chọn này chỉ định đường dẫn đến thư mục để sử dụng làm bộ đệm kết quả. Nếu không
đã chỉ định nó mặc định thành "~ / .critcl /", hoặc khi tạo một gói (xem
tùy chọn -pkg dưới đây), thành "~ / .critcl /.", Khi được chỉ định nhiều lần,
giá trị cuối cùng được sử dụng.

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà dưới đây).

-dọn dẹp Khi được chỉ định, bộ đệm kết quả được làm trống, tức là tất cả các tệp và thư mục được tìm thấy
bên trong bị xóa) trước khi quá trình biên dịch bắt đầu.

Tùy chọn này không liên quan khi tạo một gói (xem tùy chọn -pkg dưới đây) bởi vì
chế độ này bắt đầu với một bộ đệm kết quả trống và duy nhất.

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà dưới đây).

-config con đường
Tùy chọn này chỉ định đường dẫn đến tệp cấu hình tùy chỉnh, cho phép người dùng
sử dụng các thông số kỹ thuật mục tiêu của riêng họ. Nếu không được chỉ định, một mặc định được hardwired
thay vào đó, cấu hình nhúng trong lõi hệ thống sẽ được sử dụng. Khi được chỉ định nhiều
lần giá trị cuối cùng được sử dụng.

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà dưới đây).

-gỡ lỗi chế độ
Tùy chọn này kích hoạt biên dịch với gỡ lỗi. Nó chấp nhận các chế độ bên dưới. Khi nào
được chỉ định nhiều lần sự kết hợp của tất cả các chế độ được sử dụng.

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà dưới đây).

trí nhớ Chế độ này kích hoạt gỡ lỗi bộ nhớ các phân bổ được thực hiện thông qua Tcl
cốt lõi.

biểu tượng
Chế độ này kích hoạt xây dựng tất cả ".c"các tệp có ký hiệu gỡ lỗi.

tất cả các Chế độ này kích hoạt cả hai trí nhớ và biểu tượng.

-vô hiệu hóa tên
Tùy chọn này đặt giá trị của tùy chọn cấu hình bản dựng tùy chỉnh tên đến sai.
Nó tương đương với "-with-tên 0 ".

Thông tin chỉ được xác thực nếu một trong các nút ".critcl"đầu vào tệp thực sự
xác định và sử dụng tùy chọn cấu hình bản dựng tùy chỉnh với tên.

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà dưới đây).

-có thể tên
Tùy chọn này đặt giá trị của tùy chọn cấu hình bản dựng tùy chỉnh tên đến đúng.
Nó tương đương với "-with-tên 1 ".

Thông tin chỉ được xác thực nếu một trong các nút ".critcl"đầu vào tệp thực sự
xác định và sử dụng tùy chọn cấu hình bản dựng tùy chỉnh với tên.

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà dưới đây).

-lực lượng Khi biên dịch được chỉ định luôn được thực hiện, ngay cả khi một thư viện được chia sẻ cho tệp
đã tồn tại. Hiệu ứng này có thể được thực hiện thông qua việc làm sạch bộ nhớ cache (xem ở trên) như
tốt, ngoại trừ việc nó lười biếng trong việc hủy tệp và sẽ không hủy tệp
không liên quan đến những cái chúng tôi đang xây dựng.

Tùy chọn này không liên quan khi tạo một gói (xem tùy chọn -pkg dưới đây) bởi vì
chế độ này bắt đầu với một bộ đệm kết quả trống và duy nhất.

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà dưới đây).

-Cứu giúp Tùy chọn này sẽ khiến hệ thống in ra một trợ giúp ngắn về cú pháp dòng lệnh
và các tùy chọn rồi thoát ứng dụng.

-giữ cho Tùy chọn này sẽ khiến hệ thống giữ ".c"các tệp được tạo bởi một lần chạy trong
bộ nhớ cache kết quả. Khi tạo một gói (xem tùy chọn -pkg bên dưới) điều này cũng ngăn cản
việc xóa bộ đệm kết quả duy nhất được sử dụng bởi quá trình chạy. Tùy chọn này là nhằm mục đích
để gỡ lỗi phê bình chính nó, nơi có thể cần thiết để kiểm tra
mã C được tạo.

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà dưới đây).

-libdir con đường
Tùy chọn này chỉ định đường dẫn mà các gói được tạo thông qua tùy chọn -pkg
được lưu. Nó cũng chỉ định một đường dẫn đến các thư viện tìm kiếm trong đó, như đối với -L. Khi nào
được chỉ định nhiều lần giá trị cuối cùng được sử dụng. Khi không được chỉ định ở tất cả
vỡ nợ, "lib", được sử dụng. Lưu ý rằng đây là một đường dẫn tương đối, đặt kết quả vào
thư mục làm việc hiện tại.

-bao gồm con đường
Tùy chọn này chỉ định đường dẫn mà theo đó mọi tiêu đề gói được tạo sẽ được lưu.
Nó cũng chỉ định một đường dẫn để tìm kiếm bao gồm các tệp trong đó, như đối với -I. Khi được chỉ định
nhiều lần giá trị cuối cùng được sử dụng làm đích, tuy nhiên tất cả các giá trị trước đó
được giữ trên đường dẫn tìm kiếm bao gồm. Khi hoàn toàn không được chỉ định theo mặc định,
"bao gồm", được sử dụng. Lưu ý rằng đây là một đường dẫn tương đối, đặt kết quả vào
thư mục làm việc hiện tại.

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà dưới đây).

-pkg Chế độ mặc định của ứng dụng là xây dựng ".critcl"các tệp được liệt kê trên
dòng lệnh và lưu kết quả trong bộ đệm kết quả. Về cơ bản, điền trước
bộ nhớ cache với các gói quan trọng, cắt giảm thời gian cần thiết để sử dụng các gói này
gói.

Tùy chọn này kích hoạt một trong các chế độ khác, tạo gói. Trong chế độ này,
các tệp đầu vào được xử lý đầu tiên như bình thường, tuy nhiên sau đó chúng được đóng gói thành
một thư viện duy nhất và các tệp bổ sung được tạo để làm cho thư viện này có thể sử dụng được như
một gói Tcl thông thường.

Tùy chọn -trà, xem bên dưới, gọi chế độ cuối cùng, tạo TEA. Nếu cả hai tùy chọn,
tức là -pkg và -trà được chỉ định chiến thắng cuối cùng được chỉ định.

Trong chế độ này, các tùy chọn -dọn dẹp và -lực lượng không liên quan và bị bỏ qua. Ngược lại,
tùy chọn -libdir có liên quan trong cả điều này và -trà chế độ.

Khi tùy chọn này được chỉ định tên cơ sở của đối số tệp đầu tiên sau
tùy chọn được sử dụng làm tên của gói để tạo. Nếu phần mở rộng của điều đó
tệp cho biết một thư viện được chia sẻ (".vì thế"".sl"".dylib", Và"DLL.") nó cũng là
bị xóa khỏi tập hợp các tệp đầu vào. MỘT ".tcl"tệp được giữ như một phần của dữ liệu đầu vào. A
một tệp không có phần mở rộng được giả định là thực sự có ".tcl"phần mở rộng. A
tệp không có phần mở rộng, nhưng các tệp đầu vào khác sau đây được coi như tên của
một thư viện được chia sẻ thích hợp và bị xóa khỏi tập hợp các tệp đầu vào.

Ví dụ:
=> Tên gói là: foo
=> Tập tin đầu vào là: foo.tcl
=> Tên gói là: foo
=> Tập tin đầu vào là: bar.tcl
=> Tên gói là: foo
=> Tập tin đầu vào là: foo.tcl
=> Tên gói là: foo
=> Tập tin đầu vào là: bar.tcl

-chỉ Tùy chọn này, khi được chỉ định, sẽ khiến hệ thống in cấu hình của
mục tiêu đã chọn để tiêu chuẩn và sau đó thoát ra. Việc lựa chọn mục tiêu có thể bị ảnh hưởng
thông qua tùy chọn -Mục tiêu (xem bên dưới).

-hiển thị tất cả
Tùy chọn này, khi được chỉ định, sẽ khiến hệ thống in toàn bộ
tệp cấu hình thành tiêu chuẩn và sau đó thoát ra. Sự lựa chọn tệp cấu hình có thể
bị ảnh hưởng thông qua tùy chọn -config (xem ở trên).

-Mục tiêu tên
Tùy chọn này ghi đè lựa chọn mặc định của mục tiêu xây dựng với lựa chọn của người dùng.
Khi được chỉ định nhiều lần, giá trị cuối cùng được sử dụng. Mục tiêu được đặt tên phải tồn tại
trong tệp cấu hình đã chọn. Sử dụng tùy chọn -mục tiêu (xem bên dưới) để lấy danh sách
các chỉ tiêu có thể chấp nhận được. Việc lựa chọn tệp cấu hình có thể bị ảnh hưởng thông qua
tùy chọn -config (xem ở trên).

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà dưới đây).

-mục tiêu
Tùy chọn này, khi được chỉ định, sẽ khiến hệ thống in danh sách tất cả các
mục tiêu từ tệp cấu hình đã chọn đến tiêu chuẩn và sau đó thoát ra. Sự lựa chọn của
tệp cấu hình có thể bị ảnh hưởng thông qua tùy chọn -config (xem ở trên).

-trà Tương tự với option -pkg, ngoại trừ việc chế độ được gọi không tạo ra các tệp nhị phân,
nhưng một hệ thống phân cấp thư mục có chứa ".critcl"tệp, tệp đồng hành của nó và
Hệ thống xây dựng TEA-lookalike với hầu hết các mã hỗ trợ cần thiết (bao gồm các bản sao
của các gói critcl).

Nếu cả hai tùy chọn, tức là -pkg và -trà được chỉ định chiến thắng cuối cùng được chỉ định.

Trong chế độ này, các tùy chọn -I, -L, -dọn dẹp, -lực lượng, -bộ đệm, -bao gồm, -có thể,
-vô hiệu hóavà -với-FOO không liên quan và bị bỏ qua. Ngược lại, tùy chọn -libdir
có liên quan trong cả điều này và -pkg chế độ.

Khi tùy chọn này được chỉ định tên cơ sở của đối số tệp đầu tiên sau
tùy chọn được sử dụng làm tên của gói để tạo. Nếu phần mở rộng của điều đó
tệp cho biết một thư viện được chia sẻ (".vì thế"".sl"".dylib", Và"DLL.") nó cũng là
bị xóa khỏi tập hợp các tệp đầu vào. MỘT ".tcl"tệp được giữ như một phần của dữ liệu đầu vào. A
một tệp không có phần mở rộng được giả định là thực sự có ".tcl"phần mở rộng. A
tệp không có phần mở rộng, nhưng các tệp đầu vào khác sau đây được coi như tên của
một thư viện được chia sẻ thích hợp và bị xóa khỏi tập hợp các tệp đầu vào.

Ví dụ:
=> Tên gói là: foo
=> Tập tin đầu vào là: foo.tcl
=> Tên gói là: foo
=> Tập tin đầu vào là: bar.tcl
=> Tên gói là: foo
=> Tập tin đầu vào là: foo.tcl
=> Tên gói là: foo
=> Tập tin đầu vào là: bar.tcl

-với-tên giá trị
Tùy chọn này đặt giá trị của tùy chọn cấu hình bản dựng tùy chỉnh tên đến giá trị.

Thông tin chỉ được xác thực nếu một trong các nút ".critcl"đầu vào tệp thực sự
xác định và sử dụng tùy chọn cấu hình bản dựng tùy chỉnh với tên.

Tùy chọn này không liên quan khi tạo gói TEA (xem tùy chọn -trà ở trên).

GÓI Cơ cấu

Các gói được tạo bởi critcl có cấu trúc cơ bản sau:

+ - pkgIndex.tcl
+ - critcl-rt.tcl
+ - license.terms (tùy chọn)
|
+ - tcl (tùy chọn)
| + -
|
+ -
+ -

Chú ý

[1] Tệp "pkgIndex.tcl"là tệp chỉ mục gói tiêu chuẩn được mong đợi bởi Tcl's
quản lý gói. Nó có nguồn gốc trong quá trình tìm kiếm các gói và khai báo
gói vào Tcl với các tệp của nó và cách xử lý chúng.

[2] Tệp "phê bình-rt.tcl"là một tệp trợ giúp chứa mã chung được sử dụng bởi
"pkgIndex.tcl"để thực hiện các nhiệm vụ của mình.

[3] Tệp "Hợp đồng"là tùy chọn và chỉ xuất hiện nếu".critcl"nộp hồ sơ
gói được tạo từ lệnh đã sử dụng critcl :: giấy phép để khai báo gói hàng
tác giả và giấy phép.

[4] Tất cả các tệp được khai báo bằng lệnh critcl :: tsources được đưa vào thư mục con
"TCL".

[5] Thư viện được chia sẻ được tạo bởi critcl được đưa vào một nền tảng con cụ thể
thư mục.

Toàn bộ cấu trúc, và đặc biệt là điểm cuối cùng, cho phép chúng tôi hợp nhất các kết quả sau này
(cho cùng một gói và phiên bản) cho nhiều nền tảng mục tiêu vào một thư mục duy nhất
cấu trúc không có xung đột, bằng cách sao chép các thư mục hàng đầu lên nhau. Các
chỉ các tệp có thể xung đột trong và "TCL"thư mục, và đối với những thư mục này, chúng tôi
biết rằng chúng giống nhau giữa các mục tiêu. Kết quả của sự hợp nhất như vậy sẽ giống như sau:

+ - pkgIndex.tcl
+ - critcl-rt.tcl
+ - license.terms (tùy chọn)
|
+ - tcl (tùy chọn)
| + -
|
+ -
| + -
+ -
| + -
+ -
+ -

THAY ĐỔI CHO PHIÊN BẢN 2.1

[1] Đã sửa lỗi ở đâu critcl :: tsources các đường dẫn tương đối được giải thích là liên quan đến
thư mục làm việc hiện tại thay vì liên quan đến ".critcl"sử dụng tệp
như tất cả các lệnh khác thuộc loại này.

[2] Đã sửa lỗi nội bộ, ngăn thông tin được thu thập cho nhiều ".critcl"gửi tới
rò rỉ giữa chúng. Đáng chú ý, critcl :: tk không phải là một tùy chọn cấu hình chung
nữa không.

[3] Đã sửa lệnh critcl :: giấy phép là một hoạt động rỗng trong chế độ "biên dịch và chạy",
thay vì ném một lỗi.

[4] Đã sửa lỗi ứng dụng critcl can thiệp vào bộ đệm kết quả "biên dịch và chạy"
in -pkg bằng cách để nó sử dụng một chế độ hoàn toàn riêng biệt (và theo mặc định là tạm thời)
thư mục cho chế độ đó.

[5] Đã sửa lỗi thay đổi thành ".critcl"tệp không dẫn đến việc xây dựng lại cho chế độ
"biên dịch và chạy". Tất cả các lệnh API có liên quan hiện đảm bảo UUID thay đổi.

[6] Đã sửa lỗi trong việc xử lý phụ trợ của critcl :: gỡ lỗi nơi c-nguồn đồng hành của
một ".critcl"tệp không được biên dịch với các tùy chọn gỡ lỗi, mặc dù".critcl" tập tin
là.

[7] Đã sửa lỗi trong critcl :: gỡ lỗi điều này đã ngăn cản việc nhận dạng chế độ "tất cả" khi nó
không phải là đối số đầu tiên của lệnh.

[8] Đã sửa lỗi trong "tải trước.c"ngăn cản quá trình biên dịch của nó trên các nền tảng không phải windows.

[9] Đã sửa lỗi lâu dài trong việc xử lý các dấu hiệu định tính không gian tên trong tên lệnh
lập luận của critcl :: cproc và critcl :: ccommand. Bây giờ có thể chỉ định một
tên lệnh đầy đủ điều kiện mà không có vấn đề.

[10] Mở rộng / làm lại critcl :: tsources trở thành cách thông thường để khai báo ".tcl"
các tệp đồng hành ngay cả đối với chế độ "biên dịch và chạy".

[11] Mở rộng / làm lại critcl :: tsources để cho phép sử dụng một ".critcl"tập tin như của riêng nó
Tcl đồng hành tệp.

[12] Mở rộng critcl :: framework để kiểm tra nội bộ mục tiêu xây dựng OS X và bỏ qua
khai báo nếu không.

[13] Mở rộng critcl :: fail có thể được gọi nhiều lần trong một ".critcl"tệp.
lệnh gọi đầu tiên buộc việc xây dựng, nếu nó chưa được thực hiện, để nhận kết quả. Hơn nữa
các cuộc gọi trả về kết quả được lưu trong bộ nhớ cache của cuộc gọi đầu tiên.

[14] Mở rộng việc xử lý CC biến môi trường trong mã xác định
trình biên dịch sử dụng để xử lý (tức là loại bỏ) các đường dẫn đến trình biên dịch, tệp trình biên dịch
các phần mở rộng và các tùy chọn trình biên dịch được chỉ định sau chính trình biên dịch, chỉ để lại
tên trần của trình biên dịch.

[15] Mở rộng mã xử lý tìm kiếm các thư viện được tải trước để in các đường dẫn nó
đã tìm kiếm, giúp việc gỡ lỗi tìm kiếm không thành công dễ dàng hơn.

[16] Một lệnh mới critcl :: tcl có thể được sử dụng để khai báo phiên bản Tcl tối thiểu
cần thiết để xây dựng và chạy ".critcl"tệp và gói. Mặc định là 8.4 nếu không
khai báo. Mở rộng critcl để có phần đầu và phần đầu cho tất cả Tcl 8.4, 8.5,
và 8.6.

[17] Một lệnh mới critcl :: tải buộc việc xây dựng và tải một ".critcl"tệp. Đây là
cách chính thức để ghi đè lược đồ lười-xây dựng - & - tải theo yêu cầu mặc định của critcl
cho chế độ "biên dịch và chạy".

Chú thích điều đó sau khi sử dụng critcl :: tải / critcl :: fail trong một ".critcl"nó không phải là
có thể sử dụng các lệnh critcl trong tệp đó nữa. Làm như vậy sẽ xuất hiện một lỗi.

[18] Mở rộng thế hệ pragmas '#line' để sử dụng Thông tin khung (nếu có) đến
cung cấp trình biên dịch C với số dòng chính xác vào ".critcl"tệp cho
báo cáo các cảnh báo và lỗi.

[19] Mở rộng critcl :: kiểm tra với ghi nhật ký để giúp gỡ lỗi kiểm tra thời gian xây dựng của
môi trường, cộng với một đối số tùy chọn bổ sung để cung cấp nhãn.

[20] Đã thêm một lệnh mới critcl :: liên kết kiểm tra mà không chỉ cố gắng kiểm tra môi trường
thông qua việc biên dịch mã, mà còn cả khả năng liên kết của nó.

[21] Đã thêm một lệnh mới critcl :: msg để nhắn tin, như lệnh critcl :: error là cho
báo cáo lỗi. Tương tự như vậy, đây là một hook mà người dùng gói được phép
ghi đè. Triển khai mặc định, được sử dụng theo chế độ biên dịch & chạy Không lam gi cả. Các
thực hiện cho chế độ tạo ra gói in thông báo vào stdout.

Việc sử dụng được hình dung là để báo cáo kết quả được xác định bởi critcl :: kiểm tra và
critcl :: liên kết kiểm tra trong quá trình xây dựng, để giúp gỡ lỗi khi có sự cố
bằng séc.

[22] Tiếp xúc với bên trong xử lý đối số của critcl :: proc để sử dụng bởi nâng cao
người dùng. Các lệnh mới là

[1] critcl :: argnames

[2] critcl :: argcnames

[3] critcl :: argcsignature

[4] critcl :: argvardecls

[5] critcl :: argconversion

Vui lòng xem phần Nâng cao Nhúng C Mã của phê bình tài liệu gói cho
chi tiết.

[23] Mở rộng gói critcl để đánh chặn gói cho và ghi lại tệp ->
ánh xạ tên gói. Cộng với các thay đổi nội bộ khác hiện cho phép sử dụng không gian tên
tên gói trong khi vẫn sử dụng tên đường dẫn thích hợp và hàm init.

[24] Bỏ các lệnh không sử dụng critcl :: tối ưu hóa và critcl :: bao gồm.

[25] Đã giảm -lib chế độ từ ứng dụng critcl.

[26] Bỏ sót phần hỗ trợ cho Tcl 8.3 trở về trước.

THAY ĐỔI CHO PHIÊN BẢN 3

[1] Lệnh critcl :: nền tảng không được chấp nhận trong phiên bản 2.1, được cấp trên bởi
critcl :: targetplatform, nhưng được giữ lại để tương thích. Bây giờ nó đã được gỡ bỏ.

[2] Lệnh critcl :: đã biên dịch được giữ nguyên trong phiên bản 2.1 với ngữ nghĩa trong
mâu thuẫn với nó, để tương thích. Sự mâu thuẫn này đã được loại bỏ,
thay đổi ngữ nghĩa hiển thị của lệnh phù hợp với tên của nó.

[3] Thay đổi đối với phiên bản 3 trở nên cần thiết vì có thể nhìn thấy hai phiên bản không tương thích
những thay đổi trên.

[4] Mở rộng gói ứng dụng với xử lý mã một tùy chọn mới -trà. Xác định
tùy chọn này gọi một chế độ đặc biệt trong đó critcl tạo ra một gói TEA, tức là kết thúc
đầu vào vào hệ thống phân cấp thư mục và các tệp hỗ trợ cung cấp cho nó TEA-
hệ thống xây dựng lookalike.

Tùy chọn mới này và -pkg, loại trừ nhau. Nếu cả hai đều được chỉ định thì lần sử dụng cuối cùng
tùy chọn được ưu tiên.

Hệ thống phân cấp thư mục gói được tạo chủ yếu là độc lập, nhưng không hoàn toàn.
Nó không chỉ yêu cầu cài đặt hoạt động của Tcl mà còn phải cài đặt hoạt động
trong số các gói md5 và dòng lệnh. Cả hai điều này đều được cung cấp bởi Tcllib bó.
Không bắt buộc, nhưng nên cài đặt bất kỳ gói nào có thể
tăng tốc hoạt động của md5, tức là bộ mật mã, tclibc, hoặc là trf.

[5] Mở rộng gói critcl bằng một lệnh mới critcl :: scan đi đường dẫn đến một
".critcl", quét tĩnh và trả lại giấy phép, phiên bản, danh sách
các tệp đồng hành của nó, danh sách các API đã nhập và danh sách các tùy chỉnh do nhà phát triển chỉ định
Tùy chọn cấu hình. Dữ liệu này là nền tảng cho gói TEA được mô tả
ở trên.

Lưu ý rằng đây là một tĩnh quét. Trong khi các chế độ xây dựng khác có thể (phải) thực thi
".critcl"và đưa ra các quyết định về nền tảng cụ thể liên quan đến mã C được tập hợp,
tệp đồng hành, v.v. chế độ bọc TEA không ở vị trí để tạo nền tảng-
quyết định cụ thể. Nó phải gói mọi thứ có thể cần đến
khi thực sự xây dựng. Do đó, quét tĩnh. Tuy nhiên, điều này có tập hợp riêng của nó
các vấn đề, cụ thể là không thể tìm ra bất kỳ cấu trúc động nào của đồng hành
đường dẫn tệp, ít nhất là đường dẫn riêng của nó. Như vậy:

[6] Mở rộng API được sử dụng bởi các gói dựa trên critcl bằng lệnh critcl :: sở hữu. Trong khi
lệnh này bị bỏ qua bởi các chế độ xây dựng thông thường mà máy quét tĩnh đã mô tả
ở trên lấy các đối số của nó làm tên của các tệp đồng hành phải được bao bọc
vào gói TEA và máy quét không thể tìm thấy nếu không, như
vì các đường dẫn động đến critcl :: tsources, critcl :: csources, có nguồn gốc
trực tiếp, hoặc đơn giản là các tệp dữ liệu phụ trợ.

[7] Mở rộng API được sử dụng bởi các gói dựa trên critcl bằng lệnh critcl :: api cho
quản lý các bảng sơ khai, có thể là việc sử dụng chúng, và / hoặc khai báo và xuất khẩu.

Vui lòng xem phần Sơ khai Bàn Quản lý của phê bình tài liệu gói cho
chi tiết.

[8] Mở rộng API được sử dụng bởi các gói dựa trên critcl bằng lệnh critcl :: userconfig
để quản lý các tùy chọn cấu hình tùy chỉnh do nhà phát triển chỉ định, có thể là
sử dụng và / hoặc khai báo.

Vui lòng xem phần Tuỳ chỉnh Xây dựng Cấu hình của phê bình tài liệu gói
để biết thêm chi tiết.

[9] Mở rộng API được sử dụng bởi các gói dựa trên critcl với các lệnh
critcl :: description, critcl :: tóm tắt, critcl :: chủ đề, critcl :: metavà
critcl :: buildrequirement để khai báo về siêu dữ liệu TEApot cho / về
Gói.

Vui lòng xem phần Đóng gói Siêu dữ liệu Ngày của phê bình tài liệu gói cho
chi tiết.

THAY ĐỔI CHO PHIÊN BẢN 3.0.1

[1] Sửa các lỗi xung quanh. Chi tiết:

[2] Cố định ghi các yêu cầu phiên bản Tcl. Giữ tên gói và phiên bản
cùng nhau, mở dữ liệu meta được tạo ra và lệnh tải gói đã tạo.

[3] Đã sửa lỗi tập lệnh xây dựng: Khi cài đặt hoặc gói cho TEA, hãy tạo bất kỳ tập lệnh nào bị thiếu
thư mục

[4] Đã sửa đổi các tập lệnh xây dựng để thoát ứng dụng đúng cách khi cửa sổ
GUI của họ được đóng thông qua nút (X).

[5] Đã xóa 8.5-ism (wb mở) đã trượt vào tập lệnh xây dựng chính.

[6] Đã sửa đổi các tập lệnh xây dựng ví dụ để tách đầu ra cho các tập lệnh khác nhau
ví dụ (và các gói) bằng cách thêm các dòng trống.

[7] stack :: c example bugfix: Bao gồm các khai báo API để sử dụng trong các tệp đồng hành.

[8] Mở rộng tài liệu: Lưu ý sự cần thiết phải cài đặt C hoạt động
trình biên dịch.

[9] Mở rộng các định nghĩa và mã đích của Windows để xử lý các tệp kê khai được sử dụng
bởi các môi trường phát triển MS hiện đại. Lưu ý rằng mã này xử lý cả hai
các khả năng, môi trường sử dụng tệp kê khai và môi trường (cũ (cũ)) không có.

[10] Mở rộng định nghĩa và mã mục tiêu Windows 64bit để tự động phát hiện nhu cầu
thư viện trợ giúp "bufferoverflowU.lib" và định cấu hình lại trình biên dịch và liên kết
các lệnh một cách thích hợp. Chúng tôi giả định rằng thư viện phải được liên kết khi hiện tại.
Điều này sẽ không có hại nếu thư viện hiện có, nhưng không cần thiết. Chỉ cần thừa.
Chúng tôi tìm kiếm thư viện trong các đường dẫn được chỉ định bởi biến môi trường LIB.

THAY ĐỔI CHO PHIÊN BẢN 3.0.2

[1] Đã khắc phục sự cố trong chế độ biên dịch và chạy trong đó các lệnh được đưa vào auto_index không được
được tìm thấy bởi lệnh [không xác định] của Tcl.

[2] Đã sửa lỗi khóa mảng không khớp phá vỡ việc sử dụng dữ liệu khách hàng và chức năng xóa cho
thủ tục. Báo cáo bởi Jos DeCoster, với bản vá.

[3] Đã triển khai một tùy chọn dòng lệnh -L, một tùy chọn tương đương -I, chỉ dành cho thư viện
các đường dẫn tìm kiếm.

[4] Đã khắc phục sự cố github 5 và 8. Khắc phục sự cố thiếu biến :: errorInfo. Nó
nên luôn có mặt, tuy nhiên, dường như có những bản sửa đổi của Tcl xung quanh đó
vi phạm giả định này.

THAY ĐỔI CHO PHIÊN BẢN 3.0.3

[1] Đã khắc phục sự cố github 5 và 8, đối với tập lệnh build.tcl ví dụ. Làm việc xung quanh một
biến thiếu :: errorInfo. Nó phải luôn có mặt, tuy nhiên dường như có
các bản sửa đổi của Tcl xung quanh vi phạm giả định này.

THAY ĐỔI CHO PHIÊN BẢN 3.0.4

[1] Đã sửa lỗi tạo initname của gói khi mã đến được đọc từ
stdin và không có đường dẫn thích hợp.

[2] Đã khắc phục sự cố github 11. Hiện đang sử dụng / LIBPATH thay vì -L trên Windows (libinclude
cài đặt cấu hình).

[3] Mở rộng critcl để xử lý -l: định dạng đường dẫn của các tùy chọn -l. GNU ld 2.22+ xử lý điều này
bằng cách tìm kiếm đường dẫn như hiện tại. Tốt khi chỉ định thư viện tĩnh, như đơn giản -l
tìm kiếm các thư viện được chia sẻ ưu tiên hơn là tĩnh. critcl xử lý nó ngay bây giờ, như
GNU cũ hơn không hiểu nó, cũng như các trình liên kết dành riêng cho nhà cung cấp khác nhau.

[4] Đã khắc phục sự cố github # 12. Critcl hiện xác định phiên bản MSVC đang sử dụng và sử dụng
nó để chuyển đổi giữa các tùy chọn gỡ lỗi liên kết khác nhau. Đơn giản hóa việc xử lý
bufferoverflowU.lib cũng vậy, sử dụng cùng một cơ chế và thu gọn cả hai
phần cấu hình chúng tôi đã trở lại thành một phần.

[5] Làm lại việc chèn # dòng pragmas vào mã C đã tạo để tránh
các giới hạn đối với đối số số dòng được áp đặt bởi các trình biên dịch khác nhau và hơn thế nữa
chính xác

[6] Xử lý đối số được sửa đổi. Tùy chọn -libdir bây giờ cũng ngụ ý L cho đối số của nó.

[7] Xử lý mở rộng tùy chọn -show (critcl :: showconfig) để liệt kê đường dẫn của
tệp cấu hình mà dữ liệu đến. Tốt cho cấu hình gỡ lỗi
Chế biến.

[8] Mở rộng tập lệnh xây dựng với các mục tiêu để tạo lại tài liệu nhúng,
và sơ đồ, và để tạo một bản phát hành.

THAY ĐỔI CHO PHIÊN BẢN 3.0.5

[1] Đã sửa lỗi trong mã mới cho # dòng pragmas được kích hoạt khi chỉ định mã C.
không có khoảng trắng ở đầu.

[2] Mở rộng tài liệu để có các trang dành cho giấy phép, truy xuất nguồn,
trình cài đặt và hướng dẫn của nhà phát triển.

THAY ĐỔI CHO PHIÊN BẢN 3.0.6

[1] Đã khắc phục sự cố github 10. Ứng dụng critcl hiện cung cấp mã thoát thích hợp (1)
khi xây dựng thất bại, thay vì luôn chỉ ra thành công (trạng thái 0).

[2] Đã khắc phục sự cố github 13. Xử lý bufferoverflowU.lib cho các bản phát hành là
không phù hợp với xử lý cho các bản dựng gỡ lỗi. Nó hiện được xử lý giống hệt nhau
(có điều kiện) bởi cả hai trường hợp.

[3] Dọn dẹp tài liệu, chủ yếu trong hướng dẫn cài đặt và README.md được hiển thị bởi
github

THAY ĐỔI CHO PHIÊN BẢN 3.0.7

[1] Đã sửa mã được tạo bởi lệnh critcl :: c ++. Mã phát ra không phải là
bảng chuỗi tĩnh thành Tcl_GetIndexFromObj, vi phạm hợp đồng,
yêu cầu bảng phải có một địa chỉ cố định. Đây là một kỷ niệm đáng chờ đợi
xảy ra. Cảm ơn Brian Griffin đã giúp chúng tôi giải quyết vấn đề chung.

THAY ĐỔI CHO PHIÊN BẢN 3.1

[1] Đã thêm một gói cấp cao hơn mới critcl :: iassoc.

Gói này đơn giản hóa việc tạo dữ liệu liên kết mã với trình thông dịch
qua Tcl's Tcl_ (Nhận | Đặt) PGSData () API. Người dùng có thể tập trung vào dữ liệu của mình trong khi
tất cả mã C soạn sẵn cần thiết để hỗ trợ điều này được tạo bởi gói.

Gói này sử dụng một số tính năng mới đã được thêm vào lõi phê bình
gói, xem bên dưới.

[2] Đã thêm gói cấp cao hơn critcl :: lớp.

Gói này đơn giản hóa việc tạo các đối tượng cấp C với lớp và cá thể
các lệnh. Người dùng có thể viết một định nghĩa lớp với các biến lớp và cá thể
và -methods tương tự như lớp TclOO, với tất cả mã C soạn sẵn cần thiết để
hỗ trợ điều này được tạo ra bởi gói.

Gói này sử dụng một số tính năng mới đã được thêm vào lõi phê bình
gói, xem bên dưới.

[3] Đã mở rộng API để xử lý siêu dữ liệu TEApot. Đã thêm lệnh critcl :: meta? đến
truy vấn thông tin được lưu trữ. Công dụng chính hiện được hình dung là truy xuất
tên của gói hiện tại bằng các lệnh tiện ích, để sử dụng trong các tên đã xây dựng. Điều này
thông tin cụ thể luôn có sẵn do quá trình quét tĩnh của gói
tệp về việc thực thi lệnh critcl đầu tiên.

Các gói mới critcl :: iassoc và critcl :: lớp (xem ở trên) là người dùng của cái này
chỉ huy.

[4] Mở rộng API bằng một lệnh, critcl :: name2c, tiết lộ quá trình chuyển đổi
tên Tcl thành tên cơ sở, không gian tên và không gian tên C. Điều này cho phép cấp cao hơn
trình tạo mã để tạo cùng một loại mã định danh C như phê bình chính nó.

Gói mới critcl :: lớp (xem ở trên) là người dùng lệnh này.

[5] Mở rộng API bằng một lệnh, critcl :: nguồn, thực thi các lệnh critcl được tìm thấy trong
một tệp riêng biệt trong ngữ cảnh của tệp hiện tại. Điều này cho phép quản lý dễ dàng hơn
của các nội dung mã lớn hơn vì nó cho phép người dùng chia chúng thành các
tiêu hóa các phần nhỏ hơn mà không tạo ra nhiều gói.

[6] Liên quan đến mục trước, đã mở rộng API bằng các lệnh để chuyển hướng bộ sưu tập
mã C được tạo vào bộ nhớ. Điều này giúp bạn dễ dàng sử dụng các lệnh cho
mã C được nhúng trong bộ tạo mã cấp cao hơn.

Xem phần Nâng cao: Chuyển hướng để biết chi tiết về các lệnh được cung cấp.

Gói mới critcl :: lớp (xem ở trên) là người dùng của các cơ sở này.

[7] Mở rộng API với các lệnh giúp các nhà phát triển tạo C thích hợp
#hàng các chỉ thị. Điều này cho phép trình tạo mã cấp cao hơn tạo và chèn
chỉ thị của riêng họ, đảm bảo rằng các lỗi biên dịch trong mã của họ là đúng
quy ra.

Xem phần Nâng cao: Địa Chỉ quản lý để biết chi tiết về các lệnh được cung cấp.

Các gói mới critcl :: iassoc và critcl :: lớp (xem ở trên) là người dùng
cơ sở vật chất.

[8] Mở rộng API với các lệnh cung cấp cho người dùng khả năng xác định đối số tùy chỉnh
và các loại kết quả cho :: critcl :: cproc.

Xem phần Nâng cao: Mở rộng cproc để biết chi tiết về các lệnh được cung cấp.

THAY ĐỔI CHO PHIÊN BẢN 3.1.1

[1] Sửa các lỗi xung quanh. Chi tiết:

[2] Đã sửa lỗi tạo lỗi # args sai cho critcl :: cproc và mã nguồn gốc
(critcl :: lớp phương pháp dựa trên cproc). Sử dụng NULL nếu không có đối số và lấy
phần bù vào tài khoản.

[3] Đã sửa lỗi xử lý tên gói bằng critcl :: lớp. Quên rằng chúng có thể chứa
dấu phân cách vùng tên. Đã chuyển sang phiên bản 1.0.1.

[4] Mở rộng a critcl :: lớp đã tạo ra thông báo lỗi trong quá trình tạo ví dụ cho rõ ràng.
Đã chuyển sang phiên bản 1.0.2.

THAY ĐỔI CHO PHIÊN BẢN 3.1.2

[1] Cải tiến. Chi tiết:

[2] Mở rộng critcl :: cproc để có thể xử lý các đối số tùy chọn, một cách hạn chế.
Điều này tự động có sẵn cho critcl :: lớp các phương pháp dựa trên cproc cũng vậy.

[3] Sửa lỗi trong phân công thi đua cho Tcl 8.4. Đặt đúng các biến không sử dụng thành
chuỗi rỗng. Phiên bản đệm của gói giả lập lphân công84 để 1.0.1.

THAY ĐỔI CHO PHIÊN BẢN 3.1.3

[1] Cải tiến. Chi tiết:

[2] Đã thêm loại đối số mới "pstring", cho "Pascal String", một chuỗi được đếm, tức là
sự kết hợp của con trỏ chuỗi và độ dài chuỗi.

[3] Đã thêm các phương pháp mới critcl :: argtypesupport và :: critcl :: argsupport để xác định và sử dụng
mã hỗ trợ bổ sung cho một loại đối số, ở đây được sử dụng bởi "pstring" ở trên để
xác định cấu trúc cần thiết.

[4] Sửa một số lỗi trong các gói critcl :: lớp và critcl :: iassoc. Pragmas cho AS
máy quét dữ liệu meta để đảm bảo rằng các tệp mẫu được tạo thành một phần của gói.
Các phiên bản tăng lần lượt lên 1.0.4 và 1.0.1.

THAY ĐỔI CHO PHIÊN BẢN 3.1.4

[1] Sửa lỗi trong gói critcl :: lớp. Tạo một trường giả trong cấu trúc lớp nếu
lớp không có biến lớp. Nếu không có thay đổi này, cấu trúc sẽ trống,
và một số trình biên dịch không thể xử lý kiểu như vậy.

[2] Sửa lỗi đánh máy làm hỏng cấu hình win64.

[3] Đã khắc phục sự cố # 16, lỗi đánh máy trong tài liệu lệnh critcl :: lớp.

THAY ĐỔI CHO PHIÊN BẢN 3.1.5

[1] Đã khắc phục sự cố # 19. Tạo biểu thức chính quy trích xuất số phiên bản MSVC
tổng quát hơn để làm cho nó hoạt động trên các hệ thống ngôn ngữ Đức. Điều này có thể phải
được xem lại trong tương lai, cho các ngôn ngữ Windows khác.

[2] Đã khắc phục sự cố # 20. Đã thực hiện tùy chọn -tea hoạt động trên windows, ít nhất là trong một trình mô phỏng unix
môi trường như msys / mingw.

THAY ĐỔI CHO PHIÊN BẢN 3.1.6

[1] Đã khắc phục sự cố # 21. Trong khi đa định nghĩa của các biến con trỏ bảng sơ khai là
ok với tất cả các trình liên kết C được thấy cho đến nay Các trình liên kết C ++ không thích điều này chút nào.
Làm lại mã để đảm bảo rằng tập hợp các biến này chỉ được tạo một lần, trong
bao bọc xung quanh tất cả các mảnh để lắp ráp.

[2] Đã khắc phục sự cố # 22, việc xử lý các đối số định danh lệnh của
critcl :: ccommand, critcl :: cprocvà critcl :: cdata. Bây giờ chúng tôi cho phép bất kỳ Tcl nào
định danh và tạo số nhận dạng C nội bộ thích hợp từ chúng.

Là một phần của điều này, chữ ký của lệnh critcl :: name2c đã thay đổi. Lệnh bây giờ
cung cấp danh sách bốn giá trị thay vì ba giá trị. Giá trị mới đã được thêm vào
cuối.

Điều chỉnh hơn nữa việc thực hiện gói critcl :: lớp, một người dùng của
critcl :: name2c. Gói này hiện ở phiên bản 1.0.6 và yêu cầu critcl 3.1.6

Lần cuối cùng đã khắc phục việc xử lý sai tùy chọn -cname in critcl :: ccommandvà
critcl :: cproc.

[3] Đã khắc phục sự cố # 23.

THAY ĐỔI CHO PHIÊN BẢN 3.1.7

[1] Đã khắc phục sự cố # 24. Trích xuất và hiển thị vô điều kiện các cảnh báo trình biên dịch được tìm thấy trong
xây dựng nhật ký. Ngăn người dùng khỏi các cảnh báo bị thiếu, trong khi không gây ra sự cố
không thành công, vẫn có thể chỉ ra vấn đề.

[2] Tính năng mới. Móc đầu ra. Tất cả đầu ra của người dùng không gửi tin nhắn hiện được chuyển qua
lệnh critcl :: printvà người dùng được phép ghi đè nó khi sử dụng critcl
ứng dụng dưới dạng gói.

[3] Tính năng mới, của Ashok P. Nadkarni. Cấu hình nền tảng có thể kế thừa các giá trị từ
cấu hình được xác định trước chúng.

THAY ĐỔI CHO PHIÊN BẢN 3.1.8

[1] Đã khắc phục sự cố với các chỉ số gói được tạo cho Tcl 8.4. Tham gia danh sách các lệnh
có dấu chấm phẩy, không phải dòng mới.

[2] Đã khắc phục sự cố # 26 dẫn đến các trường hợp sử dụng mà tôi đã quên cân nhắc khi sửa
lỗi # 21 (xem critcl 3.1.6).

THAY ĐỔI CHO PHIÊN BẢN 3.1.9

[1] Đã khắc phục sự cố # 27. Đã thêm các định nghĩa nền tảng còn thiếu cho nhiều linux thay thế khác nhau và
Mục tiêu OS X.

[2] Đã khắc phục sự cố # 28. Đã thêm cờ -mXX bị thiếu để liên kết tại linux- {32,64} - *
mục tiêu.

[3] Đã khắc phục sự cố # 29. Đã thay thế việc sử dụng thông tin "cheaders" thô trong quá trình xử lý
của "cdefines" với các chỉ thị bao gồm thích hợp bắt nguồn từ nó.

[4] Đã khắc phục sự cố đằng sau yêu cầu kéo bị từ chối số 30 của Andrew Shadura. Động
trích xuất các khai báo biến sơ khai từ các tệp tiêu đề Tcl và tạo
phù hợp với các định nghĩa biến để sử dụng trong mã gói. Mã được tạo sẽ
bây giờ hãy luôn nhất quán với các tiêu đề, ngay cả khi bản sao của chính critcl về chúng
được thay thế bằng tiêu đề hệ thống.

[5] Đã khắc phục sự cố # 31. Bản vá được chấp nhận bởi Andrew Shadura, với những thay đổi (nhận xét), cho
tích hợp critcl dễ dàng hơn với các hệ thống gói hệ điều hành, thay thế các bản sao critcl của
Tiêu đề Tcl với tiêu đề riêng của họ.

[6] Đã khắc phục sự cố # 32. Yêu cầu kéo hợp nhất của Andrew Shadura. Các lỗi chính tả khác nhau trong
tài liệu và nhận xét.

[7] Đã khắc phục sự cố # 33. Xử lý các tệp bắt đầu bằng dấu chấm tốt hơn.

TÁC GIẢ

Diễn viên:Jean Claude WipplerSteve LandersAndreas Kupries

Sử dụng critcl trực tuyến bằng các dịch vụ onworks.net