imake - Online sa Cloud

PROGRAMA:

NAME

imake - C preprocessor interface sa make utility

SINOPSIS

imake [ -Dmagtakda ] [ -Idir ] [ -Umagtakda ] [ -Ttemplate ] [ -f filename ] [ -C filename ] [
-s filename ] [ -e ] [ -v ]

DESCRIPTION

Imake ay ginagamit upang makabuo Makefiles mula sa isang template, isang set ng cpp macro function, at a
per-directory input file na tinatawag na an Imakefile. Pinapayagan nito ang mga dependency ng makina (tulad ng
mga opsyon sa compiler, mga alternatibong pangalan ng command, at espesyal gumawa mga panuntunan) na dapat panatilihing hiwalay
mula sa mga paglalarawan ng iba't ibang bagay na gagawin.

Opsyon

Ang mga sumusunod na opsyon sa command line ay maaaring maipasa sa imake:

-Dmagtakda
Direktang ipinapasa ang opsyong ito sa cpp. Ito ay karaniwang ginagamit upang magtakda ng direktoryo-
tiyak na mga variable. Halimbawa, ginamit ng X Window System ang flag na ito upang itakda TOPDIR
sa pangalan ng direktoryo na naglalaman ng tuktok ng pangunahing pamamahagi at
CURDIR sa pangalan ng kasalukuyang direktoryo, na nauugnay sa itaas.

-Idirektoryo
Direktang ipinapasa ang opsyong ito sa cpp. Ito ay karaniwang ginagamit upang ipahiwatig ang
direktoryo kung saan ang imake maaaring mahanap ang template at configuration file.

-Umagtakda
Direktang ipinapasa ang opsyong ito sa cpp. Karaniwan itong ginagamit upang i-unset ang mga variable
kapag nagde-debug imake mga file ng pagsasaayos.

-Ttemplate
Tinutukoy ng opsyong ito ang pangalan ng master template file (na karaniwan ay
matatagpuan sa direktoryo na tinukoy sa -I) ginamit ni cpp. Ang default ay
Imake.tmpl.

-f filename
Tinutukoy ng opsyong ito ang pangalan ng per-directory input file. Ang default ay
Imakefile.

-C filename
Tinutukoy ng opsyong ito ang pangalan ng .c file na binuo sa kasalukuyang
direktoryo. Ang default ay Imakefile.c.

-s filename
Tinutukoy ng opsyong ito ang pangalan ng gumawa paglalarawan file na bubuo ngunit
gumawa hindi dapat itawag. Kung ang filename ay isang gitling (-), ang output ay nakasulat
sa stdout. Ang default ay upang bumuo, ngunit hindi isagawa, a Makefile.

-e Ang pagpipiliang ito ay nagpapahiwatig ng imake dapat isagawa ang nabuo Makefile. ang
Ang default ay iwanan ito sa user.

-v Ang pagpipiliang ito ay nagpapahiwatig na imake dapat i-print ang cpp command line na ito
ginagamit upang makabuo ng Makefile.

PAANO IT gUMAGANA

Imake panunaw cpp sa anumang -I or -D ipinasa ang mga flag sa command line at ipinapasa ang pangalan
ng isang file na naglalaman ng sumusunod na 3 linya:

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

saan Imake.tmpl at Imakefile maaaring ma-override ng -T at -f mga pagpipilian sa command,
ayon sa pagkakabanggit.

Ang IMAKE_TEMPLATE ay karaniwang nagbabasa sa isang file na naglalaman ng mga parameter na nakadepende sa makina
(tinukoy bilang cpp mga simbolo), isang file ng mga parameter na tukoy sa site, isang file na tumutukoy sa mga variable, a
file na naglalaman ng cpp macro function para sa pagbuo gumawa mga panuntunan, at panghuli ang Imakefile
(tinukoy ng INCLUDE_IMAKEFILE) sa kasalukuyang direktoryo. Ang Imakefile gumagamit ng macro
mga function upang ipahiwatig kung anong mga target ang dapat itayo; imake nangangalaga sa pagbuo ng
angkop na mga tuntunin.

Imake Ang mga configuration file ay naglalaman ng dalawang uri ng mga variable, imake variable at make
mga variable. Ang mga variable ng imake ay binibigyang kahulugan ng cpp kapag imake ay tumakbo. Sa pamamagitan ng convention
mixed case sila. Ang gumawa ng mga variable ay nakasulat sa Makefile para mamaya
interpretasyon ni gumawa. Sa pamamagitan ng convention gumawa ng mga variable ay upper case.

Ang file ng mga patakaran (karaniwang pinangalanan Imake.rules sa direktoryo ng pagsasaayos) ay naglalaman ng a
iba't-ibang cpp macro function na na-configure ayon sa kasalukuyang platform.
Imake pinapalitan ang anumang paglitaw ng string ``@@'' ng isang bagong linya upang payagan ang mga macro na iyon
bumuo ng higit sa isang linya ng gumawa mga tuntunin. Halimbawa, ang macro

#define program_target(program, objlist) @@\
programa: objlist @@\
$(CC) -o $@ objlist $(LDFLAGS)

kapag tinawag kasama program_target(foo, foo1.o foo2.o) lalawak sa

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

Imake pinapalitan din ang anumang paglitaw ng salitang ``XCOMM'' ng character na ``#'' sa
pinahihintulutan ang paglalagay ng mga komento sa Makefile nang hindi nagiging sanhi ng mga error na ``di-wastong direktiba
ang preprocessor.

Ilang kumplikado imake macros nangangailangan nabuo gumawa mga variable na lokal sa bawat invocation ng
macro, kadalasan dahil ang kanilang halaga ay nakadepende sa mga parameter na ipinasa sa macro. ganyan
Ang mga variable ay maaaring malikha sa pamamagitan ng paggamit ng isang imake variable ng anyo XVARdefn, Kung saan n ay isang
isang digit. Isang kakaiba gumawa ang variable ay papalitan. Ang mga susunod na pangyayari ng
nagbabago XVARusen ay papalitan ng variable na nilikha ng kaukulang XVARdefn.

Sa mga sistema kung saan cpp binabawasan ang maraming tab at espasyo sa isang espasyo, imake pagtatangka upang
ibalik ang anumang kinakailangang tab (gumawa ay masyadong mapili tungkol sa pagkakaiba sa pagitan ng mga tab at
mga puwang). Para sa kadahilanang ito, ang mga tutuldok (:) sa mga linya ng command ay dapat na unahan ng backslash
(\).

GAMITIN SA ANG X WINDOW SYSTEM

Ginamit ang X Window System imake malawakan hanggang sa paglabas ng X11R6.9, para sa parehong puno
bubuo sa loob ng source tree at panlabas na software. Lumipat na ang X sa GNU autoconf
at automake para sa build system nito sa X11R7.0 at ipapalabas sa ibang pagkakataon, ngunit pinapanatili pa rin ang imake
para sa pagbuo ng mga umiiral na panlabas na software program na hindi pa na-convert.

Tulad ng nabanggit sa itaas, dalawang espesyal na variable, TOPDIR at CURDIR, ay nakatakdang gumawa ng sanggunian
mga file gamit ang mga kamag-anak na pangalan ng path. Halimbawa, nabuo ang sumusunod na command
awtomatikong bumuo ng Makefile sa direktoryo lib/X/ (kamag-anak sa tuktok ng
mga mapagkukunan):

% ../.././config/imake -I../.././config \
-DTOPDIR=../../. -DCURDIR=./lib/X
Kapag nagtatayo ng mga X program sa labas ng source tree, isang espesyal na simbolo UseInstalled ay tinukoy
at TOPDIR at CURDIR ay tinanggal. Kung ang mga file ng pagsasaayos ay maayos
naka-install, ang script xmkmf(1) maaaring gamitin.

INPUT MGA FILE

Narito ang isang buod ng mga file na binasa ni imake gaya ng ginamit ng X. Ang indentation ay nagpapakita kung ano
Kasama sa mga file kung ano ang iba pang mga file.
Imake.tmpl generic na mga variable
site.def site-specific, tinukoy ng BeforeVendorCF
*.cf partikular sa makina
*Nakabahaging mga panuntunan sa library ang Lib.rules
site.def site-specific, tinukoy ng AfterVendorCF
Imake.rules rules
Project.tmpl X-specific na mga variable
*Lib.tmpl shared library variable
Imakefile
Mga panuntunan sa library.tmpl library
Mga panuntunan ng server.tmpl server
Threads.tmpl multi-threaded na mga panuntunan

Tandaan na ang site.def ay naisasama ng dalawang beses, isang beses bago ang *.cf file at isang beses pagkatapos.
Bagama't ang karamihan sa mga pagpapasadya ng site ay dapat na tukuyin pagkatapos ng *.cf file, ang ilan, tulad ng
ang pagpili ng tagatala, kailangang tukuyin bago, dahil ang iba pang mga variable na setting ay maaaring
depende sa kanila.

Unang beses site.def ay kasama, ang variable BeforeVendorCF ay tinukoy, at ang
sa pangalawang pagkakataon, ang variable na AfterVendorCF ay tinukoy. Pasok lahat ng code site.def dapat nasa loob
isang #ifdef para sa isa sa mga simbolo na ito.

Gamitin ang imake online gamit ang mga serbisyo ng onworks.net