imake - Online di Awan

PROGRAM:

NAMA

imake - Antarmuka praprosesor C ke utilitas make

RINGKASAN

aku membuat [ -Dmenetapkan ] [ -Idir ] [ -Umenetapkan ] [ -TTemplate ] [ -f nama file ] [ -C nama file ] [
-s nama file ] [ -e ] [ -v ]

DESKRIPSI

Aku membuat digunakan untuk menghasilkan Makefile dari template, satu set cpp fungsi makro, dan a
file input per-direktori yang disebut an file gambar. Ini memungkinkan dependensi mesin (seperti:
opsi kompiler, nama perintah alternatif, dan spesial membuat aturan) untuk disimpan terpisah
dari deskripsi berbagai item yang akan dibangun.

PILIHAN

Opsi baris perintah berikut dapat diteruskan ke aku membuat:

-Dmenetapkan
Opsi ini diteruskan langsung ke cpp. Biasanya digunakan untuk mengatur direktori-
variabel tertentu. Misalnya, Sistem X Window menggunakan tanda ini untuk menyetel TOPDIR
ke nama direktori yang berisi bagian atas distribusi inti dan
CURDIR dengan nama direktori saat ini, relatif ke atas.

-Idirektori
Opsi ini diteruskan langsung ke cpp. Biasanya digunakan untuk menunjukkan
direktori di mana aku membuat file template dan konfigurasi dapat ditemukan.

-Umenetapkan
Opsi ini diteruskan langsung ke cpp. Ini biasanya digunakan untuk menghapus variabel
saat men-debug aku membuat file konfigurasi.

-TTemplate
Opsi ini menentukan nama file template master (yang biasanya adalah
terletak di direktori yang ditentukan dengan -I) digunakan oleh cpp. Standarnya adalah
Imake.tmpl.

-f nama file
Opsi ini menentukan nama file input per direktori. Standarnya adalah
file gambar.

-C nama file
Opsi ini menentukan nama file .c yang dibuat saat ini
direktori. Standarnya adalah Imakefile.c.

-s nama file
Opsi ini menentukan nama dari membuat file deskripsi yang akan dibuat tetapi
membuat tidak harus dipanggil. jika nama file adalah tanda hubung (-), outputnya ditulis
untuk stdout. Standarnya adalah menghasilkan, tetapi tidak mengeksekusi, a Makefile.

-e Opsi ini menunjukkan aku membuat harus mengeksekusi yang dihasilkan Makefile. itu
defaultnya adalah menyerahkan ini kepada pengguna.

-v Pilihan ini menunjukkan bahwa aku membuat harus mencetak cpp baris perintah itu
menggunakan untuk menghasilkan Makefile.

BAGAIMANA IT KARYA

Aku membuat memanggil cpp dengan apapun -I or -D bendera diteruskan pada baris perintah dan melewati nama
dari file yang berisi 3 baris berikut:

#define IMAKE_TEMPLATE "Imake.tmpl"
#define INCLUDE_IMAKEFILE
#sertakan IMAKE_TEMPLATE

dimana Imake.tmpl dan file gambar dapat ditimpa oleh -T dan -f opsi perintah,
masing.

IMAKE_TEMPLATE biasanya membaca dalam file yang berisi parameter yang bergantung pada mesin
(ditentukan sebagai cpp simbol), file parameter khusus situs, file yang mendefinisikan variabel, a
file yang berisi cpp fungsi makro untuk menghasilkan membuat aturan, dan akhirnya file gambar
(ditentukan oleh INCLUDE_IMAKEFILE) di direktori saat ini. Itu file gambar menggunakan makro
berfungsi untuk menunjukkan target apa yang harus dibangun; aku membuat mengurus menghasilkan
aturan yang sesuai.

Aku membuat file konfigurasi berisi dua jenis variabel, variabel imake dan make
variabel. Variabel imake diinterpretasikan oleh cpp ketika aku membuat dijalankan. Dengan perjanjian
mereka kasus campuran. Variabel make ditulis ke dalam Makefile untuk nanti
interpretasi oleh membuat. Dengan konvensi membuat variabel adalah huruf besar.

File aturan (biasanya bernama Aturan Imake di direktori konfigurasi) berisi a
variasi dari cpp fungsi makro yang dikonfigurasi sesuai dengan platform saat ini.
Aku membuat mengganti kemunculan string ``@@'' dengan baris baru untuk mengizinkan makro yang
menghasilkan lebih dari satu baris membuat aturan. Misalnya makro

#define program_target(program, daftar objek) @@\
program: daftar keberatan @@\
$(CC) -o $@ daftar keberatan $(LDFLAGS)

ketika dipanggil dengan program_target(foo, foo1.o foo2.o) akan berkembang menjadi

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

Aku membuat juga mengganti kemunculan kata ``XCOMM'' dengan karakter ``#'' menjadi
izin menempatkan komentar di Makefile tanpa menyebabkan kesalahan `` direktif tidak valid'' dari
praprosesor.

Beberapa kompleks aku membuat makro perlu dihasilkan membuat variabel lokal untuk setiap pemanggilan
makro, seringkali karena nilainya bergantung pada parameter yang diteruskan ke makro. Seperti
variabel dapat dibuat dengan menggunakan aku membuat variabel bentuk Pertahanan XVARn, Di mana n adalah
satu digit. Unik membuat variabel akan diganti. Kejadian selanjutnya dari
variabel penggunaan XVARn akan digantikan oleh variabel yang dibuat oleh yang sesuai Pertahanan XVARn.

Pada sistem yang cpp mengurangi banyak tab dan spasi menjadi satu spasi, aku membuat mencoba untuk
kembalikan semua tab yang diperlukan (membuat sangat pilih-pilih tentang perbedaan antara tab dan
spasi). Untuk alasan ini, titik dua (:) di baris perintah harus didahului dengan garis miring terbalik
(\).

GUNAKAN DENGAN THE X WINDOW SISTEM

Sistem X Window yang digunakan aku membuat secara ekstensif melalui rilis X11R6.9, untuk keduanya penuh
dibangun di dalam pohon sumber dan perangkat lunak eksternal. X telah dipindahkan ke autoconf GNU
dan automake untuk sistem build-nya di X11R7.0 dan rilis yang lebih baru, tetapi masih mempertahankan imake
untuk membangun program perangkat lunak eksternal yang ada yang belum dikonversi.

Seperti disebutkan di atas, dua variabel khusus, TOPDIR dan KURDIR, diatur untuk membuat referensi
file menggunakan nama jalur relatif lebih mudah. Misalnya, perintah berikut dihasilkan
secara otomatis untuk membangun Makefile di direktori perpustakaan/X/ (relatif terhadap bagian atas
sumber):

% ../.././config/imake -I../.././config \
-DTOPDIR=../../. -DCURDIR=./lib/X
Saat membangun program X di luar pohon sumber, simbol khusus Gunakan Terpasang didefinisikan
dan TOPDIR dan CURDIR dihilangkan. Jika file konfigurasi sudah benar
diinstal, skrip xmkmf(1) dapat digunakan.

INPUT FILE

Berikut adalah ringkasan dari file yang dibaca oleh aku membuat seperti yang digunakan oleh X. Indentasi menunjukkan apa
file termasuk apa file lainnya.
Variabel generik Imake.tmpl
site.def khusus situs, SebelumVendorCF ditentukan
*.cf khusus mesin
*Lib.rules aturan perpustakaan bersama
site.def khusus situs, ditentukan AfterVendorCF
Imake.rules aturan
Variabel khusus Project.tmpl X
*Lib.tmpl variabel perpustakaan bersama
file gambar
Library.tmpl aturan perpustakaan
Aturan server server.tmpl
Aturan multi-utas Threads.tmpl

Perhatikan bahwa situs.def disertakan dua kali, sekali sebelum *.lih file dan sekali setelahnya.
Meskipun sebagian besar penyesuaian situs harus ditentukan setelah *.lih file, beberapa, seperti
pilihan kompiler, perlu ditentukan sebelumnya, karena pengaturan variabel lain mungkin
bergantung pada mereka.

Pertama kali situs.def disertakan, variabel BeforeVendorCF didefinisikan, dan
kedua kalinya, variabel AfterVendorCF didefinisikan. Semua kode di situs.def harus di dalam
sebuah #ifdef untuk salah satu simbol ini.

Gunakan imake online menggunakan layanan onworks.net