aemv - Dalam talian di Awan

JADUAL:

NAMA

aegis move file - menamakan semula satu atau lebih fail sebagai sebahagian daripada perubahan

SINOPSIS

naungan -MoVe_file [ pilihan... ] nama lama nama baru [ old1 new1 [ old2 new2 ] ]
naungan -MoVe_file -Senarai [ pilihan... ]
naungan -MoVe_file -Tolong

DESCRIPTION

. naungan -MoVe_file arahan digunakan untuk menyalin fail ke dalam perubahan dan menukar namanya di
pada masa yang sama.

Fail yang dinamakan akan disalin daripada garis dasar (fail lama) ke dalam pembangunan
direktori (fail baru), dan ditambah pada senarai fail dalam perubahan.

Amaran: Jika sudah ada fail dalam direktori pembangunan sama ada fail nama lama or
yang nama baru mereka akan ditimpa.

. fail lama dalam direktori pembangunan akan mengandungi 1KB teks rawak. Yang rawak
teks cukup memberontak bahawa kebanyakan penyusun akan memberikan mesej ralat, sekiranya
fail dirujuk secara tidak sengaja. Ini selalunya sangat membantu apabila memindahkan termasuk fail.

Anda boleh menamakan semula direktori. Semua fail dalam nama lama pokok direktori akan dinamakan semula
berada di bawah nama baru pokok direktori.

File Nama Tafsiran
Program aegis akan cuba menentukan nama fail projek daripada nama fail
diberikan pada baris arahan. Semua nama fail disimpan dalam projek aegis sebagai relatif
kepada akar pokok direktori garis dasar. Direktori pembangunan dan
direktori integrasi adalah bayang-bayang direktori garis dasar ini, dan nama relatif ini
memohon di sini juga. Fail yang dinamakan pada baris arahan mula-mula ditukar kepada laluan mutlak
jika perlu. Mereka kemudiannya dibandingkan dengan laluan garis dasar, direktori pembangunan
laluan, dan laluan direktori penyepaduan, untuk menentukan nama relatif garis dasar. Ia adalah
ralat jika fail yang dinamakan berada di luar salah satu daripada pepohon direktori ini.

. -BAse_RElative pilihan boleh digunakan untuk menyebabkan nama fail relatif ditafsirkan sebagai
relatif kepada laluan garis dasar; nama fail mutlak masih akan dibandingkan dengan pelbagai
laluan untuk menentukan nama relatif garis dasar.

. relative_filename_preference dalam fail konfigurasi pengguna boleh digunakan untuk mengubah suai
tingkah laku lalai ini. Lihat aeuconf(5) untuk maklumat lanjut.

Proses Sampingan Kesan
Perintah ini akan membatalkan sebarang pendaftaran binaan atau ujian, kerana menambah fail lain
logiknya membatalkannya.

Apabila fail perubahan disenaraikan (naungan -Senarai Tukar_Fail -TERse) fail baharu (baru-
nama) akan muncul dalam penyenaraian, dan fail yang dialih keluar (nama lama) akan tidak muncul di
penyenaraian ringkas. Begitu juga, apabila fail projek disenaraikan dengan perubahan yang jelas
nombor (naungan -Senarai Projek_Fail -TERse -Ubah N) tiada fail perubahan, termasuk
kedua-dua fail baharu dan dialih keluar, akan muncul dalam penyenaraian singkat. Kedua-dua ciri ini ialah
sangat membantu apabila memanggil aegis dari dalam DMT untuk menjana senarai fail sumber.

Pemberitahuan
. new_file_command and remove_file_command dalam projek tersebut config fail dijalankan, jika ditetapkan.
. project_file_command juga dijalankan, jika ditetapkan, dan jika terdapat penyepaduan
baru-baru ini. Lihat aepconf(5) untuk maklumat lanjut.

PUTIH

Aegis memberi anda apa yang sering dipanggil "laluan pandangan" yang menunjukkan kepada pembangunan
alatan (penyusun, membina sistem, dan lain-lain) lihat dahulu dalam direktori pembangunan, kemudian dalam
garis dasar cawangan, dan seterusnya sehingga garis dasar batang.

Masalah dengan laluan paparan ialah untuk mengalih keluar fail, anda memerlukan beberapa jenis
"whiteout" untuk mengatakan "berhenti mencari, ia telah dialih keluar."

Apabila anda menggunakan arm(1) atau aemv(1) arahan, ini bermakna "tambah maklumat kepada perubahan ini
yang akan mengalih keluar fail daripada garis dasar apabila perubahan ini disepadukan". Ya manakala
perubahan adalah pada menjadi maju nyatakan, fail hanya "dialih keluar" dalam pembangunan
direktori - ia masih terdapat dalam garis dasar, dan akan berlaku sehingga perubahan itu
berjaya diintegrasikan.

Apabila anda menggunakan arm(1) atau aemv(1) arahan, Aegis akan mencipta fail 1K untuk bertindak sebagai
whiteout. Kandungannya agak hodoh sehingga jika anda menyusun atau memasukkan "dialih keluar"
fail secara tidak sengaja, anda mendapat ralat maut. Ini akan mengingatkan anda untuk mengalih keluar yang usang
rujukan.

Apabila perubahan dalam bersepadu, fail yang dialih keluar adalah tidak disalin/dipautkan daripada garis dasar kepada
direktori penyepaduan, dan ialah tidak disalin daripada direktori pembangunan. Di sini
masa ia hilang secara fizikal (tiada whiteout). Diandaikan bahawa kerana kesilapan
mendorong pemutihan semua rujukan lama ditemui dan ditetapkan semasa perubahan dalam
menjadi maju negeri.

File Manifestasi
Apabila menjana senarai fail untuk disusun atau dipautkan, adalah penting bahawa fail tersebut
manifes dijana daripada maklumat yang diketahui oleh Aegis, bukannya daripada sistem fail.
Ini adalah atas beberapa sebab:

(a) Aegis tahu dengan tepat apa (sumber) fail di mana, sedangkan yang lain berada
membuat kesimpulan pengetahuan Aegis; dan

(b) mencari dalam sistem fail adalah sukar apabila laluan paparan lebih panjang daripada 2 direktori
(dan kaedah percabangan Aegis boleh menjadikannya panjang sewenang-wenangnya); dan

(c) Fail whiteout, dan apa-apa lagi yang tertinggal "terletak", akan mengelirukan sebarang kaedah
yang menyoal siasat sistem fail.

Cara paling mudah untuk menggunakan pengetahuan fail Aegis ialah dengan sesuatu seperti an awk(1) skrip
memproses senarai fail Aegis. Sebagai contoh, anda boleh melakukan ini dengan membuat(1) seperti berikut:
# jana manifes fail
manifest.make.inc: manifest.make.awk
( aegis -l cf -ter ; aegis -l pf -ter ) | \
awk -f manifest.make.awk > manifest.make.inc
# kini masukkan manifes fail
sertakan manifest.make.inc
Nota: ini akan menjadi tidak cekap jika anda melakukannya sekali bagi setiap direktori, tetapi tiada apa-apa
menghentikan anda menulis banyak tugasan ke dalam manifest.make.inc fail, semuanya dalam satu
lulus.

Adalah mungkin untuk melakukan perkara yang sama dengan penjana laporan Aegis (lihat udara(1) untuk lebih lanjut
maklumat), tetapi ini lebih terlibat daripada awk(1) skrip. Walau bagaimanapun, dengan
maklumat "terus dari mulut kuda" seolah-olah, ia juga boleh menjadi lebih bijak.

Manifes fail ini akan menjadi lapuk tanpa interlock pada fail Aegis
arahan operasi. Dengan menggunakan perintah_fail projek and change_file_command bidang dari
projek config fail (lihat aepconf(5) untuk maklumat lanjut), anda boleh memadam fail ini
pada masa yang strategik.
/* jalankan apabila manifes fail perubahan diubah */
change_file_command = "rm -f manifest.make.inc";
/* jalankan apabila manifes fail projek diubah */
project_file_command = "rm -f manifest.make.inc";
Oleh itu, manifes fail baharu akan dibina semula pada masa berikutnya aeb(1) perintah.

Pilihan and keutamaan
Terdapat -Tiada-WhiteOut pilihan, yang boleh digunakan untuk menyekat fail whiteout apabila anda menggunakan
yang arm(1) dan aemv(1) perintah. Ada yang sepadan -WhiteOut pilihan, yang
biasanya lalai.

Terdapat whiteout_preference medan dalam fail pilihan pengguna (lihat aeuconf(5) untuk
maklumat lanjut) jika anda ingin menetapkan pilihan ini secara lebih kekal.

Whiteout File Templates
. whiteout_template bidang projek config fail boleh digunakan untuk menghasilkan bahasa-
fail ralat tertentu. Jika tiada entri templat whiteout sepadan, fail 1KB yang sangat hodoh akan
dihasilkan - ia harus mendorong ralat pengkompil untuk hampir semua bahasa.

Jika anda mahukan mesej ralat yang lebih mudah dibaca manusia, entri seperti
templat_putih =
[
{
corak = [ "*.[ch]" ];
body = "#error Fail ini telah dialih keluar.";
}
];
boleh menjadi sangat berkesan (contoh ini menganggap gcc(1) sedang digunakan).

Jika itu penting tidak fail whiteout dihasilkan, katakan untuk fail sumber C, anda boleh
gunakan templat whiteout seperti
templat_putih =
[
{ corak = [ "*.c" ]; }
];
kerana tidak hadir badan sub-medan bermaksud menjana tiada fail putih sama sekali.

Anda mungkin mempunyai lebih daripada satu entri templat whiteout, tetapi ambil perhatian bahawa susunan
penyertaan adalah penting. Entri pertama yang sepadan akan digunakan.

Pemberitahuan
Apabila berjaya menyelesaikan arahan ini, pemberitahuan biasanya dilakukan oleh
arm(1), aenf(1) dan aent(1) arahan dijalankan, mengikut kesesuaian. Ini termasuk
project_file_command, new_file_command, new_test_command and remove_file_command bidang
projek config fail. Lihat aepconf(5) untuk maklumat lanjut.

PILIHAN

Pilihan berikut difahami:

-Ubah nombor
Pilihan ini boleh digunakan untuk menentukan perubahan tertentu dalam projek. Lihat
naungan(1) untuk penerangan lengkap tentang pilihan ini.

-Tolong
Pilihan ini boleh digunakan untuk mendapatkan maklumat lanjut tentang cara menggunakan naungan
program.

-Senarai
Pilihan ini boleh digunakan untuk mendapatkan senarai subjek yang sesuai untuk arahan ini.
Senarai itu mungkin lebih umum daripada yang dijangkakan.

-Bukan_Logging
Pilihan ini boleh digunakan untuk melumpuhkan pengelogan automatik output dan ralat ke
sebuah fail. Ini selalunya berguna apabila beberapa arahan aegis digabungkan dalam shell
skrip.

-Projek nama
Pilihan ini boleh digunakan untuk memilih projek yang diminati. Apabila tidak -Projek
pilihan ditentukan, iaitu AEGIS_PROJECT pembolehubah persekitaran dirujuk. Jika
yang tidak wujud, milik pengguna $HOME/.aegisrc fail diperiksa untuk lalai
bidang projek (lihat aeuconf(5) untuk maklumat lanjut). Jika itu tidak wujud,
apabila pengguna hanya mengusahakan perubahan dalam satu projek, projek
nama lalai kepada projek itu. Jika tidak, ia adalah satu kesilapan.

-TERse
Pilihan ini boleh digunakan untuk menyebabkan penyenaraian menghasilkan sekurang-kurangnya
maklumat. Ia biasanya berguna untuk skrip shell.

-Verbose
Pilihan ini boleh digunakan untuk menyebabkan aegis menghasilkan lebih banyak output. Secara lalai aegis
hanya menghasilkan output pada ralat. Apabila digunakan dengan -Senarai pilihan pilihan ini
menyebabkan tajuk lajur ditambah.

-Tunggu Pilihan ini boleh digunakan untuk meminta arahan Aegis menunggu kunci akses, jika
mereka tidak boleh diperolehi dengan segera. Lalai kepada pengguna lock_wait_preference
jika tidak dinyatakan, lihat aeuconf(5) untuk maklumat lanjut.

-Tidak_Tunggu
Pilihan ini boleh digunakan untuk menghendaki arahan Aegis untuk mengeluarkan ralat maut jika akses
kunci tidak boleh diperolehi dengan segera. Lalai kepada pengguna
lock_wait_preference jika tidak dinyatakan, lihat aeuconf(5) untuk maklumat lanjut.

-WhiteOut
Pilihan ini boleh digunakan untuk meminta fail yang dipadam digantikan dengan "whiteout"
fail dalam direktori pembangunan. Ideanya ialah menyusun fail sedemikian akan
mengakibatkan ralat maut, supaya semua rujukan boleh ditemui. Ini adalah
biasanya lalai.

-No_WhiteOut
Pilihan ini boleh digunakan untuk meminta supaya tiada fail "whiteout" diletakkan dalam
direktori pembangunan.

Lihat juga naungan(1) untuk pilihan biasa kepada semua arahan aegis.

Semua pilihan boleh dipendekkan; singkatan didokumentasikan sebagai huruf besar,
semua huruf kecil dan garis bawah (_) adalah pilihan. Anda mesti menggunakan berturut-turut
urutan huruf pilihan.

Semua pilihan adalah tidak sensitif huruf besar-besaran, anda boleh menaipnya dalam huruf besar atau huruf kecil atau a
gabungan kedua-duanya, kes tidak penting.

Contohnya: hujah "-project, "-PROJ" dan "-p" semuanya ditafsirkan bermaksud
-Projek pilihan. Hujah "-prj" tidak akan difahami, kerana berturut-turut
aksara pilihan tidak dibekalkan.

Pilihan dan argumen baris arahan lain boleh dicampur sewenang-wenangnya pada baris arahan,
selepas pemilih fungsi.

Nama pilihan panjang GNU difahami. Oleh kerana semua nama pilihan untuk naungan panjang,
ini bermakna mengabaikan tambahan terkemuka '-'. "--pilihan=nilai"konvensyen juga
faham.

RECOMMENDED ALIAS

Alias ​​yang disyorkan untuk arahan ini ialah
csh% alias aemv 'aegis -mv \!* -v'
sh$ aemv(){aegis -mv "$@" -v}

KESALAHAN

Ia adalah ralat jika perubahan itu tidak ada dalam menjadi maju negeri.
Ia adalah ralat jika perubahan tidak diberikan kepada pengguna semasa.
Ia adalah ralat jika mana-mana fail sudah dalam perubahan.

EXIT STATUS

. naungan arahan akan keluar dengan status 1 pada sebarang ralat. The naungan perintah akan sahaja
keluar dengan status 0 jika tiada ralat.

PERSEKITARAN PELBAGAI

Lihat naungan(1) untuk senarai pembolehubah persekitaran yang boleh menjejaskan arahan ini. Lihat
aepconf(5) untuk fail konfigurasi projek projek_khusus medan untuk cara menetapkan
pembolehubah persekitaran untuk semua arahan yang dilaksanakan oleh Aegis.

Gunakan aemv dalam talian menggunakan perkhidmatan onworks.net