aecp - Bulutta Çevrimiçi

Program:

ADI

aegis kopya dosyası - bir dosyayı bir değişikliğe kopyalayın

SİNOPSİS

siper -Dosya kopyalamak [ seçenek... ] Dosya...
siper -Dosya kopyalamak -Bağımsız [ seçenek... ] Dosya...
siper -Dosya kopyalamak -Liste [ seçenek... ]
siper -Dosya kopyalamak -Yardım

TANIM

The siper -Dosya kopyalamak komutu, bir dosyayı bir değişikliğe kopyalamak için kullanılır. Adlandırılmış dosyalar
taban çizgisinden geliştirme dizinine kopyalanmalı ve listeye eklenmelidir.
Değişiklikteki dosyalar. Temelden kopyalanan dosyaların sürümü hatırlanır.

Bu komut, testleri yalnızca kaynak dosyalara değil, bir değişikliğe kopyalamak için kullanılabilir. testler
diğer herhangi bir kaynak dosya gibi ele alınır ve aynı işleme tabi tutulur.

Uyarı: Geliştirme dizininde aynı adı taşıyan dosyalar varsa, bunlar
bu komutla üzerine yazılır.

Ayrıca dizinleri de adlandırabilirsiniz. Adlandırılmış dizinlerdeki tüm kaynak dosyalar ve tümü
altındaki dizinler, taban çizgisinden geliştirme dizinine kopyalanacak,
ve değişiklikteki dosyalar listesine eklendi.

Dosyaları açıkça kopyalarken, dosya zaten değişikliğin bir parçasıysa bu bir hatadır.
Bir dizini adlandırdığınızda, projedeki tüm kaynak dosyalar o dizinin altında
zaten değişiklikte olanlar dışında kopyalanır. Hiçbiri yoksa bu bir hatadır.
dizin tarafından dolaylı olarak adlandırılan dosyalar kullanılabilir.

Kopyalanan bir kaynak dosyayı yürütülebilir olacak şekilde değiştirmek istiyorsanız (örneğin kabuk komut dosyaları)
o zaman sadece normali kullanırsın chmod(1) komut; yürütülebilir olmaması için tersini yapın.
Dosyanın yürütülebilir bitlerinden herhangi biri şurada ayarlanmışsa: yardımcı(1) dosyanın şu şekilde hatırlandığı zaman
yürütülebilir ve tüm yürütme bitleri (eksi projenin umask'ı) sonraki tarafından belirlenir
aecp(1) komutlar.

fileto Name Yorumlama
Aegis programı, dosya adlarından proje dosya adlarını belirlemeye çalışacaktır.
komut satırında verilir. Tüm dosya adları, aegis projelerinde göreli olarak saklanır
temel dizin ağacının köküne. Geliştirme dizini ve
entegrasyon dizini, bu temel dizinin gölgeleridir ve dolayısıyla bu göreli adlar
buraya da başvurun. Komut satırında adlandırılan dosyalar önce mutlak yollara dönüştürülür
Eğer gerekliyse. Daha sonra, geliştirme dizini olan temel yol ile karşılaştırılırlar.
temele göre bir ad belirlemek için yol ve tümleştirme dizini yolu. Bu
adlı dosya bu dizin ağaçlarından birinin dışındaysa bir hata.

The -BAse_RElative seçenek, göreli dosya adlarının şu şekilde yorumlanmasına neden olmak için kullanılabilir.
temel yola göre; mutlak dosya adları yine de çeşitli dosya adlarıyla karşılaştırılacaktır.
temele göre bir ad belirlemek için yollar.

The göreceli_dosyaadı_tercih kullanıcı yapılandırma dosyasında değişiklik yapmak için kullanılabilir
bu varsayılan davranış. Görmek aeuconf(5) daha fazla bilgi için.

süreci Yan etkileri
Bu komut, başka bir dosya eklendiğinden herhangi bir derleme veya test kaydını iptal edecektir.
mantıksal olarak geçersiz kılar. Proje yapılandırma dosyası eklendiyse, herhangi bir fark
kayıt da iptal edilecektir.

Değişiklik dosyaları listelendiğinde (siper -Liste Dosya_Değiştir -TERse) kopyalanan dosyalar
listede görünür. Proje dosyaları açık bir değişiklik numarasıyla listelendiğinde
(siper -Liste Proje_Dosyaları -TERse -Değişiklik N) değişiklik dosyalarının hiçbiri dahil
kopyalanan dosyalar, kısa listede görünecektir. Bu iki özellik,
kaynak dosyaların listesini oluşturmak için bir DMT içinden aegis çağırma.

L' TEMEL KİLİT

Taban çizgisi kilidi, taban çizgisinin tutarlı bir durumda kalmasını sağlamak için kullanılır.
taban çizgisindeki dosyaların içeriğini okuması gereken komutların süresi.

Taban çizgisinin tutarlı olmasını gerektiren komutlar (bunlar şunları içerir: aeb(1)
aecp(1) ve aED(1) komutlar) bir temel alın okumak kilit. Bu özel olmayan bir kilit, yani
değişikliklerin eşzamanlı gelişimi engellenmez.

Taban çizgisini değiştiren komut, geçit(1), bir temel alır yazmak kilit. Bu
özel bir kilittir, zorlar geçit(1) aktif taban çizgisi okuması kalmayana kadar engellemek için
kilitlenir.

Yukarıdaki geliştirme komutlarından birinin, bir devam edene kadar engellemesi mümkündür.
siper -Entegre_PASS tamamlar. Proje süresince bu genellikle kısa sürelidir.
tarih güncellendi. Bu komutların tutarlı bir sonuç alması için gecikme önemlidir.
taban çizgisinin görünümü. Başka hiçbir entegrasyon komutu yukarıdaki gelişmeye neden olmaz
engelleme komutları.

Aegis'in şube işlevi kullanımdayken, üzerinde bir okuma (özel olmayan) kilidi alınır.
dal taban çizgisi ve ayrıca "üst" taban çizgilerinin her biri. Ancak, bir temel yazma
(özel) kilit yalnızca dal temel çizgisinde alınır; "üst" taban çizgileri yalnızca
okuma (münhasır olmayan) kilitli.

TEST KORELASYONLAR

“aegis -Test -SUGgest” komutu, aegis'in uygun regresyon önermesini sağlamak için kullanılabilir.
değişikliğinizdeki kaynak dosyalara dayalı olarak değişikliğinizi test eder. Bu otomatik olarak
Test çabalarını ilgili testlere odaklayarak regresyon testlerinin sayısını azaltır
bir hata eklemediğinizden emin olmak için gereklidir.

Test korelasyonları, "aegis -Integrate_Pass" komutu tarafından oluşturulur.
değişiklikteki her testi, değişiklikteki her kaynak dosyayla ilişkilendirir. Böylece, her
kaynak dosya, geçmişte kendisiyle ilişkilendirilmiş testlerin bir listesini toplar.
Bu, kod kapsamı analizi kadar kesin değildir, ancak makul bir yaklaşımdır.
uygulama.

The aecp(1) ve aenf(1) komutlar, bir değişiklikle dosyaları ilişkilendirmek için kullanılır. Onlar iken
ilişkilendirmeyi aktif olarak gerçekleştirmeyin, bunlar tarafından kullanılan dosyalardır. geçit(1) ve
aet(1) hangi kaynak dosyalarının hangi testlerle ilişkili olduğunu belirlemek için.

test Ilişki doğruluk
Test korelasyonlarının doğru olduğunu ve testlerin eşit olduğunu varsayarsak
fonksiyon alanı boyunca dağıtılmış, daha az olacaktır 1/sayı şans ki bir
ilgili test “aegis -Test -SUGgest” tarafından yürütülmemiştir. numara" emretmek. Küçük
test ağırlığına bir miktar gürültü eklenir, böylece beklenmedik şeyler bazen
test edilir ve aynı testler her seferinde çalıştırılmaz.

Test korelasyon doğruluğu, aşağıdakiler sağlanarak geliştirilebilir:

· Her değişiklik, gereksiz dosya eklemeleri olmadan güçlü bir şekilde odaklanmalıdır. Bu
sahte korelasyonlardan kaçınır.

· Her yeni işlevsellik öğesi, yeni işlevler yerine bireysel bir değişiklikle eklenmelidir.
birkaç birlikte. Bu, testleri işlevsellikle güçlü bir şekilde ilişkilendirir.

· Her bir hata, birden fazla hata yerine tek bir değişiklikle düzeltilmelidir. Bu
testleri işlevsellikle güçlü bir şekilde ilişkilendirir.

· Dosyalar taşınırsa test korelasyonları kaybolur. Bunun nedeni, korelasyonların
adı.

Testlerin kaynak dosyalarla doğru bir şekilde ilişkilendirilmesinin en iyi yolu, bir değişiklik olduğunda
bir test ve tam olarak test edilen işlevsellik ile ilgili dosyaları içerir. Fazla
birçok sahte dosya, test korelasyonlarının kullanışlılığını zayıflatacaktır.

Bildirim
The kopya_dosya_komutu Projede yapılandırma ayarlanmışsa dosya çalıştırılır. NS proje_dosyası_‐
komuta ayarlanmışsa ve yakın zamanda bir entegrasyon olmuşsa da çalıştırılır. Görmek
aepconf(5) daha fazla bilgi için.

fileto Action Ayar
Bu komut çalıştığında, önce değişiklik dosyalarını proje dosyalarına göre kontrol eder. Eğer
tutarsızlıklar varsa, dosya eylemleri aşağıdaki gibi ayarlanacaktır:

create Bir dosya oluşturuluyorsa, ancak başka bir değişiklik seti entegre edilmişse, bu da
dosyayı oluşturur, halen geliştirilmekte olan değişiklik kümesindeki dosya eylemi
"değiştirmek" için ayarlandı.

değiştirmek Bir dosya değiştiriliyorsa, ancak kaldırılan başka bir değişiklik seti entegre edilmişse
dosya, hala geliştirilmekte olan değişiklik kümesindeki dosya eylemi
"oluşturmak" için ayarlandı.

kaldır Bir dosya kaldırılıyorsa, ancak kaldırılan başka bir değişiklik kümesi entegre edilmişse
dosya, halen geliştirilmekte olan değişiklik kümesinden çıkarılacaktır.

SEÇENEKLER

Aşağıdaki seçenekler anlaşılmıştır:

-BAse_RElative
Bu seçenek, göreli dosya adlarının göreli olarak değerlendirilmesine neden olmak için kullanılabilir.
kaynak ağacın tabanı. Görmek aeuconf(5) ilgili kullanıcı için
tercih.

-CUrrent_RElative
Bu seçenek, göreli dosya adlarının göreli olarak değerlendirilmesine neden olmak için kullanılabilir.
geçerli dizin. Bu genellikle varsayılandır. Görmek aeuconf(5) için
ilgili kullanıcı tercihi.

-Dal numara
Bu seçenek, kaynak dosya için farklı bir dal belirtmek için kullanılabilir.
taban çizgisinden daha fazla. (Ayrıca bakınız -Gövde seçenek. Lütfen Dikkat: -Dal seçenek
proje adı almaz, sadece şube numarası soneki alır.

-Büyük Ebeveyn
Bu seçenek, büyük ebeveyn dalı belirtmek için kullanılabilir (bir
geçerli dal) taban çizgisi yerine kaynak dosya için. (-dedesi
seçeneği “-branch ..” seçeneğiyle aynıdır.)

-Değişiklik numara
Bu seçenek, bir proje içinde belirli bir değişikliği belirtmek için kullanılabilir. Görmek
siper(1) bu seçeneğin tam açıklaması için.

-Delta numara
Bu seçenek, projenin geçmişinde belirli bir delta belirtmek için kullanılabilir.
dosyayı en güncel sürümden ziyade kopyalayın. delta olmuşsa
bir isim verildi (bkz. aedn(1) nasıl) delta yerine delta adı kullanabilirsiniz
sayı. Belirtilen delta yoksa bu bir hatadır. Delta numaraları
1'den başlayın ve artırın; delta 0, "dallandığında" anlamına gelen özel bir durumdur.
başladı”.

-DELta_Tarihi dizi
Bu seçenek, projenin belirli bir tarih ve saatini belirtmek için kullanılabilir.
Dosyayı en güncel sürümden ziyade kopyalamak için geçmiş. O bir
Belirtilen dize geçerli bir tarih ve saat olarak yorumlanamazsa hata.
Boşluk kullanmanız gerekiyorsa dizeyi alıntılayın.

-DELta_From_Change numara
Bu seçenek, değişikliğinden belirli bir proje deltasını belirtmek için kullanılabilir.
numarası.

-Yardım
Bu seçenek, cihazın nasıl kullanılacağı hakkında daha fazla bilgi edinmek için kullanılabilir. siper
programı.

-Bağımsız
Bu seçenek, kopyanın herhangi bir dosyadan bağımsız olarak çalıştırılacağını belirtmek için kullanılır.
özel değişiklik. Dosyalar geçerli dizine göre kopyalanacaktır.

-Kale
Bu seçenek, genellikle silinen veya silinen dosyaları ve/veya dizinleri saklamak için kullanılabilir.
komutuyla değiştirilir. Kullanıcının varsayılanları delete_file_preference değilse
belirtilen, bkz. aeuconf(5) daha fazla bilgi için.

-Hayır_Keep
Bu seçenek, dosyaların ve/veya dizinlerin silinmesini sağlamak için kullanılabilir.
veya komutla değiştirilir. Kullanıcının varsayılanları delete_file_preference değilse
belirtilen, bkz. aeuconf(5) daha fazla bilgi için.

-Liste
Bu seçenek, bu komut için uygun konuların bir listesini elde etmek için kullanılabilir.
Liste beklenenden daha genel olabilir.

-Logging_Logging
Bu seçenek, çıktıların ve hataların otomatik olarak günlüğe kaydedilmesini devre dışı bırakmak için kullanılabilir.
bir dosya. Bu, genellikle birkaç aegis komutu bir kabukta birleştirildiğinde kullanışlıdır.
komut.

-Çıktı Dosya
Bu seçenek, kopyalanan bir dosyanın çıktı dosyasını belirtmek için kullanılabilir.
temel. Bu seçenek kullanıldığında yalnızca bir temel dosya adlandırılabilir. NS
dosya adı "-" standart çıktı anlamına gelir. Bu seçenek
dosyayı değişiklik dosyaları grubuna ekleyin. Yok hayır kilitler bu seçenek alındığında alınır
kullanılmış, taban çizgisi okuma kilidi bile değil.

-Üzerine Yazma
Bu seçenek, dosyaların üzerine yazmaya zorlamak için kullanılabilir. Varsayılan eylem
mevcut bir dosyanın üzerine yazılacaksa bir hata verir.

-Proje isim
Bu seçenek, ilgilenilen projeyi seçmek için kullanılabilir. hayır olduğunda -Proje
seçeneği belirtilirse, AEGIS_PROJESİ ortam değişkenine danışılır. Eğer
bu mevcut değil, kullanıcının $HOME/.aegisrc dosya varsayılan olarak incelenir
proje alanı (bkz. aeuconf(5) daha fazla bilgi için). Bu yoksa,
kullanıcı yalnızca tek bir projedeki değişiklikler üzerinde çalışırken, proje
name varsayılanları bu proje için. Aksi takdirde, bu bir hatadır.

-Sadece oku
Bu seçenek, dosyanın yalıtım için kullanılacağını belirtmek için kullanılabilir.
taban çizgisinden değişir. Kullanıcı dosyayı düzenleme niyetinde değildir. Bunlar
geliştirme sona ermeden önce dosyaların kopyalanması kaldırılmalıdır.

- İPTAL
Bu seçenek, tamamlanmış bir değişikliği iptal etmek (geri almak) için kullanılabilir. değişiklik
geri alma (geri alma), --delta'dan biriyle olağan şekilde belirtilir.
seçenekleri.

-TERse
Bu seçenek, listelemelerin minimum minimum ürün üretmesine neden olmak için kullanılabilir.
bilgi. Genellikle kabuk komut dosyaları için kullanışlıdır.

-Gövde
Bu seçenek, kaynak dosya için proje ana hattını belirtmek için kullanılabilir.
taban çizgisinden daha fazla. (Ayrıca bakınız -Dal seçeneği, -trunk seçeneği ile aynıdır
“-branch -” seçeneği.)

-Ayrıntılı
Bu seçenek, aegis'in daha fazla çıktı üretmesini sağlamak için kullanılabilir. Varsayılan olarak kalkan
yalnızca hatalar üzerinde çıktı üretir. ile kullanıldığında -Liste seçenek bu seçenek
sütun başlıklarının eklenmesine neden olur.

-Beklemek Bu seçenek, aşağıdaki durumlarda Aegis komutlarının erişim kilitlerini beklemesini istemek için kullanılabilir.
hemen elde edilemezler. Kullanıcının varsayılanları lock_wait_preference
belirtilmemişse, bkz. aeuconf(5) daha fazla bilgi için.

-Hayır bekle
Bu seçenek, erişim durumunda Aegis komutlarının önemli bir hata yaymasını istemek için kullanılabilir.
kilitler hemen elde edilemez. Kullanıcının varsayılanları
lock_wait_preference belirtilmemişse, bkz. aeuconf(5) daha fazla bilgi için.

Ayrıca bakınız siper(1) tüm aegis komutlarında ortak olan seçenekler için.

Tüm seçenekler kısaltılabilir; kısaltma büyük harflerle belgelenmiştir,
tüm küçük harfler ve alt çizgiler (_) isteğe bağlıdır. ardışık kullanmalısın
isteğe bağlı harf dizileri.

Tüm seçenekler büyük/küçük harfe duyarlı değildir, bunları büyük harf veya küçük harf olarak yazabilirsiniz veya
ikisinin birleşimi, durum önemli değil.

Örneğin: "-project, "-PROJ" ve "-p" argümanlarının tümü,
-Proje seçenek. "-prj" argümanı anlaşılmayacaktır, çünkü ardışık
isteğe bağlı karakterler sağlanmadı.

Seçenekler ve diğer komut satırı argümanları, komut satırında keyfi olarak karıştırılabilir,
fonksiyon seçicilerden sonra.

GNU uzun seçenek adları anlaşılır. için tüm seçenek adları beri siper uzun,
bu, baştaki fazladan '-'yi yok saymak anlamına gelir. NS "--seçenek=değer"sözleşme aynı zamanda
anladım.

ÖNERİLEN ALIAS

Bu komut için önerilen diğer ad
csh% takma ad aecp 'aegis -cp \!* -v'
sh$ aecp(){aegis -cp "$@" -v}

HATALAR

Değişikliğin içinde olmaması bir hatadır. olmak gelişmiş devlet.
Değişikliğin geçerli kullanıcıya atanmaması bir hatadır.
Dosya zaten değişiklikteyse bu bir hatadır ve -Üzerine Yaz seçenek değil
belirtildi.

EXIT DURUMU

The siper komut, herhangi bir hata durumunda 1 durumuyla çıkacaktır. NS siper komut sadece
hata yoksa 0 durumuyla çıkın.

ÇEVRE DEĞİŞKENLER

Yerimizi siper(1) bu komutu etkileyebilecek ortam değişkenlerinin bir listesi için. Görmek
aepconf(5) proje yapılandırma dosyası için projeye özel nasıl ayarlanacağı için alan
Aegis tarafından yürütülen tüm komutlar için ortam değişkenleri.

ÖRNEKLER

İşte bazı basit örnekler. Çoğu komutun geçerli komuta göre olduğunu unutmayın.
dizin, bu örnekler geliştirmenin temelinde olduğunuzu varsaysa da
dizin ağacı.

kopya Bütün Proje
Tüm projeyi değişikliğinize kopyalamak için şu komutu kullanın:
aecp.
Sondaki nokta komutun bir parçasıdır, "geçerli dizin ve her şey" anlamına gelir.
altında". Bu, proje kaynak ağacınızdaki herhangi bir dizin için çalışır, isterseniz
daha seçici.

üretmek Daha erken Proje Sürümü
Projenizin önceki bir sürümü için kaynakları tam olarak yeniden oluşturmak istiyorsanız,
edelta numarasını bilmeniz gerekir (kullanın aEL proje geçmişi bulmak için). O zaman bunu kullan
komut:
aecp-delta n .
nerede n proje geçmişindeki delta numarasıdır. Yine, sondaki nokta bir parçasıdır
komuta. kullanarak $sürüm ikame (bkz. esub(5) daha fazla bilgi için)
dağıtmadan önce bu delta numarasını programınıza gömebilirsiniz.

Bunun yerine, bu komutu kullanarak önceki bir değişiklik numarası vermek de mümkündür:
aecp -delta-değişiklikten n .
nerede n ilgi değişikliği sayısıdır. Yine, sondaki nokta,
Komut.

feshetmek a değişim
Tamamlanmış bir değişikliği iptal etmeniz (geri çekmeniz) gerektiğinde, muhtemelen
zaman önce, bu nedenle delta numarasını veya değişiklik numarasını bilmeniz gerekir. Bu komutu kullanın:
aecp-delta n - iptal.
nerede n ilgilenilen delta sayısıdır. Diğer tüm -delta değişkenleri de çalışır, bu nedenle
değişiklik numarasını biliyorsanız, hangi dosyaların kopyalanacağı konusunda daha seçici olabilirsiniz:
aecp -delta-değişiklikten n aegis -l cf -ter -c n`
nerede n ilgi değişikliği sayısıdır. Bu, yalnızca içinde bulunan dosyaları kopyalar.
rahatsız edici değişiklik.

onworks.net hizmetlerini kullanarak aecp'yi çevrimiçi kullanın