aenf - Dalam talian di Awan

JADUAL:

NAMA

aegis fail baharu - tambah fail baharu yang akan dibuat melalui perubahan

SINOPSIS

naungan -Fail_Baru nama fail... [ pilihan... ]
naungan -Fail_Baru -Senarai [ pilihan... ]
naungan -Fail_Baru -Tolong

DESCRIPTION

. naungan -Fail_Baru arahan digunakan untuk menambah fail baharu pada perubahan. Fail yang dinamakan akan
ditambahkan pada senarai fail dalam perubahan.

Untuk setiap fail yang dinamakan, fail baharu dicipta dalam direktori pembangunan, jika tidak
sudah wujud. Jika fail sudah wujud, ia tidak akan diubah.

Jika anda mahu fail sumber baharu boleh dilaksanakan (contohnya skrip shell) maka anda
guna yang biasa sahaja Chmod(1) perintah. Jika mana-mana bit boleh laku fail ditetapkan pada
aede(1) masa fail diingati sebagai boleh laku dan semua bit laksana (tolak
umask projek) akan ditetapkan oleh yang berikutnya aecp(1) perintah.

Jika anda menamakan direktori pada baris arahan, keseluruhan pepohon direktori akan dicari
untuk fail baharu. (Nota: semuanya akan ditambah, termasuk fail titik dan
fail binari, jadi anda perlu membersihkan mana-mana sampah terlebih dahulu.) Fail di bawah ini dinamakan
direktori yang sudah dalam perubahan, atau dalam projek, akan diabaikan. The
nama_fail_terima and nama_fail_tolak corak dalam projek aegis.conf fail juga akan
digunakan, lihat aepconf(5) untuk maklumat lanjut.

Direktori Contoh
Ada kalanya perintah seperti
$ aenf fubar/*
aegis: projek "contoh": perubahan 42: "fubar/glorp" sudah berubah
aegis: "contoh" projek: perubahan 42: mendapati 1 ralat maut, tiada fail baharu ditambah
$
akan gagal seperti yang ditunjukkan. Terdapat beberapa cara untuk menangani perkara ini, yang paling mudah ialah
hanya namakan direktori:
$ aenf fubar
aegis: "contoh" projek: perubahan 42: fail "fubar/smiley" ditambah
aegis: "contoh" projek: perubahan 42: fail "fubar/frownie" ditambah
$
Anda juga boleh menggunakan mencari(1) arahan untuk pemilihan fail yang kompleks secara sewenang-wenangnya, tetapi anda
mesti terlebih dahulu mengecualikan fail yang perintah di atas tidak termasuk secara automatik:
$ aelcf > tidak termasuk
$ aelpf >> tidak termasuk
$ mencari fubar Jenis f | \
grep -v -f tidak termasuk | \
xargs naungan --fail-baru -v
aegis: "contoh" projek: perubahan 42: fail "fubar/smiley" ditambah
aegis: "contoh" projek: perubahan 42: fail "fubar/frownie" ditambah
$
Jika anda tidak menggunakan senarai kecualikan, senarai mencari(1) arahan akan memerlukan penalaan halus untuk anda
gaya direktori pembangunan. Jika anda menggunakan gaya symlink, anda perlu menambah
yang mencari -nlink 1 pilihan sebagai tambahan kepada mencari Jenis f pilihan.
$ mencari fubar Jenis f -nlinks 1 | \
xargs naungan --fail-baru -v
aegis: "contoh" projek: perubahan 42: fail "fubar/smiley" ditambah
aegis: "contoh" projek: perubahan 42: fail "fubar/frownie" ditambah
$
Jika anda menggunakan gaya direktori pembangunan salinan penuh, anda perlu menggunakan
kecualikan kaedah senarai, di atas.

File Templates
Apabila fail baharu dibuat dalam direktori pembangunan projek config fail adalah
mencari templat untuk fail baharu. Jika templat ditemui, fail baharu akan
dimulakan ke templat, jika tidak, ia akan dibuat kosong. Lihat aepconf(5) untuk lebih lanjut
maklumat.

Bentuk yang paling mudah ialah menggunakan fail templat, seperti
templat_fail =
[
{
corak = [ "*.c" ];
badan = "${read_file ${source template/c abs}}";
},
{
corak = [ "ujian/*/.sh" ];
body = "${read_file ${source template/test abs}}";
},
];
Seperti yang anda lihat, fail templat adalah sebahagian daripada sumber projek, jadi anda boleh menambah
notis hak cipta yang sesuai dan pembungkus, dan lain-lain. Yang $sumber penggantian menempatkan mereka,
jika mereka bukan sebahagian daripada perubahan semasa (dan mereka biasanya tidak).

Fail templat itu sendiri mengandungi penggantian. The $nama fail penggantian ialah
tersedia, dan mengandungi nama fail yang sedang dibuat. Ini boleh dimanipulasi dalam
pelbagai cara semasa membina kandungan fail yang sesuai. Lihat aesub(5) untuk lebih lanjut
maklumat tentang penggantian.

Ia juga mungkin untuk menjalankan arahan untuk mencipta fail baharu. Anda boleh melakukan ini bukannya
menyatakan rentetan badan, iaitu:
templat_fail =
[
{
corak = [ "*" ];
body_command = "perl ${source template.pl abs} $filename";
},
];
Perintah dijalankan dengan direktori semasa yang ditetapkan ke bahagian atas direktori pembangunan.
Ia adalah ralat jika arahan gagal mencipta fail. Anda boleh mencampur-dan-padankan kedua-duanya
teknik, badan rentetan dan perintah_badan, jika anda mahu.

File Nama Batasan
Terdapat beberapa kawalan yang tersedia untuk mengehadkan bentuk nama fail projek. Semuanya
kawalan ini boleh didapati dalam fail konfigurasi projek, lihat aepconf(5) untuk lebih lanjut
maklumat. Yang paling penting diterangkan secara ringkas di sini:

maksimum_nama_fail_panjang = integer;
Medan ini digunakan untuk mengehadkan panjang nama fail. Semua fail baharu mungkin tiada
komponen laluan lebih lama daripada ini. Lalai kepada 255 jika tidak ditetapkan. Untuk maksimum
mudah alih anda harus menetapkan ini kepada 14.

posix_filename_charset = boolean;
Medan ini boleh digunakan untuk mengehadkan aksara yang dibenarkan dalam nama fail kepada mereka sahaja
dibenarkan secara jelas oleh POSIX. Lalai kepada palsu jika tidak ditetapkan, bermakna apa sahaja anda
sistem pengendalian akan bertolak ansur, kecuali ruang putih dan aksara high-bit-on.
Untuk kemudahalihan maksimum anda harus menetapkan ini kepada benar.

dos_filename_required = boolean;
Medan ini boleh digunakan untuk mengehadkan nama fail supaya ia mematuhi DOS 8+3
had nama fail dan kepada set aksara nama fail DOS. Lalai kepada palsu jika tidak
ditetapkan.

windows_filename_required = boolean;
Medan ini boleh digunakan untuk mengehadkan nama fail supaya ia mematuhi Windows98
dan had nama fail WindowsNT dan set aksara. Lalai kepada palsu jika tidak ditetapkan.

shell_safe_filenames = boolean;
Medan ini boleh digunakan untuk mengehadkan nama fail supaya ia tidak mengandungi shell
watak istimewa. Lalai kepada benar jika tidak ditetapkan. Jika medan ini ditetapkan kepada palsu,
anda perlu menggunakan ${quote} penggantian di sekitar nama fail dalam arahan, kepada
pastikan nama fail yang mengandungi aksara khas shell tidak mempunyai yang tidak disengajakan
kesan sampingan. Aksara pelik dalam nama fail juga boleh mengelirukan kebergantungan anda
alat penyelenggaraan.

allow_white_space_in_filenames = boolean;
Medan ini boleh digunakan untuk membenarkan aksara ruang putih dalam nama fail. Ini akan
benarkan aksara berikut muncul dalam nama fail: ruang belakang (BS, \b, 0x08),
tab mendatar (HT, \t, 0x09), baris baharu (NL, \n, 0x0A), tab menegak (VT, \v,
0x0B), suapan borang (FF, \f, 0x0C) dan pemulangan pengangkutan (CR, \r, 0x0D). Lalai kepada
palsu jika tidak ditetapkan.

Ambil perhatian bahawa medan ini tidak mengatasi penapis nama fail lain. Ia akan menjadi
perlu ditetapkan secara eksplisit shell_safe_filename = palsu juga. Ia akan menjadi
perlu ditetapkan dos_filename_required = palsu (lalai) juga. Ia akan menjadi
perlu ditetapkan posix_filename_charset = palsu (lalai) juga.

Pengguna mesti berhati-hati menggunakan penggantian ${quote} di sekeliling semua fail
nama dalam arahan dalam konfigurasi projek. Dan walaupun begitu, penggantian
yang menjangkakan senarai nama fail yang dipisahkan oleh ruang akan mempunyai hasil yang tidak ditentukan.

allow_non_ascii_filenames = boolean;
Medan ini boleh digunakan untuk membenarkan nama fail dengan aksara yang tidak boleh dicetak ascii
mereka. Biasanya ini bermaksud UTF8 atau beberapa jenis carset antarabangsa.
Lalai kepada palsu jika tidak ditetapkan.

Ambil perhatian bahawa medan ini tidak mengatasi penapis nama fail lain. Ia akan menjadi
perlu ditetapkan secara eksplisit shell_safe_filename = palsu juga. Ia akan menjadi
perlu ditetapkan dos_filename_required = palsu (lalai) juga. Ia akan menjadi
perlu ditetapkan posix_filename_charset = palsu (lalai) juga.

nama fail_pattern_accept = [ rentetan ];
Medan ini digunakan untuk menentukan senarai corak nama fail yang boleh diterima.
Lalai kepada "*" jika tidak ditetapkan.

nama fail_pattern_reject = [ rentetan ];
Medan ini digunakan untuk menentukan senarai corak nama fail yang tidak boleh diterima.

Sila Catatan: Aegis juga merujuk sistem fail asas, untuk menentukan tanggapannya tentang
saiz fail maksimum. Di mana saiz fail maksimum sistem fail adalah kurang daripada
panjang_nama_fail maksimum, sistem fail menang. Ini boleh berlaku, sebagai contoh, apabila anda berada
menggunakan sistem fail Linux UMSDOS, atau apabila anda mempunyai NFS memasang V7 purba
sistem fail. Tetapan panjang_nama_fail maksimum kepada 255 dalam kes ini tidak mengubah
fakta bahawa had sistem fail asas adalah jauh lebih kecil (masing-masing 12 dan 14).

Jika direktori pembangunan anda (atau keseluruhan projek anda) berada pada sistem fail dengan nama fail
batasan, atau sebahagian daripada binaan heterogen berlaku dalam persekitaran sedemikian,
ia membantu untuk memberitahu Aegis apa mereka (menggunakan projek config medan fail) supaya anda
jangan menghadapi situasi di mana projek membina lebih permisif
persekitaran, tetapi gagal dengan ralat misteri dalam persekitaran yang lebih terhad.

Jika direktori pembangunan anda secara rutin pada sistem fail Linux UMSDOS, anda akan melakukannya
mungkin lebih baik jika ditetapkan dos_filename_required = benar, dan juga menukar
templat_direktori_pembangunan padang. Pembangunan heterogen dengan pelbagai Windows
persekitaran juga mungkin memerlukan ini.

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.

menukar yang Jenis of a File
Jika anda ingin menukar jenis fail (katakan, daripada ujian kepada fail sumber, atau Naib
juga sebaliknya) anda boleh melakukannya sebagai dua perubahan, dengan terlebih dahulu menggunakan arm(1) dalam satu perubahan dan kemudian
menggunakan aenf(1) atau aent(1) dalam perubahan kedua, atau anda boleh menggabungkan kedua-dua langkah dalam yang sama
ubah. Ingat untuk menggunakan arm -nowhiteout pilihan atau anda akan mendapat pilihan baharu yang paling pelik
templat fail.

File Tindakan Pelarasan
Apabila arahan ini dijalankan, ia mula-mula menyemak fail perubahan terhadap fail projek. Jika
terdapat ketidakkonsistenan, tindakan fail akan diselaraskan seperti berikut:

cipta Jika fail sedang dibuat, tetapi set perubahan lain disepadukan yang juga
mencipta fail, tindakan fail dalam set perubahan yang masih dibangunkan adalah
dilaraskan kepada "ubah suai".

ubah suai Jika fail sedang diubah suai, tetapi set perubahan lain disepadukan yang mengalih keluar
fail, tindakan fail dalam set perubahan yang masih dibangunkan adalah
diselaraskan kepada "mencipta".

keluarkan Jika fail sedang dialih keluar, tetapi set perubahan lain disepadukan yang mengalih keluar
fail, fail akan digugurkan daripada set perubahan yang masih dibangunkan.

Pemberitahuan
. new_file_command dalam fail konfigurasi projek dijalankan, jika ditetapkan. The projek_-
perintah_fail juga dijalankan, jika ditetapkan, dan jika terdapat penyepaduan baru-baru ini. Lihat
aepconf(5) untuk maklumat lanjut.

UJIAN KORELASI

Perintah "aegis -Test -SUGgest" boleh digunakan untuk meminta aegis mencadangkan regresi yang sesuai
ujian untuk perubahan anda, berdasarkan fail sumber dalam perubahan anda. Ini secara automatik
memfokuskan usaha ujian kepada ujian yang berkaitan, mengurangkan bilangan ujian regresi
perlu untuk yakin bahawa anda tidak memperkenalkan pepijat.

Korelasi ujian dijana oleh arahan "aegis -Integrate_Pass", yang
mengaitkan setiap ujian dalam perubahan dengan setiap fail sumber dalam perubahan. Justeru, setiap
fail sumber mengumpul senarai ujian yang telah dikaitkan dengannya pada masa lalu.
Ini tidak tepat seperti analisis liputan kod, tetapi merupakan anggaran yang munasabah dalam
amalan.

. aecp(1) dan aenf(1) arahan digunakan untuk mengaitkan fail dengan perubahan. Sedangkan mereka
tidak melakukan perkaitan secara aktif, ini adalah fail yang digunakan oleh aeipass(1) dan
aet(1) untuk menentukan fail sumber yang dikaitkan dengan ujian mana.

ujian Korelasi Ketepatan
Dengan mengandaikan bahawa korelasi ujian adalah tepat dan ujian adalah sama rata
diedarkan merentasi ruang fungsi, akan ada kurang daripada 1/nombor peluang bahawa a
ujian yang berkaitan belum dijalankan oleh “aegis -Test -SUGgest nombor” perintah. Kecil
jumlah hingar ditambah pada pemberat ujian, jadi kadangkala perkara yang tidak dijangka berlaku
diuji, dan ujian yang sama tidak dijalankan setiap kali.

Ketepatan korelasi ujian boleh dipertingkatkan dengan memastikan bahawa:

· Setiap perubahan harus difokuskan dengan kuat, tanpa kemasukan fail yang tidak sepatutnya. ini
mengelakkan korelasi palsu.

· Setiap item kefungsian baharu perlu ditambah dalam perubahan individu, bukannya
beberapa bersama-sama. Ini sangat mengaitkan ujian dengan kefungsian.

· Setiap pepijat harus diperbaiki dalam perubahan individu, bukannya beberapa bersama-sama. ini
sangat mengaitkan ujian dengan kefungsian.

· Perkaitan ujian akan hilang jika fail dialihkan. Ini kerana korelasi adalah oleh
nama.

Cara terbaik untuk ujian mengaitkan dengan tepat dengan fail sumber ialah apabila berlaku perubahan
mengandungi ujian dan betul-betul fail yang berkaitan dengan fungsi yang sedang diuji. Juga
banyak fail palsu akan melemahkan kegunaan korelasi ujian.

PILIHAN

Pilihan berikut difahami

-Bina
Pilihan ini boleh digunakan untuk menentukan bahawa fail dibina semasa binaan
(selalunya hanya binaan bersepadu), supaya sejarahnya boleh disimpan. Ini adalah
berguna untuk menjana fail tampalan, yang mempunyai sejarah fail yang dijana
penting. Fail yang dibuat dengan cara ini mungkin tidak boleh disalin ke dalam perubahan, walaupun
mereka mungkin dipadamkan. Elakkan menggunakan fail jenis ini, jika boleh.

-BAse_RElative
Pilihan ini boleh digunakan untuk menyebabkan nama fail relatif dianggap relatif kepada
pangkal pokok sumber. Lihat aeuconf(5) untuk pengguna yang sepadan
keutamaan.

-CUrrent_RElative
Pilihan ini boleh digunakan untuk menyebabkan nama fail relatif dianggap relatif kepada
direktori semasa. Ini biasanya lalai. Lihat aeuconf(5) untuk
keutamaan pengguna yang sepadan.

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

-Dikonfigurasikan
Pilihan ini boleh digunakan untuk menentukan bahawa fail itu adalah projek Aegis
fail konfigurasi. Fail konfigurasi projek lalai dipanggil aegis.conf,
namun sebarang nama fail boleh digunakan. Anda juga boleh menggunakan lebih daripada satu fail,
membahagikan kandungan merentasi beberapa fail, kesemuanya mestilah jenis ini.

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

-Simpan
Pilihan ini boleh digunakan untuk mengekalkan fail dan/atau direktori yang biasanya dipadamkan atau
digantikan dengan arahan. Lalai kepada pengguna delete_file_preference jika tidak
ditentukan, lihat aeuconf(5) untuk maklumat lanjut.

-Tidak_Simpan
Pilihan ini boleh digunakan untuk memastikan bahawa fail dan/atau direktori dipadamkan
atau digantikan dengan arahan. Lalai kepada pengguna delete_file_preference jika tidak
ditentukan, lihat aeuconf(5) untuk maklumat lanjut.

-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.

-templat
Pilihan ini boleh digunakan untuk menentukan bahawa templat fail baharu harus digunakan, walaupun
jika fail sudah wujud.

-No_TEMplate
Pilihan ini boleh digunakan untuk menentukan bahawa templat fail baharu tidak boleh digunakan,
walaupun fail itu tidak wujud (sebarang fail kosong akan dibuat).

-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.

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 aenf 'aegis -nf \!* -v'
sh$ aenf(){aegis -nf "$@" -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 fail itu sudah menjadi sebahagian daripada perubahan.
Ia adalah ralat jika fail itu sudah menjadi sebahagian daripada garis dasar.
Ia adalah ralat jika fail yang dinamakan pada baris arahan bukan fail biasa dan bukan
direktori. (Jika anda memerlukan pautan simbolik atau fail khas, buatnya pada masa binaan.)

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 aenf dalam talian menggunakan perkhidmatan onworks.net