Aracılığıyla paylaş


Açıklama blokları

Açıklama blokları bir derleme dosyasının çekirdeğini oluşturur. Hedefleri veya oluşturulacak dosyaları ve bunların bağımlılıklarını, hedefleri oluşturmak için gereken dosyaları açıklar. Açıklama bloğu, bağımlılıklardan hedeflerin nasıl oluşturulacağını açıklayan komutlar içerebilir. Açıklama bloğu, isteğe bağlı olarak bir komut bloğunun ardından gelen bir bağımlılık satırıdır:

targets... : dependents...
    commands...

Bağımlılık satırları

Bağımlılık satırı bir veya daha fazla hedefi ve sıfır veya daha fazla bağımlıyı belirtir. Bir hedef yoksa veya bağımlıdan daha eski bir zaman damgasına sahipse, NMAKE komutları komut bloğunda yürütür. NMAKE ayrıca hedef bir pseudotarget ise komut bloğunu yürütür. Aşağıda örnek bir bağımlılık satırı verilmişti:

hi_bye.exe : hello.obj goodbye.obj helper.lib

Bu bağımlılık satırında hi_bye.exe hedeftir. Bağımlılıkları , goodbye.objve helper.libşeklindedirhello.obj. Bağımlılık satırı, NMAKE'ye hedefi hello.objher , goodbye.objveya helper.lib değerinden daha yakın zamanda değiştiğinde oluşturmasını hi_bye.exesöyler.

Hedefin satırın başında olması gerekir. Hiçbir boşluk veya sekmeyle girintilenemez. Hedefleri bağımlılardan ayırmak için iki nokta üst üste (:) kullanın. Hedefler, iki nokta üst üste ayırıcısı (): ve bağımlılar arasında boşluklara veya sekmelere izin verilir. Bağımlılık satırını bölmek için bir hedef veya bağımlıdan sonra ters eğik çizgi (\) kullanın.

Komut bloklarını yürütmeden önce, NMAKE bağımlılık ağacı oluşturmak için tüm bağımlılıkları ve geçerli çıkarım kurallarını tarar. Bağımlılık ağacı, hedefi tam olarak güncelleştirmek için gereken adımları belirtir. NMAKE, bir bağımlının başka bir bağımlılık listesindeki bir hedef olup olmadığını yinelemeli olarak denetler. Bağımlılık ağacını derledikten sonra NMAKE zaman damgalarını denetler. Ağaçtaki bağımlılardan herhangi biri hedeften daha yeniyse, NMAKE hedefi oluşturur.

Hedefler

Bağımlılık satırının hedefler bölümü bir veya daha fazla hedefi belirtir. Hedef herhangi bir geçerli dosya adı, dizin adı veya pseudotarget olabilir. Bir veya daha fazla boşluk veya sekme kullanarak birden çok hedefi ayırın. Hedefler büyük/küçük harfe duyarlı değildir. Yollara dosya adlarıyla izin verilir. Hedef ve yolu 256 karakteri aşamaz. İki nokta üst üste işaretinden önceki hedef tek bir karakterse, ayırma alanı kullanın. Aksi takdirde, NMAKE harf-iki nokta birleşimini bir sürücü tanımlayıcısı olarak yorumlar.

Birden çok hedef

NMAKE, her biri ayrı bir açıklama bloğunda belirtilmiş gibi tek bir bağımlılıktaki birden çok hedefi değerlendirir.

Örneğin, bu kural:

bounce.exe leap.exe : jump.obj
   echo Building...

şu şekilde değerlendirilir:

bounce.exe : jump.obj
   echo Building...

leap.exe : jump.obj
   echo Building...

Birikmeli bağımlılıklar

Bir hedef yinelenirse bağımlılıklar bir açıklama bloğunda birikmeli olur.

Örneğin, bu kurallar kümesi,

bounce.exe : jump.obj
bounce.exe : up.obj
   echo Building bounce.exe...

şu şekilde değerlendirilir:

bounce.exe : jump.obj up.obj
   echo Building bounce.exe...

Tek bir açıklama bloğunda birden çok bağımlılık satırına birden çok hedefiniz olduğunda, NMAKE bunları her biri ayrı bir açıklama bloğunda belirtilmiş gibi değerlendirir. Ancak yalnızca son bağımlılık satırındaki hedefler komut bloğunu kullanır. NMAKE, diğer hedefler için çıkarım kuralı kullanmayı dener.

Örneğin, bu kurallar kümesi,

leap.exe bounce.exe : jump.obj
bounce.exe climb.exe : up.obj
   echo Building bounce.exe...

şu şekilde değerlendirilir:

leap.exe : jump.obj
# invokes an inference rule

bounce.exe : jump.obj up.obj
   echo Building bounce.exe...

climb.exe : up.obj
   echo Building bounce.exe...

Birden çok açıklama bloğundaki hedefler

Farklı komutları kullanarak birden fazla açıklama bloğundaki bir hedefi güncelleştirmek için, hedefler ve bağımlılar arasında ardışık iki nokta üst üste (::) belirtin.

target.lib :: one.asm two.asm three.asm
    ml one.asm two.asm three.asm
    lib target one.obj two.obj three.obj
target.lib :: four.c five.c
    cl /c four.c five.c
    lib target four.obj five.obj

Bağımlılık yan etkileri

İki nokta üst üste (:) farklı konumlardaki iki bağımlılık satırına sahip bir hedef belirtebilirsiniz. Komutlar satırlardan yalnızca birinden sonra görünürse, NMAKE bağımlılıkları satırlar bitişik veya birleştirilmiş gibi yorumlar. Komutu olmayan bağımlılık için çıkarım kuralı çağırmaz. Bunun yerine, NMAKE bağımlılıkların bir açıklama bloğuna ait olduğunu varsayar ve diğer bağımlılıkla belirtilen komutları yürütür. Bu kural kümesini göz önünde bulundurun:

bounce.exe : jump.obj
   echo Building bounce.exe...

bounce.exe : up.obj

şu şekilde değerlendirilir:

bounce.exe : jump.obj up.obj
   echo Building bounce.exe...

Çift iki nokta üst üste (::) kullanıldığında bu etki oluşmaz. Örneğin, bu kural kümesi:

bounce.exe :: jump.obj
   echo Building bounce.exe...

bounce.exe :: up.obj

şu şekilde değerlendirilir:

bounce.exe : jump.obj
   echo Building bounce.exe...

bounce.exe : up.obj
# invokes an inference rule

Sözde Hedefler

Pseudotarget, bağımlılık satırında dosya adı yerine kullanılan bir etikettir. Mevcut olmayan ve güncel olmayan bir dosya olarak yorumlanır. NMAKE, bir pseudotarget'in zaman damgasının tüm bağımlılarının en son sürümüyle aynı olduğunu varsayar. Bağımlı değilse geçerli saat varsayılır. Hedef olarak bir pseudotarget kullanılırsa, komutları her zaman yürütülür. Bağımlı olarak kullanılan bir pseudotarget de başka bir bağımlılıkta hedef olarak görünmelidir. Ancak bu bağımlılığın komut bloğuna sahip olması gerekmez.

Pseudotarget adları, hedefler için dosya adı söz dizimi kurallarını izler. Ancak, adın bir uzantısı yoksa, dosya adları için 8 karakterlik sınırı aşabilir ve en fazla 256 karakter uzunluğunda olabilir.

NMAKE'nin otomatik olarak birden fazla hedef oluşturmasını istediğinizde sahte hedefler kullanışlıdır. NMAKE yalnızca komut satırında belirtilen hedefleri oluşturur. Veya herhangi bir komut satırı hedefi belirtilmezse, derleme dosyasındaki ilk bağımlılıkta yalnızca ilk hedefi oluşturur. NMAKE'ye komut satırında tek tek listelemeden birden çok hedef oluşturmasını söyleyebilirsiniz. Sahte hedef içeren bir bağımlılığı olan bir açıklama bloğu yazın ve oluşturmak istediğiniz hedefleri bağımlı olarak listeleyin. Ardından, bu açıklama bloğunu ilk olarak makefile'a yerleştirin veya NMAKE komut satırında pseudotarget değerini belirtin.

Bu örnekte UPDATE bir sözde hedeftir.

UPDATE : *.*
COPY $** c:\product\release

UPDATE değerlendirildiğinde, NMAKE geçerli dizindeki tüm dosyaları belirtilen sürücüye ve dizine kopyalar.

Aşağıdaki makefile dosyasında, pseudotarget all hem hem de project1.exe project2.exe komut satırında hedef belirtildiyse veya belirtilmemişse all derleniyor. Pseudotarget setenv , dosyalar güncelleştirilmeden önce LIB ortam değişkenini .exe değiştirir:

all : setenv project1.exe project2.exe

project1.exe : project1.obj
    LINK project1;

project2.exe : project2.obj
    LINK project2;

setenv :
    set LIB=\project\lib

Bağımlılıklar

Bağımlılık satırında, geçerli bir dosya adı veya sözde hedef kullanarak iki nokta üst üste (:) veya çift iki nokta üst üste ():: sonrasında sıfır veya daha fazla bağımlı belirtin. Bir veya daha fazla boşluk veya sekme kullanarak birden çok bağımlıyı ayırın. Bağımlılar büyük/küçük harfe duyarlı değildir. Yollara dosya adlarıyla izin verilir.

Çıkarsanan bağımlılıklar

Bağımlılık satırında açıkça listelediğiniz bağımlılarla birlikte, NMAKE çıkarım yapılan bir bağımlı olduğunu varsayabilir. Çıkarılmış bir bağımlı, çıkarım kuralından türetilir ve açık bağımlılardan önce değerlendirilir. Çıkarsanan bir bağımlı hedefle karşılaştırıldığında güncel olmadığında, NMAKE bağımlılık için komut bloğunu çağırır. Çıkarılan bir bağımlı yoksa veya kendi bağımlılarına kıyasla güncel değilse, NMAKE önce çıkarılan bağımlıyı güncelleştirir. Çıkarımı yapılan bağımlılar hakkında daha fazla bilgi için bkz . Çıkarım kuralları.

Bağımlılıklar için yollar ara

Her bağımlı için isteğe bağlı bir arama yolu belirtebilirsiniz. Aranacak dizin kümesini belirtmek için söz dizimi aşağıdadır:

{directory[;dizin...]}bağımlı

Dizin adlarını ayraç içine alın ({ }). Birden çok dizini noktalı virgülle (;) ayırın. Boşluk veya sekmeye izin verilmez. NMAKE, bağımlıyı önce geçerli dizinde, ardından dizin listesinde belirtilen sırada arar. Arama yolunun bir bölümünü veya tamamını belirtmek için makro kullanabilirsiniz. Bu arama yolunu yalnızca belirtilen bağımlı kullanır.

Dizin arama yolu örneği

Bu bağımlılık satırı, arama için dizin belirtimlerinin nasıl oluşturulacağını gösterir:

reverse.exe : {\src\omega;e:\repo\backwards}retro.obj

Hedefin reverse.exe bağımlı bir tane vardır: retro.obj. Ayraç içine alınmış liste iki dizin belirtir. NMAKE önce geçerli dizinde öğesini retro.obj arar. Orada değilse, NMAKE dizininde \src\omega , sonra da dizininde e:\repo\backwards arama yapın.

Ayrıca bkz.

NMAKE Başvurusu