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

CHƯƠNG TRÌNH:

TÊN

imake - Giao diện tiền xử lý C cho tiện ích tạo

SYNOPSIS

tôi làm [ -Dđịnh nghĩa ] [ -Idir ] [ -Uđịnh nghĩa ] [ -Tmẫu ] [ -f tên tập tin ] [ -C tên tập tin ] [
-s tên tập tin ] [ -e ] [ -v ]

MÔ TẢ

Tôi làm được sử dụng để tạo ra Trang điểm từ một mẫu, một bộ cpp các chức năng vĩ mô và
tập tin đầu vào trên mỗi thư mục được gọi là tập tin hình ảnh. Điều này cho phép các phụ thuộc của máy (chẳng hạn như
tùy chọn trình biên dịch, tên lệnh thay thế và đặc biệt làm cho quy tắc) được giữ riêng biệt
từ các mô tả của các hạng mục khác nhau sẽ được xây dựng.

LỰA CHỌN

Các tùy chọn dòng lệnh sau có thể được chuyển tới tôi làm:

-Dđịnh nghĩa
Tùy chọn này được chuyển trực tiếp tới cpp. Nó thường được sử dụng để thiết lập thư mục-
các biến cụ thể. Ví dụ: Hệ thống X Window đã sử dụng cờ này để đặt TOPDIR
vào tên của thư mục chứa phần trên cùng của bản phân phối lõi và
CUỘN theo tên của thư mục hiện tại, tương đối so với đầu.

-Ithư mục
Tùy chọn này được chuyển trực tiếp tới cpp. Nó thường được sử dụng để chỉ ra
thư mục trong đó tôi làm mẫu và tập tin cấu hình có thể được tìm thấy.

-Uđịnh nghĩa
Tùy chọn này được chuyển trực tiếp tới cpp. Nó thường được sử dụng để bỏ đặt các biến
khi gỡ lỗi tôi làm tập tin cấu hình.

-Tmẫu
Tùy chọn này chỉ định tên của tệp mẫu chính (thường là
nằm trong thư mục được chỉ định với -I) được sử dụng bởi cpp. Mặc định là
Imake.tmpl.

-f tên tập tin
Tùy chọn này chỉ định tên của tệp đầu vào trên mỗi thư mục. Mặc định là
tập tin hình ảnh.

-C tên tập tin
Tùy chọn này chỉ định tên của tệp .c được xây dựng trong hiện tại
danh mục. Mặc định là Imakefile.c.

-s tên tập tin
Tùy chọn này chỉ định tên của làm cho tập tin mô tả sẽ được tạo ra nhưng
làm cho không nên triệu tập. Nếu tên tập tin là dấu gạch ngang (-), đầu ra được viết
đến tiêu chuẩn. Giá trị mặc định là tạo ra nhưng không thực thi một makefile.

-e Tùy chọn này cho biết tôi làm nên thực hiện việc tạo ra makefile. Các
mặc định là để lại việc này cho người dùng.

-v Tùy chọn này chỉ ra rằng tôi làm nên in cpp dòng lệnh đó là
sử dụng để tạo ra makefile.

LÀM THẾ NÀO IT LÀM RA SAO

Tôi làm viện dẫn cpp với bất kỳ -I or -D cờ được truyền trên dòng lệnh và chuyển tên
của một tập tin chứa 3 dòng sau:

#define IMAKE_TEMPLATE "Imake.tmpl"
#xác định INCLUDE_IMAKEFILE
#include IMAKE_TEMPLATE

Ở đâu Imake.tmpl và tập tin hình ảnh có thể bị ghi đè bởi -T và -f tùy chọn lệnh,
tương ứng.

IMAKE_TEMPLATE thường đọc trong tệp chứa các tham số phụ thuộc vào máy
(được chỉ định là cpp các ký hiệu), một tệp tham số dành riêng cho trang web, một tệp xác định các biến, một
tệp chứa cpp các hàm macro để tạo làm cho quy tắc và cuối cùng là tập tin hình ảnh
(được chỉ định bởi INCLUDE_IMAKEFILE) trong thư mục hiện tại. Các tập tin hình ảnh sử dụng macro
chức năng chỉ ra những mục tiêu nào cần được xây dựng; tôi làm đảm nhiệm việc tạo ra
những quy định thích hợp.

Tôi làm Các tập tin cấu hình chứa hai loại biến, biến imake và biến make
biến. Các biến imake được giải thích bởi cpp khi tôi làm chạy. Theo quy ước
chúng là trường hợp hỗn hợp. Các biến make được ghi vào makefile cho sau này
giải thích bởi chế tạo. Theo quy ước, các biến sẽ được viết hoa.

Tệp quy tắc (thường được đặt tên Imake.rules trong thư mục cấu hình) chứa một
nhiều cpp các chức năng macro được cấu hình theo nền tảng hiện tại.
Tôi làm thay thế bất kỳ lần xuất hiện nào của chuỗi ``@@'' bằng một dòng mới để cho phép các macro
tạo ra nhiều hơn một dòng làm cho quy tắc. Ví dụ: vĩ mô

#define chương trình_target(chương trình, danh sách đối tượng) @@\
chương trình: danh sách đối tượng @@\
$(CC) -o $@ danh sách đối tượng $(LDFLAGS)

khi được gọi với chương trình_target(foo, foo1.o foo2.o) sẽ mở rộng đến

foo: foo1.o foo2.o
$(CC) -o $@ foo1.o foo2.o $(LDFLAGS)

Tôi làm cũng thay thế bất kỳ lần xuất hiện nào của từ ``XCOMM'' bằng ký tự ``#'' thành
cho phép đặt nhận xét trong Makefile mà không gây ra lỗi ``lệnh không hợp lệ'' từ
bộ tiền xử lý.

Một số phức tạp tôi làm macro yêu cầu tạo làm cho các biến cục bộ cho mỗi lệnh gọi của
macro, thường là do giá trị của chúng phụ thuộc vào các tham số được truyền cho macro. Như là
các biến có thể được tạo bằng cách sử dụng một tôi làm biến có dạng XVARdefn, Nơi n là một
chữ số duy nhất. Một sự độc đáo làm cho biến sẽ được thay thế. Những lần xuất hiện sau đó của
biến XVARsử dụngn sẽ được thay thế bằng biến được tạo bởi biến tương ứng XVARdefn.

Trên các hệ thống có cpp giảm nhiều tab và dấu cách thành một khoảng trắng, tôi làm cố gắng
đặt lại mọi tab cần thiết (làm cho rất kén chọn về sự khác biệt giữa các tab và
khoảng trắng). Vì lý do này, dấu hai chấm (:) trong dòng lệnh phải được đặt trước dấu gạch chéo ngược
(\).

SỬ DỤNG CÙNG VỚI CÁC X Cửa sổ WELFARE

Hệ thống X Window được sử dụng tôi làm được nâng cấp rộng rãi thông qua bản phát hành X11R6.9, cho cả phiên bản đầy đủ
xây dựng trong cây nguồn và phần mềm bên ngoài. X đã chuyển sang GNU autoconf
và tự động hóa cho hệ thống xây dựng của nó trong X11R7.0 và các bản phát hành mới hơn, nhưng vẫn duy trì imake
để xây dựng các chương trình phần mềm bên ngoài hiện có chưa được chuyển đổi.

Như đã đề cập ở trên, hai biến đặc biệt, TOPDIR và sữa chua, được thiết lập để làm tài liệu tham khảo
các tập tin sử dụng tên đường dẫn tương đối dễ dàng hơn. Ví dụ: lệnh sau được tạo
tự động để xây dựng makefile trong danh bạ lib/X/ (so với đỉnh của
nguồn):

% ../.././config/imake -I../.././config \
-DTOPDIR=../../. -DCURDIR=./lib/X
Khi xây dựng chương trình X bên ngoài cây nguồn, một ký hiệu đặc biệt Sử dụngĐã cài đặt được định nghĩa
và TOPDIR và CUỘN được bỏ qua. Nếu các tập tin cấu hình đã được cài đặt đúng cách
đã cài đặt, tập lệnh xmkmf(1) có thể được sử dụng.

ĐẦU VÀO CÁC TẬP TIN

Đây là bản tóm tắt các tập tin được đọc bởi tôi làm như được sử dụng bởi X. Vết thụt đầu dòng cho thấy những gì
các tập tin bao gồm những tập tin khác.
Biến chung của Imake.tmpl
site.def dành riêng cho trang web, được xác định BeforeVendorCF
*.cf dành riêng cho máy
*Quy tắc thư viện chia sẻ Lib.rules
site.def dành riêng cho trang web, AfterVendorCF được xác định
Quy tắc Imake.rules
Các biến cụ thể của Project.tmpl X
*Các biến thư viện chia sẻ Lib.tmpl
tập tin hình ảnh
Quy tắc thư viện Library.tmpl
Quy tắc máy chủ Server.tmpl
Quy tắc đa luồng Threads.tmpl

Lưu ý rằng trang web.def được bao gồm hai lần, một lần trước *.cf tập tin và một lần sau đó.
Mặc dù hầu hết các tùy chỉnh trang web phải được chỉ định sau *.cf tập tin, một số, chẳng hạn như
việc lựa chọn trình biên dịch cần phải được chỉ định trước vì các cài đặt biến khác có thể
phụ thuộc vào họ.

Lần đầu tiên trang web.def được bao gồm, biến BeforeVendorCF được xác định và
lần thứ hai, biến AfterVendorCF được xác định. Tất cả mã trong trang web.def nên ở bên trong
#ifdef cho một trong những biểu tượng này.

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