Ini ialah arahan hg yang boleh dijalankan dalam penyedia pengehosan percuma OnWorks menggunakan salah satu daripada berbilang stesen kerja dalam talian percuma kami seperti Ubuntu Online, Fedora Online, emulator dalam talian Windows atau emulator dalam talian MAC OS.
JADUAL:
NAMA
hg - Sistem pengurusan kod sumber Mercurial
SINOPSIS
hg arahan [pilihan]... [hujah]...
DESCRIPTION
. hg arahan menyediakan antara muka baris arahan kepada sistem Mercurial.
COMMAND ELEMENTS
fail ...
menunjukkan satu atau lebih nama fail atau nama fail laluan relatif; lihat Corak Nama Fail
untuk maklumat tentang padanan corak
jalan menunjukkan laluan pada mesin tempatan
semakan
menunjukkan set perubahan yang boleh ditentukan sebagai nombor semakan set perubahan, teg,
atau subrentetan unik nilai cincang changeset
repositori jalan
sama ada nama laluan repositori tempatan atau URI repositori jauh.
PILIHAN
-R,--repositori
direktori akar repositori atau nama fail himpunan tindanan
--cwd
tukar direktori kerja
-y, --tidak interaktif
jangan gesa, pilih pilihan pertama secara automatik untuk semua gesaan
-q, --senyap
menekan output
-v, --verbose
membolehkan keluaran tambahan
--config
tetapkan/timpa pilihan konfigurasi (gunakan 'section.name=value')
--nyahpepijat
dayakan output penyahpepijatan
--penyahpepijat
mulakan penyahpepijat
--pengekodan
tetapkan pengekodan charset (lalai: UTF-8)
--mod pengekodan
tetapkan mod pengekodan charset (lalai: ketat)
--mengesan balik
sentiasa mencetak jejak balik dengan pengecualian
--masa masa berapa lama arahan itu diambil
--profil
cetak profil pelaksanaan arahan
--versi
maklumat versi keluaran dan keluar
-h, - membantu
paparan bantuan dan keluar
--tersembunyi
pertimbangkan perubahan tersembunyi
[+] pilihan bertanda boleh ditentukan beberapa kali
PERINTAH
menambah
tambah fail yang ditentukan pada komit seterusnya:
hg tambah [PILIHAN]... [FAIL]...
Jadualkan fail untuk dikawal versi dan ditambahkan pada repositori.
Fail akan ditambahkan ke repositori pada komit seterusnya. Untuk membuat asal tambah sebelum itu,
lihat hg lupa.
Jika tiada nama diberikan, tambahkan semua fail ke repositori (kecuali fail yang sepadan .hgignore).
Contoh:
· Fail baharu (tidak diketahui) ditambah secara automatik oleh hg menambah:
$ls
foo.c
status $hg
? foo.c
$ hg tambah
menambah foo.c
status $hg
A foo.c
· Fail khusus untuk ditambah boleh ditentukan:
$ls
bar.c foo.c
status $hg
? bar.c
? foo.c
$ hg tambah bar.c
status $hg
Sebuah palang.c
? foo.c
Mengembalikan 0 jika semua fail berjaya ditambah.
Pilihan:
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-S, --subrepos
berulang ke dalam subrepositori
-n, --lari kering
jangan lakukan tindakan, hanya cetak output
[+] pilihan bertanda boleh ditentukan beberapa kali
addremove
tambah semua fail baharu, padam semua fail yang hilang:
hg addremove [PILIHAN]... [FAIL]...
Tambahkan semua fail baharu dan alih keluar semua fail yang hilang daripada repositori.
Melainkan nama diberikan, fail baharu diabaikan jika ia sepadan dengan mana-mana corak dalam
.hgignore. Seperti tambahan, perubahan ini berkuat kuasa pada komit seterusnya.
Gunakan pilihan -s/--similarity untuk mengesan fail yang dinamakan semula. Pilihan ini mengambil peratusan
antara 0 (dilumpuhkan) dan 100 (fail mestilah sama) sebagai parameternya. Dengan parameter
lebih besar daripada 0, ini membandingkan setiap fail yang dialih keluar dengan setiap fail yang ditambah dan merekodkannya
cukup serupa seperti menamakan semula. Mengesan fail yang dinamakan semula dengan cara ini boleh menjadi mahal. Selepas menggunakan
pilihan ini, hg terkini -C boleh digunakan untuk menyemak fail yang dikenal pasti sebagai dipindahkan atau
dinamakan semula. Jika tidak dinyatakan, -s/--similarity menjadi lalai kepada 100 dan hanya menamakan semula yang serupa
fail dikesan.
Contoh:
· Sebilangan fail (bar.c dan foo.c) adalah baharu, manakala foobar.c telah dialih keluar (tanpa
menggunakan hg mengeluarkan) dari repositori:
$ls
bar.c foo.c
status $hg
! foobar.c
? bar.c
? foo.c
$ hg addremove
menambah bar.c
menambah foo.c
mengeluarkan foobar.c
status $hg
Sebuah palang.c
A foo.c
R foobar.c
· Fail foobar.c telah dialihkan ke foo.c tanpa menggunakan hg menamakan semula. Selepas itu, ia adalah
disunting sedikit:
$ls
foo.c
status $hg
! foobar.c
? foo.c
$ hg addremove --similarity 90
mengeluarkan foobar.c
menambah foo.c
rakaman pengalihan keluar foobar.c sebagai nama semula kepada foo.c (94% serupa)
status $ hg -C
A foo.c
foobar.c
R foobar.c
Mengembalikan 0 jika semua fail berjaya ditambah.
Pilihan:
-ya,--persamaan
teka namakan semula fail mengikut persamaan (0<=s<=100)
-S, --subrepos
berulang ke dalam subrepositori
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-n, --lari kering
jangan lakukan tindakan, hanya cetak output
[+] pilihan bertanda boleh ditentukan beberapa kali
memberi keterangan
tunjukkan maklumat set perubahan mengikut baris untuk setiap fail:
hg anotasi [-r REV] [-f] [-a] [-u] [-d] [-n] [-c] [-l] FAIL...
Senaraikan perubahan dalam fail, menunjukkan id semakan yang bertanggungjawab untuk setiap baris.
Perintah ini berguna untuk mengetahui bila perubahan dibuat dan oleh siapa.
Jika anda menyertakan --file, --user, atau --date, nombor semakan akan dihalang melainkan anda
sertakan juga --nombor.
Tanpa pilihan -a/--text, anotasi akan mengelakkan pemprosesan fail yang dikesan sebagai binari.
Dengan -a, anotasi akan menganotasi fail juga, walaupun hasilnya mungkin
tidak berguna dan tidak diingini.
Mengembalikan 0 pada kejayaan.
Pilihan:
-r,--rev
anotasi semakan yang ditentukan
--ikut
ikuti salinan/namakan semula dan senaraikan nama fail (DILARANG)
--tidak ikut
jangan ikut salinan dan namakan semula
-A, - teks
layan semua fail sebagai teks
-u, --pengguna
senaraikan pengarang (panjang dengan -v)
-f, --fail
senaraikan nama fail
-d, --Tarikh
senaraikan tarikh (pendek dengan -q)
-n, --nombor
senaraikan nombor semakan (lalai)
-c, --changeset
senaraikan set perubahan
-l, --nombor garisan
tunjukkan nombor baris pada penampilan pertama
-w, --abaikan-semua-ruang
abaikan ruang putih apabila membandingkan garisan
-b, --abaikan-ruang-perubahan
mengabaikan perubahan dalam jumlah ruang putih
-B, --abaikan-garis-kosong
abaikan perubahan yang semua barisnya kosong
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-T,--template
paparan dengan templat (EKSPERIMEN)
[+] pilihan bertanda boleh ditentukan beberapa kali
alias: salahkan
arkib
buat arkib tidak berversi semakan repositori:
hg arkib [PILIHAN]... DEST
Secara lalai, semakan yang digunakan ialah induk bagi direktori kerja; gunakan -r/--rev ke
nyatakan semakan yang berbeza.
Jenis arkib dikesan secara automatik berdasarkan sambungan fail (untuk mengatasi, gunakan
-t/--jenis).
Contoh:
· buat fail zip yang mengandungi keluaran 1.0:
hg arkib -r 1.0 project-1.0.zip
· buat tarball tidak termasuk fail .hg:
hg arkib project.tar.gz -X ".hg*"
Jenis yang sah ialah:
fail
direktori yang penuh dengan fail (lalai)
tar
arkib tar, tidak dimampatkan
tbz2
arkib tar, dimampatkan menggunakan bzip2
tgz
arkib tar, dimampatkan menggunakan gzip
uzip
zip arkib, tidak dimampatkan
zip
zip arkib, dimampatkan menggunakan deflate
Nama sebenar arkib atau direktori destinasi diberikan menggunakan rentetan format; lihat
hg membantu mengeksport untuk maklumat lanjut.
Setiap ahli yang ditambahkan pada fail arkib mempunyai awalan direktori yang telah didahulukan. Gunakan -p/--prefix untuk
tentukan rentetan format untuk awalan. Lalai ialah nama asas arkib, dengan
akhiran dikeluarkan.
Mengembalikan 0 pada kejayaan.
Pilihan:
--tiada-nyahkod
jangan hantar fail melalui penyahkod
-p,--awalan
awalan direktori untuk fail dalam arkib
-r,--rev
semakan untuk diedarkan
-t,- jenis
jenis pengedaran untuk dibuat
-S, --subrepos
berulang ke dalam subrepositori
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
berundur
kesan terbalik set perubahan sebelumnya:
hg sandaran [PILIHAN]... [-r] REV
Sediakan set perubahan baharu dengan kesan REV dibuat asal dalam direktori kerja semasa. Jika
tiada konflik yang dihadapi, ia akan dilakukan serta-merta.
Jika REV ialah induk kepada direktori kerja, maka set perubahan baharu ini dilakukan
secara automatik (melainkan --no-commit ditentukan).
Nota hg berundur tidak boleh digunakan untuk membetulkan gabungan yang tidak diingini atau tidak betul.
Contoh:
· Balikkan kesan induk direktori kerja. Backout ini akan menjadi
komited segera:
hg sandaran -r .
· Balikkan kesan semakan buruk sebelumnya 23:
hg sandaran -r 23
· Balikkan kesan semakan buruk sebelumnya 23 dan biarkan perubahan tanpa komitmen:
hg backout -r 23 --no-commit
hg commit -m "Semakan keluar 23"
Secara lalai, set perubahan yang belum selesai akan mempunyai satu induk, mengekalkan sejarah linear. Dengan
--merge, set perubahan yang belum selesai sebaliknya akan mempunyai dua ibu bapa: ibu bapa lama
direktori kerja dan anak baharu REV yang hanya membuat asal REV.
Sebelum versi 1.7, tingkah laku tanpa --merge adalah bersamaan dengan menentukan --merge
diikuti oleh hg maklumat --bersih . untuk membatalkan gabungan dan meninggalkan anak REV sebagai ketua
untuk digabungkan secara berasingan.
Lihat hg membantu tarikh untuk senarai format yang sah untuk -d/--date.
Lihat hg membantu kembali untuk cara memulihkan fail kepada keadaan semakan lain.
Mengembalikan 0 pada kejayaan, 1 jika tiada apa yang perlu diundur atau terdapat fail yang belum diselesaikan.
Pilihan:
--bercantum
bergabung dengan induk dirstate lama selepas mundur
--komit
komit jika tiada konflik yang dihadapi (DIHENTIKAN)
--tidak-komit
jangan buat komitmen
--ibu bapa
ibu bapa untuk dipilih apabila menyandarkan gabungan (TIDAK TERUS)
-r,--rev
semakan kepada backout
-e, --edit
panggil editor pada komit mesej
-t,--alat
tentukan alat gabungan
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-m,--mesej
gunakan teks sebagai mesej komit
-l,--fail log
baca mesej komit daripada fail
-d,--Tarikh
rekod tarikh yang ditetapkan sebagai tarikh komit
-u,--pengguna
merekodkan pengguna yang ditentukan sebagai committer
[+] pilihan bertanda boleh ditentukan beberapa kali
dua belah
carian subbahagian perubahan set:
hg dua belah [-gbsr] [-U] [-c CMD] [REV]
Perintah ini membantu untuk mencari perubahan yang menimbulkan masalah. Untuk menggunakan, tandakan yang paling awal
changeset yang anda tahu mempamerkan masalah sebagai buruk, kemudian tandai changeset terkini iaitu
bebas daripada masalah sebagai baik. Bisect akan mengemas kini direktori kerja anda kepada semakan untuk
ujian (melainkan pilihan -U/--noupdate ditentukan). Setelah anda melakukan ujian,
tandakan direktori kerja sebagai baik atau buruk, dan dua bahagian akan sama ada mengemas kini kepada yang lain
set perubahan calon atau umumkan bahawa ia telah menemui semakan yang buruk.
Sebagai pintasan, anda juga boleh menggunakan hujah semakan untuk menandakan semakan sebagai baik atau buruk
tanpa menyemaknya terlebih dahulu.
Jika anda membekalkan arahan, ia akan digunakan untuk pembahagian dua automatik. Alam sekitar
pembolehubah HG_NODE akan mengandungi ID set perubahan yang sedang diuji. Status keluar daripada
arahan akan digunakan untuk menandakan semakan sebagai baik atau buruk: status 0 bermaksud baik, 125 bermaksud untuk
langkau semakan, 127 (arahan tidak ditemui) akan membatalkan pembahagian dua, dan mana-mana
status keluar bukan sifar bermakna semakan adalah buruk.
Beberapa contoh:
· mulakan pembahagian dua dengan semakan buruk 34 yang diketahui, dan semakan baik 12:
hg belah dua --buruk 34
hg dua belah --baik 12
· memajukan belahan semasa dengan menandakan semakan semasa sebagai baik atau buruk:
hg belah dua --bagus
hg belah dua --buruk
· tandakan semakan semasa, atau semakan yang diketahui, untuk dilangkau (cth. jika semakan itu
tidak boleh digunakan kerana isu lain):
hg belah dua --langkau
hg belah dua --langkau 23
· langkau semua semakan yang tidak menyentuh direktori foo or bar:
hg dua belah --langkau "!( fail('path:foo') & fail('path:bar') )"
· lupakan belahan semasa:
hg belah dua --set semula
· gunakan 'buat && buat ujian' untuk mencari semakan rosak pertama secara automatik:
hg belah dua --set semula
hg belah dua --buruk 34
hg dua belah --baik 12
hg dua belah --perintah "buat && buat ujian"
· lihat semua set perubahan yang keadaannya sudah diketahui dalam pembahagian semasa:
hg log -r "belah dua (dipangkas)"
· lihat set perubahan yang sedang dibahagikan (terutamanya berguna jika dijalankan dengan
-U/--tiada kemas kini):
hg log -r "dua belah (semasa)"
· lihat semua set perubahan yang mengambil bahagian dalam pembahagian bahagian semasa:
hg log -r "dua belah (julat)"
· anda juga boleh mendapatkan graf yang bagus:
hg log --graph -r "bisekt(julat)"
Lihat hg membantu set semula untuk lebih lanjut mengenai belah dua () kata kunci.
Mengembalikan 0 pada kejayaan.
Pilihan:
-r, --set semula
set semula keadaan belah dua
-g, --baik
tandakan changeset baik
-b, --buruk
tandakan changeset teruk
-ya, --langkau
langkau set perubahan ujian
-e, --panjangkan
memanjangkan julat pembahagian dua
-c,--perintah
gunakan arahan untuk menyemak keadaan set perubahan
-U, --tiada kemas kini
jangan kemas kini ke sasaran
penanda buku
buat penanda halaman baharu atau senaraikan penanda halaman sedia ada:
hg penanda halaman [PILIHAN]... [NAMA]...
Penanda halaman ialah label pada set perubahan untuk membantu menjejaki garis pembangunan. Penanda buku adalah
tidak versi dan boleh dialihkan, dinamakan semula dan dipadamkan. Memadam atau mengalihkan penanda halaman mempunyai no
kesan ke atas perubahan yang berkaitan.
Mencipta atau mengemas kini kepada penanda halaman menyebabkan ia ditandakan sebagai 'aktif'. Yang aktif
penanda halaman ditunjukkan dengan '*'. Apabila komitmen dibuat, penanda halaman aktif akan maju
kepada komitmen baru. Sebuah dataran hg maklumat juga akan memajukan penanda halaman aktif, jika boleh.
Mengemas kini daripada penanda halaman akan menyebabkan ia dinyahaktifkan.
Penanda halaman boleh ditolak dan ditarik antara repositori (lihat hg membantu menolak and hg membantu tarik
). Jika penanda halaman kongsi telah menyimpang, 'penanda halaman berbeza' baharu dalam bentuk 'nama@laluan'
akan diwujudkan. menggunakan hg bergabung akan menyelesaikan perbezaan tersebut.
Penanda halaman bernama '@' mempunyai sifat istimewa itu hg mengklon akan menyemaknya secara lalai
jika ia wujud.
Contoh:
· buat penanda halaman aktif untuk barisan pembangunan baharu:
hg book ciri baharu
· buat penanda halaman yang tidak aktif sebagai penanda tempat:
hg buku -saya menyemak
· buat penanda halaman yang tidak aktif pada set perubahan lain:
hg buku -r .^ diuji
· menamakan semula penanda buku ayam belanda kepada makan malam:
hg buku -m makan malam ayam belanda
· alihkan penanda halaman '@' dari cawangan lain:
hg buku -f @
Pilihan:
-f, - kekuatan
kekuatan
-r,--rev
semakan untuk tindakan penanda halaman
-d, --padam
padamkan penanda halaman yang diberikan
-m,--menamakan semula
menamakan semula penanda halaman yang diberikan
-saya, --tidak aktif
tandakan penanda buku tidak aktif
-T,--template
paparan dengan templat (EKSPERIMEN)
alias: penanda buku
cawangan
tetapkan atau tunjukkan nama cawangan semasa:
cawangan hg [-fC] [NAMA]
Nota Nama cawangan adalah kekal dan global. guna hg bookmark untuk mencipta berat ringan
penanda buku sebaliknya. Lihat hg membantu glosari untuk maklumat lanjut tentang cawangan yang dinamakan
dan penanda buku.
Tanpa hujah, tunjukkan nama cawangan semasa. Dengan satu hujah, tetapkan kerja
nama cawangan direktori (cawangan tidak akan wujud dalam repositori sehingga komit seterusnya).
Amalan standard mengesyorkan bahawa pembangunan utama berlaku pada cawangan 'lalai'.
Melainkan -f/--force ditentukan, cawangan tidak akan membenarkan anda menetapkan nama cawangan yang sudah
wujud.
Gunakan -C/--clean untuk menetapkan semula cawangan direktori kerja kepada bahagian induk kerja
direktori, menafikan perubahan cawangan sebelumnya.
Gunakan arahan hg maklumat untuk bertukar ke cawangan sedia ada. guna hg melakukan --cawangan-tutup kepada
tandakan ketua cawangan ini sebagai ditutup. Apabila semua ketua cawangan ditutup, cawangan akan
dianggap tertutup.
Mengembalikan 0 pada kejayaan.
Pilihan:
-f, - kekuatan
tetapkan nama cawangan walaupun ia membayangi cawangan sedia ada
-C, --bersih
set semula nama cawangan kepada nama cawangan induk
cawangan
senaraikan repositori bernama cawangan:
cawangan hg [-c]
Senaraikan cawangan yang dinamakan repositori, menunjukkan mana yang tidak aktif. Jika -c/--ditutup
ditentukan, serta senaraikan cawangan yang telah ditanda ditutup (lihat hg melakukan
--cawangan-tutup).
Gunakan arahan hg maklumat untuk bertukar ke cawangan sedia ada.
Mengembalikan 0.
Pilihan:
-A, --aktif
tunjukkan hanya cawangan yang mempunyai kepala tidak bercantum (TIDAK ADA)
-c, --ditutup
menunjukkan cawangan biasa dan tertutup
-T,--template
paparan dengan templat (EKSPERIMEN)
bundle
buat fail changegroup:
hg bundle [-f] [-t TYPE] [-a] [-r REV]... [--base REV]... FAIL [DEST]
Hasilkan fail kumpulan perubahan yang mengumpul set perubahan untuk ditambahkan pada repositori.
Untuk membuat himpunan yang mengandungi semua set perubahan, gunakan -a/--all (atau --base null). Jika tidak, hg
menganggap destinasi akan mempunyai semua nod yang anda tentukan dengan parameter --base.
Jika tidak, hg akan menganggap repositori mempunyai semua nod dalam destinasi, atau
lalai-tolak/lalai jika tiada destinasi ditentukan.
Anda boleh menukar format berkas dengan pilihan -t/--type. Anda boleh menentukan pemampatan, a
versi berkas atau kedua-duanya menggunakan sengkang (versi komp). Kaedah pemampatan yang tersedia ialah:
tiada, bzip2 dan gzip (secara lalai, berkas dimampatkan menggunakan bzip2). Yang ada
format ialah: v1, v2 (lalai kepada yang paling sesuai).
Fail berkas kemudiannya boleh dipindahkan menggunakan cara konvensional dan digunakan pada yang lain
repositori dengan perintah unbundle atau pull. Ini berguna apabila tolakan dan tarikan terus
tidak tersedia atau apabila mengeksport keseluruhan repositori adalah tidak diingini.
Menggunakan himpunan mengekalkan semua kandungan set perubahan termasuk kebenaran, salin/menamakan semula
maklumat, dan sejarah semakan.
Mengembalikan 0 pada kejayaan, 1 jika tiada perubahan ditemui.
Pilihan:
-f, - kekuatan
berjalan walaupun destinasi tidak berkaitan
-r,--rev
set perubahan yang bertujuan untuk ditambahkan pada destinasi
-b,--cawangan
cawangan tertentu yang anda ingin himpunkan
--dasar
set perubahan asas yang diandaikan tersedia di destinasi
-A, --semua
ikat semua perubahan dalam repositori
-t,- jenis
jenis mampatan berkas untuk digunakan (lalai: bzip2)
-e,--ssh
tentukan arahan ssh untuk digunakan
--remotecmd
tentukan arahan hg untuk dijalankan pada bahagian jauh
--tidak selamat
jangan sahkan sijil pelayan (mengabaikan konfigurasi web.cacerts)
[+] pilihan bertanda boleh ditentukan beberapa kali
kucing
keluarkan semakan fail semasa atau diberikan:
hg cat [PILIHAN]... FAIL...
Cetak fail yang ditentukan seperti yang terdapat pada semakan yang diberikan. Jika tiada semakan diberikan, the
induk direktori kerja digunakan.
Output mungkin kepada fail, dalam hal ini nama fail diberikan menggunakan format
tali. Peraturan pemformatan seperti berikut:
%%
aksara "%" literal
%s
nama asas fail yang sedang dicetak
%d
nama fail yang sedang dicetak atau '.' jika dalam akar repositori
%p
nama laluan relatif akar bagi fail yang sedang dicetak
%H
changeset hash (40 digit heksadesimal)
%R
tukar nombor semakan
%h
cincang set perubahan bentuk pendek (12 digit heksadesimal)
%r
nombor semakan set perubahan berlapik sifar
%b
nama asas repositori pengeksport
Mengembalikan 0 pada kejayaan.
Pilihan:
-o,--pengeluaran
cetak output ke fail dengan nama terformat
-r,--rev
mencetak semakan yang diberikan
--nyahkod
gunakan mana-mana penapis nyahkod yang sepadan
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
mengklon
buat salinan repositori sedia ada:
hg klon [PILIHAN]... SUMBER [DEST]
Buat salinan repositori sedia ada dalam direktori baharu.
Jika tiada nama direktori destinasi dinyatakan, ia lalai kepada nama asas sumber.
Lokasi sumber ditambahkan pada repositori baharu .hg/hgrc fail, sebagai lalai
untuk digunakan untuk tarikan masa hadapan.
Hanya laluan tempatan dan ssh:// URL disokong sebagai destinasi. Untuk ssh:// destinasi,
tiada direktori kerja atau .hg/hgrc akan dibuat di bahagian terpencil.
Jika repositori sumber mempunyai penanda halaman yang dipanggil set '@', semakan itu akan diperiksa
dalam repositori baharu secara lalai.
Untuk menyemak versi tertentu, gunakan -u/--update, atau -U/--noupdate untuk membuat klon
tanpa direktori kerja.
Untuk menarik hanya subset set perubahan, tentukan satu atau lebih pengecam semakan dengan
-r/--rev atau cawangan dengan -b/--cawangan. Klon yang terhasil akan mengandungi hanya yang ditentukan
perubahan dan nenek moyang mereka. Pilihan ini (atau 'clone src#rev dest') membayangkan --pull, even
untuk repositori sumber tempatan.
Nota Menentukan teg akan termasuk set perubahan berteg tetapi bukan set perubahan yang mengandungi
tag itu.
Untuk kecekapan, pautan keras digunakan untuk pengklonan apabila sumber dan destinasi dihidupkan
sistem fail yang sama (perhatikan ini hanya terpakai pada data repositori, bukan untuk kerja
direktori). Sesetengah sistem fail, seperti AFS, melaksanakan pemautan keras secara salah, tetapi tidak
melaporkan kesilapan. Dalam kes ini, gunakan pilihan --pull untuk mengelakkan pautan keras.
Dalam sesetengah kes, anda boleh mengklon repositori dan direktori kerja menggunakan pautan keras penuh
bersama
$ cp -al REPO REPOCLONE
Ini adalah cara terpantas untuk mengklon, tetapi ia tidak selalunya selamat. Operasi itu bukan atom
(memastikan REPO tidak diubah suai semasa operasi terpulang kepada anda) dan anda perlu buat
pastikan editor anda memecahkan pautan keras (Emacs dan kebanyakan alatan Linux Kernel berbuat demikian). Juga, ini adalah
tidak serasi dengan sambungan tertentu yang meletakkan metadatanya di bawah direktori .hg,
seperti mq.
Mercurial akan mengemas kini direktori kerja kepada semakan pertama yang berkenaan daripada ini
senarai:
a. null jika -U atau repositori sumber tidak mempunyai perubahan
b. kalau awak . dan repositori sumber adalah setempat, induk pertama repositori sumber
direktori kerja
c. set perubahan yang ditentukan dengan -u (jika nama cawangan, ini bermakna ketua terbaharu itu
cawangan)
d. set perubahan yang ditentukan dengan -r
e. kepala paling hujung dinyatakan dengan -b
f. kepala paling hujung yang ditentukan dengan sintaks sumber url#branch
g. semakan yang ditanda dengan penanda buku '@', jika ada
h. kepala paling hujung bagi cawangan lalai
i. petua
Apabila mengklon daripada pelayan yang menyokongnya, Mercurial mungkin mengambil data pra-jana daripada a
URL yang diiklankan pelayan. Apabila ini selesai, cangkuk beroperasi pada set perubahan masuk dan
changegroups boleh menyala dua kali, sekali untuk himpunan yang diambil daripada URL dan satu lagi untuk mana-mana
data tambahan tidak diambil daripada URL ini. Di samping itu, jika ralat berlaku, repositori
boleh digulung semula kepada klon separa. Tingkah laku ini mungkin berubah dalam keluaran akan datang. Lihat hg
membantu -e klonebundle untuk lebih.
Contoh:
· mengklon repositori jauh ke direktori baharu bernama hg/:
hg klon http://selenic.com/hg
· cipta klon tempatan yang ringan:
projek klon hg/ ciri projek/
· mengklon daripada laluan mutlak pada pelayan ssh (perhatikan dua garis miring):
hg klon ssh://user@server//home/projects/alpha/
· lakukan klon berkelajuan tinggi melalui LAN sambil menyemak versi yang ditentukan:
hg klon --tidak dimampatkan http://server/repo -u 1.5
· buat repositori tanpa set perubahan selepas semakan tertentu:
hg klon -r 04e544 eksperimen/ bagus/
· mengklon (dan menjejaki) cawangan bernama tertentu:
hg klon http://selenic.com/hg#stabil
Lihat hg membantu url untuk butiran tentang menentukan URL.
Mengembalikan 0 pada kejayaan.
Pilihan:
-U, --tiada kemas kini
klon akan memasukkan direktori kerja kosong (hanya repositori)
-u,--updaterev
semakan, teg atau cawangan untuk menyemak
-r,--rev
sertakan set perubahan yang ditentukan
-b,--cawangan
klon hanya cawangan yang ditentukan
--tarik gunakan protokol tarik untuk menyalin metadata
--tidak dimampatkan
gunakan pemindahan tidak termampat (cepat melalui LAN)
-e,--ssh
tentukan arahan ssh untuk digunakan
--remotecmd
tentukan arahan hg untuk dijalankan pada bahagian jauh
--tidak selamat
jangan sahkan sijil pelayan (mengabaikan konfigurasi web.cacerts)
[+] pilihan bertanda boleh ditentukan beberapa kali
melakukan
lakukan fail yang ditentukan atau semua perubahan tertunggak:
hg commit [PILIHAN]... [FAIL]...
Lakukan perubahan pada fail yang diberikan ke dalam repositori. Tidak seperti SCM berpusat, ini
operasi adalah operasi tempatan. Lihat hg menolak untuk cara mengedarkan perubahan anda secara aktif.
Jika senarai fail ditinggalkan, semua perubahan dilaporkan oleh hg terkini akan komited.
Jika anda melakukan hasil gabungan, jangan berikan sebarang nama fail atau -I/-X
penapis.
Jika tiada mesej komit dinyatakan, Mercurial memulakan editor terkonfigurasi anda di mana anda boleh
masukkan mesej. Sekiranya komit anda gagal, anda akan menemui sandaran mesej anda
.hg/last-message.txt.
Bendera --close-branch boleh digunakan untuk menandakan kepala cawangan semasa ditutup. Apabila semua kepala
cawangan ditutup, cawangan itu akan dianggap ditutup dan tidak lagi disenaraikan.
Bendera --amend boleh digunakan untuk meminda induk direktori kerja dengan yang baharu
commit yang mengandungi perubahan dalam induk sebagai tambahan kepada yang kini dilaporkan oleh
hg terkini, jika ada. Komit lama disimpan dalam himpunan sandaran dalam
.hg/strip-backup (Lihat hg membantu bundle and hg membantu unbundle tentang cara memulihkannya).
Mesej, pengguna dan tarikh diambil daripada komit yang dipinda melainkan dinyatakan. Apabila mesej
tidak dinyatakan pada baris arahan, editor akan dibuka dengan mesej yang dipinda
komited.
Tidak mungkin untuk meminda set perubahan awam (lihat hg membantu fasa) atau perubahan yang mempunyai
kanak-kanak.
Lihat hg membantu tarikh untuk senarai format yang sah untuk -d/--date.
Mengembalikan 0 pada kejayaan, 1 jika tiada perubahan.
Contoh:
· komit semua fail yang berakhir dengan .py:
hg commit --include "set:**.py"
· komit semua fail bukan binari:
hg commit --exclude "set: binary()"
· pinda komit semasa dan tetapkan tarikh kepada sekarang:
hg commit --pindaan --tarikh sekarang
Pilihan:
-A, --addremove
tandakan fail baharu/tiada sebagai ditambah/dialih keluar sebelum melakukan
--cawangan-tutup
tandakan kepala cawangan sebagai tertutup
- amend
meminda induk direktori kerja
-ya, --rahsia
gunakan fasa rahsia untuk melakukan
-e, --edit
panggil editor pada komit mesej
-saya, --interaktif
gunakan mod interaktif
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-m,--mesej
gunakan teks sebagai mesej komit
-l,--fail log
baca mesej komit daripada fail
-d,--Tarikh
rekod tarikh yang ditetapkan sebagai tarikh komit
-u,--pengguna
merekodkan pengguna yang ditentukan sebagai committer
-S, --subrepos
berulang ke dalam subrepositori
[+] pilihan bertanda boleh ditentukan beberapa kali
alias: ci
config
tunjukkan tetapan konfigurasi gabungan dari semua fail hgrc:
hg konfigurasi [-u] [NAMA]...
Tanpa hujah, cetak nama dan nilai semua item konfigurasi.
Dengan satu hujah borang section.name, cetak hanya nilai item konfigurasi itu.
Dengan berbilang argumen, cetak nama dan nilai semua item konfigurasi dengan bahagian yang sepadan
nama.
Dengan --edit, mulakan editor pada fail konfigurasi peringkat pengguna. Dengan --global, edit
fail konfigurasi seluruh sistem. Dengan --local, edit fail konfigurasi peringkat repositori.
Dengan --debug, sumber (nama fail dan nombor baris) dicetak untuk setiap item konfigurasi.
Lihat hg membantu config untuk maklumat lanjut tentang fail konfigurasi.
Mengembalikan 0 pada kejayaan, 1 jika NAME tidak wujud.
Pilihan:
-u, --tidak dipercayai
tunjukkan pilihan konfigurasi yang tidak dipercayai
-e, --edit
edit konfigurasi pengguna
-l, --tempatan
edit konfigurasi repositori
-g, --global
edit konfigurasi global
alias: showconfig debugconfig
salinan
tandakan fail sebagai disalin untuk komit seterusnya:
hg copy [PILIHAN]... [SUMBER]... DEST
Tandai dest sebagai mempunyai salinan fail sumber. Jika dest ialah direktori, salinan diletakkan di dalamnya
direktori. Jika dest ialah fail, sumber mestilah satu fail.
Secara lalai, arahan ini menyalin kandungan fail kerana ia wujud dalam kerja
direktori. Jika dipanggil dengan -A/--selepas, operasi direkodkan, tetapi tiada penyalinan
dilakukan.
Perintah ini berkuat kuasa dengan komit seterusnya. Untuk membuat asal salinan sebelum itu, lihat hg kembali.
Mengembalikan 0 pada kejayaan, 1 jika ralat ditemui.
Pilihan:
-A, --selepas
merekodkan salinan yang telah berlaku
-f, - kekuatan
menyalin secara paksa fail terurus sedia ada
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-n, --lari kering
jangan lakukan tindakan, hanya cetak output
[+] pilihan bertanda boleh ditentukan beberapa kali
alias: cp
diff
repositori diff (atau fail terpilih):
hg diff [PILIHAN]... ([-c REV] | [-r REV1 [-r REV2]]) [FAIL]...
Tunjukkan perbezaan antara semakan untuk fail yang ditentukan.
Perbezaan antara fail ditunjukkan menggunakan format perbezaan bersatu.
Nota hg diff mungkin menjana hasil yang tidak dijangka untuk cantuman, kerana ia akan menjadi lalai untuk membandingkan
terhadap set perubahan induk pertama direktori kerja jika tiada semakan
dinyatakan.
Apabila dua hujah semakan diberikan, maka perubahan ditunjukkan antara semakan tersebut. Jika
hanya satu semakan ditentukan kemudian semakan itu dibandingkan dengan direktori kerja,
dan, apabila tiada semakan ditentukan, fail direktori kerja dibandingkan dengannya
ibu bapa pertama.
Sebagai alternatif anda boleh menentukan -c/--change dengan semakan untuk melihat perubahan dalam itu
changeset relatif kepada induk pertamanya.
Tanpa pilihan -a/--text, diff akan mengelak daripada menjana perbezaan fail yang dikesan sebagai
binari. Dengan -a, perbezaan akan menghasilkan perbezaan, mungkin dengan hasil yang tidak diingini.
Gunakan pilihan -g/--git untuk menjana perbezaan dalam format git extended diff. Untuk lebih
maklumat, baca hg membantu berbeza.
Contoh:
· bandingkan fail dalam direktori kerja semasa dengan induknya:
hg diff foo.c
· bandingkan dua versi sejarah direktori, dengan menamakan semula maklumat:
hg diff --git -r 1.0:1.2 lib/
· dapatkan statistik perubahan berbanding dengan perubahan terakhir pada beberapa tarikh:
hg diff --stat -r "tarikh('2 Mei')"
· membezakan semua fail yang baru ditambah yang mengandungi kata kunci:
hg diff "set:added() dan grep(GNU)"
· membandingkan semakan dan ibu bapanya:
hg diff -c 9353 # bandingkan dengan induk pertama
hg diff -r 9353^:9353 # sama menggunakan sintaks revset
hg diff -r 9353^2:9353 # bandingkan dengan induk kedua
Mengembalikan 0 pada kejayaan.
Pilihan:
-r,--rev
semakan
-c,--ubah
perubahan yang dibuat melalui semakan
-A, - teks
layan semua fail sebagai teks
-g, --git
gunakan format git extended diff
--nodates
tinggalkan tarikh daripada pengepala berbeza
--noprefix
tinggalkan awalan a/ dan b/ daripada nama fail
-p, --tunjuk-fungsi
tunjukkan fungsi yang ada pada setiap perubahan
--terbalik
menghasilkan perbezaan yang membatalkan perubahan
-w, --abaikan-semua-ruang
abaikan ruang putih apabila membandingkan garisan
-b, --abaikan-ruang-perubahan
mengabaikan perubahan dalam jumlah ruang putih
-B, --abaikan-garis-kosong
abaikan perubahan yang semua barisnya kosong
-U,--bersatu
bilangan baris konteks untuk ditunjukkan
--stat keluaran ringkasan gaya diffstat bagi perubahan
--akar
menghasilkan perbezaan berbanding dengan subdirektori
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-S, --subrepos
berulang ke dalam subrepositori
[+] pilihan bertanda boleh ditentukan beberapa kali
mengeksport
buang pengepala dan perbezaan untuk satu atau lebih set perubahan:
hg eksport [PILIHAN]... [-o OUTFILESPEC] [-r] [REV]...
Cetak pengepala set perubahan dan perbezaan untuk satu atau lebih semakan. Jika tiada semakan diberikan,
induk direktori kerja digunakan.
Maklumat yang ditunjukkan dalam pengepala set perubahan ialah: pengarang, tarikh, nama cawangan (jika
bukan lalai), changeset hash, induk(s) dan komen komit.
Nota hg mengeksport boleh menjana output perbezaan yang tidak dijangka untuk set perubahan gabungan, seperti yang akan berlaku
bandingkan set perubahan gabungan dengan induk pertamanya sahaja.
Output mungkin kepada fail, dalam hal ini nama fail diberikan menggunakan format
tali. Peraturan pemformatan adalah seperti berikut:
%%
aksara "%" literal
%H
changeset hash (40 digit heksadesimal)
%N
bilangan patch yang dihasilkan
%R
tukar nombor semakan
%b
nama asas repositori pengeksport
%h
cincang set perubahan bentuk pendek (12 digit heksadesimal)
%m
baris pertama mesej komit (hanya aksara abjad angka)
%n
nombor urutan berlapik sifar, bermula pada 1
%r
nombor semakan set perubahan berlapik sifar
Tanpa pilihan -a/--text, eksport akan mengelak daripada menjana perbezaan fail yang dikesan sebagai
binari. Dengan -a, eksport akan menghasilkan perbezaan, mungkin dengan hasil yang tidak diingini.
Gunakan pilihan -g/--git untuk menjana perbezaan dalam format git extended diff. Lihat hg membantu
berbeza untuk maklumat lanjut.
Dengan pilihan --switch-parent, perbezaannya adalah terhadap induk kedua. Ia boleh menjadi
berguna untuk menyemak gabungan.
Contoh:
· gunakan eksport dan import untuk memindahkan pembetulan pepijat ke cawangan semasa:
hg eksport -r 9353 | hg import -
· eksport semua set perubahan antara dua semakan ke fail dengan menamakan semula maklumat:
hg eksport --git -r 123:150 > changes.txt
· pecahkan perubahan keluar kepada satu siri tampalan dengan nama deskriptif:
hg export -r "outgoing()" -o "%n-%m.patch"
Mengembalikan 0 pada kejayaan.
Pilihan:
-o,--pengeluaran
cetak output ke fail dengan nama terformat
--tukar-induk
berbeza dengan ibu bapa kedua
-r,--rev
semakan untuk mengeksport
-A, - teks
layan semua fail sebagai teks
-g, --git
gunakan format git extended diff
--nodates
tinggalkan tarikh daripada pengepala berbeza
[+] pilihan bertanda boleh ditentukan beberapa kali
fail
senaraikan fail yang dijejaki:
fail hg [PILIHAN]... [CORAK]...
Cetak fail di bawah kawalan Mercurial dalam direktori kerja atau semakan tertentu yang
nama sepadan dengan corak yang diberikan (tidak termasuk fail yang dialih keluar).
Jika tiada corak diberikan untuk dipadankan, arahan ini mencetak nama semua fail di bawah
Kawalan merkuri dalam direktori kerja.
Contoh:
· senaraikan semua fail di bawah direktori semasa:
fail hg.
· menunjukkan saiz dan bendera untuk semakan semasa:
fail hg -vr .
· senaraikan semua fail bernama README:
fail hg -I "**/README"
· senaraikan semua fail binari:
fail hg "set: binary()"
· cari fail yang mengandungi ungkapan biasa:
fail hg "set:grep('bob')"
· cari kandungan fail yang dijejaki dengan xargs dan grep:
fail hg -0 | xargs -0 grep foo
Lihat hg membantu corak and hg membantu set fail untuk maklumat lanjut tentang menentukan fail
corak.
Mengembalikan 0 jika padanan ditemui, 1 sebaliknya.
Pilihan:
-r,--rev
cari repositori seperti yang terdapat dalam REV
-0, --cetak0
tamatkan nama fail dengan NUL, untuk digunakan dengan xargs
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-T,--template
paparan dengan templat (EKSPERIMEN)
-S, --subrepos
berulang ke dalam subrepositori
[+] pilihan bertanda boleh ditentukan beberapa kali
lupa
lupakan fail yang ditentukan pada komit seterusnya:
hg lupa [PILIHAN]... FAIL...
Tandai fail yang ditentukan supaya ia tidak lagi dijejaki selepas komit seterusnya.
Ini hanya mengalih keluar fail daripada cawangan semasa, bukan daripada keseluruhan sejarah projek, dan
ia tidak memadamnya daripada direktori kerja.
Untuk memadam fail daripada direktori kerja, lihat hg mengeluarkan.
Untuk membuat asal lupa sebelum komit seterusnya, lihat hg menambah.
Contoh:
· lupakan fail binari yang baru ditambah:
hg lupakan "set:added() dan binary()"
· lupakan fail yang akan dikecualikan oleh .hgignore:
hg lupa "set:hgignore()"
Mengembalikan 0 pada kejayaan.
Pilihan:
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
rasuah
salin perubahan dari cawangan lain ke cawangan semasa:
hg cantuman [PILIHAN]... [-r REV]... REV...
Perintah ini menggunakan logik gabungan Mercurial untuk menyalin perubahan individu daripada cawangan lain
tanpa menggabungkan cabang dalam graf sejarah. Ini kadangkala dikenali sebagai 'backporting' atau
'memetik ceri'. Secara lalai, cantuman akan menyalin pengguna, tarikh dan keterangan daripada sumber
set perubahan.
Set perubahan yang merupakan nenek moyang semakan semasa, yang telah dicantumkan, atau
yang merupakan gabungan akan dilangkau.
Jika --log ditentukan, mesej log akan mempunyai ulasan yang dilampirkan pada borang:
(dicantumkan daripada CHANGESETHASH)
Jika --force dinyatakan, semakan akan dicantumkan walaupun ia sudah menjadi nenek moyang
atau telah dicantumkan ke destinasi. Ini berguna apabila semakan telah dibuat sejak itu
telah diundur.
Jika cantuman cantuman mengakibatkan konflik, proses cantuman akan terganggu sehinggakan
gabungan semasa boleh diselesaikan secara manual. Setelah semua konflik ditangani, rasuah
proses boleh diteruskan dengan pilihan -c/--continue.
Nota Pilihan -c/--continue tidak menggunakan semula pilihan sebelumnya, kecuali untuk --force.
Contoh:
· salin satu perubahan ke cawangan stabil dan edit penerangannya:
kemas kini hg stabil
hg cantuman --edit 9393
· cantuman julat set perubahan dengan satu pengecualian, mengemas kini tarikh:
hg cantuman -D "2085::2093 dan bukan 2091"
· meneruskan rasuah selepas menyelesaikan konflik:
hg cantuman -c
· tunjukkan sumber set perubahan yang dicantumkan:
hg log --debug -r .
· tunjukkan semakan disusun mengikut tarikh:
hg log -r 'sort(all(), date)'
Lihat hg membantu semakan and hg membantu set semula untuk lebih lanjut tentang menentukan semakan.
Mengembalikan 0 apabila berjaya disiapkan.
Pilihan:
-r,--rev
semakan kepada rasuah
-c, --sambung
menyambung semula rasuah tergendala
-e, --edit
panggil editor pada komit mesej
--log tambah maklumat cantuman pada mesej log
-f, - kekuatan
rasuah paksa
-D, --tarikh semasa
rekod tarikh semasa sebagai tarikh komit
-U, --pengguna semasa
merekodkan pengguna semasa sebagai committer
-d,--Tarikh
rekod tarikh yang ditetapkan sebagai tarikh komit
-u,--pengguna
merekodkan pengguna yang ditentukan sebagai committer
-t,--alat
tentukan alat gabungan
-n, --lari kering
jangan lakukan tindakan, hanya cetak output
[+] pilihan bertanda boleh ditentukan beberapa kali
grep
cari corak dalam fail dan semakan yang ditentukan:
hg grep [PILIHAN]... CORAK [FAIL]...
Cari semakan fail untuk ungkapan biasa.
Perintah ini berkelakuan berbeza daripada Unix grep. Ia hanya menerima Python/Perl regexps. Ia
mencari sejarah repositori, bukan direktori kerja. Ia sentiasa mencetak semakan
nombor di mana padanan muncul.
Secara lalai, grep hanya mencetak output untuk semakan pertama fail di mana ia menemui a
perlawanan. Untuk mendapatkannya mencetak setiap semakan yang mengandungi perubahan dalam status padanan ("-" untuk a
padanan yang menjadi bukan padanan atau "+" untuk bukan padanan yang menjadi padanan), gunakan
--semua bendera.
Mengembalikan 0 jika padanan ditemui, 1 sebaliknya.
Pilihan:
-0, --cetak0
tamatkan medan dengan NUL
--semua cetak semua semakan yang sepadan
-A, - teks
layan semua fail sebagai teks
-f, --ikut
ikut sejarah set perubahan, atau sejarah fail merentas salinan dan nama semula
-saya, --abaikan-kes
abaikan kes apabila memadankan
-l, --fail-dengan-perlawanan
cetak hanya nama fail dan semakan yang sepadan
-n, --nombor garisan
mencetak nombor baris yang sepadan
-r,--rev
hanya fail carian diubah dalam julat semakan
-u, --pengguna
senaraikan pengarang (panjang dengan -v)
-d, --Tarikh
senaraikan tarikh (pendek dengan -q)
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
kepala
tunjukkan ketua cawangan:
hg kepala [-ct] [-r STARTREV] [REV]...
Tanpa hujah, tunjukkan semua kepala cawangan terbuka dalam repositori. Ketua cawangan ialah
changeset yang tidak mempunyai keturunan pada cawangan yang sama. Mereka adalah tempat pembangunan
umumnya berlaku dan merupakan sasaran biasa untuk operasi kemas kini dan gabungan.
Jika satu atau lebih REV diberikan, hanya buka kepala cawangan pada cawangan yang berkaitan dengan
set perubahan yang ditentukan ditunjukkan. Ini bermakna anda boleh menggunakan hg kepala . untuk melihat kepala pada
cawangan yang sedang mendaftar keluar.
Jika -c/--closed ditentukan, tunjukkan juga kepala cawangan yang ditanda ditutup (lihat hg melakukan
--cawangan-tutup).
Jika STARTREV ditentukan, hanya ketua yang merupakan keturunan STARTREV akan menjadi
dipaparkan.
Jika -t/--topo dinyatakan, mekanik cawangan yang dinamakan akan diabaikan dan hanya topologi
kepala (perubahan tanpa kanak-kanak) akan ditunjukkan.
Mengembalikan 0 jika kepala yang sepadan ditemui, 1 jika tidak.
Pilihan:
-r,--rev
tunjukkan hanya kepala yang merupakan keturunan STARTREV
-t, --topo
tunjukkan kepala topologi sahaja
-A, --aktif
tunjukkan ketua cawangan yang aktif sahaja (DILARANG)
-c, --ditutup
menunjukkan kepala cawangan biasa dan tertutup
--gaya
paparan menggunakan fail peta templat (DILARANG)
-T,--template
paparan dengan templat
membantu
tunjukkan bantuan untuk topik tertentu atau gambaran keseluruhan bantuan:
hg bantuan [-ecks] [TOPIK]
Tanpa hujah, cetak senarai arahan dengan mesej bantuan ringkas.
Diberi topik, sambungan atau nama perintah, cetak bantuan untuk topik itu.
Mengembalikan 0 jika berjaya.
Pilihan:
-e, --sambungan
tunjukkan hanya bantuan untuk sambungan
-c, --perintah
tunjukkan hanya bantuan untuk arahan
-k, --kata kunci
tunjukkan topik padanan kata kunci
-ya,--sistem
tunjukkan bantuan untuk platform tertentu
[+] pilihan bertanda boleh ditentukan beberapa kali
mengenal pasti
mengenal pasti direktori kerja atau semakan yang ditentukan:
hg kenal pasti [-nibtB] [-r REV] [SUMBER]
Cetak ringkasan yang mengenal pasti keadaan repositori di REV menggunakan satu atau dua cincang induk
pengecam, diikuti dengan "+" jika direktori kerja mempunyai perubahan tanpa komitmen, the
nama cawangan (jika tidak lalai), senarai tag dan senarai penanda halaman.
Apabila REV tidak diberikan, cetak ringkasan keadaan semasa repositori.
Menentukan laluan ke akar repositori atau berkas Mercurial akan menyebabkan carian beroperasi
repositori/bundle itu.
Contoh:
· menjana pengecam binaan untuk direktori kerja:
hg id --id > build-id.dat
· cari semakan yang sepadan dengan teg:
hg id -n -r 1.3
· semak semakan terbaru repositori jauh:
hg id -r tip http://selenic.com/hg/
Lihat hg log untuk menjana maklumat lanjut tentang semakan khusus, termasuk cincang penuh
pengecam.
Mengembalikan 0 jika berjaya.
Pilihan:
-r,--rev
mengenal pasti semakan yang ditetapkan
-n, --bilangan
tunjukkan nombor semakan tempatan
-saya, --ID
tunjukkan id semakan global
-b, --cawangan
tunjuk cawangan
-t, --tag
tunjukkan tag
-B, --penanda buku
tunjukkan penanda buku
-e,--ssh
tentukan arahan ssh untuk digunakan
--remotecmd
tentukan arahan hg untuk dijalankan pada bahagian jauh
--tidak selamat
jangan sahkan sijil pelayan (mengabaikan konfigurasi web.cacerts)
alias: id
mengimport
import set tampalan yang dipesan:
hg import [PILIHAN]... PATCH...
Import senarai patch dan masukkannya secara individu (melainkan --no-commit ditentukan).
Untuk membaca tampalan daripada input standard, gunakan "-" sebagai nama tampung. Jika URL ditentukan,
patch akan dimuat turun dari sana.
Import terlebih dahulu menggunakan perubahan pada direktori kerja (melainkan --bypass ditentukan),
import akan dibatalkan jika terdapat perubahan yang tertunggak.
Gunakan --bypass untuk memohon dan melakukan tampalan terus ke repositori, tanpa menjejaskan
direktori kerja. Tanpa --tepat, tampalan akan digunakan di atas kerja
semakan induk direktori.
Anda boleh mengimport tampung terus daripada mesej mel. Malah tampalan sebagai lampiran berfungsi (kepada
guna bahagian badan, mesti ada type text/plain or text/x-patch). Dari dan Pengepala Subjek
mesej e-mel digunakan sebagai komit lalai dan mesej komit. Semua teks/badan biasa
bahagian sebelum perbezaan pertama ditambahkan pada mesej komit.
Jika tampung yang diimport dihasilkan oleh hg mengeksport, pengguna dan perihalan daripada penggantian tampung
nilai daripada pengepala dan kandungan mesej. Nilai yang diberikan pada baris arahan dengan -m/--message dan
-u/--pengguna mengatasi ini.
Jika --exact ditentukan, import akan menetapkan direktori kerja kepada induk setiap tampung
sebelum menggunakannya, dan akan membatalkan jika set perubahan yang terhasil mempunyai ID yang berbeza daripada
satu direkodkan dalam tampalan. Ini mungkin berlaku disebabkan masalah set watak atau lain-lain
kekurangan dalam format tampalan teks.
Gunakan --partial untuk memastikan set perubahan akan dibuat daripada tampalan walaupun beberapa hunks gagal
untuk memohon. Bongkok yang gagal memohon akan ditulis kepada a .rej fail. Konflik
kemudian boleh diselesaikan dengan tangan sebelum hg melakukan - amend dijalankan untuk mengemas kini yang dibuat
set perubahan. Bendera ini wujud untuk membenarkan orang mengimport patch yang sebahagiannya digunakan tanpa
kehilangan metadata yang berkaitan (pengarang, tarikh, penerangan, ...).
Nota Apabila tiada hunks memohon dengan bersih, hg mengimport --separa akan membuat set perubahan kosong,
hanya mengimport metadata tampung.
Dengan -s/--similarity, hg akan cuba mencari nama semula dan salinan dalam patch dalam
dengan cara yang sama seperti hg addremove.
Anda boleh menggunakan program tampalan luaran untuk melaksanakan tampalan dengan menetapkan ui.patch
pilihan konfigurasi. Untuk alat dalaman lalai, fuzz juga boleh dikonfigurasikan melalui
patch.fuzz. Lihat hg membantu config untuk maklumat lanjut tentang fail konfigurasi dan cara untuk
gunakan pilihan ini.
Lihat hg membantu tarikh untuk senarai format yang sah untuk -d/--date.
Contoh:
· mengimport tampung tradisional daripada tapak web dan mengesan nama semula:
hg import -s 80 http://example.com/bugfix.patch
· import set perubahan daripada pelayan hgweb:
hg import http://www.selenic.com/hg/rev/5ca8c111e9aa
· import semua patch dalam mbox gaya Unix:
hg import incoming-patches.mbox
· cuba memulihkan set perubahan yang dieksport dengan tepat (tidak selalu mungkin):
hg import --exact proposed-fix.patch
· gunakan alat luaran untuk menggunakan tampalan yang terlalu kabur untuk alat dalaman lalai.
hg import --config ui.patch="patch --merge" fuzzy.patch
· tukar kabur lalai daripada 2 kepada kurang ketat 7
hg import --config ui.fuzz=7 fuzz.patch
Mengembalikan 0 pada kejayaan, 1 pada kejayaan separa (lihat --separa).
Pilihan:
-p,--jalur
pilihan jalur direktori untuk tampalan. Ini mempunyai makna yang sama dengan yang sepadan
pilihan tampalan (lalai: 1)
-b,--dasar
laluan asas (TAMAT)
-e, --edit
panggil editor pada komit mesej
-f, - kekuatan
langkau semak untuk perubahan belum komited yang tertunggak (TAMAT)
--tidak-komit
jangan commit, cuma kemas kini direktori kerja
--bypass
gunakan tampalan tanpa menyentuh direktori kerja
--separa
komited walaupun beberapa hunks gagal
--tepat
gunakan tampalan pada nod dari mana ia dijana
--awalan
gunakan tampalan pada subdirektori
--cawangan import
gunakan sebarang maklumat cawangan dalam tampung (tersirat oleh --exact)
-m,--mesej
gunakan teks sebagai mesej komit
-l,--fail log
baca mesej komit daripada fail
-d,--Tarikh
rekod tarikh yang ditetapkan sebagai tarikh komit
-u,--pengguna
merekodkan pengguna yang ditentukan sebagai committer
-ya,--persamaan
teka namakan semula fail mengikut persamaan (0<=s<=100)
alias: tampalan
masuk
tunjukkan set perubahan baharu yang ditemui dalam sumber:
hg masuk [-p] [-n] [-M] [-f] [-r REV]... [--bundle FILENAME] [SUMBER]
Tunjukkan set perubahan baharu yang ditemui dalam laluan/URL yang ditentukan atau lokasi tarik lalai. Ini
ialah set perubahan yang akan ditarik jika ditarik pada masa anda mengeluarkan ini
perintah.
Lihat tarik untuk butiran format sumber yang sah.
Dengan -B/--penanda halaman, hasil perbandingan penanda halaman antara tempatan dan jauh
repositori dipaparkan. Dengan -v/--verbose, status juga dipaparkan untuk setiap penanda halaman
seperti di bawah:
BM1 01234567890a ditambah
BM2 1234567890ab lanjutan
BM3 234567890abc mencapah
BM4 34567890abcd ditukar
Tindakan yang diambil secara setempat semasa menarik bergantung pada status setiap penanda halaman:
tambah
tarik akan menciptanya
maju
pull akan mengemas kininya
menyimpang
tarik akan mencipta penanda buku yang berbeza
berubah
keputusan bergantung pada perubahan jauh
Dari sudut pandangan tingkah laku menarik, penanda halaman hanya wujud dalam alat kawalan jauh
repositori dianggap sebagai tambah, walaupun ia sebenarnya dipadamkan secara setempat.
Untuk repositori jauh, menggunakan --bundle mengelakkan memuat turun set perubahan dua kali jika fail
masuk diikuti dengan tarikan.
Contoh:
· tunjukkan perubahan masuk dengan tampung dan penerangan penuh:
hg masuk -vp
· tunjukkan perubahan masuk tidak termasuk cantuman, simpan berkas:
hg dalam -vpM --bundle incoming.hg
hg tarik masuk.hg
· senaraikan secara ringkas perubahan dalam satu berkas:
hg dalam perubahan.hg -T "{desc|firstline}\n"
Mengembalikan 0 jika terdapat perubahan masuk, 1 sebaliknya.
Pilihan:
-f, - kekuatan
dijalankan walaupun repositori jauh tidak berkaitan
-n, --terbaru-pertama
tunjukkan rekod terbaru dahulu
--berikat
fail untuk menyimpan berkas ke dalam
-r,--rev
set perubahan jauh yang bertujuan untuk ditambah
-B, --penanda buku
bandingkan penanda buku
-b,--cawangan
cawangan tertentu yang anda ingin tarik
-p, --tampalan
tunjukkan tampalan
-g, --git
gunakan format git extended diff
-l,--had
hadkan bilangan perubahan yang dipaparkan
-M, --tidak-bercantum
jangan tunjukkan cantuman
--stat keluaran ringkasan gaya diffstat bagi perubahan
-G, --graf
tunjukkan DAG semakan
--gaya
paparan menggunakan fail peta templat (DILARANG)
-T,--template
paparan dengan templat
-e,--ssh
tentukan arahan ssh untuk digunakan
--remotecmd
tentukan arahan hg untuk dijalankan pada bahagian jauh
--tidak selamat
jangan sahkan sijil pelayan (mengabaikan konfigurasi web.cacerts)
-S, --subrepos
berulang ke dalam subrepositori
[+] pilihan bertanda boleh ditentukan beberapa kali
alias: dalam
INIT
buat repositori baharu dalam direktori yang diberikan:
hg init [-e CMD] [--remotecmd CMD] [DEST]
Mulakan repositori baharu dalam direktori yang diberikan. Jika direktori yang diberikan tidak wujud,
ia akan dicipta.
Jika tiada direktori diberikan, direktori semasa digunakan.
Ia adalah mungkin untuk menentukan a ssh:// URL sebagai destinasi. Lihat hg membantu url selama lebih
maklumat.
Mengembalikan 0 pada kejayaan.
Pilihan:
-e,--ssh
tentukan arahan ssh untuk digunakan
--remotecmd
tentukan arahan hg untuk dijalankan pada bahagian jauh
--tidak selamat
jangan sahkan sijil pelayan (mengabaikan konfigurasi web.cacerts)
Cari
cari fail yang sepadan dengan corak tertentu (DIHENTIKAN):
hg cari [PILIHAN]... [PATTERN]...
Cetak fail di bawah kawalan Mercurial dalam direktori kerja yang namanya sepadan dengan yang diberikan
corak.
Secara lalai, arahan ini mencari semua direktori dalam direktori kerja. Untuk mencari sahaja
direktori semasa dan subdirektorinya, gunakan "--include .".
Jika tiada corak diberikan untuk dipadankan, arahan ini mencetak nama semua fail di bawah
Kawalan merkuri dalam direktori kerja.
Jika anda ingin menyuapkan output arahan ini ke dalam arahan "xargs", gunakan pilihan -0
kepada kedua-dua arahan ini dan "xargs". Ini akan mengelakkan masalah "xargs" merawat bujang
nama fail yang mengandungi ruang putih sebagai berbilang nama fail.
Lihat hg membantu fail untuk arahan yang lebih serba boleh.
Mengembalikan 0 jika padanan ditemui, 1 sebaliknya.
Pilihan:
-r,--rev
cari repositori seperti yang terdapat dalam REV
-0, --cetak0
tamatkan nama fail dengan NUL, untuk digunakan dengan xargs
-f, --fullpath
cetak laluan lengkap daripada akar sistem fail
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
log
tunjukkan sejarah semakan keseluruhan repositori atau fail:
log hg [PILIHAN]... [FAIL]
Cetak sejarah semakan fail yang ditentukan atau keseluruhan projek.
Jika tiada julat semakan ditentukan, lalainya ialah tip:0 melainkan --follow ditetapkan, di mana
kes induk direktori kerja digunakan sebagai semakan permulaan.
Sejarah fail ditunjukkan tanpa mengikut nama semula atau menyalin sejarah fail. Gunakan -f/--follow
dengan nama fail untuk mengikuti sejarah merentasi nama semula dan salinan. --ikut tanpa nama fail
hanya akan menunjukkan nenek moyang atau keturunan semakan permulaan.
Secara lalai arahan ini mencetak nombor semakan dan id set perubahan, teg, bukan remeh
ibu bapa, pengguna, tarikh dan masa serta ringkasan untuk setiap komitmen. Apabila suis -v/--verbose
digunakan, senarai fail yang diubah dan mesej komit penuh ditunjukkan.
Dengan --graph, semakan ditunjukkan sebagai DAG seni ASCII dengan set perubahan terkini pada
bahagian atas. 'o' ialah set perubahan, '@' ialah induk direktori yang berfungsi, 'x' adalah usang dan '+'
mewakili garpu di mana set perubahan daripada baris di bawah adalah induk kepada gabungan 'o'
baris yang sama.
Nota hg log --tampalan boleh menjana output perbezaan yang tidak dijangka untuk set perubahan gabungan, seperti yang akan berlaku
hanya bandingkan set perubahan gabungan dengan induk pertamanya. Juga, hanya fail
berbeza daripada KEDUA ibu bapa akan muncul dalam fail:.
Nota Atas sebab prestasi, hg log FAIL boleh meninggalkan perubahan pendua yang dibuat pada cawangan
dan tidak akan menunjukkan pengalihan keluar atau perubahan mod. Untuk melihat semua perubahan tersebut, gunakan
--suis dialih keluar.
Beberapa contoh:
· set perubahan dengan penerangan penuh dan senarai fail:
hg log -v
· mengubah nenek moyang ke direktori kerja:
hg log -f
· 10 komitmen terakhir pada cawangan semasa:
hg log -l 10 -b .
· set perubahan menunjukkan semua pengubahsuaian fail, termasuk pengalihan keluar:
hg log --dialih keluar fail.c
· semua set perubahan yang menyentuh direktori, dengan perbezaan, tidak termasuk cantuman:
hg log -Mp lib/
· semua nombor semakan yang sepadan dengan kata kunci:
hg log -k bug --template "{rev}\n"
· pengecam cincang penuh bagi induk direktori kerja:
hg log -r . --template "{nod}\n"
· senaraikan templat log yang tersedia:
hg log -T senarai
· semak sama ada set perubahan yang diberikan disertakan dalam keluaran berteg:
hg log -r "a21ccf dan moyang(1.9)"
· cari semua set perubahan oleh sesetengah pengguna dalam julat tarikh:
hg log -k alice -d "mei 2008 hingga jul 2008"
· ringkasan semua set perubahan selepas teg terakhir:
hg log -r "last(tagged())::" --template "{desc|firstline}\n"
Lihat hg membantu tarikh untuk senarai format yang sah untuk -d/--date.
Lihat hg membantu semakan and hg membantu set semula untuk lebih lanjut tentang menentukan dan memesan
semakan.
Lihat hg membantu template untuk mengetahui lebih lanjut tentang gaya pra-pakej dan menentukan templat tersuai.
Mengembalikan 0 pada kejayaan.
Pilihan:
-f, --ikut
ikut sejarah set perubahan, atau sejarah fail merentas salinan dan nama semula
--ikut-dahulu
hanya ikuti induk pertama set perubahan gabungan (TAMAT)
-d,--Tarikh
tunjukkan semakan padanan spesifikasi tarikh
-C, --salinan
tunjukkan fail yang disalin
-k,--kata kunci
lakukan carian tidak peka huruf besar-besaran untuk teks tertentu
-r,--rev
tunjukkan semakan atau set semula yang ditentukan
--dialih keluar
termasuk semakan di mana fail telah dialih keluar
-m, --hanya-bercantum
tunjukkan cantuman sahaja (DILARANG)
-u,--pengguna
semakan yang dilakukan oleh pengguna
--cawangan sahaja
tunjukkan hanya set perubahan dalam cawangan bernama yang diberikan (TIDAK ADA)
-b,--cawangan
tunjukkan perubahan dalam cawangan bernama yang diberikan
-P,--pangkas
tidak memaparkan semakan atau mana-mana nenek moyangnya
-p, --tampalan
tunjukkan tampalan
-g, --git
gunakan format git extended diff
-l,--had
hadkan bilangan perubahan yang dipaparkan
-M, --tidak-bercantum
jangan tunjukkan cantuman
--stat keluaran ringkasan gaya diffstat bagi perubahan
-G, --graf
tunjukkan DAG semakan
--gaya
paparan menggunakan fail peta templat (DILARANG)
-T,--template
paparan dengan templat
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
alias: sejarah
nyata
keluarkan semakan semasa atau yang diberikan bagi manifes projek:
hg manifes [-r REV]
Cetak senarai fail terkawal versi untuk semakan yang diberikan. Jika tiada semakan diberikan,
induk pertama direktori kerja digunakan, atau semakan nol jika tiada semakan
mendaftar keluar.
Dengan -v, kebenaran cetak fail, symlink dan bit boleh laku. Dengan --debug, cetak fail
cincang semakan.
Jika pilihan --semua ditentukan, senarai semua fail daripada semua semakan akan dicetak. ini
termasuk fail yang dipadam dan dinamakan semula.
Mengembalikan 0 pada kejayaan.
Pilihan:
-r,--rev
semakan untuk dipaparkan
--semua senaraikan fail daripada semua semakan
-T,--template
paparan dengan templat (EKSPERIMEN)
bergabung
gabungkan semakan lain ke dalam direktori kerja:
hg cantumkan [-P] [[-r] REV]
Direktori kerja semasa dikemas kini dengan semua perubahan yang dibuat dalam semakan yang diminta
sejak semakan pendahulu biasa yang terakhir.
Fail yang berubah antara mana-mana induk ditandakan sebagai ditukar untuk komit seterusnya dan a
commit mesti dilakukan sebelum sebarang kemas kini lanjut pada repositori dibenarkan. The
Komit seterusnya akan mempunyai dua ibu bapa.
--alat boleh digunakan untuk menentukan alat cantum yang digunakan untuk cantuman fail. Ia mengatasi
Pembolehubah persekitaran HGMERGE dan fail konfigurasi anda. Lihat hg membantu merge-tools Untuk
pilihan.
Jika tiada semakan ditentukan, induk direktori kerja ialah semakan kepala, dan
cawangan semasa mengandungi betul-betul satu kepala lain, kepala satu lagi digabungkan secara lalai.
Jika tidak, semakan eksplisit untuk digabungkan mesti disediakan.
Lihat hg membantu menyelesaikan untuk maklumat tentang pengendalian konflik fail.
Untuk membuat asal cantuman tanpa komitmen, gunakan hg maklumat --bersih . yang akan menyemak salinan bersih
induk gabungan asal, kehilangan semua perubahan.
Mengembalikan 0 pada kejayaan, 1 jika terdapat fail yang belum diselesaikan.
Pilihan:
-f, - kekuatan
paksa percantuman termasuk perubahan tertunggak (DIHENTIKAN)
-r,--rev
semakan untuk bergabung
-P, --pratonton
semak semakan untuk digabungkan (tiada gabungan dilakukan)
-t,--alat
tentukan alat gabungan
keluar
tunjukkan perubahan yang tidak ditemui di destinasi:
hg keluar [-M] [-p] [-n] [-f] [-r REV]... [DEST]
Tunjukkan set perubahan yang tidak ditemui dalam repositori destinasi yang ditentukan atau tolak lalai
lokasi. Ini ialah set perubahan yang akan ditolak jika tolakan diminta.
Lihat tarik untuk butiran format destinasi yang sah.
Dengan -B/--penanda halaman, hasil perbandingan penanda halaman antara tempatan dan jauh
repositori dipaparkan. Dengan -v/--verbose, status juga dipaparkan untuk setiap penanda halaman
seperti di bawah:
BM1 01234567890a ditambah
BM2 dipadamkan
BM3 234567890abc lanjutan
BM4 34567890abcd mencapah
BM5 4567890abcde ditukar
Tindakan yang diambil semasa menolak bergantung pada status setiap penanda halaman:
tambah
tolak dengan -B akan menciptanya
dipadamkan
tolak dengan -B akan memadamnya
maju
push akan mengemas kininya
menyimpang
tolak dengan -B akan mengemas kininya
berubah
tolak dengan -B akan mengemas kininya
Dari sudut pandangan tingkah laku menolak, penanda halaman hanya wujud dalam alat kawalan jauh
repositori dianggap sebagai dipadamkan, walaupun ia sebenarnya ditambah dari jauh.
Mengembalikan 0 jika terdapat perubahan keluar, 1 sebaliknya.
Pilihan:
-f, - kekuatan
berjalan walaupun destinasi tidak berkaitan
-r,--rev
set perubahan yang dimaksudkan untuk dimasukkan ke dalam destinasi
-n, --terbaru-pertama
tunjukkan rekod terbaru dahulu
-B, --penanda buku
bandingkan penanda buku
-b,--cawangan
cawangan tertentu yang anda ingin tolak
-p, --tampalan
tunjukkan tampalan
-g, --git
gunakan format git extended diff
-l,--had
hadkan bilangan perubahan yang dipaparkan
-M, --tidak-bercantum
jangan tunjukkan cantuman
--stat keluaran ringkasan gaya diffstat bagi perubahan
-G, --graf
tunjukkan DAG semakan
--gaya
paparan menggunakan fail peta templat (DILARANG)
-T,--template
paparan dengan templat
-e,--ssh
tentukan arahan ssh untuk digunakan
--remotecmd
tentukan arahan hg untuk dijalankan pada bahagian jauh
--tidak selamat
jangan sahkan sijil pelayan (mengabaikan konfigurasi web.cacerts)
-S, --subrepos
berulang ke dalam subrepositori
[+] pilihan bertanda boleh ditentukan beberapa kali
alias: keluar
ibu bapa
tunjukkan ibu bapa direktori kerja atau semakan (TIDAK ADA):
hg ibu bapa [-r REV] [FAIL]
Cetak semakan induk direktori kerja. Jika semakan diberikan melalui -r/--rev, the
ibu bapa semakan itu akan dicetak. Jika hujah fail diberikan, semakan dalam
fail yang terakhir diubah (sebelum semakan direktori kerja atau hujah ke
--rev jika diberi) dicetak.
Perintah ini bersamaan dengan:
hg log -r "p1()+p2()" atau
hg log -r "p1(REV)+p2(REV)" atau
hg log -r "maks(::p1() dan fail(FAIL))+maks(::p2() dan fail(FAIL))" atau
hg log -r "maks(::p1(REV) dan fail(FAIL))+maks(::p2(REV) dan fail(FAIL))"
Lihat hg ringkasan and hg membantu set semula untuk maklumat berkaitan.
Mengembalikan 0 pada kejayaan.
Pilihan:
-r,--rev
tunjukkan ibu bapa semakan yang ditentukan
--gaya
paparan menggunakan fail peta templat (DILARANG)
-T,--template
paparan dengan templat
laluan
tunjukkan alias untuk repositori jauh:
laluan hg [NAME]
Tunjukkan takrifan nama laluan simbolik NAME. Jika tiada nama diberikan, tunjukkan definisi semua
nama yang tersedia.
Pilihan -q/--quiet menyekat semua output apabila mencari NAME dan hanya menunjukkan laluan
nama apabila menyenaraikan semua definisi.
Nama laluan ditakrifkan dalam bahagian [paths] fail konfigurasi anda dan dalam
/etc/mercurial/hgrc. Jika dijalankan di dalam repositori, .hg/hgrc digunakan juga.
Nama laluan lalai and lalai-tolak mempunyai makna yang istimewa. Apabila melakukan tolakan atau
operasi tarik, ia digunakan sebagai sandaran jika tiada lokasi dinyatakan pada
baris arahan. Bila lalai-tolak ditetapkan, ia akan digunakan untuk menolak dan lalai akan digunakan
untuk tarik; sebaliknya lalai digunakan sebagai sandaran untuk kedua-duanya. Apabila mengkloning repositori,
sumber klon ditulis sebagai lalai in .hg/hgrc.
Nota lalai and lalai-tolak digunakan untuk semua masuk (cth hg masuk) dan keluar
(contohnya hg keluar, hg e-mel and hg bundle) operasi.
Lihat hg membantu url untuk maklumat lanjut.
Mengembalikan 0 pada kejayaan.
Pilihan:
-T,--template
paparan dengan templat (EKSPERIMEN)
fasa
tetapkan atau tunjukkan nama fasa semasa:
fasa hg [-p|-d|-s] [-f] [-r] [REV...]
Tanpa hujah, tunjukkan nama fasa semakan semasa.
Dengan salah satu daripada -p/--awam, -d/--draf atau -s/--rahsia, tukar nilai fasa bagi
semakan yang ditetapkan.
Melainkan -f/--force ditentukan, hg fasa tidak akan mengalihkan changeset dari fasa yang lebih rendah ke fasa
fasa yang lebih tinggi. Fasa disusun seperti berikut:
awam < draf < rahsia
Mengembalikan 0 pada kejayaan, 1 jika beberapa fasa tidak dapat diubah.
(Untuk maklumat lanjut tentang konsep fasa, lihat hg membantu fasa.)
Pilihan:
-p, --awam
tetapkan fasa set perubahan kepada awam
-d, --draf
tetapkan fasa set perubahan kepada draf
-ya, --rahsia
tetapkan fasa changeset kepada rahsia
-f, - kekuatan
membenarkan untuk memindahkan sempadan ke belakang
-r,--rev
semakan sasaran
[+] pilihan bertanda boleh ditentukan beberapa kali
tarik
tarik perubahan dari sumber yang ditentukan:
hg tarik [-u] [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [SUMBER]
Tarik perubahan dari repositori jauh kepada yang setempat.
Ini mencari semua perubahan daripada repositori di laluan atau URL yang ditentukan dan menambahkannya pada a
repositori tempatan (yang semasa melainkan -R ditentukan). Secara lalai, ini tidak
kemas kini salinan projek dalam direktori kerja.
Penggunaan hg masuk jika anda ingin melihat apa yang akan ditambah dengan tarikan pada masa anda
mengeluarkan arahan ini. Jika anda kemudian memutuskan untuk menambah perubahan tersebut pada repositori, anda harus
penggunaan hg tarik -r X di mana X ialah set perubahan terakhir yang disenaraikan oleh hg masuk.
Jika SOURCE ditinggalkan, laluan 'lalai' akan digunakan. Lihat hg membantu url selama lebih
maklumat.
Mengembalikan 0 pada kejayaan, 1 jika kemas kini mempunyai fail yang tidak dapat diselesaikan.
Pilihan:
-u, - kemas kini
kemas kini kepada ketua cawangan baharu jika perubahan telah ditarik
-f, - kekuatan
dijalankan walaupun repositori jauh tidak berkaitan
-r,--rev
set perubahan jauh yang bertujuan untuk ditambah
-B,--penanda buku
penanda buku untuk ditarik
-b,--cawangan
cawangan tertentu yang anda ingin tarik
-e,--ssh
tentukan arahan ssh untuk digunakan
--remotecmd
tentukan arahan hg untuk dijalankan pada bahagian jauh
--tidak selamat
jangan sahkan sijil pelayan (mengabaikan konfigurasi web.cacerts)
[+] pilihan bertanda boleh ditentukan beberapa kali
menolak
tolak perubahan ke destinasi yang ditentukan:
hg tolak [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [DEST]
Tolak set perubahan dari repositori tempatan ke destinasi yang ditentukan.
Operasi ini simetri untuk ditarik: ia sama dengan tarikan di destinasi
repositori daripada yang semasa.
Secara lalai, tolak tidak akan membenarkan penciptaan kepala baharu di destinasi, kerana berbilang
kepala akan menjadikannya tidak jelas kepala yang hendak digunakan. Dalam keadaan ini, adalah disyorkan untuk
tarik dan cantum sebelum menolak.
Gunakan --new-branch jika anda ingin membenarkan push untuk mencipta cawangan bernama baharu yang tidak
hadir di destinasi. Ini membolehkan anda hanya membuat cawangan baharu tanpa memaksa
perubahan lain.
Nota Penjagaan tambahan harus diambil dengan pilihan -f/--force, yang akan menolak semua yang baharu
mengetuai semua cabang, tindakan yang hampir selalu menyebabkan kekeliruan
rakan usaha sama.
Jika -r/--rev digunakan, semakan yang ditentukan dan semua nenek moyangnya akan ditolak ke
repositori jauh.
Jika -B/--penanda halaman digunakan, semakan penanda halaman yang ditentukan, nenek moyangnya dan
penanda buku akan ditolak ke repositori jauh.
Sila lihat hg membantu url untuk butiran penting tentang ssh:// URL. Jika DESTINATION ialah
ditinggalkan, laluan lalai akan digunakan.
Mengembalikan 0 jika tolak berjaya, 1 jika tiada untuk ditolak.
Pilihan:
-f, - kekuatan
tolak paksa
-r,--rev
set perubahan yang dimaksudkan untuk dimasukkan ke dalam destinasi
-B,--penanda buku
penanda buku untuk menolak
-b,--cawangan
cawangan tertentu yang anda ingin tolak
--cawangan-baru
benarkan menolak cawangan baharu
-e,--ssh
tentukan arahan ssh untuk digunakan
--remotecmd
tentukan arahan hg untuk dijalankan pada bahagian jauh
--tidak selamat
jangan sahkan sijil pelayan (mengabaikan konfigurasi web.cacerts)
[+] pilihan bertanda boleh ditentukan beberapa kali
pulih
gulung semula transaksi yang terganggu:
hg pulih
Pulih daripada komit atau tarik yang terganggu.
Perintah ini cuba membetulkan status repositori selepas operasi yang terganggu. Sepatutnya
hanya perlu apabila Mercurial mencadangkannya.
Mengembalikan 0 jika berjaya, 1 jika tiada apa-apa untuk memulihkan atau mengesahkan gagal.
mengeluarkan
alih keluar fail yang ditentukan pada komit seterusnya:
hg alih keluar [PILIHAN]... FAIL...
Jadualkan fail yang ditunjukkan untuk dialih keluar dari cawangan semasa.
Perintah ini menjadualkan fail untuk dialih keluar pada komit seterusnya. Untuk membuat asal pengalihan keluar
sebelum itu, lihat hg kembali. Untuk membuat asal fail yang ditambahkan, lihat hg lupa.
-A/--selepas boleh digunakan untuk mengalih keluar hanya fail yang telah dipadamkan, -f/--force boleh
digunakan untuk memaksa pemadaman, dan -Af boleh digunakan untuk mengalih keluar fail daripada semakan seterusnya
tanpa memadamnya daripada direktori kerja.
Jadual berikut memperincikan tingkah laku alih keluar untuk keadaan fail yang berbeza (lajur) dan
kombinasi pilihan (baris). Keadaan fail ialah Ditambah [A], Bersihkan [C], Diubahsuai [M] dan
Tiada [!] (seperti yang dilaporkan oleh hg terkini). Tindakan tersebut ialah Amaran, Buang (dari cawangan) dan
Padam (dari cakera):
┌──────────┬───┬────┬────┬───┐
│pilih/nyatakan │ A │ C │ M │ ! │
├──────────┼───┼────┼────┼───┤
│tiada │ W │ RD │ W │ R │
├──────────┼───┼────┼────┼───┤
│-f │ R │ RD │ RD │ R │
├──────────┼───┼────┼────┼───┤
│-A │ W │ W │ W │ R │
├──────────┼───┼────┼────┼───┤
│-Af │ R │ R │ R │ R │
└──────────┴───┴────┴────┴───┘
Nota hg mengeluarkan tidak sekali-kali memadam fail dalam keadaan Ditambah [A] daripada direktori kerja, bukan
walaupun - kekuatan dinyatakan.
Mengembalikan 0 pada kejayaan, 1 jika sebarang amaran ditemui.
Pilihan:
-A, --selepas
rekod padam untuk fail yang hilang
-f, - kekuatan
alih keluar (dan padam) fail walaupun ditambah atau diubah suai
-S, --subrepos
berulang ke dalam subrepositori
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
alias: rm
menamakan semula
menamakan semula fail; bersamaan dengan salinan + keluarkan:
hg menamakan semula [PILIHAN]... SUMBER... DEST
Tandakan dest sebagai salinan sumber; tandakan sumber untuk pemadaman. Jika dest ialah direktori, salin
dimasukkan ke dalam direktori itu. Jika dest ialah fail, hanya boleh ada satu sumber.
Secara lalai, arahan ini menyalin kandungan fail kerana ia wujud dalam kerja
direktori. Jika dipanggil dengan -A/--selepas, operasi direkodkan, tetapi tiada penyalinan
dilakukan.
Perintah ini berkuat kuasa pada komit seterusnya. Untuk membuat asal nama semula sebelum itu, lihat hg kembali.
Mengembalikan 0 pada kejayaan, 1 jika ralat ditemui.
Pilihan:
-A, --selepas
merekodkan nama semula yang telah berlaku
-f, - kekuatan
menyalin secara paksa fail terurus sedia ada
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-n, --lari kering
jangan lakukan tindakan, hanya cetak output
[+] pilihan bertanda boleh ditentukan beberapa kali
alias: alihkan mv
menyelesaikan
buat semula cantuman atau tetapkan/lihat status cantuman fail:
hg selesaikan [PILIHAN]... [FAIL]...
Gabungan dengan konflik yang tidak dapat diselesaikan selalunya adalah hasil penggabungan tidak interaktif menggunakan
dalaman:cantum tetapan konfigurasi, atau alat gabungan baris arahan seperti perbezaan3. Azam
arahan digunakan untuk menguruskan fail yang terlibat dalam gabungan, selepas hg bergabung telah dijalankan, dan
sebelum hg melakukan dijalankan (iaitu direktori kerja mesti mempunyai dua ibu bapa). Lihat hg membantu
merge-tools untuk maklumat tentang mengkonfigurasi alat gabungan.
Perintah resolve boleh digunakan dengan cara berikut:
· hg menyelesaikan [--alat ALATAN] FAIL...: cuba untuk menggabungkan semula fail yang ditentukan, membuang
sebarang percubaan gabungan sebelumnya. Penggabungan semula tidak dilakukan untuk fail yang telah ditanda sebagai
diselesaikan. guna --semua/-a untuk memilih semua fail yang belum diselesaikan. --alat boleh digunakan untuk menentukan
alat gabungan yang digunakan untuk fail yang diberikan. Ia mengatasi pembolehubah persekitaran HGMERGE dan
fail konfigurasi anda. Kandungan fail sebelumnya disimpan dengan a .orig akhiran.
· hg menyelesaikan -m [FAIL]: tandakan fail sebagai telah diselesaikan (cth. selepas selesai secara manual
membetulkan fail). Lalai adalah untuk menandakan semua fail yang belum diselesaikan.
· hg menyelesaikan -u [FAIL]...: tandakan fail sebagai tidak diselesaikan. Lalai adalah untuk menandakan semua diselesaikan
fail.
· hg menyelesaikan -l: senaraikan fail yang mempunyai atau masih mempunyai konflik. Dalam senarai yang dicetak, U =
tidak dapat diselesaikan dan R = diselesaikan.
Nota Mercurial tidak akan membenarkan anda melakukan fail dengan konflik gabungan yang tidak dapat diselesaikan. Kamu mesti
penggunaan hg menyelesaikan -m ... sebelum anda boleh membuat komitmen selepas gabungan yang bercanggah.
Mengembalikan 0 pada kejayaan, 1 jika mana-mana fail gagal percubaan menyelesaikan.
Pilihan:
-A, --semua
pilih semua fail yang belum diselesaikan
-l, --senarai
senaraikan keadaan fail yang memerlukan gabungan
-m, --tanda
tandakan fail sebagai diselesaikan
-u, --nyahtanda
tandakan fail sebagai tidak diselesaikan
-n, --tiada status
sembunyikan awalan status
-t,--alat
tentukan alat gabungan
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-T,--template
paparan dengan templat (EKSPERIMEN)
[+] pilihan bertanda boleh ditentukan beberapa kali
kembali
memulihkan fail kepada keadaan pembayaran mereka:
hg kembalikan [PILIHAN]... [-r REV] [NAMA]...
Nota Untuk menyemak semakan awal, anda harus menggunakan hg maklumat REV. Untuk membatalkan a
gabungan tanpa komitmen (dan kehilangan perubahan anda), gunakan hg maklumat --bersih ..
Tanpa semakan yang ditentukan, kembalikan fail atau direktori yang ditentukan kepada kandungannya
ada dalam induk direktori kerja. Ini memulihkan kandungan fail ke an
keadaan tidak diubah suai dan tidak berjadual menambah, mengalih keluar, menyalin dan menamakan semula. Jika bekerja
direktori mempunyai dua ibu bapa, anda mesti menyatakan semakan secara eksplisit.
Menggunakan pilihan -r/--rev atau -d/--date, kembalikan fail atau direktori yang diberikan kepada
menyatakan pada semakan tertentu. Kerana revert tidak mengubah direktori kerja
ibu bapa, ini akan menyebabkan fail ini kelihatan diubah suai. Ini boleh membantu untuk "undur"
sebahagian atau semua perubahan terdahulu. Lihat hg berundur untuk kaedah yang berkaitan.
Fail yang diubah suai disimpan dengan akhiran .orig sebelum berbalik. Untuk melumpuhkan sandaran ini,
gunakan --no-backup.
Lihat hg membantu tarikh untuk senarai format yang sah untuk -d/--date.
Lihat hg membantu berundur untuk cara membalikkan kesan set perubahan yang lebih awal.
Mengembalikan 0 pada kejayaan.
Pilihan:
-A, --semua
kembalikan semua perubahan apabila tiada hujah diberikan
-d,--Tarikh
tarikh padanan semakan paling tip
-r,--rev
kembali kepada semakan yang ditetapkan
-C, --tiada-sandaran
jangan simpan salinan sandaran fail
-saya, --interaktif
pilih perubahan secara interaktif (EKSPERIMEN)
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-n, --lari kering
jangan lakukan tindakan, hanya cetak output
[+] pilihan bertanda boleh ditentukan beberapa kali
melakukan pengembalian
gulung balik urus niaga terakhir (BERBAHAYA) (TIDAK AMAI):
hg rollback
Sila guna hg melakukan - amend bukannya rollback untuk membetulkan kesilapan dalam komit terakhir.
Perintah ini harus digunakan dengan berhati-hati. Terdapat hanya satu tahap rollback, dan ada
tiada cara untuk membuat asal rollback. Ia juga akan memulihkan dirstate pada masa yang terakhir
transaksi, kehilangan sebarang perubahan dirstate sejak masa itu. Perintah ini tidak mengubah
direktori kerja.
Transaksi digunakan untuk merangkum kesan semua arahan yang mencipta baharu
set perubahan atau menyebarkan set perubahan sedia ada ke dalam repositori.
Sebagai contoh, arahan berikut adalah transaksional, dan kesannya boleh dilancarkan
belakang:
· komited
· import
· tarik
· tolak (dengan repositori ini sebagai destinasi)
· buka ikatan
Untuk mengelakkan kehilangan data yang kekal, rollback akan menolak untuk membatalkan transaksi komit jika ia
tidak didaftar keluar. Gunakan --force untuk mengatasi perlindungan ini.
Perintah ini tidak bertujuan untuk digunakan pada repositori awam. Sebaik sahaja perubahan kelihatan untuk
ditarik oleh pengguna lain, melancarkan semula transaksi secara setempat adalah tidak berkesan (orang lain mungkin
sudah menarik perubahan). Tambahan pula, perlumbaan boleh dilakukan dengan pembaca
repositori; contohnya tarikan dalam proses dari repositori mungkin gagal jika rollback berlaku
dilakukan.
Mengembalikan 0 pada kejayaan, 1 jika tiada data rollback tersedia.
Pilihan:
-n, --lari kering
jangan lakukan tindakan, hanya cetak output
-f, - kekuatan
mengabaikan langkah keselamatan
akar
cetak akar (atas) direktori kerja semasa:
hg akar
Cetak direktori akar repositori semasa.
Mengembalikan 0 pada kejayaan.
berkhidmat
mulakan pelayan web yang berdiri sendiri:
hg berkhidmat [PILIHAN]...
Mulakan pelayar repositori HTTP tempatan dan tarik pelayan. Anda boleh menggunakan ini untuk perkongsian ad-hoc
dan menyemak imbas repositori. Adalah disyorkan untuk menggunakan pelayan web sebenar untuk melayani a
repositori untuk jangka masa yang lebih lama.
Sila ambil perhatian bahawa pelayan tidak melaksanakan kawalan akses. Ini bermakna bahawa, oleh
lalai, sesiapa sahaja boleh membaca dari pelayan dan tiada siapa boleh menulis kepadanya secara lalai. Menetapkan
web.allow_push pilihan untuk * untuk membolehkan semua orang menolak ke pelayan. Anda harus menggunakan yang sebenar
pelayan web jika anda perlu mengesahkan pengguna.
Secara lalai, log pelayan mengakses stdout dan ralat ke stderr. Menggunakan
-A/--accesslog dan -E/--errorlog pilihan untuk log ke fail.
Untuk meminta pelayan memilih nombor port percuma untuk mendengar, nyatakan nombor port 0; dalam
kes ini, pelayan akan mencetak nombor port yang digunakannya.
Mengembalikan 0 pada kejayaan.
Pilihan:
-A,--accesslog
nama fail log akses untuk menulis
-d, --daemon
jalankan pelayan di latar belakang
--daemon-pipefds
digunakan secara dalaman oleh mod daemon
-E,--errorlog
nama fail log ralat untuk ditulis
-p,--pelabuhan
port untuk mendengar (lalai: 8000)
-A,--alamat
alamat untuk mendengar (lalai: semua antara muka)
--awalan
laluan awalan untuk berkhidmat daripada (lalai: akar pelayan)
-n,--nama
nama untuk ditunjukkan dalam halaman web (lalai: direktori kerja)
--web-conf
nama fail konfigurasi hgweb (lihat "hg help hgweb")
--webdir-conf
nama fail konfigurasi hgweb (DILARANG)
--pid-file
nama fail untuk menulis ID proses
--stdio
untuk pelanggan jauh
--cmdserver
untuk pelanggan jauh
-t,--templat
templat web untuk digunakan
--gaya
gaya templat untuk digunakan
-6, --ipv6
gunakan IPv6 sebagai tambahan kepada IPv4
--sijil
Fail sijil SSL
terkini
tunjukkan fail yang diubah dalam direktori kerja:
status hg [PILIHAN]... [FAIL]...
Tunjukkan status fail dalam repositori. Jika nama diberikan, hanya fail yang sepadan sahaja
ditunjukkan. Fail yang bersih atau diabaikan atau sumber operasi salinan/pindah, tidak
disenaraikan melainkan -c/--bersih, -i/--diabaikan, -C/--salinan atau -A/--semua diberikan. Melainkan pilihan
diterangkan dengan "tunjukkan sahaja ..." diberikan, pilihan -mardu digunakan.
Option -q/--quiet menyembunyikan fail yang tidak dikesan (tidak diketahui dan diabaikan) melainkan diminta secara eksplisit
dengan -u/--tidak diketahui atau -i/--diabaikan.
Nota hg terkini mungkin kelihatan tidak bersetuju dengan perbezaan jika kebenaran telah berubah atau gabungan
telah berlaku. Format perbezaan standard tidak melaporkan perubahan dan perbezaan kebenaran
hanya melaporkan perubahan relatif kepada satu induk gabungan.
Jika satu semakan diberikan, ia digunakan sebagai semakan asas. Jika dua semakan diberikan,
perbezaan antara mereka ditunjukkan. Pilihan --change juga boleh digunakan sebagai jalan pintas
untuk menyenaraikan fail yang diubah bagi semakan daripada induk pertamanya.
Kod yang digunakan untuk menunjukkan status fail ialah:
M = diubah suai
A = ditambah
R = dikeluarkan
C = bersih
! = hilang (dipadamkan oleh arahan bukan hg, tetapi masih dijejaki)
? = tidak dijejaki
Saya = tidak diendahkan
= asal fail sebelumnya (dengan --copy)
Contoh:
· tunjukkan perubahan dalam direktori kerja berbanding set perubahan:
status hg --rev 9353
· tunjukkan perubahan dalam direktori kerja berbanding dengan direktori semasa (lihat hg membantu
corak untuk maklumat lanjut):
status hg semula:
· tunjukkan semua perubahan termasuk salinan dalam set perubahan sedia ada:
status hg --salinan --ubah 9353
· dapatkan senarai fail tambahan yang dipisahkan NUL, sesuai untuk xargs:
status hg -an0
Mengembalikan 0 pada kejayaan.
Pilihan:
-A, --semua
tunjukkan status semua fail
-m, --diubah suai
tunjukkan hanya fail yang diubah suai
-A, --tambah
tunjukkan hanya fail yang ditambah
-r, --dialih keluar
tunjukkan hanya fail yang dialih keluar
-d, --dipadamkan
tunjukkan hanya fail yang dipadam (tetapi dijejaki).
-c, --bersih
tunjukkan fail sahaja tanpa perubahan
-u, --tidak diketahui
tunjukkan hanya fail yang tidak diketahui (tidak dijejaki).
-saya, --diabaikan
tunjukkan hanya fail yang diabaikan
-n, --tiada status
sembunyikan awalan status
-C, --salinan
tunjukkan sumber fail yang disalin
-0, --cetak0
tamatkan nama fail dengan NUL, untuk digunakan dengan xargs
--rev
menunjukkan perbezaan daripada semakan
--ubah
senaraikan fail yang diubah bagi semakan
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-S, --subrepos
berulang ke dalam subrepositori
-T,--template
paparan dengan templat (EKSPERIMEN)
[+] pilihan bertanda boleh ditentukan beberapa kali
alias: st
ringkasan
meringkaskan keadaan direktori kerja:
ringkasan hg [--remote]
Ini menjana ringkasan ringkas keadaan direktori kerja, termasuk ibu bapa, cawangan,
komit status, fasa dan kemas kini yang tersedia.
Dengan pilihan --remote, ini akan menyemak laluan lalai untuk masuk dan keluar
perubahan. Ini boleh memakan masa.
Mengembalikan 0 pada kejayaan.
Pilihan:
--jauh
semak tolak dan tarik
alias: jumlah
tag
tambah satu atau lebih teg untuk semakan semasa atau yang diberikan:
teg hg [-f] [-l] [-m TEKS] [-d TARIKH] [-u PENGGUNA] [-r REV] NAMA...
Namakan semakan tertentu menggunakan .
Tag digunakan untuk menamakan semakan tertentu repositori dan sangat berguna untuk
bandingkan semakan yang berbeza, untuk kembali ke versi terdahulu yang penting atau untuk menandakan cawangan
mata sebagai keluaran, dsb. Menukar teg sedia ada biasanya tidak dibenarkan; gunakan -f/--force
untuk mengatasi.
Jika tiada semakan diberikan, induk direktori kerja digunakan.
Untuk memudahkan kawalan versi, pengedaran dan penggabungan teg, ia disimpan sebagai a
fail bernama ".hgtags" yang diuruskan sama seperti fail projek lain dan boleh
disunting dengan tangan jika perlu. Ini juga bermakna penandaan mencipta komitmen baharu. Fail
".hg/localtags" digunakan untuk teg tempatan (tidak dikongsi antara repositori).
Komit teg biasanya dibuat di kepala cawangan. Jika ibu bapa yang bekerja
direktori bukan ketua cawangan, hg tag menggugurkan kandungan; gunakan -f/--force untuk memaksa tag commit to
berdasarkan set perubahan bukan kepala.
Lihat hg membantu tarikh untuk senarai format yang sah untuk -d/--date.
Memandangkan nama teg mempunyai keutamaan berbanding nama cawangan semasa carian semakan, menggunakan nama sedia ada
nama cawangan sebagai nama tag adalah tidak digalakkan.
Mengembalikan 0 pada kejayaan.
Pilihan:
-f, - kekuatan
tag paksa
-l, --tempatan
jadikan tag setempat
-r,--rev
semakan kepada tag
--buang
keluarkan tag
-e, --edit
panggil editor pada komit mesej
-m,--mesej
gunakan teks sebagai mesej komit
-d,--Tarikh
rekod tarikh yang ditetapkan sebagai tarikh komit
-u,--pengguna
merekodkan pengguna yang ditentukan sebagai committer
tags
senaraikan teg repositori:
tag hg
Ini menyenaraikan kedua-dua teg biasa dan tempatan. Apabila suis -v/--verbose digunakan, satu pertiga
lajur "tempatan" dicetak untuk teg tempatan. Apabila suis -q/--quiet digunakan, hanya suis
nama tag dicetak.
Mengembalikan 0 pada kejayaan.
Pilihan:
-T,--template
paparan dengan templat (EKSPERIMEN)
hujung
tunjukkan semakan petua (DILAMATKAN):
petua hg [-p] [-g]
Semakan tip (biasanya hanya dipanggil tip) ialah set perubahan yang paling baru ditambahkan pada
repositori (dan oleh itu kepala yang paling baru ditukar).
Jika anda baru sahaja membuat komitmen, komitmen itu akan menjadi petua. Kalau baru tarik
berubah daripada repositori lain, hujung repositori itu menjadi petua semasa. The
Teg "tip" adalah istimewa dan tidak boleh dinamakan semula atau diberikan kepada set perubahan yang berbeza.
Perintah ini ditamatkan, sila gunakan hg kepala sebaliknya.
Mengembalikan 0 pada kejayaan.
Pilihan:
-p, --tampalan
tunjukkan tampalan
-g, --git
gunakan format git extended diff
--gaya
paparan menggunakan fail peta templat (DILARANG)
-T,--template
paparan dengan templat
unbundle
gunakan satu atau lebih fail kumpulan perubahan:
hg nyahhimpun [-u] FAIL...
Gunakan satu atau lebih fail kumpulan perubahan termampat yang dijana oleh arahan himpunan.
Mengembalikan 0 pada kejayaan, 1 jika kemas kini mempunyai fail yang belum diselesaikan.
Pilihan:
-u, - kemas kini
kemas kini kepada ketua cawangan baharu jika set perubahan telah dinyahhimpun
maklumat
kemas kini direktori kerja (atau tukar semakan):
kemas kini hg [-c] [-C] [-d TARIKH] [[-r] REV]
Kemas kini direktori kerja repositori kepada set perubahan yang ditentukan. Jika tiada changeset adalah
ditentukan, kemas kini ke hujung cawangan bernama semasa dan gerakkan penanda halaman aktif (lihat
hg membantu penanda buku).
Kemas kini menetapkan semakan induk direktori kerja kepada set perubahan yang ditentukan (lihat hg
membantu ibu bapa).
Jika set perubahan bukan keturunan atau nenek moyang induk direktori kerja, the
kemas kini dibatalkan. Dengan pilihan -c/--check, direktori kerja disemak
perubahan tanpa komitmen; jika tiada yang ditemui, direktori kerja dikemas kini kepada yang ditentukan
set perubahan.
Peraturan berikut digunakan apabila direktori kerja mengandungi perubahan tanpa komitmen:
1. Jika -c/--check mahupun -C/--clean tidak dinyatakan, dan jika set perubahan yang diminta ialah
nenek moyang atau keturunan induk direktori kerja, perubahan tanpa komitmen adalah
digabungkan ke dalam set perubahan yang diminta dan hasil gabungan dibiarkan tanpa komitmen. Sekiranya
set perubahan yang diminta bukan nenek moyang atau keturunan (iaitu, ia adalah pada yang lain
cawangan), kemas kini dibatalkan dan perubahan yang tidak dikomitkan disimpan.
2. Dengan pilihan -c/--check, kemas kini dibatalkan dan perubahan yang tidak dikomit adalah
terpelihara.
3. Dengan pilihan -C/--clean, perubahan tanpa komitmen akan dibuang dan direktori kerja
dikemas kini kepada set perubahan yang diminta.
Untuk membatalkan gabungan tanpa komitmen (dan kehilangan perubahan anda), gunakan hg maklumat --bersih ..
Gunakan null sebagai set perubahan untuk mengalih keluar direktori kerja (seperti hg mengklon -U).
Jika anda ingin mengembalikan hanya satu fail kepada semakan yang lebih lama, gunakan hg kembali [-r REV] NAMA.
Lihat hg membantu tarikh untuk senarai format yang sah untuk -d/--date.
Mengembalikan 0 pada kejayaan, 1 jika terdapat fail yang belum diselesaikan.
Pilihan:
-C, --bersih
buang perubahan tanpa komitmen (tiada sandaran)
-c, --semak
kemas kini merentas cawangan jika tiada perubahan tanpa komitmen
-d,--Tarikh
tarikh padanan semakan paling tip
-r,--rev
semakan
-t,--alat
tentukan alat gabungan
alias: up checkout co
mengesahkan
sahkan integriti repositori:
hg mengesahkan
Sahkan integriti repositori semasa.
Ini akan melakukan pemeriksaan menyeluruh terhadap integriti repositori, mengesahkan cincangan
dan jumlah semak setiap entri dalam log perubahan, manifes dan fail yang dijejaki, serta fail
integriti pautan silang dan indeks mereka.
Sila lihat https://mercurial-scm.org/wiki/RepositoryCorruption untuk mendapatkan maklumat lanjut tentang
pemulihan daripada rasuah repositori.
Mengembalikan 0 pada kejayaan, 1 jika ralat ditemui.
versi
versi keluaran dan maklumat hak cipta:
versi hg
versi keluaran dan maklumat hak cipta
TARIKH FORMATS
Sesetengah arahan membenarkan pengguna untuk menentukan tarikh, cth:
· backout, commit, import, tag: Nyatakan tarikh commit.
· log, kembalikan, kemas kini: Pilih semakan mengikut tarikh.
Banyak format tarikh yang sah. Berikut adalah beberapa contoh:
· Rab disember 6 13:18:29 2006 (zon waktu tempatan diandaikan)
· disember 6 13:18 -0600 (tahun diandaikan, masa mengimbangi disediakan)
· disember 6 13:18 UTC (UTC dan GMT ialah alias untuk +0000)
· disember 6 (tengah malam)
· 13:18 (hari ini diandaikan)
· 3:39 (3:39AM diandaikan)
· 3: 39pm (15: 39)
· 2006-12-06 13:18:29 (format ISO 8601)
· 2006-12-6 13:18
· 2006-12-6
· 12-6
· 12/6
· 12/6/6 (6 Dis 2006)
· hari ini (tengah malam)
· semalam (tengah malam)
· kini - sekarang
Akhir sekali, terdapat format dalaman Mercurial:
· 1165411109 0 (Rabu 6 Dis 13:18:29 2006 UTC)
Ini ialah format perwakilan dalaman untuk tarikh. Nombor pertama ialah bilangan
saat sejak zaman itu (1970-01-01 00:00 UTC). Yang kedua ialah mengimbangi tempatan
zon waktu, dalam saat barat UTC (negatif jika zon waktu adalah timur UTC).
Perintah log juga menerima julat tarikh:
· <DATE - pada atau sebelum tarikh/masa tertentu
· >TARIKH - pada atau selepas tarikh/masa tertentu
· TARIKH kepada TARIKH - julat tarikh, termasuk
· -HARI - dalam beberapa hari tertentu hari ini
BERBEZA FORMATS
Format lalai Mercurial untuk menunjukkan perubahan antara dua versi fail ialah
serasi dengan format bersatu GNU diff, yang boleh digunakan oleh patch GNU dan banyak lagi
alat standard yang lain.
Walaupun format standard ini selalunya cukup, ia tidak mengekod maklumat berikut:
· status boleh laku dan bit kebenaran lain
· menyalin atau menamakan semula maklumat
· perubahan dalam fail binari
· penciptaan atau pemadaman fail kosong
Mercurial juga menyokong format diff lanjutan dari git VCS yang menangani ini
batasan. Format git diff tidak dihasilkan secara lalai kerana beberapa alat yang meluas
masih tidak faham format ini.
Ini bermakna apabila menjana perbezaan daripada repositori Mercurial (cth dengan hg mengeksport),
anda harus berhati-hati tentang perkara seperti salinan fail dan nama semula atau perkara lain yang disebut
di atas, kerana apabila menggunakan perbezaan standard pada repositori yang berbeza, tambahan ini
maklumat hilang. Operasi dalaman Mercurial (seperti tolak dan tarik) tidak terjejas
oleh ini, kerana mereka menggunakan format binari dalaman untuk menyampaikan perubahan.
Untuk membuat Mercurial menghasilkan format git extended diff, gunakan pilihan --git yang tersedia untuk
banyak arahan, atau tetapkan 'git = True' dalam bahagian [diff] fail konfigurasi anda. awak
tidak perlu menetapkan pilihan ini apabila mengimport perbezaan dalam format ini atau menggunakannya dalam mq
sambungan.
PERSEKITARAN PELBAGAI
HG Laluan ke 'hg' boleh laku, diluluskan secara automatik apabila menjalankan cangkuk, sambungan atau
alat luaran. Jika tidak ditetapkan atau kosong, ini ialah nama hg boleh laku jika ia dibekukan,
atau boleh laksana bernama 'hg' (dengan %PATHEXT% [lalai kepada COM/EXE/BAT/CMD]
sambungan pada Windows) dicari.
HGEDITOR
Ini adalah nama editor untuk dijalankan apabila melakukan. Lihat EDITOR.
(tidak digunakan lagi, gunakan fail konfigurasi)
HGENCODING
Ini mengatasi tetapan tempat lalai yang dikesan oleh Mercurial. Tetapan ini ialah
digunakan untuk menukar data termasuk nama pengguna, perihalan set perubahan, nama teg dan
cawangan. Tetapan ini boleh diganti dengan pilihan baris arahan --encoding.
HGENCODINGMODE
Ini menetapkan tingkah laku Mercurial untuk mengendalikan aksara yang tidak diketahui semasa transcoding
input pengguna. Lalai ialah "ketat", yang menyebabkan Mercurial menggugurkan jika tidak boleh
memetakan watak. Tetapan lain termasuk "ganti", yang menggantikan yang tidak diketahui
aksara, dan "abaikan", yang menjatuhkannya. Tetapan ini boleh ditindih dengan
--encodingmode pilihan baris arahan.
HGENCODINGAMBIGUOUS
Ini menetapkan tingkah laku Mercurial untuk mengendalikan aksara dengan lebar "samar-samar" seperti
aksara Latin beraksen dengan fon Asia Timur. Secara lalai, Mercurial menganggap
aksara samar-samar adalah sempit, tetapkan pembolehubah ini kepada "lebar" jika aksara sedemikian
menyebabkan masalah pemformatan.
HGMERGE
Boleh laku untuk digunakan untuk menyelesaikan konflik gabungan. Program akan dilaksanakan
dengan tiga argumen: fail tempatan, fail jauh, fail nenek moyang.
(tidak digunakan lagi, gunakan fail konfigurasi)
HGRCPATH
Senarai fail atau direktori untuk mencari fail konfigurasi. Pemisah item ialah
":" pada Unix, ";" pada Windows. Jika HGRRCPATH tidak ditetapkan, laluan carian lalai platform
digunakan. Jika kosong, hanya .hg/hgrc daripada repositori semasa dibaca.
Untuk setiap elemen dalam HGRCPATH:
· jika ia adalah direktori, semua fail yang berakhir dengan .rc ditambah
· jika tidak, fail itu sendiri akan ditambah
HGPLAIN
Apabila ditetapkan, ini melumpuhkan sebarang tetapan konfigurasi yang mungkin menukar Mercurial
keluaran lalai. Ini termasuk pengekodan, lalai, mod verbose, mod nyahpepijat, senyap
mod, jejak balik dan penyetempatan. Ini boleh berguna apabila skrip menentang
Mercurial dalam menghadapi konfigurasi pengguna sedia ada.
Pilihan setara yang ditetapkan melalui bendera baris arahan atau pembolehubah persekitaran tidak
ditindih.
HGPLAINEXCEPT
Ini ialah senarai ciri yang dipisahkan koma untuk dikekalkan apabila HGPLAIN didayakan.
Pada masa ini nilai berikut disokong:
alias
Jangan alih keluar alias.
i18n
Kekalkan pengantarabangsaan.
revsetalias
Jangan alih keluar alias revset.
Menetapkan HGPLAINEXCEPT kepada apa-apa sahaja (walaupun rentetan kosong) akan mendayakan mod biasa.
HGUSER Ini ialah rentetan yang digunakan sebagai pengarang komit. Jika tidak ditetapkan, nilai yang tersedia
akan dipertimbangkan dalam susunan ini:
· HGUSER (ditamatkan)
· fail konfigurasi daripada HGRRCPATH
· gesaan interaktif
· LOGNAME (dengan @nama hos dilampirkan)
(tidak digunakan lagi, gunakan fail konfigurasi)
EMAIL Boleh digunakan sebagai pengarang komit; lihat HGUSER.
LOGNAME
Boleh digunakan sebagai pengarang komit; lihat HGUSER.
VISUAL Ini adalah nama editor untuk digunakan semasa melakukan. Lihat EDITOR.
EDITOR Kadangkala Mercurial perlu membuka fail teks dalam editor untuk pengguna mengubah suai,
contohnya semasa menulis mesej komit. Editor yang digunakannya ditentukan oleh
melihat pembolehubah persekitaran HGEDITOR, VISUAL dan EDITOR, dalam susunan itu.
Yang pertama bukan kosong dipilih. Jika kesemuanya kosong, editor lalai kepada
'penyunting yang bijak'.
PYTHONPATH
Ini digunakan oleh Python untuk mencari modul yang diimport dan mungkin perlu ditetapkan
sewajarnya jika Mercurial ini tidak dipasang di seluruh sistem.
MENGGUNAKAN TAMBAHAN CIRI-CIRI
Mercurial mempunyai keupayaan untuk menambah ciri baharu melalui penggunaan sambungan. Sambungan
boleh menambah arahan baharu, menambah pilihan pada arahan sedia ada, menukar tingkah laku lalai bagi
arahan, atau melaksanakan cangkuk.
Untuk mendayakan sambungan "foo", sama ada dihantar dengan Mercurial atau dalam laluan carian Python,
buat entri untuknya dalam fail konfigurasi anda, seperti ini:
[sambungan]
foo =
Anda juga boleh menentukan laluan penuh ke sambungan:
[sambungan]
myfeature = ~/.hgext/myfeature.py
Lihat hg membantu config untuk maklumat lanjut tentang fail konfigurasi.
Sambungan tidak dimuatkan secara lalai atas pelbagai sebab: ia boleh meningkatkan permulaan
atas kepala; ia mungkin dimaksudkan untuk penggunaan lanjutan sahaja; mereka mungkin menyediakan secara berpotensi
kebolehan berbahaya (seperti membiarkan anda memusnahkan atau mengubah suai sejarah); mereka mungkin tidak
bersedia untuk masa perdana; atau mereka mungkin mengubah beberapa tingkah laku biasa saham Mercurial. Ia adalah
oleh itu terpulang kepada pengguna untuk mengaktifkan sambungan mengikut keperluan.
Untuk melumpuhkan sambungan yang didayakan secara eksplisit dalam fail konfigurasi skop yang lebih luas,
sediakan laluannya dengan !:
[sambungan]
# melumpuhkan bar sambungan yang berada di /path/to/extension/bar.py
bar = !/path/to/extension/bar.py
# begitu juga, tetapi tiada laluan dibekalkan untuk sambungan baz
baz = !
sambungan dilumpuhkan:
acl cangkuk untuk mengawal akses repositori
kotak hitam
log peristiwa repositori ke kotak hitam untuk nyahpepijat
bugzilla
cangkuk untuk menyepadukan dengan penjejak pepijat Bugzilla
menapis memadam kandungan fail pada semakan yang diberikan
berpura-pura arahan untuk memaparkan statistik tentang sejarah repositori
klonebundle
mengiklankan berkas pra-jana kepada klon benih
warna mewarnakan output daripada beberapa arahan
menukar
import semakan daripada repositori VCS asing ke dalam Mercurial
eol mengurus baris baharu secara automatik dalam fail repositori
extdiff
arahan untuk membenarkan program luaran membandingkan semakan
factotum
pengesahan http dengan factotum
gpg arahan untuk menandatangani dan mengesahkan perubahan
hgcia cangkuk untuk menyepadukan dengan perkhidmatan pemberitahuan CIA.vc
hgk semak imbas repositori dalam cara grafik
menyerlahkan
penonjolan sintaks untuk hgweb (memerlukan Pygments)
histedit
penyuntingan sejarah interaktif
kata kunci
mengembangkan kata kunci dalam fail yang dijejaki
fail besar
menjejaki fail binari yang besar
mq menguruskan timbunan tampalan
memberitahu cangkuk untuk menghantar pemberitahuan tolak e-mel
pager semak imbas output arahan dengan alat kelui luaran
patchbomb
arahan untuk menghantar set perubahan sebagai (siri) e-mel tampalan
membersihkan arahan untuk memadam fail yang tidak dijejaki daripada direktori kerja
melunaskan semula perintah untuk memindahkan set semakan kepada nenek moyang yang berbeza
rekod arahan untuk memilih perubahan secara interaktif untuk komit/qrefresh
paut semula mencipta semula pautan keras antara klon repositori
skim
meluaskan skim dengan pintasan ke kumpulan repositori
saham berkongsi sejarah yang sama antara beberapa direktori kerja
rak simpan dan pulihkan perubahan pada direktori kerja
jalur strip changeset dan keturunan mereka daripada sejarah
pemindahan
perintah untuk memindahkan perubahan dari cawangan lain
menang32mbcs
membenarkan penggunaan laluan MBCS dengan pengekodan bermasalah
zeroconf
menemui dan mengiklankan repositori pada rangkaian tempatan
MENYERTAI FAIL SETS
Mercurial menyokong bahasa berfungsi untuk memilih set fail.
Seperti corak fail lain, jenis corak ini ditunjukkan dengan awalan, 'set:'. Bahasa
menyokong beberapa predikat yang dicantumkan oleh operator infiks. Kurungan boleh
digunakan untuk berkumpulan.
Pengecam seperti nama fail atau corak mesti dipetik dengan petikan tunggal atau berganda jika
ia mengandungi watak di luar [.*{}[]?/\_a-zA-Z0-9\x80-\xff] atau jika ia sepadan dengan salah satu daripadanya
predikat yang telah ditetapkan. Ini biasanya digunakan pada corak fail selain daripada glob dan
hujah untuk predikat.
Aksara khas boleh digunakan dalam pengecam yang disebut dengan melarikan diri mereka, cth, \n is
ditafsirkan sebagai baris baharu. Untuk mengelakkannya daripada ditafsirkan, rentetan boleh diberi awalan
bersama r, contohnya r'...'.
Terdapat operator awalan tunggal:
tidak x
Fail tiada dalam x. Bentuk pendek ialah ! x.
Ini ialah operator infix yang disokong:
x and y
Persilangan fail dalam x dan y. Bentuk pendek ialah x & y.
x or y
Penyatuan fail dalam x dan y. Terdapat dua bentuk pendek alternatif: x | y and x +
y.
x - y
Fail dalam x tetapi bukan dalam y.
Predikat berikut disokong:
ditambah()
Fail yang ditambah mengikut hg terkini.
binari()
Fail yang kelihatan seperti binari (mengandungi bait NUL).
bersih()
Fail yang bersih mengikut hg terkini.
disalin()
Fail yang direkodkan sebagai disalin.
dipadam()
Alias untuk hilang().
pengekodan(nama)
Fail boleh berjaya dinyahkodkan dengan pengekodan aksara yang diberikan. Mungkin tidak
berguna untuk pengekodan selain daripada ASCII dan UTF-8.
eol(gaya)
Fail mengandungi baris baharu gaya yang diberikan (dos, unix, mac). Fail binari adalah
dikecualikan, fail dengan pengakhiran baris bercampur sepadan dengan berbilang gaya.
exec ()
Fail yang ditandakan sebagai boleh laku.
grep(regex)
Fail mengandungi ungkapan biasa yang diberikan.
hgignore()
Fail yang sepadan dengan corak .hgignore aktif.
diabaikan()
Fail yang diabaikan mengikut hg terkini. Fail ini hanya akan dipertimbangkan jika
predikat ini digunakan.
hilang()
Fail yang tiada mengikut hg terkini.
diubah suai()
Fail yang diubah suai mengikut hg terkini.
mudah alih()
Fail yang mempunyai nama mudah alih. (Ini tidak termasuk nama fail dengan case
perlanggaran.)
dialih keluar()
Fail yang dialih keluar mengikut hg terkini.
diselesaikan()
Fail yang ditanda diselesaikan mengikut hg menyelesaikan -l.
saiz (ungkapan)
Saiz fail sepadan dengan ungkapan yang diberikan. Contoh:
· 1k (fail dari 1024 hingga 2047 bait)
· < 20k (fail kurang daripada 20480 bait)
· >= .5MB (fail sekurang-kurangnya 524288 bait)
· 4k - 1MB (fail daripada 4096 bait hingga 1048576 bait)
subrepo([corak])
Subrepositori yang laluannya sepadan dengan corak yang diberikan.
symlink()
Fail yang ditandakan sebagai symlink.
tidak diketahui()
Fail yang tidak diketahui mengikut hg terkini. Fail ini hanya akan dipertimbangkan jika
predikat ini digunakan.
tidak dapat diselesaikan()
Fail yang ditanda tidak diselesaikan mengikut hg menyelesaikan -l.
Beberapa contoh pertanyaan:
· Tunjukkan status fail yang kelihatan seperti binari dalam direktori kerja:
status hg -A "set: binary()"
· Lupakan fail yang berada dalam .hgignore tetapi sudah dijejaki:
hg lupakan "set:hgignore() dan tidak diabaikan()"
· Cari fail teks yang mengandungi rentetan:
fail hg "set:grep(sihir) dan bukan binari()"
· Cari fail C dalam pengekodan bukan standard:
hg fail "set:**.c dan bukan pengekodan('UTF-8')"
· Kembalikan salinan fail binari yang besar:
hg revert "set:copyed() dan binary() and size('>1M')"
· Alih keluar fail yang disenaraikan dalam foo.lst yang mengandungi huruf a atau b:
hg alih keluar "set: 'listfile:foo.lst' dan (**a* atau **b*)"
Lihat juga hg membantu corak.
GLOSSARY
Leluhur
Mana-mana set perubahan yang boleh dicapai oleh rantaian perubahan induk yang tidak terputus daripada a
set perubahan yang diberikan. Lebih tepat lagi, nenek moyang set perubahan boleh ditakrifkan oleh dua
sifat: ibu bapa set perubahan ialah nenek moyang, dan ibu bapa kepada nenek moyang ialah
seorang moyang. Lihat juga: 'Keturunan'.
Bookmark
Penanda halaman adalah penunjuk kepada komitmen tertentu yang bergerak apabila melakukan. Mereka adalah
serupa dengan teg kerana nama penanda halaman boleh digunakan di semua tempat di mana
Mercurial menjangkakan ID set perubahan, cth, dengan hg maklumat. Tidak seperti tag, penanda halaman bergerak
bersama apabila anda membuat komitmen.
Penanda halaman boleh dinamakan semula, disalin dan dipadamkan. Penanda halaman adalah tempatan, melainkan ianya
ditolak atau ditarik secara eksplisit antara repositori. Menolak dan menarik penanda buku
membolehkan anda bekerjasama dengan orang lain di cawangan tanpa membuat cawangan bernama.
Cawangan (Kata nama) Set perubahan kanak-kanak yang telah dicipta daripada ibu bapa yang bukan kepala.
Ini dikenali sebagai cawangan topologi, lihat 'Cawangan, topologi'. Sekiranya
cawangan topologi dinamakan, ia menjadi cawangan bernama. Jika cabang topologi adalah
tidak dinamakan, ia menjadi cawangan tanpa nama. Lihat 'Cawangan, tanpa nama' dan 'Cawangan,
bernama'.
Cawangan boleh dibuat apabila perubahan ditarik dari atau ditolak ke alat kawalan jauh
repositori, kerana kepala baharu boleh dibuat oleh operasi ini. Perhatikan bahawa istilah
cawangan juga boleh digunakan secara tidak formal untuk menggambarkan proses pembangunan di mana
pembangunan tertentu dilakukan secara bebas daripada pembangunan lain. Ini kadang-kadang
dilakukan secara eksplisit dengan cawangan bernama, tetapi ia juga boleh dilakukan secara tempatan, menggunakan
penanda buku atau klon dan cawangan tanpa nama.
Contoh: "Cawangan percubaan."
(Kata Kerja) Tindakan mencipta set perubahan kanak-kanak yang mengakibatkan ibu bapanya mempunyai
lebih daripada seorang kanak-kanak.
Contoh: "Saya akan pergi ke cawangan di X."
Cawangan, tanpa nama
Setiap kali set perubahan anak baharu dicipta daripada ibu bapa yang bukan kepala dan
nama cawangan tidak ditukar, cawangan tanpa nama baharu dicipta.
Cawangan, sementara
Cawangan bernama yang ketua cawangannya semuanya telah ditutup.
Cawangan, lalai
Cawangan yang diberikan kepada set perubahan apabila tiada nama telah ditetapkan sebelum ini.
Cawangan kepala
Lihat 'Kepala, cawangan'.
Cawangan, aktif
Jika cawangan yang dinamakan tidak mempunyai kepala topologi, ia dianggap tidak aktif. Sebagai sebuah
contoh, cawangan ciri menjadi tidak aktif apabila ia digabungkan ke dalam lalai
cawangan. The hg cawangan arahan menunjukkan cawangan tidak aktif secara lalai, walaupun boleh
disembunyikan dengan hg cawangan --aktif.
NOTA: konsep ini ditamatkan kerana ia terlalu tersirat. Cawangan sepatutnya sekarang
ditutup secara eksplisit menggunakan hg melakukan --cawangan-tutup apabila mereka tidak lagi diperlukan.
Cawangan, bernama
Koleksi set perubahan yang mempunyai nama cawangan yang sama. Secara lalai, kanak-kanak daripada
set perubahan dalam cawangan bernama tergolong dalam cawangan bernama yang sama. Seorang kanak-kanak boleh
ditugaskan secara eksplisit ke cawangan lain. Lihat hg membantu cawangan, hg membantu cawangan and
hg melakukan --cawangan-tutup untuk maklumat lanjut tentang pengurusan cawangan.
Cawangan yang dinamakan boleh dianggap sebagai sejenis ruang nama, membahagikan koleksi
changeset yang terdiri daripada repositori ke dalam koleksi subset terputus-putus. A
cawangan yang dinamakan tidak semestinya cawangan topologi. Jika cawangan baru bernama
dicipta daripada ketua cawangan lain bernama, atau cawangan lalai, tetapi tidak
set perubahan selanjutnya ditambahkan pada cawangan sebelumnya, kemudian cawangan sebelumnya
akan menjadi cawangan pada nama sahaja.
Cawangan hujung
Lihat 'Petua, cawangan'.
Cawangan, topologi
Setiap kali set perubahan anak baharu dibuat daripada ibu bapa yang bukan kepala, baru
cawangan topologi dicipta. Jika cawangan topologi dinamakan, ia menjadi dinamakan
cawangan. Jika cawangan topologi tidak dinamakan, ia menjadi cawangan tanpa nama bagi
semasa, mungkin lalai, cawangan.
Changelog
Rekod perubahan set dalam susunan ia ditambahkan pada repositori.
Ini termasuk butiran seperti id set perubahan, pengarang, mesej komit, tarikh dan senarai
daripada fail yang diubah.
Set perubahan
Gambar keadaan repositori yang digunakan untuk merekodkan perubahan.
Set perubahan, kanak-kanak
Kebalikan set perubahan ibu bapa: jika P ialah ibu bapa kepada C, maka C ialah anak kepada P.
Tiada had kepada bilangan kanak-kanak yang mungkin ada pada set perubahan.
Set perubahan id
Cincang SHA-1 yang mengenal pasti set perubahan secara unik. Ia boleh diwakili sebagai sama ada
rentetan 40 digit heksadesimal "panjang", atau rentetan 12 digit perenambelasan "pendek".
Set perubahan, bergabung
Set perubahan dengan dua ibu bapa. Ini berlaku apabila penggabungan dilakukan.
Set perubahan, ibu bapa
Semakan yang berdasarkan set perubahan kanak-kanak. Khususnya, set perubahan ibu bapa
daripada set perubahan C ialah set perubahan yang nodnya serta-merta mendahului C dalam DAG.
Changesets mempunyai paling banyak dua ibu bapa.
Pembayaran
(Kata Nama) Direktori kerja sedang dikemas kini kepada semakan tertentu. Penggunaan ini sepatutnya
mungkin dielakkan jika boleh, kerana set perubahan adalah lebih sesuai daripada
pembayaran dalam konteks ini.
Contoh: "Saya menggunakan pembayaran X."
(Kata Kerja) Mengemas kini direktori kerja kepada set perubahan tertentu. Lihat hg membantu maklumat.
Contoh: "Saya akan menyemak set perubahan X."
Kanak-kanak changeset
Lihat 'Ubah, anak'.
Tutup changeset
Lihat 'Kepala, cawangan tertutup'.
Tutup cawangan
Lihat 'Cawangan, ditutup'.
Klon (Kata nama) Salinan keseluruhan atau sebahagian daripada repositori. Klon separa mestilah dalam
bentuk semakan dan nenek moyangnya.
Contoh: "Adakah klon anda terkini?"
(Kata Kerja) Proses mencipta klon, menggunakan hg mengklon.
Contoh: "Saya akan mengklon repositori."
Tutup cawangan kepala
Lihat 'Kepala, cawangan tertutup'.
komited (Kata Nama) Sinonim untuk set perubahan.
Contoh: "Adakah pepijat dibetulkan dalam komitmen anda baru-baru ini?"
(Kata Kerja) Perbuatan merekod berubah kepada repositori. Apabila fail dilakukan dalam a
direktori kerja, Mercurial mencari perbezaan antara fail komited dan
set perubahan induk mereka, mencipta set perubahan baharu dalam repositori.
Contoh: "Anda harus melakukan perubahan itu sekarang."
Cset Singkatan biasa bagi istilah changeset.
DAG Repositori set perubahan sistem kawalan versi teragih (DVCS) boleh
digambarkan sebagai graf asiklik terarah (DAG), yang terdiri daripada nod dan tepi, di mana
nod sepadan dengan set perubahan dan tepi menyiratkan hubungan ibu bapa -> anak. ini
graf boleh divisualisasikan dengan alat grafik seperti hg log --graf. Dalam Mercurial,
DAG dihadkan oleh keperluan untuk kanak-kanak mempunyai paling banyak dua ibu bapa.
Dikecam
Ciri dialih keluar daripada dokumentasi, tetapi tidak dijadualkan untuk dialih keluar.
Lalai cawangan
Lihat 'Cawangan, lalai'.
Keturunan
Sebarang set perubahan yang boleh dicapai oleh rangkaian set perubahan anak daripada set perubahan yang diberikan
set perubahan. Lebih tepat lagi, keturunan set perubahan boleh ditakrifkan oleh dua
sifat: anak kepada set perubahan ialah keturunan, dan anak kepada keturunan
adalah keturunan. Lihat juga: 'Ancestor'.
Diff (Kata nama) Perbezaan antara kandungan dan atribut fail dalam dua
set perubahan atau set perubahan dan direktori kerja semasa. Perbezaannya ialah
biasanya diwakili dalam bentuk piawai yang dipanggil "perbezaan" atau "tampalan". "git diff"
format digunakan apabila perubahan termasuk salinan, menamakan semula atau perubahan pada fail
atribut, tiada satu pun daripadanya boleh diwakili/dikendalikan oleh "perbezaan" dan "tampung" klasik.
Contoh: "Adakah anda melihat pembetulan saya dalam perbezaan?"
(Kata Kerja) Membezakan dua set perubahan ialah tindakan mencipta perbezaan atau tampalan.
Contoh: "Jika anda berbeza dengan set perubahan X, anda akan melihat apa yang saya maksudkan."
Direktori, bekerja
Direktori kerja mewakili keadaan fail yang dijejaki oleh Mercurial, itu
akan direkodkan dalam komit seterusnya. Direktori kerja pada mulanya sepadan dengan
syot kilat pada set perubahan sedia ada, yang dikenali sebagai induk kepada kerja
direktori. Lihat 'Ibu bapa, direktori kerja'. Negeri boleh diubah suai dengan perubahan kepada
fail yang diperkenalkan secara manual atau dengan gabungan. Metadata repositori wujud dalam
Direktori .hg di dalam direktori kerja.
draf Set perubahan dalam fasa draf belum dikongsi dengan repositori penerbitan dan
dengan itu boleh ditukar dengan selamat oleh sambungan yang mengubah suai sejarah. Lihat hg membantu fasa.
Eksperimen
Ciri yang mungkin berubah atau dialih keluar di kemudian hari.
Grafik Lihat DAG dan hg log --graf.
Ketua Istilah 'kepala' boleh digunakan untuk merujuk kepada kedua-dua kepala cawangan atau kepala repositori,
bergantung kepada konteks. Lihat 'Kepala, cawangan' dan 'Kepala, repositori' untuk khusus
takrifan.
Ketua adalah tempat pembangunan umumnya berlaku dan merupakan sasaran biasa
kemas kini dan operasi gabungan.
Ketua, cawangan
Set perubahan tanpa keturunan pada cawangan bernama yang sama.
Ketua, sementara cawangan
Set perubahan yang menandakan kepala sebagai tidak lagi menarik. Kepala tertutup adalah tidak
lagi disenaraikan oleh hg kepala. Sesebuah cawangan dianggap tertutup apabila semua kepalanya tertutup
ditutup dan akibatnya tidak disenaraikan oleh hg cawangan.
Kepala tertutup boleh dibuka semula dengan melakukan set perubahan baharu sebagai anak kepada
changeset yang menandakan kepala sebagai ditutup.
Ketua, repositori
Kepala topologi yang belum ditutup.
Ketua, topologi
Set perubahan tanpa kanak-kanak dalam repositori.
Sejarah, tidak berubah
Setelah dilakukan, perubahan tidak boleh diubah. Sambungan yang kelihatan berubah
sejarah sebenarnya mencipta set perubahan baharu yang menggantikan yang sedia ada, dan kemudian memusnahkan
perubahan lama. Melakukannya dalam repositori awam boleh menghasilkan set perubahan lama
diperkenalkan semula ke repositori.
Sejarah, menulis semula
Set perubahan dalam repositori tidak boleh diubah. Walau bagaimanapun, sambungan kepada Mercurial boleh
digunakan untuk mengubah repositori, biasanya dengan cara untuk mengekalkan set perubahan
kandungan.
Tidak boleh berubah sejarah
Lihat 'Sejarah, tidak berubah'.
Bergabung changeset
Lihat 'Changeset, merge'.
Nyata
Setiap set perubahan mempunyai manifes, iaitu senarai fail yang dijejaki oleh
set perubahan.
Bergabung Digunakan untuk menyatukan cabang kerja yang berbeza. Apabila anda mengemas kini kepada set perubahan
dan kemudian menggabungkan set perubahan yang lain, anda membawa sejarah set perubahan yang terakhir
ke dalam direktori kerja anda. Setelah konflik diselesaikan (dan ditandai), gabungan ini
boleh dilakukan sebagai set perubahan gabungan, membawa dua cawangan bersama-sama dalam DAG.
Dinamakan cawangan
Lihat 'Cawangan, dinamakan'.
Menyeimbangkan changeset
Set perubahan kosong. Ia ialah keadaan induk bagi repositori yang baru dimulakan dan
repositori tanpa semakan yang didaftar keluar. Oleh itu, ia adalah induk kepada perubahan akar
dan moyang yang berkesan apabila menggabungkan perubahan yang tidak berkaitan. Boleh ditentukan oleh
alias 'null' atau mengikut changeset ID '000000000000'.
Ibu bapa Lihat 'Changeset, parent'.
Ibu bapa changeset
Lihat 'Changeset, parent'.
ibu bapa, bekerja direktori
Induk direktori kerja mencerminkan semakan maya yang merupakan anak kepada
changeset (atau dua changeset dengan gabungan tidak komited) ditunjukkan oleh hg ibu bapa. ini
diubah dengan hg maklumat. Perintah lain untuk melihat induk direktori kerja ialah
hg ringkasan and hg id. Boleh ditentukan dengan alias ".".
patch (Kata nama) Hasil darab operasi beza.
Contoh: "Saya telah menghantar patch saya kepada anda."
(Kata Kerja) Proses menggunakan fail tampalan untuk mengubah satu set perubahan kepada yang lain.
Contoh: "Anda perlu menampal semakan itu."
Fasa Keadaan per-changeset menjejaki bagaimana set perubahan telah atau sepatutnya dikongsi. Lihat
hg membantu fasa.
Awam Set perubahan dalam fasa awam telah dikongsi dengan repositori penerbitan dan
oleh itu dianggap tidak berubah. Lihat hg membantu fasa.
Tarik Operasi di mana changeset dalam repositori jauh yang bukan dalam tempatan
repositori dibawa ke repositori tempatan. Ambil perhatian bahawa operasi ini tanpa
argumen khas hanya mengemas kini repositori, ia tidak mengemas kini fail dalam
direktori kerja. Lihat hg membantu tarik.
Tolak Operasi di mana perubahan dalam repositori tempatan yang tidak berada dalam alat kawalan jauh
repositori dihantar ke repositori jauh. Ambil perhatian bahawa operasi ini hanya menambah
set perubahan yang telah dilakukan secara tempatan ke repositori jauh. Tidak komited
perubahan tidak dihantar. Lihat hg membantu menolak.
Repositori
Metadata yang menerangkan semua keadaan rekod koleksi fail. Masing-masing direkodkan
keadaan diwakili oleh set perubahan. Repositori biasanya (tetapi tidak selalu) ditemui
dalam .hg subdirektori bagi direktori kerja. Mana-mana keadaan yang direkodkan boleh dibuat semula
dengan "mengemas kini" direktori kerja kepada set perubahan tertentu.
Repositori kepala
Lihat 'Kepala, repositori'.
Revisi
Keadaan repositori pada satu ketika. Semakan awal boleh dikemas kini
kepada dengan menggunakan hg maklumat. Lihat juga 'Nombor semakan'; Lihat juga 'Changeset'.
Revisi nombor
Integer ini secara unik mengenal pasti set perubahan dalam repositori tertentu. Ia
mewakili susunan perubahan yang ditambahkan pada repositori, bermula dengan
nombor semakan 0. Ambil perhatian bahawa nombor semakan mungkin berbeza dalam setiap klon
sebuah repositori. Untuk mengenal pasti set perubahan secara unik antara klon yang berbeza, lihat
'Tukar id'.
Revlog Mekanisme penyimpanan sejarah yang digunakan oleh Mercurial. Ia adalah satu bentuk pengekodan delta, dengan
semakan penuh sekali-sekala diikuti oleh delta setiap semakan berturut-turut. Ia
termasuk data dan indeks yang menunjuk kepada data.
Menulis semula sejarah
Lihat 'Sejarah, menulis semula'.
Akar Set perubahan yang hanya mempunyai set perubahan nol sebagai induknya. Kebanyakan repositori mempunyai
hanya satu set perubahan akar.
Rahsia Set perubahan dalam fasa rahsia tidak boleh dikongsi melalui tolak, tarik atau klon. Lihat hg
membantu fasa.
Tag Nama alternatif yang diberikan kepada set perubahan. Tag boleh digunakan di semua tempat di mana
Mercurial menjangkakan ID set perubahan, cth, dengan hg maklumat. Penciptaan tag adalah
disimpan dalam sejarah dan dengan itu akan dikongsi secara automatik dengan orang lain menggunakan push
dan tarik.
Petua Set perubahan dengan nombor semakan tertinggi. Ia adalah set perubahan terkini
ditambah dalam repositori.
Petua, cawangan
Ketua cawangan tertentu dengan nombor semakan tertinggi. Apabila nama cawangan adalah
digunakan sebagai pengecam semakan, ia merujuk kepada hujung cawangan. Lihat juga 'Cawangan,
kepala'. Ambil perhatian bahawa kerana nombor semakan mungkin berbeza dalam repositori yang berbeza
klon, hujung cawangan mungkin berbeza dalam repositori klon yang berbeza.
Update (Kata nama) Satu lagi sinonim bagi changeset.
Contoh: "Saya telah menolak kemas kini."
(Kata Kerja) Istilah ini biasanya digunakan untuk menerangkan pengemaskinian keadaan kerja
direktori kepada set perubahan tertentu. Lihat hg membantu maklumat.
Contoh: "Anda harus mengemas kini."
Kerja direktori
Lihat 'Direktori, berfungsi'.
Kerja direktori ibu bapa
Lihat 'Ibu bapa, direktori kerja'.
SISTEM UNTUK MERCURIAL ABAI FILES
Sinopsis
Sistem Mercurial menggunakan fail yang dipanggil .hgignore dalam direktori akar repositori kepada
mengawal tingkah lakunya apabila ia mencari fail yang tidak dijejakinya pada masa ini.
Penerangan Produk
Direktori kerja repositori Mercurial selalunya mengandungi fail yang tidak sepatutnya
dikesan oleh Mercurial. Ini termasuk fail sandaran yang dibuat oleh editor dan membina produk
dicipta oleh penyusun. Fail ini boleh diabaikan dengan menyenaraikannya dalam a .hgignore memfailkan di
akar direktori kerja. The .hgignore fail mesti dibuat secara manual. Ia adalah
biasanya diletakkan di bawah kawalan versi, supaya tetapan akan disebarkan kepada yang lain
repositori dengan tolak dan tarik.
Fail yang tidak dijejaki diabaikan jika laluannya berkaitan dengan direktori akar repositori, atau mana-mana
laluan awalan laluan itu, dipadankan dengan mana-mana corak dalam .hgignore.
Sebagai contoh, katakan kami mempunyai fail yang tidak dijejaki, fail.c, pada a/b/fail.c di dalam repositori kami.
Mercurial akan mengabaikan fail.c jika ada corak dalam .hgignore perlawanan a/b/fail.c, a / b or a.
Di samping itu, fail konfigurasi Mercurial boleh merujuk set setiap pengguna atau global
abaikan fail. Lihat mengabaikan kekunci konfigurasi pada [ui] seksyen hg membantu config Untuk
butiran tentang cara mengkonfigurasi fail ini.
Untuk mengawal pengendalian fail Mercurial yang diurusnya, banyak arahan menyokong fail -I and
-X pilihan; lihat hg membantu and hg membantu corak untuk maklumat lanjut.
Fail yang sudah dijejaki tidak terjejas oleh .hgignore, walaupun ia muncul dalam
.hgignore. Fail X yang tidak dijejaki boleh ditambah secara eksplisit hg menambah X, walaupun X akan menjadi
dikecualikan oleh corak dalam .hgignore.
Syntax
Fail abaikan ialah fail teks biasa yang terdiri daripada senarai corak, dengan satu corak setiap
barisan. Talian kosong dilangkau. The # watak dianggap sebagai watak komen, dan
\ watak dianggap sebagai watak melarikan diri.
Mercurial menyokong beberapa sintaks corak. Sintaks lalai yang digunakan ialah gaya Python/Perl
ungkapan biasa.
Untuk menukar sintaks yang digunakan, gunakan baris bentuk berikut:
sintaks: NAME
di mana NAMA adalah salah satu perkara berikut:
regexp
Ungkapan biasa, sintaks Python/Perl.
epal
Glob gaya cangkerang.
Sintaks yang dipilih kekal berkuat kuasa apabila menghuraikan semua corak yang mengikuti, sehingga yang lain
sintaks dipilih.
Corak glob mahupun regexp tidak berakar. Corak glob-sintaks borang *.c akan
padankan fail yang berakhir dengan .c dalam mana-mana direktori, dan corak regexp borang \.c$ akan buat
sama. Untuk mengakar corak regexp, mulakan dengan ^.
Subdirektori boleh mempunyai tetapan .hgignore mereka sendiri dengan menambah
subinclude:path/to/subdir/.hgignore kepada akar .hgignore. Lihat hg membantu corak Untuk
butiran mengenai masukkan: and termasuk:.
Nota Corak yang dinyatakan dalam selain daripada .hgignore sentiasa berakar umbi. Sila lihat hg membantu
corak untuk maklumat lanjut.
Contoh
Berikut ialah contoh fail abaikan.
# gunakan sintaks glob.
sintaks: glob
*.elc
*.pyc
*~
# tukar kepada sintaks regexp.
sintaks: regexp
^\.pc/
KONFIGURASI HGWEB
Pelayan web dalaman Mercurial, hgweb, boleh menyediakan sama ada satu repositori atau pokok
repositori. Dalam kes kedua, laluan repositori dan pilihan global boleh ditakrifkan menggunakan
fail konfigurasi khusus yang biasa digunakan hg berkhidmat, hgweb.wsgi, hgweb.cgi and hgweb.fcgi.
Fail ini menggunakan sintaks yang sama seperti fail konfigurasi Mercurial yang lain tetapi mengecam sahaja
bahagian berikut:
· web
· laluan
· koleksi
. web pilihan diterangkan dengan teliti dalam hg membantu config.
. laluan bahagian memetakan laluan URL ke laluan repositori dalam sistem fail. hgweb akan
tidak mendedahkan sistem fail secara langsung - hanya repositori Mercurial boleh diterbitkan dan hanya
mengikut konfigurasi.
Bahagian kiri ialah laluan dalam URL. Ambil perhatian bahawa hgweb menyimpan sublaluan seperti rev or
fail, cuba gunakan nama yang berbeza untuk repositori bersarang untuk mengelakkan kesan yang mengelirukan.
Sebelah kanan ialah laluan dalam sistem fail. Jika laluan yang ditentukan berakhir dengan * or **
sistem fail akan dicari secara rekursif untuk repositori di bawah titik itu. Dengan * it
tidak akan berulang ke dalam repositori yang ditemuinya (kecuali untuk .hg/patches). Dengan ** ia akan
juga cari di dalam direktori kerja repositori dan mungkin cari subrepositori.
Dalam contoh ini:
[laluan]
/projek/a = /srv/tmprepos/a
/projek/b = c:/repos/b
/ = /srv/repos/*
/pengguna/bob = /home/bob/repos/**
· Dua entri pertama menjadikan dua repositori dalam direktori berbeza muncul di bawah
direktori yang sama dalam antara muka web
· Entri ketiga akan menerbitkan setiap repositori Mercurial yang terdapat dalam /srv/repos/, Bagi
contohnya repositori /srv/repos/quux/ akan muncul sebagai http://server/quux/
· Entri keempat akan menerbitkan kedua-duanya http://server/user/bob/quux/ and
http://server/user/bob/quux/testsubrepo/
. Koleksi bahagian ditamatkan dan telah digantikan oleh laluan.
URL and Common Argumen
URL di bawah setiap repositori mempunyai borang /{command}[/{arguments}] di mana {perintah}
mewakili nama arahan atau pengendali dan {arguments} mewakili sebarang bilangan
parameter URL tambahan kepada arahan itu.
Pelayan web mempunyai gaya lalai yang dikaitkan dengannya. Peta gaya kepada koleksi yang dinamakan
templat. Setiap templat digunakan untuk memaparkan sekeping data tertentu, seperti set perubahan
atau berbeza.
Gaya untuk permintaan semasa boleh ditimpa dua cara. Pertama, jika {perintah}
mengandungi tanda sempang (-), teks sebelum tanda sempang mentakrifkan gaya. Sebagai contoh,
/atom-log akan menyebabkan log pengendali arahan dengan atom gaya. Cara kedua untuk menetapkan
gaya adalah dengan gaya hujah rentetan pertanyaan. Sebagai contoh, /log?style=atom. Yang
parameter URL sempang lebih disukai.
Tidak semua templat tersedia untuk semua gaya. Percubaan untuk menggunakan gaya yang tidak
mempunyai semua templat ditakrifkan boleh mengakibatkan ralat memaparkan halaman.
Banyak arahan mengambil a {ulang kaji} Parameter URL. Ini mentakrifkan set perubahan untuk beroperasi.
Ini biasanya dinyatakan sebagai singkatan pendek, 12 digit heksadesimal untuk 40 penuh
pengecam semakan unik watak. Walau bagaimanapun, sebarang nilai yang diterangkan oleh hg membantu semakan
biasanya berfungsi.
arahan and URL
Perintah web berikut dan URLnya tersedia:
/annotate/{revision}/{path}
Tunjukkan maklumat set perubahan untuk setiap baris dalam fail.
. anotasi fail templat diberikan.
/archive/{revision}.{format}[/{path}]
Dapatkan arkib kandungan repositori.
Kandungan dan jenis arkib ditakrifkan oleh parameter laluan URL. format adalah
sambungan fail jenis arkib yang akan dijana. cth zip or tar bz2. Bukan semua arkib
jenis mungkin dibenarkan oleh konfigurasi pelayan anda.
Pilihannya jalan Parameter URL mengawal kandungan untuk disertakan dalam arkib. Jika ditinggalkan,
setiap fail dalam semakan yang ditentukan terdapat dalam arkib. Jika disertakan, hanya
fail tertentu atau kandungan direktori yang ditentukan akan dimasukkan ke dalam arkib.
Tiada templat digunakan untuk pengendali ini. Kandungan mentah, binari dijana.
/penanda buku
Tunjukkan maklumat tentang penanda halaman.
Tiada hujah diterima.
. penanda buku templat diberikan.
/cawangan
Tunjukkan maklumat tentang cawangan.
Semua cawangan yang diketahui terkandung dalam output, walaupun cawangan tertutup.
Tiada hujah diterima.
. cawangan templat diberikan.
/changelog[/{revision}]
Tunjukkan maklumat tentang berbilang set perubahan.
Jika pilihan semakan Argumen URL tiada, maklumat tentang semua set perubahan bermula
at hujung akan diberikan. Sekiranya semakan hujah hadir, set perubahan akan ditunjukkan
bermula daripada semakan yang ditetapkan.
If semakan tidak hadir, yang rev hujah rentetan pertanyaan boleh ditakrifkan. Ini akan melaksanakan a
cari perubahan.
Hujah untuk rev boleh menjadi semakan tunggal, set semakan atau kata kunci literal kepada
cari dalam data changeset (bersamaan dengan hg log -k).
. kiraan semula hujah rentetan pertanyaan mentakrifkan bilangan maksimum set perubahan untuk diberikan.
Untuk bukan carian, yang Changelog templat akan diberikan.
/changeset[/{revision}]
Tunjukkan maklumat tentang set perubahan tunggal.
Argumen laluan URL ialah pengecam set perubahan untuk ditunjukkan. Lihat hg membantu semakan Untuk
nilai yang mungkin. Jika tidak ditakrifkan, hujung set perubahan akan ditunjukkan.
. changeset templat diberikan. Kandungan changesettag, changesetbookmark,
pautan fail, filenolink, dan banyak templat yang berkaitan dengan perbezaan semuanya boleh digunakan
menghasilkan keluaran.
/comparison/{revision}/{path}
Tunjukkan perbandingan antara versi lama dan baharu fail daripada perubahan yang dibuat pada a
semakan tertentu.
Ini serupa dengan diff pengendali. Walau bagaimanapun, borang ini mempunyai perpecahan atau sebelah menyebelah
diff dan bukannya diff bersatu.
. konteks hujah rentetan pertanyaan boleh digunakan untuk mengawal baris konteks dalam perbezaan.
. perbandingan fail templat diberikan.
/diff/{revision}/{path}
Tunjukkan cara fail berubah dalam komit tertentu.
. faildiff templat diberikan.
Pengendali ini didaftarkan di bawah kedua-dua /perbezaan and /filediff laluan. /perbezaan digunakan dalam
kod moden.
/file/{revision}[/{path}]
Tunjukkan maklumat tentang direktori atau fail dalam repositori.
Maklumat mengenai jalan diberikan sebagai parameter URL akan dipaparkan.
If jalan ialah direktori, maklumat tentang entri dalam direktori itu akan diberikan.
Borang ini bersamaan dengan nyata penangan.
If jalan ialah fail, maklumat tentang fail itu akan ditunjukkan melalui semakan fail
templat.
If jalan tidak ditakrifkan, maklumat tentang direktori akar akan diberikan.
/diff/{revision}/{path}
Tunjukkan cara fail berubah dalam komit tertentu.
. faildiff templat diberikan.
Pengendali ini didaftarkan di bawah kedua-dua /perbezaan and /filediff laluan. /perbezaan digunakan dalam
kod moden.
/filelog/{revision}/{path}
Tunjukkan maklumat tentang sejarah fail dalam repositori.
. kiraan semula hujah rentetan pertanyaan boleh ditakrifkan untuk mengawal bilangan entri maksimum
untuk menunjukkan.
. log fail templat akan diberikan.
/graf[/{revision}]
Tunjukkan maklumat tentang topologi grafik repositori.
Maklumat yang diberikan oleh pengendali ini boleh digunakan untuk membuat representasi visual
topologi repositori.
. semakan Parameter URL mengawal set perubahan permulaan.
. kiraan semula hujah rentetan pertanyaan boleh menentukan bilangan set perubahan untuk menunjukkan maklumat
bagi.
Pengendali ini akan memberikan graf templat.
/help[/{topic}]
Berikan dokumentasi bantuan.
Perintah web ini lebih kurang sama dengan hg membantu. Sekiranya topik ditakrifkan, topik bantuan itu
akan diberikan. Jika tidak, indeks topik bantuan yang tersedia akan diberikan.
. membantu templat akan diberikan apabila meminta bantuan untuk topik. topik bantuan akan
diberikan untuk indeks topik bantuan.
/log[/{revision}[/{path}]]
Tunjukkan repositori atau sejarah fail.
Untuk URL borang /log/{revision}, senarai set perubahan bermula pada yang ditentukan
pengecam set perubahan ditunjukkan. Jika {ulang kaji} tidak ditakrifkan, lalainya ialah hujung. Borang ini
adalah bersamaan dengan Changelog penangan.
Untuk URL borang /log/{revision}/{file}, sejarah untuk fail tertentu ialah
ditunjukkan. Borang ini bersamaan dengan log fail penangan.
/manifest[/{revision}[/{path}]]
Tunjukkan maklumat tentang direktori.
Jika argumen laluan URL ditinggalkan, maklumat tentang direktori akar untuk hujung
set perubahan akan ditunjukkan.
Oleh kerana pengendali ini hanya boleh menunjukkan maklumat untuk direktori, adalah disyorkan untuk digunakan
yang fail pengendali sebaliknya, kerana ia boleh mengendalikan kedua-dua direktori dan fail.
. nyata templat akan diberikan untuk pengendali ini.
/changeset[/{revision}]
Tunjukkan maklumat tentang set perubahan tunggal.
Argumen laluan URL ialah pengecam set perubahan untuk ditunjukkan. Lihat hg membantu semakan Untuk
nilai yang mungkin. Jika tidak ditakrifkan, hujung set perubahan akan ditunjukkan.
. changeset templat diberikan. Kandungan changesettag, changesetbookmark,
pautan fail, filenolink, dan banyak templat yang berkaitan dengan perbezaan semuanya boleh digunakan
menghasilkan keluaran.
/shortlog
Tunjukkan maklumat asas tentang set set perubahan.
Ini menerima parameter yang sama seperti Changelog pengendali. Satu-satunya perbezaan adalah
shortlog templat akan diberikan dan bukannya Changelog templat.
/ringkasan
Tunjukkan ringkasan keadaan repositori.
Maklumat tentang set perubahan, penanda halaman, teg dan cawangan terkini ditangkap oleh ini
penangan.
. ringkasan templat diberikan.
/tag
Tunjukkan maklumat tentang tag.
Tiada hujah diterima.
. tags templat diberikan.
TEKNIKAL PELAKSANAAN TOPIK
berkas
bekas untuk pertukaran data repositori
kumpulan perubahan
perwakilan data revlog
revlogs
mekanisme penyimpanan semakan
MERGE TOOLS
Untuk menggabungkan fail Mercurial menggunakan alat gabungan.
Alat cantum menggabungkan dua versi fail yang berbeza ke dalam fail yang digabungkan. Alat gabungan adalah
memandangkan kedua-dua fail dan nenek moyang sepunya terbesar bagi kedua-dua versi fail, jadi mereka boleh
tentukan perubahan yang dibuat pada kedua-dua cabang.
Alat gabungan digunakan kedua-duanya untuk hg menyelesaikan, hg bergabung, hg maklumat, hg berundur dan dalam beberapa
sambungan.
Biasanya, alat gabungan cuba menyelaraskan fail secara automatik dengan menggabungkan semua
perubahan tidak bertindih yang berlaku secara berasingan dalam dua evolusi berbeza
fail asas awal yang sama. Tambahan pula, beberapa program gabungan interaktif menjadikannya lebih mudah untuk
menyelesaikan cantuman bercanggah secara manual, sama ada dalam cara grafik atau dengan memasukkan beberapa
penanda konflik. Mercurial tidak termasuk sebarang program gabungan interaktif tetapi bergantung pada
alat luaran untuk itu.
Boleh didapati bergabung alat
Alat gabungan luaran dan sifatnya dikonfigurasikan dalam konfigurasi alat gabungan
bahagian - lihat hgrc(5) - tetapi mereka selalunya boleh dinamakan oleh boleh laku mereka.
Alat gabungan biasanya boleh digunakan jika boleh laku boleh didapati pada sistem dan jika ia
boleh mengendalikan gabungan. Boleh laku ditemui jika ia boleh laku mutlak atau relatif
laluan atau nama aplikasi dalam laluan carian boleh laku. Alat itu diandaikan
boleh mengendalikan gabungan jika ia boleh mengendalikan pautan sym jika fail itu pautan sym, jika boleh
mengendalikan fail binari jika fail adalah binari, dan jika GUI tersedia jika alat memerlukan
GUI.
Terdapat beberapa alat gabungan dalaman yang boleh digunakan. Alat gabungan dalaman ialah:
:pembuangan
Mencipta tiga versi fail untuk digabungkan, yang mengandungi kandungan tempatan,
lain dan asas. Fail ini kemudiannya boleh digunakan untuk melakukan cantuman secara manual. Sekiranya
fail yang hendak digabungkan dinamakan a.txt, fail ini akan dinamakan dengan sewajarnya
a.txt.local, a.txt.lain and a.txt.base dan mereka akan ditempatkan di tempat yang sama
direktori sebagai a.txt.
:gagal
Daripada cuba menggabungkan fail yang telah diubah suai pada kedua-dua cawangan, ia menandakan
mereka sebagai tidak dapat diselesaikan. Perintah menyelesaikan mesti digunakan untuk menyelesaikan konflik ini.
: tempatan
Menggunakan versi tempatan fail sebagai versi gabungan.
: bergabung
Menggunakan algoritma cantum ringkas bukan interaktif dalaman untuk menggabungkan fail. Ia akan
gagal jika terdapat sebarang konflik dan meninggalkan penanda dalam fail yang dicantumkan separa.
Penanda akan mempunyai dua bahagian, satu untuk setiap sisi cantuman.
:gabung-tempatan
Seperti :merge, tetapi selesaikan semua konflik secara bukan interaktif yang memihak kepada setempat
perubahan.
:gabung-lain
Seperti :merge, tetapi selesaikan semua konflik secara tidak interaktif yang memihak kepada yang lain
perubahan.
:gabung3
Menggunakan algoritma cantum ringkas bukan interaktif dalaman untuk menggabungkan fail. Ia akan
gagal jika terdapat sebarang konflik dan meninggalkan penanda dalam fail yang dicantumkan separa.
Penanda akan mempunyai tiga bahagian, satu dari setiap sisi gabungan dan satu untuk
kandungan asas.
: lain-lain
Menggunakan versi fail lain sebagai versi gabungan.
: segera
Meminta pengguna versi tempatan atau versi yang lain untuk disimpan sebagai gabungan
versi.
:tagmerge
Menggunakan algoritma gabungan teg dalaman (percubaan).
: kesatuan
Menggunakan algoritma cantum ringkas bukan interaktif dalaman untuk menggabungkan fail. Ia akan
gunakan kedua-dua belah kiri dan kanan untuk kawasan konflik. Tiada penanda dimasukkan.
Alat dalaman sentiasa tersedia dan tidak memerlukan GUI tetapi secara lalai tidak
mengendalikan symlinks atau fail binari.
Memilih a bergabung alat
Mercurial menggunakan peraturan ini apabila memutuskan alat gabungan yang hendak digunakan:
1. Jika alat telah ditentukan dengan pilihan --tool untuk menggabungkan atau menyelesaikan, ia digunakan.
Jika ia adalah nama alat dalam konfigurasi alat gabungan, konfigurasinya ialah
digunakan. Jika tidak, alat yang ditentukan mesti boleh dilaksanakan oleh shell.
2. Jika HGMERGE pembolehubah persekitaran hadir, nilainya digunakan dan mesti ada
boleh dilaksanakan oleh shell.
3. Jika nama fail fail yang hendak digabungkan sepadan dengan mana-mana corak dalam
bahagian konfigurasi merge-patterns, alat cantuman pertama yang boleh digunakan sepadan dengan a
corak padanan digunakan. Di sini, keupayaan binari alat gabungan tidak
dipertimbangkan.
4. Jika ui.merge ditetapkan ia akan dipertimbangkan seterusnya. Jika nilainya bukan nama a
alat yang dikonfigurasikan, nilai yang ditentukan digunakan dan mesti boleh dilaksanakan oleh shell.
Jika tidak, alat yang dinamakan digunakan jika ia boleh digunakan.
5. Jika mana-mana alat cantum yang boleh digunakan terdapat dalam bahagian konfigurasi alatan cantum, yang satu
dengan keutamaan tertinggi digunakan.
6. Jika sesuatu program dinamakan hgmerge boleh didapati pada sistem, ia digunakan - tetapi ia akan oleh
lalai tidak boleh digunakan untuk symlinks dan fail binari.
7. Jika fail yang hendak digabungkan bukan binari dan bukan symlink, maka dalaman : bergabung is
terpakai.
8. Gabungan fail gagal dan mesti diselesaikan sebelum melakukan.
Nota Selepas memilih program gabungan, Mercurial secara lalai akan cuba untuk menggabungkan
fail menggunakan algoritma gabungan mudah dahulu. Hanya jika ia tidak berjaya kerana
perubahan bercanggah Mercurial sebenarnya akan melaksanakan program gabungan. Sama ada untuk
gunakan algoritma cantum mudah dahulu boleh dikawal oleh tetapan pratambahan
alat gabungan. Premerge didayakan secara lalai melainkan fail binari atau a
symlink.
Lihat bahagian alat gabungan dan ui bagi hgrc(5) untuk butiran tentang konfigurasi gabungan
alat.
MENYERTAI PELBAGAI ULASAN
Apabila Mercurial menerima lebih daripada satu semakan, ia mungkin dinyatakan secara individu, atau
disediakan sebagai julat berterusan secara topologi, dipisahkan oleh aksara ":".
Sintaks tatatanda julat ialah [BEGIN]:[END], dengan BEGIN dan END ialah semakan
pengecam. Kedua-dua BEGIN dan END adalah pilihan. Jika BEGIN tidak dinyatakan, ia lalai kepada
nombor semakan 0. Jika TAMAT tidak dinyatakan, ia lalai kepada hujung. Julat ":" dengan itu
bermaksud "semua semakan".
Jika BEGIN lebih besar daripada END, semakan dilayan dalam susunan terbalik.
Julat bertindak sebagai selang tertutup. Ini bermakna julat 3:5 memberikan 3, 4 dan 5.
Begitu juga, julat 9:6 memberikan 9, 8, 7, dan 6.
FAIL NAMA CORAK
Mercurial menerima beberapa notasi untuk mengenal pasti satu atau lebih fail pada satu masa.
Secara lalai, Mercurial menganggap nama fail sebagai corak glob lanjutan gaya shell.
Notasi corak ganti mesti dinyatakan secara eksplisit.
Corak Catatan dinyatakan dalam .hgignore tidak berakar. Sila lihat hg membantu hgignore Untuk
butiran.
Untuk menggunakan nama laluan biasa tanpa sebarang padanan corak, mulakannya dengan jalan:. Laluan ini
nama mesti sepadan sepenuhnya bermula pada akar repositori semasa.
Untuk menggunakan glob lanjutan, mulakan nama dengan glob:. Globs berakar pada arus
direktori; glob seperti *.c hanya akan memadankan fail dalam direktori semasa yang berakhir dengan
.c.
Sambungan sintaks glob yang disokong ialah ** untuk memadankan sebarang rentetan merentasi pemisah laluan dan
{a,b} bermaksud "a atau b".
Untuk menggunakan ungkapan biasa Perl/Python, mulakan nama dengan semula:. Padanan corak regexp
berlabuh pada akar repositori.
Untuk membaca corak nama daripada fail, gunakan fail senarai: or listfile0:. Yang terakhir menjangkakan batal
corak yang dihadkan manakala yang pertama menjangkakan suapan baris. Setiap rentetan dibaca daripada fail ialah
itu sendiri dianggap sebagai corak fail.
Untuk membaca set corak daripada fail, gunakan termasuk: or masukkan:. termasuk: akan menggunakan semua
corak dari fail yang diberikan dan merawatnya seolah-olah ia telah dihantar secara manual.
masukkan: hanya akan menggunakan corak terhadap fail yang berada di bawah subtermasuk
direktori fail. Lihat hg membantu hgignore untuk butiran tentang format fail ini.
Semua corak, kecuali untuk glob: dinyatakan dalam baris arahan (bukan untuk -I or -X pilihan), boleh
sepadan juga dengan direktori: fail di bawah direktori dipadankan dianggap sebagai dipadankan.
Contoh biasa:
path:foo/bar bar nama dalam direktori bernama foo dalam akar
daripada repositori
path:path:name fail atau direktori bernama "path:name"
Contoh glob:
glob:*.c sebarang nama yang berakhir dengan ".c" dalam direktori semasa
*.c mana-mana nama yang berakhir dengan ".c" dalam direktori semasa
**.c mana-mana nama yang berakhir dengan ".c" dalam mana-mana subdirektori
direktori semasa termasuk dirinya sendiri.
foo/*.c sebarang nama yang berakhir dengan ".c" dalam direktori foo
foo/**.c sebarang nama yang berakhir dengan ".c" dalam mana-mana subdirektori foo
termasuk dirinya sendiri.
Contoh Regexp:
re:.*\.c$ sebarang nama yang berakhir dengan ".c", di mana-mana dalam repositori
Contoh fail:
listfile:list.txt senarai baca daripada list.txt dengan satu corak fail setiap baris
listfile0:list.txt senarai baca daripada list.txt dengan pembatas bait nol
Lihat juga hg membantu set fail.
Sertakan contoh:
include:path/to/mypatternfile membaca corak untuk digunakan pada semua laluan
subinclude:path/to/subignorefile membaca corak khusus untuk laluan dalam
subdirektori
KERJA DENGAN FASA
Servis adalah fasa?
Fasa ialah sistem untuk menjejaki perubahan yang telah atau patut dikongsi. ini
membantu mengelakkan kesilapan biasa semasa mengubah suai sejarah (contohnya, dengan mq atau rebase
sambungan).
Setiap set perubahan dalam repositori adalah dalam salah satu fasa berikut:
· awam : set perubahan kelihatan pada pelayan awam
· draf : set perubahan belum diterbitkan
· rahsia : set perubahan tidak boleh ditolak, ditarik atau diklon
Fasa ini disusun (awam < draf < rahsia) dan tiada set perubahan boleh berada di bawah
fasa daripada nenek moyangnya. Sebagai contoh, jika set perubahan adalah umum, semua nenek moyangnya adalah
juga awam. Akhir sekali, fasa set perubahan hanya perlu diubah ke arah fasa awam.
Cara adalah fasa diuruskan?
Untuk sebahagian besar, fasa harus berfungsi dengan telus. Secara lalai, set perubahan dibuat dalam
fasa draf dan dipindahkan ke fasa awam apabila ia ditolak ke fasa lain
repositori.
Setelah set perubahan menjadi umum, sambungan seperti mq dan rebase akan menolak untuk beroperasi
mereka untuk mengelakkan mencipta set perubahan pendua. Fasa juga boleh dimanipulasi secara manual
dengan hg fasa arahan jika perlu. Lihat hg membantu -v fasa untuk contoh.
Untuk menjadikan komitmen anda rahsia secara lalai, letakkan ini dalam fail konfigurasi anda:
[fasa]
new-commit = rahsia
Fasa and pelayan
Biasanya, semua pelayan adalah penerbitan secara lalai. Ini bermaksud:
- semua set perubahan draf yang ditarik atau diklon muncul dalam fasa
awam pada klien
- semua set perubahan draf yang ditolak muncul sebagai umum pada kedua-duanya
klien dan pelayan
- set perubahan rahsia tidak ditolak, ditarik atau diklon
Nota Menarik set perubahan draf daripada pelayan penerbitan tidak menandakannya sebagai umum
bahagian pelayan disebabkan oleh sifat tarikan baca sahaja.
Kadangkala adalah wajar untuk menolak dan menarik set perubahan dalam fasa draf untuk dikongsi
kerja yang belum selesai. Ini boleh dilakukan dengan menetapkan repositori untuk melumpuhkan penerbitan di dalamnya
fail konfigurasi:
[fasa]
terbitkan = Palsu
Lihat hg membantu config untuk maklumat lanjut tentang fail konfigurasi.
Nota Pelayan yang menjalankan versi lama Mercurial dianggap sebagai penerbitan.
Nota Changeset dalam fasa rahsia tidak ditukar dengan pelayan. Ini terpakai kepada mereka
kandungan: nama fail, kandungan fail dan metadata set perubahan. Atas sebab teknikal,
pengecam (cth d825e4025e39) set perubahan rahsia boleh dimaklumkan kepada
pelayan.
Contoh
· senaraikan perubahan dalam draf atau fasa rahsia:
hg log -r "bukan awam()"
· tukar semua set perubahan rahsia kepada draf:
fasa hg --draf "rahsia()"
· secara paksa memindahkan set perubahan dan keturunan semasa daripada awam ke draf:
hg fasa --force --draft .
· tunjukkan senarai semakan dan fasa set perubahan:
hg log --template "{rev} {fasa}\n"
· menyegerakkan semula set perubahan draf berbanding dengan repositori jauh:
fasa hg -fd "keluar(URL)"
Lihat hg membantu fasa untuk maklumat lanjut tentang memanipulasi fasa secara manual.
MENYERTAI SINGLE ULASAN
Mercurial menyokong beberapa cara untuk menentukan semakan individu.
Integer biasa dianggap sebagai nombor semakan. Integer negatif dianggap sebagai
offset berurutan dari hujung, dengan -1 menandakan hujung, -2 menandakan semakan sebelumnya
ke hujung, dan sebagainya.
Rentetan heksadesimal 40 digit dianggap sebagai pengecam semakan yang unik.
Rentetan perenambelasan yang panjangnya kurang daripada 40 aksara dianggap sebagai semakan unik
pengecam dan dirujuk sebagai pengecam bentuk pendek. Pengecam bentuk pendek hanyalah
sah jika ia adalah awalan tepat satu pengecam panjang penuh.
Sebarang rentetan lain dianggap sebagai penanda halaman, teg atau nama cawangan. Penanda buku adalah boleh alih
penunjuk kepada semakan. Teg ialah nama kekal yang dikaitkan dengan semakan. Nama cawangan
menandakan kepala cawangan yang paling hujung terbuka bagi cawangan itu - atau jika mereka semua ditutup, itu
kepala cawangan yang paling tertutup. Penanda halaman, tag dan nama cawangan tidak boleh mengandungi
":" watak.
Nama simpanan "petua" sentiasa mengenal pasti semakan terbaharu.
Nama terpelihara "null" menunjukkan semakan batal. Ini adalah semakan kosong
repositori, dan induk semakan 0.
Nama terpelihara "." menunjukkan induk direktori kerja. Jika tiada direktori kerja
diperiksa keluar, ia bersamaan dengan null. Jika gabungan tanpa komitmen sedang dijalankan, "." adalah
semakan ibu bapa pertama.
MENYERTAI ULANG KAJI SETS
Mercurial menyokong bahasa berfungsi untuk memilih set semakan.
Bahasa ini menyokong beberapa predikat yang dicantumkan oleh operator infiks.
Kurungan boleh digunakan untuk pengelompokan.
Pengecam seperti nama cawangan mungkin memerlukan petikan dengan petikan tunggal atau berganda jika mereka
mengandungi aksara seperti - atau jika ia sepadan dengan salah satu predikat yang telah ditetapkan.
Aksara khas boleh digunakan dalam pengecam yang disebut dengan melarikan diri mereka, cth, \n is
ditafsirkan sebagai baris baharu. Untuk mengelakkannya daripada ditafsirkan, rentetan boleh diberi awalan
bersama r, contohnya r'...'.
Terdapat operator awalan tunggal:
tidak x
Set perubahan bukan dalam x. Bentuk pendek ialah ! x.
Ini ialah operator infix yang disokong:
x::y
Julat DAG, bermakna semua set perubahan yang merupakan keturunan x dan nenek moyang y,
termasuk x dan y sendiri. Jika titik akhir pertama ditinggalkan, ini adalah setara
kepada nenek moyang(y), jika yang kedua ditinggalkan ia bersamaan dengan keturunan(x).
Sintaks alternatif ialah x..y.
x:y
Semua set perubahan dengan nombor semakan antara x dan y, termasuk kedua-duanya. sama ada
titik akhir boleh ditinggalkan, ia lalai kepada 0 dan tip.
x and y
Persilangan set perubahan dalam x dan y. Bentuk pendek ialah x & y.
x or y
Penyatuan set perubahan dalam x dan y. Terdapat dua bentuk pendek alternatif: x | y
and x + y.
x - y
Set perubahan dalam x tetapi bukan dalam y.
x^n
Induk ke-n bagi x, n == 0, 1, atau 2. Untuk n == 0, x; untuk n == 1, induk pertama
setiap set perubahan dalam x; untuk n == 2, induk kedua set perubahan dalam x.
x~n
Nenek moyang pertama x; x~0 ialah x; x~3 is x^^.
Terdapat satu pengendali postfix:
x^
Bersamaan dengan x^1, induk pertama bagi setiap set perubahan dalam x.
Predikat berikut disokong:
menambah (corak)
Set perubahan yang menambah corak padanan fail.
Corak tanpa jenis eksplisit seperti glob: dijangka relatif kepada
direktori semasa dan padankan dengan fail atau direktori.
semua()
Semua perubahan, sama seperti 0:petua.
nenek moyang(*changeset)
Nenek moyang yang paling besar bagi kumpulan perubahan.
Menerima 0 atau lebih perubahan. Akan mengembalikan senarai kosong apabila lulus tiada args.
Nenek moyang terhebat bagi set perubahan tunggal ialah set perubahan itu.
nenek moyang (set)
Set perubahan yang merupakan nenek moyang set perubahan dalam set.
pengarang(rentetan)
Alias untuk pengguna(rentetan).
dua belah (tali)
Set perubahan yang ditandakan dalam status belah dua yang ditentukan:
· baik, buruk, skip: csets ditandakan secara eksplisit sebagai baik/buruk/langkau
· barangan, keburukan : cset secara topologi baik/buruk
· pelbagai : cset mengambil bahagian dalam pembahagian dua
· dipotong : cset yang merupakan barang, keburukan atau dilangkau
· belum dicuba : cset yang belum diketahui nasibnya
· diabaikan : cset diabaikan kerana topologi DAG
· semasa : cset yang sedang dibelah dua
penanda buku([nama])
Penanda halaman yang dinamakan atau semua penanda halaman.
If nama bermula dengan semula:, selebihnya nama dianggap sebagai biasa
ungkapan. Untuk memadankan penanda halaman yang sebenarnya bermula dengan semula:, gunakan awalan
literal:.
cawangan (rentetan or set)
Semua set perubahan kepunyaan cawangan yang diberikan atau cawangan yang diberikan
set perubahan.
If rentetan bermula dengan semula:, selebihnya nama dianggap sebagai biasa
ungkapan. Untuk memadankan cawangan yang sebenarnya bermula dengan semula:, gunakan awalan
literal:.
branchpoint()
Set perubahan dengan lebih daripada seorang kanak-kanak.
terlanggar()
Set perubahan boleh ubah ditandakan sebagai pengganti set perubahan awam.
Hanya set perubahan bukan awam dan tidak lapuk boleh bumped.
berkas()
Set perubahan dalam berkas.
Himpunan mesti ditentukan oleh pilihan -R.
kanak-kanak (set)
Set perubahan anak bagi set perubahan dalam set.
ditutup()
Changeset ditutup.
mengandungi (corak)
Manifes semakan mengandungi corak padanan fail (tetapi mungkin tidak mengubah suainya).
Lihat hg membantu corak untuk maklumat tentang corak fail.
Corak tanpa jenis eksplisit seperti glob: dijangka relatif kepada
direktori semasa dan padankan dengan fail tepat untuk kecekapan.
ditukar([id])
Set perubahan ditukar daripada pengecam yang diberikan dalam repositori lama jika ada, atau
semua set perubahan yang ditukar jika tiada pengecam ditentukan.
tarikh (selang)
Set perubahan dalam selang waktu, lihat hg membantu tarikh.
desc(rentetan)
Cari mesej komit untuk rentetan. Perlawanan adalah tidak peka huruf besar-besaran.
keturunan (set)
Set perubahan yang merupakan keturunan set perubahan dalam set.
destinasi ([set])
Set perubahan yang dibuat oleh operasi cantuman, pemindahan atau pangkalan semula, dengan
diberi semakan yang dinyatakan sebagai sumber. Mengeluarkan set pilihan adalah sama seperti
melepasi semua ().
divergen()
Pengganti akhir set perubahan dengan set pengganti terakhir alternatif.
draf()
Perubahan dalam fasa draf.
pupus()
Set perubahan usang dengan keturunan usang sahaja.
tambahan (label, [nilai])
Set perubahan dengan label yang diberikan dalam metadata tambahan, dengan pilihan yang diberikan
nilai.
If nilai bermula dengan semula:, baki nilai dianggap sebagai nilai biasa
ungkapan. Untuk memadankan nilai yang sebenarnya bermula dengan semula:, gunakan awalan
literal:.
fail (corak)
Set perubahan yang mempengaruhi fail dipadankan dengan corak.
Untuk hasil yang lebih pantas tetapi kurang tepat, pertimbangkan untuk menggunakan log fail() sebaliknya.
Predikat ini menggunakan glob: sebagai jenis corak lalai.
log fail(corak)
Changesets disambungkan ke log fail yang ditentukan.
Atas sebab prestasi, lawatan hanya semakan yang disebut dalam log fail peringkat fail,
daripada menapis semua set perubahan (lebih cepat, tetapi tidak termasuk
memadam atau menduplikasi perubahan). Untuk hasil yang lebih perlahan, lebih tepat, gunakan fail().
Corak tanpa jenis eksplisit seperti glob: dijangka relatif kepada
direktori semasa dan padankan dengan fail tepat untuk kecekapan.
Jika beberapa linkrev menunjuk kepada semakan yang ditapis oleh tinjauan semula semasa, kami akan berusaha
di sekelilingnya untuk mengembalikan nilai yang tidak ditapis.
pertama (set, [n])
Alias untuk had().
ikut([corak])
Alias untuk ::. (nenek moyang ibu bapa pertama direktori kerja). Jika corak
ditentukan, sejarah fail yang sepadan dengan corak yang diberikan diikuti, termasuk
salinan.
grep(regex)
suka kata kunci(rentetan) tetapi menerima regex. guna grep(r'...') untuk memastikan pelarian khas
aksara dikendalikan dengan betul. Tidak seperti kata kunci(rentetan), perlawanannya ialah
sensitif huruf besar-besaran.
kepala()
Changeset ialah ketua cawangan bernama.
kepala (set)
Ahli set tanpa anak dalam set.
tersembunyi()
Set perubahan tersembunyi.
id(rentetan)
Semakan tidak dinyatakan secara jelas oleh awalan rentetan hex yang diberikan.
kata kunci(rentetan)
Mesej komit carian, nama pengguna dan nama fail yang diubah untuk rentetan. Perlawanan itu
adalah tidak peka huruf besar-besaran.
terakhir (set, [n])
n ahli terakhir set, lalai kepada 1.
had (set [, n[, mengimbangi]])
n ahli set pertama, lalai kepada 1, bermula dari offset.
padanan (semakan [, medan])
Set perubahan di mana set medan tertentu sepadan dengan set medan dalam yang dipilih
semakan atau ditetapkan.
Untuk memadankan lebih daripada satu medan lulus senarai medan untuk dipadankan dipisahkan oleh ruang
(contohnya pengarang Penerangan).
Medan yang sah ialah kebanyakan medan semakan biasa dan beberapa medan khas.
Medan semakan biasa ialah Penerangan, pengarang, cawangan, tarikh, fail, fasa,
ibu bapa, substate, pengguna and diff. Perhatikan bahawa pengarang and pengguna adalah sinonim. diff
merujuk kepada kandungan semakan. Dua semakan yang sepadan dengan mereka diff juga akan
sepadan dengan mereka fail.
Bidang khas ialah ringkasan and metadata: ringkasan sepadan dengan baris pertama
keterangan. metadata adalah setara dengan padanan Penerangan pengguna tarikh (iaitu
sepadan dengan medan metadata utama).
metadata ialah medan lalai yang digunakan apabila tiada medan dinyatakan. Awak boleh
padankan lebih daripada satu bidang pada satu masa.
maks (set)
Set perubahan dengan nombor semakan tertinggi dalam set.
menggabungkan ()
Changeset ialah gabungan changeset.
min (set)
Set perubahan dengan nombor semakan terendah dalam set.
mengubah suai (corak)
Changesets mengubah suai fail dipadankan dengan corak.
Corak tanpa jenis eksplisit seperti glob: dijangka relatif kepada
direktori semasa dan padankan dengan fail atau direktori.
bernama(ruang nama)
Set perubahan dalam ruang nama yang diberikan.
If ruang nama bermula dengan semula:, baki rentetan dianggap sebagai rentetan biasa
ungkapan. Untuk memadankan ruang nama yang sebenarnya bermula dengan semula:, gunakan awalan
literal:.
usang()
Set perubahan boleh ubah dengan versi yang lebih baharu.
sahaja (set, [set])
Set perubahan yang merupakan nenek moyang set pertama yang bukan nenek moyang yang lain
kepala dalam repo. Jika set kedua ditentukan, hasilnya ialah nenek moyang
set pertama yang bukan nenek moyang set kedua (iaitu :: - :: ).
asal ([set])
Set perubahan yang dinyatakan sebagai sumber untuk cantuman, pemindahan atau pangkalan semula
yang mencipta semakan yang diberikan. Mengeluarkan set pilihan adalah sama seperti lulus
semua(). Jika set perubahan yang dibuat oleh operasi ini sendiri ditentukan sebagai sumber
untuk salah satu operasi ini, hanya set perubahan sumber untuk operasi pertama ialah
dipilih.
keluar([laluan])
Set perubahan tidak ditemui dalam repositori destinasi yang ditentukan, atau tolak lalai
lokasi.
p1([set])
Induk pertama set perubahan dalam set, atau direktori kerja.
p2([set])
Induk kedua bagi set perubahan dalam set, atau direktori kerja.
ibu bapa([set])
Set semua ibu bapa untuk semua set perubahan dalam set, atau direktori kerja.
hadir (set)
Set kosong, jika sebarang semakan dalam set tidak ditemui; jika tidak, semua semakan dalam set.
Jika mana-mana semakan yang ditentukan tidak terdapat dalam repositori tempatan, pertanyaannya adalah
biasanya digugurkan. Tetapi predikat ini membolehkan pertanyaan diteruskan walaupun dalam keadaan sedemikian
Kes.
awam()
Perubahan dalam fasa awam.
jauh ([id [,laluan]])
Semakan tempatan yang sepadan dengan pengecam yang diberikan dalam repositori jauh, jika
hadir. Di sini, '.' pengecam ialah sinonim untuk cawangan tempatan semasa.
menghilangkan (corak)
Set perubahan yang mengalih keluar corak padanan fail.
Corak tanpa jenis eksplisit seperti glob: dijangka relatif kepada
direktori semasa dan padankan dengan fail atau direktori.
rev(nombor)
Semakan dengan pengecam berangka yang diberikan.
terbalik (set)
susunan terbalik set.
akar (set)
Set perubahan dalam set tanpa set perubahan ibu bapa dalam set.
rahsia()
Perubahan dalam fasa rahsia.
jenis (set [, [-]kunci...])
Isih ditetapkan mengikut kekunci. Susunan isihan lalai adalah menaik, tentukan kunci sebagai -kunci kepada
susun mengikut tertib menurun.
Kuncinya boleh:
· rev untuk nombor semakan,
· cawangan untuk nama cawangan,
· menurun untuk mesej komit (huraian),
· pengguna untuk nama pengguna (pengarang boleh digunakan sebagai alias),
· tarikh untuk tarikh komit
subrepo([corak])
Set perubahan yang menambah, mengubah suai atau mengalih keluar subrepo yang diberikan. Jika tiada corak subrepo adalah
dinamakan, sebarang perubahan subrepo dikembalikan.
tag ([nama])
Teg yang ditentukan mengikut nama, atau semua semakan yang ditag jika tiada nama diberikan.
If nama bermula dengan semula:, selebihnya nama dianggap sebagai biasa
ungkapan. Untuk memadankan teg yang sebenarnya bermula dengan semula:, gunakan awalan literal:.
tidak stabil()
Perubahan yang tidak lapuk dengan nenek moyang yang usang.
pengguna(rentetan)
Nama pengguna mengandungi rentetan. Perlawanan adalah tidak peka huruf besar-besaran.
If rentetan bermula dengan semula:, baki rentetan dianggap sebagai rentetan biasa
ungkapan. Untuk memadankan pengguna yang sebenarnya mengandungi semula:, gunakan awalan literal:.
Predikat baharu (dikenali sebagai "alias") boleh ditakrifkan, menggunakan sebarang kombinasi sedia ada
predikat atau alias lain. Takrif alias kelihatan seperti:
=
dalam revsetalias bahagian fail konfigurasi Mercurial. Hujah bentuk $1,
$2, dsb. digantikan daripada alias ke dalam takrifan.
Sebagai contoh,
[revsetalias]
h = kepala()
d($1) = sort($1, tarikh)
rs($1, $2) = terbalik(sort($1, $2))
mentakrifkan tiga alias, h, d, dan rs. rs(0:tip, pengarang) betul-betul setara dengan
terbalik(sort(0:tip, pengarang)).
Operator infiks ## boleh menggabungkan rentetan dan pengecam menjadi satu rentetan. Sebagai contoh:
[revsetalias]
issue($1) = grep(r'\bissue[ :]?' ## $1 ## r'\b|\bbug\(' ## $1 ## r'\)')
isu(1234) adalah bersamaan dengan grep(r'\bissue[ :]?1234\b|\bbug\(1234\)') dalam kes ini. ini
sepadan dengan semua "isu 1234", "isu:1234", "isu1234" dan "pepijat(1234) ".
Semua operator awalan, infiks dan postfix lain mempunyai keutamaan yang lebih rendah daripada ##. Sebagai contoh, $1
## $ 2 ~ 2 adalah bersamaan dengan ($ 1 ## $2)~2.
Setara baris perintah untuk hg log:
-f -> ::.
-dx -> tarikh(x)
-kx -> kata kunci(x)
-m -> merge()
-ux -> pengguna(x)
-bx -> cawangan(x)
-P x -> !::x
-lx -> had(expr, x)
Beberapa contoh pertanyaan:
· Changesets pada cawangan lalai:
hg log -r "cawangan(lalai)"
· Set perubahan pada cawangan lalai sejak teg 1.5 (tidak termasuk cantuman):
hg log -r "cawangan(lalai) dan 1.5:: dan bukan merge()"
· Ketua cawangan terbuka:
hg log -r "head() dan tidak ditutup()"
· Set perubahan antara teg 1.3 dan 1.5 menyebut "pepijat" yang mempengaruhi hgext/*:
hg log -r "1.3::1.5 dan kata kunci(pepijat) dan fail('hgext/*')"
· Set perubahan dilakukan pada Mei 2008, diisih mengikut pengguna:
hg log -r "sort(date('Mei 2008'), pengguna)"
· Set perubahan yang menyebut "pepijat" atau "isu" yang tiada dalam keluaran berteg:
hg log -r "(kata kunci(pepijat) atau kata kunci(isu)) dan bukan nenek moyang(tag())"
MENGGUNAKAN MERCURIAL DARIPADA SKRIP DAN AUTOMATION
Ia adalah perkara biasa bagi mesin (berbanding dengan manusia) untuk menggunakan Mercurial. Topik bantuan ini
menerangkan beberapa pertimbangan untuk antara muka mesin dengan Mercurial.
Memilih an Antara muka
Mesin mempunyai pilihan beberapa kaedah untuk antara muka dengan Mercurial. Ini termasuk:
· Melaksanakan hg proses
· Menyoal pelayan HTTP
· Memanggil ke pelayan arahan
Melaksanakan hg proses sangat serupa dengan cara manusia berinteraksi dengan Mercurial dalam cangkerang.
Ia sepatutnya sudah biasa kepada anda.
hg berkhidmat boleh digunakan untuk memulakan pelayan. Secara lalai, ini akan memulakan pelayan HTTP "hgweb".
Pelayan HTTP ini mempunyai sokongan untuk output yang boleh dibaca mesin, seperti JSON. Untuk lebih lanjut, lihat hg
membantu hgweb.
hg berkhidmat juga boleh memulakan "pelayan arahan." Pelanggan boleh menyambung ke pelayan dan isu ini
Perintah Mercurial melalui protokol khas. Untuk butiran lanjut tentang pelayan arahan,
termasuk pautan ke perpustakaan pelanggan, lihat https://mercurial.selenic.com/wiki/CommandServer.
hg berkhidmat antara muka berasaskan (hgweb dan pelayan arahan) mempunyai kelebihan berbanding mudah
hg proses invokasi kerana ia mungkin lebih cekap. Ini kerana ada
overhed yang ketara untuk menghasilkan proses Python baharu.
Petua Jika anda perlu menggunakan beberapa hg proses dalam urutan pendek dan/atau prestasi adalah
penting kepada anda, penggunaan antara muka berasaskan pelayan amat disyorkan.
alam Sekitar Pembolehubah
Seperti yang didokumenkan dalam hg membantu persekitaran, pelbagai pembolehubah persekitaran mempengaruhi
operasi Mercurial. Perkara berikut amat relevan untuk penggunaan mesin
Mercurial:
HGPLAIN
Jika tidak ditetapkan, output Mercurial boleh dipengaruhi oleh tetapan konfigurasi yang
memberi kesan pengekodannya, mod verbose, penyetempatan, dsb.
Adalah sangat disyorkan untuk mesin menetapkan pembolehubah ini semasa memanggil hg
proses.
HGENCODING
Jika tidak ditetapkan, tempat yang digunakan oleh Mercurial akan dikesan dari persekitaran. Jika
tempat yang ditentukan tidak menyokong paparan aksara tertentu, Mercurial mungkin
menjadikan urutan aksara ini secara salah (selalunya dengan menggunakan "?" sebagai pemegang tempat
untuk aksara tidak sah dalam tempat semasa).
Menetapkan pembolehubah persekitaran ini secara eksplisit adalah amalan yang baik untuk dijamin
hasil yang konsisten. "utf-8" ialah pilihan yang baik pada persekitaran seperti UNIX.
HGRCPATH
Jika tidak ditetapkan, Mercurial akan mewarisi pilihan konfigurasi daripada fail konfigurasi menggunakan
proses yang diterangkan dalam hg membantu config. Ini termasuk mewarisi pengguna atau seluruh sistem
fail konfigurasi.
Apabila kawalan sepenuhnya ke atas konfigurasi Mercurial dikehendaki, nilai bagi
HGRCPATH boleh ditetapkan kepada fail eksplisit dengan konfigurasi baik yang diketahui. Dalam kes yang jarang berlaku,
nilai boleh ditetapkan kepada fail kosong atau peranti nol (selalunya / dev / null) untuk memintas
memuatkan mana-mana fail konfigurasi pengguna atau sistem. Ambil perhatian bahawa pendekatan ini boleh mempunyai
akibat yang tidak diingini, kerana pengguna dan fail konfigurasi sistem sering menentukan sesuatu
seperti nama pengguna dan sambungan yang mungkin diperlukan untuk antara muka dengan a
repositori.
Pengambilan Perintah Output
Ia adalah perkara biasa untuk mesin perlu menghuraikan output arahan Mercurial untuk yang berkaitan
data. Bahagian ini menerangkan pelbagai teknik untuk melakukannya.
Parsing Raw Perintah Output
Kemungkinan penyelesaian yang paling mudah dan paling berkesan untuk menggunakan output arahan adalah dengan mudah
sembah hg arahan seperti yang anda lakukan sebagai pengguna dan menghuraikan outputnya.
Output daripada banyak arahan boleh dihuraikan dengan mudah dengan alat seperti grep, sed, dan awk.
Kelemahan yang berpotensi dengan output arahan parsing ialah output arahan boleh berubah
apabila Mercurial dinaik taraf. Walaupun Mercurial secara amnya berusaha untuk kuat ke belakang
keserasian, output arahan kadangkala berubah. Mempunyai ujian untuk automatik anda
interaksi dengan hg arahan biasanya disyorkan, tetapi lebih penting lagi apabila
penghuraian output arahan mentah terlibat.
Menggunakan Templates kepada Mengawal Output
banyak hg arahan menyokong output templat melalui -T/--templat hujah. Untuk lebih lanjut, lihat
hg membantu template.
Templat berguna untuk mengawal output secara eksplisit supaya anda mendapat data dengan tepat
anda mahu diformatkan mengikut kehendak anda. Sebagai contoh, log -T {nod}\n boleh digunakan untuk mencetak a
senarai nod set perubahan yang dibatasi baris baharu dan bukannya keluaran khusus manusia yang mengandungi
pengarang, tarikh, penerangan, dsb.
Petua Jika menghuraikan output arahan mentah terlalu rumit, pertimbangkan untuk menggunakan templat untuk dibuat
hidup anda lebih mudah.
. -T/--templat hujah membenarkan menentukan gaya yang telah ditetapkan. Kapal Mercurial dengan
gaya boleh dibaca mesin json and xml, yang menyediakan output JSON dan XML, masing-masing.
Ini berguna untuk menghasilkan output yang boleh dibaca mesin apa adanya.
penting
. json and xml gaya dianggap eksperimen. Walaupun mereka mungkin menarik
untuk digunakan untuk mendapatkan output yang boleh dibaca mesin dengan mudah, tingkah laku mereka mungkin berubah
versi seterusnya.
Gaya ini juga mungkin mempamerkan hasil yang tidak dijangka apabila menangani perkara tertentu
pengekodan. Mercurial memperlakukan perkara seperti nama fail sebagai satu siri bait dan
menormalkan urutan bait tertentu kepada JSON atau XML dengan tetapan pengekodan tertentu
boleh membawa kepada kejutan.
Perintah Server Output
Jika menggunakan pelayan arahan untuk berinteraksi dengan Mercurial, anda mungkin menggunakan pelayan sedia ada
perpustakaan/API yang mengabstraksi butiran pelaksanaan pelayan arahan. Jika ya, ini
lapisan antara muka mungkin melakukan penghuraian untuk anda, menjimatkan kerja anda melaksanakannya
diri sendiri.
Output Kata Kerja
Perintah selalunya mempunyai verbositi keluaran yang berbeza-beza, walaupun semasa gaya yang boleh dibaca mesin sedang dijalankan
digunakan (cth -T json). Menambah -v/--verbose and --nyahpepijat kepada hujah perintah boleh
meningkatkan jumlah data yang didedahkan oleh Mercurial.
Cara alternatif untuk mendapatkan data yang anda perlukan adalah dengan menyatakan templat secara eksplisit.
lain-lain Topik
set semula
Set semakan ialah bahasa pertanyaan berfungsi untuk memilih set semakan.
Fikirkannya sebagai SQL untuk repositori Mercurial. Resets berguna untuk membuat pertanyaan
repositori untuk data tertentu.
Lihat hg membantu set semula untuk lebih.
saham lanjutan
. saham sambungan menyediakan fungsi untuk berkongsi data repositori merentas
beberapa salinan kerja. Ia juga secara automatik boleh "mengumpulkan" storan secara logik
repositori berkaitan semasa pengklonan.
Mengkonfigurasi saham sambungan boleh membawa kepada penggunaan sumber yang ketara
pengurangan, terutamanya di sekitar ruang cakera dan rangkaian. Ini adalah benar terutamanya
untuk persekitaran integrasi berterusan (CI).
Lihat hg membantu -e saham untuk lebih.
SUBREPOSITORI
Subrepositori membolehkan anda menyusun repositori atau projek luaran ke dalam Mercurial induk
repositori, dan membuat arahan beroperasi pada mereka sebagai satu kumpulan.
Mercurial kini menyokong subrepositori Mercurial, Git dan Subversion.
Subrepositori diperbuat daripada tiga komponen:
1. Pembayaran repositori bersarang. Mereka boleh muncul di mana-mana dalam direktori kerja induk.
2. Rujukan repositori bersarang. Mereka ditakrifkan dalam .hgsub, yang sepatutnya diletakkan di dalam
akar direktori kerja, dan beritahu dari mana pembayaran subrepositori berasal.
Subrepositori merkuri dirujuk seperti:
path/to/nested = https://example.com/nested/repo/path
Subrepos Git dan Subversion juga disokong:
path/to/nested = [git]git://example.com/nested/repo/path
path/to/nested = [svn]https://example.com/nested/trunk/path
di mana laluan/ke/bersarang ialah lokasi pembayaran relatif kepada akar Mercurial induk,
and https://example.com/nested/repo/path ialah laluan repositori sumber. Sumber boleh
juga merujuk laluan sistem fail.
Perhatikan bahawa .hgsub tidak wujud secara lalai dalam repositori Mercurial, anda perlu
buat dan tambahkannya ke repositori induk sebelum menggunakan subrepositori.
3. Keadaan repositori bersarang. Mereka ditakrifkan dalam .hgsubstate, yang diletakkan di dalam akar
direktori kerja, dan menangkap apa sahaja maklumat yang diperlukan untuk memulihkan
subrepositori kepada keadaan yang mereka lakukan dalam set perubahan repositori induk.
Mercurial secara automatik merekodkan keadaan repositori bersarang apabila melakukan dalam
repositori induk.
Nota
. .hgsubstate fail tidak boleh diedit secara manual.
Menambah a Subrepositori
If .hgsub tidak wujud, buat dan tambahkannya ke repositori induk. Klon atau pembayaran
projek luaran di mana anda mahu ia tinggal dalam repositori induk. Sunting .hgsub and
tambahkan entri subrepositori seperti yang diterangkan di atas. Pada ketika ini, subrepositori ialah
dikesan dan komit seterusnya akan merekodkan keadaannya dalam .hgsubstate dan mengikatnya pada
set perubahan yang komited.
Menyegerakkan a Subrepositori
Subrepos tidak menjejak set perubahan terkini sumbernya secara automatik. Sebaliknya, mereka
dikemas kini kepada set perubahan yang sepadan dengan set perubahan yang diperiksa dalam
set perubahan peringkat atas. Ini adalah supaya pembangun sentiasa mendapat set kod serasi yang konsisten
dan perpustakaan apabila mereka mengemas kini.
Oleh itu, mengemas kini subrepos adalah proses manual. Hanya semak subrepo sasaran di
semakan yang dikehendaki, uji dalam repo peringkat atas, kemudian lakukan dalam repositori induk ke
merekodkan gabungan baharu.
memotong a Subrepositori
Untuk mengalih keluar subrepositori daripada repositori induk, padamkan rujukannya daripada .hgsub,
kemudian keluarkan failnya.
Interaksi bersama Mercurial arahan
menambah add tidak berulang dalam subrepos melainkan -S/--subrepos ditentukan. Namun, jika
anda menentukan laluan penuh fail dalam subrepo, ia akan ditambah walaupun tanpa
-S/--subrepos ditentukan. Subrepositori subversi pada masa ini secara senyap
diabaikan.
addremove
addremove tidak berulang ke subrepos melainkan -S/--subrepos ditentukan.
Walau bagaimanapun, jika anda menentukan laluan penuh direktori dalam subrepo, addremove akan
dilakukan padanya walaupun tanpa -S/--subrepos ditentukan. Git dan Subversion
subrepositori akan mencetak amaran dan meneruskan.
arkib
arkib tidak berulang dalam subrepositori melainkan -S/--subrepos ditentukan.
kucing cat pada masa ini hanya mengendalikan padanan fail tepat dalam subrepos. Subversion
subrepositori pada masa ini diabaikan.
melakukan commit mencipta gambaran yang konsisten tentang keadaan keseluruhan projek dan projeknya
subrepositori. Jika mana-mana subrepositori telah diubah suai, Mercurial akan membatalkannya.
Mercurial boleh dibuat untuk mengkomit semua subrepositori yang diubah suai dengan menentukan
-S/--subrepos, atau tetapkan "ui.commitsubrepos=True" dalam fail konfigurasi (lihat hg
membantu config). Selepas tiada lagi subrepositori yang diubah suai, ia merekodkan
keadaan mereka dan akhirnya melakukannya dalam repositori induk. --addremove
pilihan juga menghormati pilihan -S/--subrepos. Walau bagaimanapun, Git dan Subversion
subrepositori akan mencetak amaran dan membatalkan.
diff diff tidak berulang dalam subrepos melainkan -S/--subrepos ditentukan. Perubahan adalah
dipaparkan seperti biasa, pada elemen subrepositori. Subrepositori subversi ialah
pada masa ini diabaikan secara senyap.
fail fail tidak berulang menjadi subrepos melainkan -S/--subrepos ditentukan. Walau bagaimanapun,
jika anda menentukan laluan penuh fail atau direktori dalam subrepo, ia akan menjadi
dipaparkan walaupun tanpa -S/--subrepos ditentukan. Git dan Subversion
subrepositori kini diabaikan secara senyap.
lupa lupa pada masa ini hanya mengendalikan padanan fail tepat dalam subrepos. Git dan Subversion
subrepositori kini diabaikan secara senyap.
masuk
masuk tidak berulang dalam subrepos melainkan -S/--subrepos ditentukan. Git dan
Subrepositori subversi pada masa ini diabaikan secara senyap.
keluar
keluar tidak berulang dalam subrepos melainkan -S/--subrepos ditentukan. Git dan
Subrepositori subversi pada masa ini diabaikan secara senyap.
tarik tarik tidak rekursif kerana tidak jelas apa yang perlu ditarik sebelum berlari hg maklumat
. Menyenaraikan dan mendapatkan semula semua perubahan subrepositori yang dirujuk oleh induk
set perubahan yang ditarik repositori adalah mahal, mustahil dalam Subversion
kes.
menolak Mercurial secara automatik akan menolak semua subrepositori terlebih dahulu apabila induk
repositori sedang ditolak. Ini memastikan perubahan subrepositori baharu tersedia
apabila dirujuk oleh repositori peringkat atasan. Tolak ialah larangan untuk Subversion
subrepositori.
terkini status tidak berulang ke dalam subrepositori melainkan -S/--subreposit ditentukan.
Perubahan subrepositori dipaparkan sebagai perubahan Mercurial biasa pada
elemen subrepositori. Subrepositori subversi pada masa ini diabaikan secara senyap.
mengeluarkan remove tidak berulang ke dalam subrepositori melainkan -S/--subrepos ditentukan.
Walau bagaimanapun, jika anda menentukan fail atau laluan direktori dalam subrepo, ia akan dialih keluar
walaupun tanpa -S/--subrepos. Subrepositori Git dan Subversion pada masa ini
diam tak diendahkan.
maklumat kemas kini memulihkan subrepos dalam keadaan asalnya dilakukan dalam sasaran
set perubahan. Jika set perubahan yang direkodkan tidak tersedia dalam subrepositori semasa,
Mercurial akan menariknya terlebih dahulu sebelum mengemas kini. Ini bermakna mengemas kini boleh
memerlukan akses rangkaian apabila menggunakan subrepositori.
Mengetam semula Subrepositori Sumber
Lokasi sumber subrepositori mungkin berubah semasa hayat projek, menjadikan rujukan tidak sah
disimpan dalam sejarah repositori induk. Untuk membetulkannya, peraturan penulisan semula boleh ditakrifkan dalam
repositori induk hgrc fail atau dalam konfigurasi Mercurial. Lihat [subpath] bahagian dalam
hgrc(5) untuk maklumat lanjut.
TEMPLAT PENGGUNAAN
Mercurial membolehkan anda menyesuaikan output arahan melalui templat. Anda boleh sama ada
lulus dalam templat atau pilih gaya templat sedia ada daripada baris arahan, melalui
--pilihan templat.
Anda boleh menyesuaikan output untuk sebarang arahan "seperti log": log, keluar, masuk, tip,
ibu bapa, dan ketua.
Beberapa gaya terbina dalam dibungkus dengan Mercurial. Ini boleh disenaraikan dengan hg log
--template senarai. Contoh penggunaan:
$ hg log -r1.0::1.1 --template changelog
Templat ialah sekeping teks, dengan markup untuk menggunakan pengembangan pembolehubah:
$ hg log -r1 --template "{nod}\n"
b56ce7b07c52de7d5fd79fb89701ea538af65746
Rentetan dalam pendakap kerinting dipanggil kata kunci. Ketersediaan kata kunci bergantung pada
konteks tepat templater. Kata kunci ini biasanya tersedia untuk templat a
arahan seperti log:
penanda buku aktif
Tali. Penanda halaman aktif, jika ia dikaitkan dengan set perubahan
pengarang Tali. Pengarang set perubahan yang tidak diubah suai.
dua belah Tali. Status pembahagian dua set perubahan.
penanda buku
Senarai rentetan. Sebarang penanda halaman yang dikaitkan dengan set perubahan. Juga menetapkan 'aktif',
nama penanda halaman yang aktif.
cawangan Tali. Nama cawangan di mana set perubahan dilakukan.
perubahansejaklatesttag
Integer. Semua nenek moyang tiada dalam tag terkini.
kanak-kanak
Senarai rentetan. Anak-anak perubahan.
tarikh Maklumat tarikh. Tarikh apabila set perubahan dilakukan.
menurun Tali. Teks perihalan set perubahan.
perbezaan
Tali. Statistik perubahan dengan format berikut: "fail yang diubah suai:
+tambah/-garisan dialih keluar"
tambahan Senarai dict dengan kunci, entri nilai medan 'tambahan' set perubahan ini.
fail_tambah
Senarai rentetan. Fail ditambah oleh set perubahan ini.
fail_salinan
Senarai rentetan. Fail yang disalin dalam set perubahan ini dengan sumbernya.
suis_salinan_fail
Senarai rentetan. Seperti "file_copies" tetapi dipaparkan hanya jika suis --copyed adalah
ditetapkan.
file_dels
Senarai rentetan. Fail dialih keluar oleh set perubahan ini.
mod_fail
Senarai rentetan. Fail diubah suai oleh set perubahan ini.
fail Senarai rentetan. Semua fail diubah suai, ditambah atau dialih keluar oleh set perubahan ini.
grafnod
Tali. Watak yang mewakili nod set perubahan dalam graf semakan ASCII
latesttag
Senarai rentetan. Teg global pada nenek moyang yang ditag secara global terkini
set perubahan ini.
jarak jarak terkini
Integer. Laluan terpanjang ke teg terkini.
ruang nama
Dict senarai. Nama yang dilampirkan pada set perubahan ini bagi setiap ruang nama.
nod Tali. Cincang pengenalan set perubahan, sebagai rentetan 40 digit heksadesimal.
p1nod Tali. Cincang pengenalan induk pertama set perubahan, sebagai 40 digit
rentetan heksadesimal. Jika set perubahan tidak mempunyai ibu bapa, semua digit ialah 0.
p1rev Integer. Nombor semakan repositori setempat induk pertama set perubahan, atau
-1 jika set perubahan tidak mempunyai ibu bapa.
p2nod Tali. Cincang pengenalpastian induk kedua set perubahan, sebagai 40 digit
rentetan heksadesimal. Jika set perubahan tidak mempunyai induk kedua, semua digit ialah 0.
p2rev Integer. Nombor semakan repositori-tempatan bagi induk kedua set perubahan, atau
-1 jika set perubahan tidak mempunyai induk kedua.
ibu bapa
Senarai rentetan. Ibu bapa set perubahan dalam format "rev:node". Sekiranya
changeset hanya mempunyai satu induk "semulajadi" (semakan pendahulu) tiada apa-apa
ditunjukkan.
fasa Tali. Nama fasa set perubahan.
phaseidx
Integer. Indeks fasa set perubahan.
rev Integer. Nombor semakan set perubahan repositori setempat.
subrepos
Senarai rentetan. Subrepositori dikemas kini dalam set perubahan.
tags Senarai rentetan. Sebarang teg yang dikaitkan dengan set perubahan.
Kata kunci "tarikh" tidak menghasilkan output yang boleh dibaca manusia. Jika anda ingin menggunakan tarikh dalam
output anda, anda boleh menggunakan penapis untuk memprosesnya. Penapis ialah fungsi yang mengembalikan a
rentetan berdasarkan pembolehubah input. Pastikan anda menggunakan penapis stringify terlebih dahulu apabila anda melakukannya
menggunakan penapis input rentetan pada pembolehubah input seperti senarai. Anda juga boleh menggunakan rantaian
penapis untuk mendapatkan output yang dikehendaki:
$ hg tip --template "{tarikh|isodate}\n"
2008-08-21 18:22 +0000
Senarai penapis:
addbreaks
Sebarang teks. Tambah XHTML " " teg sebelum penghujung setiap baris kecuali yang terakhir.
umur Tarikh. Mengembalikan perbezaan tarikh/masa yang boleh dibaca manusia antara tarikh/masa yang diberikan dan
tarikh/masa semasa.
nama asas
Sebarang teks. Melayan teks sebagai laluan, dan mengembalikan komponen terakhir laluan
selepas dibelah oleh pemisah laluan (mengabaikan pemisah mengekor). Sebagai contoh,
"foo/bar/baz" menjadi "baz" dan "foo/bar//" menjadi "bar".
mengira Senarai atau teks. Mengembalikan panjang sebagai integer.
domain Sebarang teks. Cari rentetan pertama yang kelihatan seperti alamat e-mel dan ekstrak
hanya komponen domain. Contoh: pengguna <[e-mel dilindungi]> menjadi example.com.
e-mel Sebarang teks. Mengekstrak rentetan pertama yang kelihatan seperti alamat e-mel. Contoh: pengguna
<[e-mel dilindungi]> menjadi [e-mel dilindungi].
pengguna e-mel
Sebarang teks. Mengembalikan bahagian pengguna alamat e-mel.
melarikan diri Sebarang teks. Menggantikan aksara XML/XHTML khas "&", "<" dan ">" dengan XML
entiti, dan menapis aksara NUL.
isi68 Sebarang teks. Membungkus teks agar muat dalam 68 lajur.
isi76 Sebarang teks. Membungkus teks agar muat dalam 76 lajur.
Barisan pertama
Sebarang teks. Mengembalikan baris pertama teks.
heks Sebarang teks. Tukar pengecam nod Mercurial binari kepada perenambelasan panjangnya
perwakilan.
hgdate Tarikh. Mengembalikan tarikh sebagai pasangan nombor: "1157407993 25200" (cap waktu Unix,
zon waktu mengimbangi).
pengasingan
Tarikh. Mengembalikan tarikh dalam format ISO 8601: "2009-08-18 13:00 +0200".
isodatesec
Tarikh. Mengembalikan tarikh dalam format ISO 8601, termasuk saat: "2009-08-18 13:00:13
+0200". Lihat juga penapis tarikh rfc3339.
yang lebih rendah Sebarang teks. Menukar teks kepada huruf kecil.
kosong
Sebarang teks. Mengembalikan '(tiada)' jika rentetan kosong.
kabur
Sebarang teks. Mengembalikan teks input yang diberikan sebagai jujukan entiti XML.
orang Sebarang teks. Mengembalikan nama sebelum alamat e-mel, mentafsirkannya mengikut RFC
5322.
revescape
Sebarang teks. Melarikan diri daripada semua aksara "istimewa", kecuali @. Tebasan ke hadapan dilepaskan
dua kali untuk menghalang pelayan web daripada melepaskannya sebelum masanya. Contohnya, "@foo
bar/baz" menjadi "@foo%20bar%252Fbaz".
rfc3339tarikh
Tarikh. Mengembalikan tarikh menggunakan format tarikh Internet yang dinyatakan dalam RFC 3339:
"2009-08-18T13:00:13+02:00".
rfc822tarikh
Tarikh. Mengembalikan tarikh menggunakan format yang sama yang digunakan dalam pengepala e-mel: "Selasa, 18 Ogos 2009
13:00:13 +0200".
pendek Ubah cincang. Mengembalikan bentuk pendek cincang set perubahan, iaitu 12 perenambelasan
rentetan digit.
shortbisect
Sebarang teks. merawat teks sebagai status pembahagian dua, dan mengembalikan satu aksara
mewakili status (G: baik, B: buruk, S: dilangkau, U: belum diuji, I: diabaikan).
Mengembalikan ruang tunggal jika teks bukan status belah dua yang sah.
tarikh pendek
Tarikh. Mengembalikan tarikh seperti "2006-09-18".
garis berpecah
Sebarang teks. Pisahkan teks kepada senarai baris.
bersungguh-sungguh
Apa-apa jenis. Menukar nilai kepada teks dengan menukar nilai kepada teks dan
menggabungkan mereka.
stripdir
Anggap teks sebagai laluan dan tanggalkan tahap direktori, jika boleh. Contohnya, "foo"
dan "foo/bar" menjadi "foo".
penanda
Sebarang teks. Mengembalikan teks, dengan setiap baris yang tidak kosong kecuali permulaan pertama
dengan watak tab.
atas Sebarang teks. Menukar teks kepada huruf besar.
urlescape
Sebarang teks. Melarikan diri dari semua watak "istimewa". Sebagai contoh, "foo bar" menjadi
"foo%20bar".
pengguna Sebarang teks. Mengembalikan perwakilan ringkas nama pengguna atau alamat e-mel.
Ambil perhatian bahawa penapis tidak lebih daripada panggilan fungsi, iaitu expr|penapis adalah setaraf
kepada penapis(expr).
Selain penapis, terdapat beberapa fungsi terbina dalam asas:
tarikh(tarikh[, fmt])
Format tarikh. Lihat hg membantu tarikh untuk memformat rentetan. Lalai ialah tarikh Unix
format, termasuk zon waktu: "Isn Sep 04 15:13:13 2006 0700".
diff([includepattern [, tidak termasuk corak]])
Tunjukkan perbezaan, secara pilihan menentukan fail untuk disertakan atau dikecualikan.
isi(teks[, lebar [, pengenalan awal [, tergantung]]])
Isi banyak perenggan dengan lekukan pilihan. Lihat penapis "isi".
dapatkan (dikt, kunci)
Dapatkan atribut/kunci daripada objek. Sesetengah kata kunci adalah jenis yang kompleks. Fungsi ini
membolehkan anda mendapatkan nilai atribut pada jenis ini.
jika (expr, kemudian[, lain])
Laksanakan secara bersyarat berdasarkan hasil ungkapan.
jika mengandungi(carian, perkara, kemudian[, lain])
Laksanakan secara bersyarat berdasarkan sama ada item "carian" berada dalam "benda".
ifeq(expr1, expr2, kemudian[, lain])
Laksanakan secara bersyarat berdasarkan sama ada 2 item adalah setara.
inden (teks, indentchars[, Barisan pertama])
Mengesot semua baris bukan kosong dengan aksara yang diberikan dalam rentetan indentchars. An
parameter ketiga pilihan akan mengatasi inden untuk baris pertama hanya jika
Sekarang.
sertai(senarai, sep)
Sertai item dalam senarai dengan pembatas.
label (label, expr)
Gunakan label pada kandungan yang dijana. Kandungan dengan label yang digunakan boleh mengakibatkan
pemprosesan pasca tambahan, seperti pewarnaan automatik.
latesttag([corak])
Teg global sepadan dengan corak yang diberikan pada teg global terkini
nenek moyang perubahan ini.
localdate(tarikh[, tz])
Menukar tarikh kepada zon waktu yang ditentukan. Lalai ialah tarikh tempatan.
pad (teks, lebar [, fillchar=' '[, right=False]])
Teks pad dengan aksara isian.
revset(pertanyaan[, formatargs...])
Laksanakan pertanyaan set semakan. Lihat hg membantu set semula.
rstdoc(teks, gaya)
Format ReStructuredText.
terpendek (nod, panjang min=4)
Dapatkan perwakilan terpendek bagi sesuatu nod.
bermula dengan(corak, teks)
Mengembalikan nilai daripada argumen "teks" jika ia bermula dengan kandungan daripada
hujah "corak".
jalur(teks[, aksara])
Keluarkan aksara daripada rentetan. Secara lalai, potong semua bahagian depan dan belakang
ruang kosong.
sub(corak, pengganti, ungkapan)
Lakukan penggantian teks menggunakan ungkapan biasa.
perkataan(nombor, teks [, pemisah])
Kembalikan perkataan ke-n daripada rentetan.
Juga, untuk sebarang ungkapan yang mengembalikan senarai, terdapat pengendali senarai:
expr % "{template}"
Seperti yang dilihat dalam contoh di atas, {template} ditafsirkan sebagai templat. Untuk mengelakkannya daripada
sedang ditafsirkan, anda boleh menggunakan watak melarikan diri \{ atau awalan rentetan mentah, r'...'.
Beberapa contoh templat baris arahan:
· Format senarai, cth fail:
$ hg log -r 0 --template "fail:\n{fail % ' {fail}\n'}"
· Sertai senarai fail dengan ", ":
$ hg log -r 0 --template "fail: {join(fail, ', ')}\n"
· Ubah suai setiap baris perihalan komit:
$ hg log --template "{splitlines(desc) % '**** {line}\n'}"
· Format tarikh:
$ hg log -r 0 --template "{tarikh(tarikh, '%Y')}\n"
· Tarikh paparan dalam UTC:
$ hg log -r 0 --template "{localdate(date, 'UTC')|date}\n"
· Output set perihalan kepada lebar isian 30:
$ hg log -r 0 --template "{fill(desc, 30)}"
· Gunakan bersyarat untuk menguji cawangan lalai:
$ hg log -r 0 --template "{ifeq(cawangan, 'lalai', 'pada cawangan utama',
'di cawangan {cawangan}')}\n"
· Tambahkan baris baharu jika tidak kosong:
$ hg tip --template "{if(author, '{author}\n')}"
· Labelkan output untuk digunakan dengan sambungan warna:
$ hg log -r 0 --template "{label('changeset.{phase}', nod|short)}\n"
· Terbalikkan penapis baris pertama, iaitu segala-galanya kecuali baris pertama:
$ hg log -r 0 --template "{sub(r'^.*\n?\n?', '', desc)}\n"
· Paparkan kandungan medan 'tambahan', satu setiap baris:
$ hg log -r 0 --template "{join(extras, '\n')}\n"
· Tandakan penanda halaman aktif dengan '*':
$ hg log --template "{bookmarks % '{bookmark}{ifeq(bookmark, active, '*')} '}\n"
· Cari teg calon keluaran sebelumnya, jarak dan perubahan sejak teg:
$ hg log -r . --template "{latesttag('re:^.*-rc$') % '{tag}, {changes}, {jarak}'}\n"
· Tandakan induk salinan yang berfungsi dengan '@':
$ hg log --template "{ifcontains(rev, revset('.'), '@')}\n"
· Tunjukkan butiran semakan ibu bapa:
$ hg log --template "{revset('parents(%d)', rev) % '{desc|firstline}\n'}"
· Tunjukkan hanya perihalan komit yang bermula dengan "templat":
$ hg log --template "{startswith('template', firstline(desc))}\n"
· Cetak perkataan pertama setiap baris mesej komit:
$ hg log --template "{word(0, desc)}\n"
URL LALUAN
URL yang sah adalah dalam bentuk:
local/filesystem/path[#revision]
file://local/filesystem/path[#revision]
http://[user[:pass]@]host[:port]/[path][#revision]
https://[user[:pass]@]host[:port]/[path][#revision]
ssh://[user@]host[:port]/[path][#revision]
Laluan dalam sistem fail tempatan boleh sama ada menunjuk ke repositori Mercurial atau ke bundle
fail (seperti yang dibuat oleh hg bundle or hg masuk --berikat). Lihat juga hg membantu laluan.
Pengecam pilihan selepas # menunjukkan cawangan, teg atau set perubahan tertentu untuk digunakan
daripada repositori jauh. Lihat juga hg membantu semakan.
Sesetengah ciri, seperti menolak ke http:// dan https:// URL hanya boleh dilakukan jika
ciri didayakan secara eksplisit pada pelayan Mercurial jauh.
Harap maklum bahawa keselamatan URL HTTPS bergantung pada konfigurasi web.cacerts yang betul.
Beberapa nota tentang menggunakan SSH dengan Mercurial:
· SSH memerlukan akaun shell yang boleh diakses pada mesin destinasi dan salinan hg in
laluan jauh atau ditentukan dengan sebagai remotecmd.
· laluan adalah relatif kepada direktori rumah pengguna jauh secara lalai. Gunakan garis miring tambahan pada
permulaan laluan untuk menentukan laluan mutlak:
ssh://example.com//tmp/repository
· Mercurial tidak menggunakan pemampatannya sendiri melalui SSH; perkara yang betul untuk dilakukan ialah mengkonfigurasi
di dalam anda ~ / .ssh / config, misalnya:
Hos *.mylocalnetwork.example.com
Nombor mampatan
Tuan rumah *
Mampatan ya
Secara alternatif, tentukan "ssh -C" sebagai arahan ssh anda dalam fail konfigurasi anda atau dengan
pilihan baris arahan --ssh.
Semua URL ini boleh disimpan dalam fail konfigurasi anda dengan alias laluan di bawah
bahagian [paths] seperti itu:
[laluan]
alias1 = URL1
alias2 = URL2
...
Anda kemudian boleh menggunakan alias untuk sebarang arahan yang menggunakan URL (contohnya hg tarik alias1
akan dilayan sebagai hg tarik URL1).
Dua alias laluan adalah istimewa kerana ia digunakan sebagai lalai apabila anda tidak menyediakan
URL kepada arahan:
lalai:
Apabila anda mencipta repositori dengan klon hg, arahan klon menyimpan lokasi bagi
repositori sumber sebagai laluan 'lalai' repositori baharu. Ini kemudian digunakan
apabila anda meninggalkan laluan daripada arahan seperti tolak dan tarik (termasuk arahan masuk dan
keluar).
tolak lalai:
Arahan tolak akan mencari laluan bernama 'default-push', dan lebih sukakannya
'default' jika kedua-duanya ditakrifkan.
PERLUASAN
Bahagian ini mengandungi bantuan untuk sambungan yang diedarkan bersama Mercurial.
Bantuan untuk sambungan lain tersedia dalam sistem bantuan.
acl
cangkuk untuk mengawal akses repositori
Cangkuk ini memungkinkan untuk membenarkan atau menafikan akses tulis kepada cawangan dan laluan yang diberikan a
repositori apabila menerima set perubahan masuk melalui pretxnchangegroup dan pretxncommit.
Keizinan dipadankan berdasarkan nama pengguna tempatan pada sistem tempat cangkuk
berjalan, dan bukan pemacu set perubahan asal (kerana yang terakhir hanyalah
bermaklumat).
Cangkuk acl paling baik digunakan bersama dengan cangkang terhad seperti hgsh, menghalang
mengesahkan pengguna daripada melakukan apa-apa selain daripada menolak atau menarik. cangkuk tidak
selamat untuk digunakan jika pengguna mempunyai akses shell interaktif, kerana mereka kemudiannya boleh melumpuhkan cangkuk. Nor
adakah selamat jika pengguna jauh berkongsi akaun, kerana tidak ada cara untuk membezakannya
Mereka.
Urutan semakan akses dilakukan ialah:
1. Tolak senarai untuk cawangan (bahagian acl.deny.cawangan)
2. Benarkan senarai untuk cawangan (bahagian acl.allow.cawangan)
3. Tolak senarai untuk laluan (bahagian acl.menafikan)
4. Benarkan senarai untuk laluan (bahagian acl.allow)
Bahagian benarkan dan tolak mengambil pasangan nilai kunci.
Berasaskan cawangan Mengakses Mengawal
Menggunakan acl.deny.cawangan and acl.allow.cawangan bahagian untuk mempunyai akses berasaskan cawangan
kawalan. Kunci dalam bahagian ini boleh sama ada:
· nama cawangan, atau
· asterisk, untuk memadankan mana-mana cawangan;
Nilai yang sepadan boleh sama ada:
· senarai dipisahkan koma yang mengandungi pengguna dan kumpulan, atau
· asterisk, untuk memadankan sesiapa sahaja;
Anda boleh menambah "!" awalan kepada nama pengguna atau kumpulan untuk menyongsangkan pengertian padanan.
Berasaskan laluan Mengakses Mengawal
Menggunakan acl.menafikan and acl.allow bahagian untuk mempunyai kawalan akses berasaskan laluan. Kunci dalam ini
bahagian menerima corak subpokok (dengan sintaks glob secara lalai). Yang sepadan
nilai mengikut sintaks yang sama seperti bahagian lain di atas.
kumpulan
Nama kumpulan mesti diawali dengan a @ simbol. Menentukan nama kumpulan mempunyai kesan yang sama
sebagai menyatakan semua pengguna dalam kumpulan itu.
Anda boleh menentukan ahli kumpulan dalam acl.groups bahagian. Jika nama kumpulan tidak ditentukan
di sana, dan Mercurial berjalan di bawah sistem seperti Unix, senarai pengguna akan diambil
daripada OS. Jika tidak, pengecualian akan dinaikkan.
Contoh konfigurasi
[cangkuk]
# Gunakan ini jika anda ingin menyemak sekatan akses pada masa komit
pretxncommit.acl = python:hgext.acl.hook
# Gunakan ini jika anda ingin menyemak sekatan akses untuk tarik, tolak,
# ikat dan hidangkan.
pretxnchangegroup.acl = python:hgext.acl.hook
[acl]
# Benarkan atau tolak akses untuk perubahan masuk hanya jika sumbernya
# disenaraikan di sini, biarkan mereka lulus sebaliknya. Sumber adalah "berkhidmat" untuk semua
# capaian jauh (http atau ssh), "push", "pull" atau "bundle" apabila
# arahan berkaitan dijalankan secara setempat.
# Lalai: berkhidmat
sumber = berkhidmat
[acl.deny.branches]
# Semua orang dinafikan ke cawangan beku:
cabang beku = *
# Pengguna buruk dinafikan pada semua cawangan:
* = pengguna jahat
[acl.allow.branches]
# Beberapa pengguna dibenarkan di cawangan-a:
cawangan-a = pengguna-1, pengguna-2, pengguna-3
# Hanya seorang pengguna dibenarkan di branch-b:
cawangan-b = pengguna-1
# Pengguna super dibenarkan di mana-mana cawangan:
* = pengguna super
# Semua orang dibenarkan mengikuti ujian cawangan:
cawangan-untuk-ujian = *
[acl.deny]
# Senarai ini disemak dahulu. Jika padanan ditemui, acl.allow tidak
# disemak. Semua pengguna diberikan akses jika acl.deny tidak hadir.
# Format untuk kedua-dua senarai: corak glob = pengguna, ..., @kumpulan, ...
# Untuk memadankan semua orang, gunakan asterisk untuk pengguna:
# saya/glob/corak = *
# user6 tidak akan mempunyai akses tulis kepada mana-mana fail:
** = pengguna6
# Kumpulan "hg-denied" tidak akan mempunyai akses menulis kepada mana-mana fail:
** = @hg-dinafikan
# Tiada siapa yang akan dapat menukar "DONT-TOUCH-THIS.txt", walaupun
# semua orang dapat menukar semua fail lain. Lihat di bawah.
src/main/resources/DONT-TOUCH-THIS.txt = *
[acl.allow]
# jika acl.allow tidak ada, semua pengguna dibenarkan secara lalai
# acl.allow kosong = tiada pengguna dibenarkan
# Pengguna "doc_writer" mempunyai akses tulis kepada mana-mana fail di bawah "docs"
# folder:
docs/** = doc_writer
# Pengguna "jack" dan kumpulan "pereka" mempunyai akses tulis kepada mana-mana fail
# di bawah folder "imej":
imej/** = bicu, @pereka
# Semua orang (kecuali "pengguna6" dan "@hg-denied" - lihat acl.deny di atas)
# akan mempunyai akses tulis kepada mana-mana fail di bawah folder "sumber".
# (kecuali untuk 1 fail. Lihat acl.deny):
src/utama/sumber/** = *
.hgtags = release_engineer
Contoh menggunakan yang ! awalan
Katakan terdapat cawangan yang hanya boleh ditolak oleh pengguna (atau kumpulan) tertentu, dan
anda tidak mahu menyekat akses kepada mana-mana cawangan lain yang mungkin dibuat.
"!" awalan membolehkan anda menghalang sesiapa kecuali pengguna atau kumpulan tertentu untuk menolak
perubahan dalam cawangan atau laluan tertentu.
Dalam contoh di bawah, kami akan: 1) Menafikan akses kepada "ring" cawangan kepada sesiapa sahaja kecuali pengguna
"gollum" 2) Tolak akses kepada "tasik" cawangan kepada sesiapa sahaja kecuali ahli kumpulan "hobbit" 3)
Tolak akses kepada fail kepada sesiapa sahaja kecuali pengguna "gollum"
[acl.allow.branches]
# Kosong
[acl.deny.branches]
# 1) hanya 'gollum' boleh komited ke 'cincin' cawangan;
# 'gollum' dan sesiapa sahaja masih boleh memberi komitmen kepada mana-mana cawangan lain.
cincin = !gollum
# 2) hanya ahli kumpulan 'hobbit' boleh komited untuk cawangan 'tasik';
# ahli 'hobbit' dan sesiapa sahaja masih boleh memberi komitmen kepada mana-mana cawangan lain.
tasik = !@hobbit
# Anda juga boleh menafikan akses berdasarkan laluan fail:
[acl.allow]
# Kosong
[acl.deny]
# 3) hanya 'gollum' boleh menukar fail di bawah;
# 'gollum' dan sesiapa sahaja masih boleh menukar mana-mana fail lain.
/kabus/gunung/gua/cincin = !gollum
kotak hitam
log peristiwa repositori ke kotak hitam untuk nyahpepijat
Log maklumat acara ke .hg/blackbox.log untuk membantu nyahpepijat dan mendiagnosis masalah. The
peristiwa yang dilog boleh dikonfigurasikan melalui kunci konfigurasi blackbox.track. Contoh:
[kotak hitam]
trek = *
[kotak hitam]
track = arahan, commandfinish, commandexception, exthook, pythonhook
[kotak hitam]
trek = masuk
[kotak hitam]
# hadkan saiz fail log
saiz maksimum = 1.5 MB
# putar sehingga N fail log apabila fail semasa menjadi terlalu besar
maxfiles = 3
arahan
kotak hitam
lihat peristiwa repositori baru-baru ini:
hg kotak hitam [PILIHAN]...
melihat peristiwa repositori baru-baru ini
Pilihan:
-l,--had
bilangan acara untuk ditunjukkan (lalai: 10)
bugzilla
cangkuk untuk menyepadukan dengan penjejak pepijat Bugzilla
Sambungan cangkuk ini menambah ulasan tentang pepijat dalam Bugzilla apabila set perubahan yang merujuk kepada pepijat
oleh ID Bugzilla dilihat. Komen diformat menggunakan mekanisme templat Mercurial.
Rujukan pepijat boleh menyertakan kemas kini untuk Bugzilla untuk masa yang dibelanjakan
bekerja pada pepijat. Pepijat juga boleh ditandakan tetap.
Tiga mod asas akses kepada Bugzilla disediakan:
1. Akses melalui antara muka XMLRPC Bugzilla. Memerlukan Bugzilla 3.4 atau lebih baru.
2. Semak data melalui antara muka Bugzilla XMLRPC dan serahkan perubahan pepijat melalui e-mel kepada
Antara muka e-mel Bugzilla. Memerlukan Bugzilla 3.4 atau lebih baru.
3. Menulis terus ke pangkalan data Bugzilla. Hanya pemasangan Bugzilla menggunakan MySQL
disokong. Memerlukan Python MySQLdb.
Menulis terus ke pangkalan data terdedah kepada perubahan skema dan bergantung pada a
Skrip penyumbang Bugzilla untuk menghantar e-mel pemberitahuan perubahan pepijat. Skrip ini berjalan sebagai
pengguna yang menjalankan Mercurial, mesti dijalankan pada hos dengan pemasangan Bugzilla, dan
memerlukan kebenaran untuk membaca butiran konfigurasi Bugzilla dan pengguna MySQL yang diperlukan
dan kata laluan untuk mempunyai hak akses penuh ke pangkalan data Bugzilla. Atas sebab-sebab ini
mod akses kini dianggap tidak digunakan lagi dan tidak akan dikemas kini untuk Bugzilla baharu
versi ke hadapan. Hanya menambah ulasan disokong dalam mod akses ini.
Akses melalui XMLRPC memerlukan nama pengguna dan kata laluan Bugzilla untuk dinyatakan dalam
konfigurasi. Komen ditambah di bawah nama pengguna itu. Oleh kerana konfigurasi mestilah
boleh dibaca oleh semua pengguna Mercurial, adalah disyorkan bahawa hak pengguna tersebut adalah
terhad dalam Bugzilla kepada minimum yang diperlukan untuk menambah ulasan. Penandaan pepijat diperbaiki
memerlukan Bugzilla 4.0 dan lebih baru.
Akses melalui XMLRPC/e-mel menggunakan XMLRPC untuk menanyakan Bugzilla, tetapi menghantar e-mel kepada Bugzilla
antara muka e-mel untuk menghantar komen kepada pepijat. Alamat Daripada: dalam e-mel ditetapkan kepada
alamat e-mel pengguna Mercurial, jadi komen itu nampaknya datang daripada Mercurial
pengguna. Sekiranya e-mel pengguna Mercurial tidak diiktiraf oleh Bugzilla sebagai a
Pengguna Bugzilla, e-mel yang dikaitkan dengan nama pengguna Bugzilla digunakan untuk log masuk ke Bugzilla
digunakan sebaliknya sebagai sumber ulasan. Pepijat menandakan berfungsi pada semua yang disokong
versi Bugzilla.
Item konfigurasi biasa untuk semua mod akses:
bugzilla.version
Jenis akses untuk digunakan. Nilai yang diiktiraf ialah:
xmlrpc
Antara muka Bugzilla XMLRPC.
xmlrpc+e-mel
Bugzilla XMLRPC dan antara muka e-mel.
3.0
Akses MySQL, Bugzilla 3.0 dan lebih baru.
2.18
Akses MySQL, Bugzilla 2.18 dan sehingga tetapi tidak termasuk 3.0.
2.16
Akses MySQL, Bugzilla 2.16 dan sehingga tetapi tidak termasuk 2.18.
bugzilla.regexp
Ungkapan biasa untuk memadankan ID pepijat untuk kemas kini dalam mesej komit changeset. Ia
mesti mengandungi satu kumpulan bernama "()". mengandungi ID pepijat yang dipisahkan oleh
aksara bukan digit. Ia juga mungkin mengandungi kumpulan bernama dengan
nombor titik terapung yang memberikan masa bekerja pada pepijat. Jika tiada kumpulan yang dinamakan
kini, kumpulan "()" pertama diandaikan mengandungi ID pepijat dan masa kerja ialah
tidak dikemas kini. Ungkapan lalai sepadan Bug 1234, Bug No. 1234, Bug nombor
1234, bugs 1234,5678, Bug 1234 and 5678 dan variasi daripadanya, diikuti dengan
nombor jam diawali dengan h or jam, contohnya jam 1.5. Pemadanan tidak peka huruf besar-besaran.
bugzilla.fixregexp
Ungkapan biasa untuk memadankan ID pepijat untuk menandakan tetap dalam mesej komit changeset.
Ini mesti mengandungi kumpulan bernama "()". ` yang mengandungi yang pepijat ID dipisahkan by
bukan digit watak-watak. It mungkin Juga mengandungi a bernama kumpulan `` dengan
nombor titik terapung yang memberikan masa bekerja pada pepijat. Jika tiada kumpulan yang dinamakan
kini, kumpulan "()" pertama diandaikan mengandungi ID pepijat dan masa kerja ialah
tidak dikemas kini. Ungkapan lalai sepadan Pembaikan 1234, Pembaikan pepijat 1234, Pembaikan pepijat
1234,5678, Pembaikan 1234 and 5678 dan variasinya, diikuti dengan nombor jam
diawali oleh h or jam, contohnya jam 1.5. Pemadanan tidak peka huruf besar-besaran.
bugzilla.fixstatus
Status untuk menetapkan pepijat apabila menandakan ditetapkan. lalai DISELESAIKAN.
bugzilla.fixresolution
Resolusi untuk menetapkan pepijat apabila menandakan ditetapkan. lalai TETAP.
bugzilla.style
Fail gaya untuk digunakan semasa memformat ulasan.
bugzilla.template
Templat untuk digunakan semasa memformat ulasan. Mengatasi gaya jika dinyatakan. Sebagai tambahan
kepada kata kunci Mercurial biasa, sambungan menentukan:
{bug}
ID pepijat Bugzilla.
{root}
Nama laluan penuh repositori Mercurial.
{webroot}
Nama laluan yang dilucutkan bagi repositori Mercurial.
{hgweb}
URL asas untuk menyemak imbas repositori Mercurial.
Lalai changeset {nod|pendek} in repo {root} merujuk kepada pepijat
{bug}.\perincian:\n\t{desc|tabindent}
bugzilla.strip
Bilangan aksara pemisah laluan untuk dilucutkan dari hadapan Mercurial
laluan repositori ({root} dalam templat) untuk menghasilkan {webroot}. Sebagai contoh, a
repositori dengan {root} /var/local/projek saya dengan jalur 2 memberikan nilai untuk
{webroot} of projek saya. Lalai 0.
web.baseurl
URL asas untuk menyemak imbas repositori Mercurial. Dirujuk daripada templat sebagai {hgweb}.
Item konfigurasi biasa untuk XMLRPC+e-mel dan mod akses MySQL:
bugzilla.usermap
Laluan fail yang mengandungi e-mel pengangkut Mercurial ke pemetaan e-mel pengguna Bugzilla.
Jika dinyatakan, fail harus mengandungi satu pemetaan setiap baris:
committer = pengguna Bugzilla
Lihat juga [peta pengguna] bawah seksyen ini.
. [peta pengguna] bahagian digunakan untuk menentukan pemetaan e-mel komiter Mercurial kepada Bugzilla
e-mel pengguna. Lihat juga bugzilla.usermap. Mengandungi entri borang pengirim = Bugzilla
pengguna.
Konfigurasi mod akses XMLRPC:
bugzilla.bzurl
URL asas untuk pemasangan Bugzilla. lalai http://localhost/bugzilla.
bugzilla.user
Nama pengguna untuk digunakan untuk log masuk ke Bugzilla melalui XMLRPC. lalai pepijat.
bugzilla.kata laluan
Kata laluan untuk log masuk Bugzilla.
Mod akses e-mel XMLRPC+ menggunakan item konfigurasi mod akses XMLRPC, dan juga:
bugzilla.bzemail
Alamat e-mel Bugzilla.
Di samping itu, tetapan e-mel Mercurial mesti dikonfigurasikan. Lihat dokumentasi dalam
hgrc(5), bahagian [e-mel] and [smtp].
Konfigurasi mod akses MySQL:
bugzilla.host
Nama hos pelayan MySQL yang memegang pangkalan data Bugzilla. lalai localhost.
bugzilla.db
Nama pangkalan data Bugzilla dalam MySQL. lalai pepijat.
bugzilla.user
Nama pengguna untuk digunakan untuk mengakses pelayan MySQL. lalai pepijat.
bugzilla.kata laluan
Kata laluan untuk digunakan untuk mengakses pelayan MySQL.
bugzilla.timeout
Tamat masa sambungan pangkalan data (saat). Lalai 5.
bugzilla.bzuser
Nama pengguna Fallback Bugzilla untuk merekodkan komen, jika changeset committer tidak boleh
ditemui sebagai pengguna Bugzilla.
bugzilla.bzdir
Direktori pemasangan Bugzilla. Digunakan secara lalai memberitahu. lalai /var/www/html/bugzilla.
bugzilla.notify
Perintah untuk menjalankan untuk mendapatkan Bugzilla menghantar e-mel pemberitahuan perubahan pepijat.
Pengganti dari peta dengan 3 kekunci, bzdir, id (id pepijat) dan pengguna (committer bugzilla
e-mel). Lalai bergantung pada versi; dari 2.18 ialah "cd %(bzdir)s && perl -T
contrib/sendbugmail.pl %(id)s %(user)s".
Mengaktifkan sambungan:
[sambungan]
bugzilla =
[cangkuk]
# jalankan cangkuk bugzilla pada setiap perubahan yang ditarik atau ditolak masuk ke sini
incoming.bugzilla = python:hgext.bugzilla.hook
Contoh konfigurasi:
Konfigurasi contoh XMLRPC. Ini menggunakan Bugzilla di http://my-project.org/bugzilla,
log masuk sebagai pengguna [e-mel dilindungi] dengan kata laluan plugh. Ia digunakan dengan a
koleksi repositori Mercurial di /var/local/hg/repos/, dengan antara muka web di
http://my-project.org/hg.
[bugzilla]
bzurl=http://my-project.org/bugzilla
pengguna=[e-mel dilindungi]
kata laluan=plug
versi=xmlrpc
template=Changeset {nod|short} dalam {root|basename}.
{hgweb}/{webroot}/rev/{nod|pendek}\n
{desc}\n
jalur=5
[laman web]
baseurl=http://my-project.org/hg
konfigurasi contoh XMLRPC+e-mel. Ini menggunakan Bugzilla di
http://my-project.org/bugzilla, log masuk sebagai pengguna [e-mel dilindungi] dengan kata laluan
plugh. Ia digunakan dengan koleksi repositori Mercurial dalam /var/local/hg/repos/,
dengan antara muka web di http://my-project.org/hg. Komen pepijat dihantar ke Bugzilla
alamat e-mel [e-mel dilindungi].
[bugzilla]
bzurl=http://my-project.org/bugzilla
pengguna=[e-mel dilindungi]
kata laluan=plug
versi=xmlrpc+e-mel
bzemail=[e-mel dilindungi]
template=Changeset {nod|short} dalam {root|basename}.
{hgweb}/{webroot}/rev/{nod|pendek}\n
{desc}\n
jalur=5
[laman web]
baseurl=http://my-project.org/hg
[peta pengguna]
[e-mel dilindungi]=[e-mel dilindungi]
konfigurasi contoh MySQL. Ini mempunyai pemasangan Bugzilla 3.2 tempatan
/opt/bugzilla-3.2. Pangkalan data MySQL dihidupkan localhost, nama pangkalan data Bugzilla ialah pepijat
dan MySQL diakses dengan nama pengguna MySQL pepijat kata laluan XYZZY. Ia digunakan dengan a
koleksi repositori Mercurial di /var/local/hg/repos/, dengan antara muka web di
http://my-project.org/hg.
[bugzilla]
hos=localhost
kata laluan=XYZZY
versi=3.0
bzuser=[e-mel dilindungi]
bzdir=/opt/bugzilla-3.2
template=Changeset {nod|short} dalam {root|basename}.
{hgweb}/{webroot}/rev/{nod|pendek}\n
{desc}\n
jalur=5
[laman web]
baseurl=http://my-project.org/hg
[peta pengguna]
[e-mel dilindungi]=[e-mel dilindungi]
Semua di atas menambah ulasan pada rekod pepijat Bugzilla dalam borang:
Changeset 3b16791d6642 dalam nama repositori.
http://my-project.org/hg/repository-name/rev/3b16791d6642
Ubah komit komen. Pepijat 1234.
menapis
memadam kandungan fail pada semakan yang diberikan
Perintah penapis mengarahkan Mercurial untuk memadam semua kandungan fail pada semakan yang diberikan
tanpa mengemas kini yang changeset hash. Ini membolehkan sejarah sedia ada kekal sah sementara
menghalang klon/tarikan masa hadapan daripada menerima data yang dipadamkan.
Penggunaan biasa untuk penapis adalah disebabkan oleh keperluan keselamatan atau undang-undang, termasuk:
* Kata laluan, kunci peribadi, bahan kriptografi
* Data/kod/perpustakaan berlesen yang lesennya telah tamat tempoh
* Maklumat Pengenalan Peribadi atau data peribadi lain
Nod yang ditapis boleh mengganggu operasi biasa mercurial pada bila-bila masa diperlukan data yang dipotong
untuk diwujudkan. Beberapa arahan, seperti hg kucing/hg kembali, gagal apabila diminta
menghasilkan data yang ditapis. Lain-lain, suka hg mengesahkan and hg maklumat, mesti boleh bertolak ansur
data ditapis untuk terus berfungsi dengan cara yang bermakna. Perintah sedemikian hanya bertolak ansur
semakan fail ditapis jika ia dibenarkan oleh pilihan konfigurasi "censor.policy=ignore".
arahan
menapis
hg penapis -r REV [-t TEKS] [FAIL]
Pilihan:
-r,--rev
penapis fail daripada semakan yang ditentukan
-t,--batu nisan
penggantian data batu nisan
chgserver
sambungan pelayan arahan untuk cHg (EKSPERIMEN)
'S' saluran (baca tulis)
menyebarkan permintaan ui.system() kepada klien
'attachio' arahan
lampirkan stdio pelanggan yang diluluskan oleh sendmsg()
'chdir' arahan
tukar direktori semasa
'getpager' arahan
menyemak sama ada kelui didayakan dan kelui yang harus dilaksanakan
'setenv' arahan
menggantikan os.environ sepenuhnya
'MENEPEK' isyarat
muat semula fail konfigurasi
kanak-kanak
arahan untuk memaparkan set perubahan kanak-kanak (TIDAK ADA)
Sambungan ini ditamatkan. Anda harus menggunakan hg log -r "kanak-kanak(REV)" sebaliknya.
arahan
kanak-kanak
tunjukkan kanak-kanak semakan direktori yang diberikan atau kerja:
hg kanak-kanak [-r REV] [FAIL]
Cetak anak-anak semakan direktori kerja. Jika semakan diberikan melalui
-r/--rev, anak-anak semakan itu akan dicetak. Jika hujah fail diberikan,
semakan di mana fail terakhir diubah (selepas semakan direktori kerja atau
hujah kepada --rev jika diberikan) dicetak.
Sila guna hg log sebaliknya:
hg kanak-kanak => hg log -r 'kanak-kanak()'
hg kanak-kanak -r REV => hg log -r 'kanak-kanak(REV)'
Lihat hg membantu log and hg membantu revsets.kanak-kanak.
Pilihan:
-r,--rev
tunjukkan kanak-kanak semakan yang ditentukan
--gaya
paparan menggunakan fail peta templat (DILARANG)
-T,--template
paparan dengan templat
berpura-pura
arahan untuk memaparkan statistik tentang sejarah repositori
arahan
berpura-pura
histogram perubahan kepada repositori:
hg churn [-d TARIKH] [-r REV] [--alias FAIL] [FAIL]
Perintah ini akan memaparkan histogram yang mewakili bilangan baris yang diubah atau
semakan, dikumpulkan mengikut templat yang diberikan. Templat lalai akan dikumpulkan
perubahan oleh pengarang. Pilihan --dateformat boleh digunakan untuk mengumpulkan hasil mengikut tarikh
sebaliknya.
Statistik adalah berdasarkan bilangan baris yang diubah, atau sebagai alternatif bilangan
semakan sepadan jika pilihan --changesets ditentukan.
Contoh:
# paparan kiraan baris yang diubah untuk setiap komit
hg churn -t "{pengarang|e-mel}"
# paparkan graf aktiviti harian
hg churn -f "%H" -s -c
# paparan aktiviti pembangun mengikut bulan
hg churn -f "%Y-%m" -s -c
# paparan kiraan baris berubah setiap tahun
hg churn -f "%Y" -s
Anda boleh memetakan alamat e-mel ganti ke alamat utama dengan menyediakan fail
menggunakan format berikut:
=
Fail sedemikian boleh ditentukan dengan pilihan --aliases, jika tidak, fail .hgchurn akan
mencari dalam akar direktori kerja. Alias akan dipisahkan dari "=" paling kanan.
Pilihan:
-r,--rev
kadar kiraan untuk semakan atau set semula yang ditentukan
-d,--Tarikh
kadar kiraan untuk semakan padanan tarikh spec
-t,--template lama
templat kepada set perubahan kumpulan (DILARANG)
-T,--template
templat untuk kumpulan perubahan set (lalai: {pengarang|e-mel})
-f,--format tarikh
Format serasi strftime untuk mengumpulkan mengikut tarikh
-c, --perubahan
kadar kiraan dengan bilangan set perubahan
-ya, --sort
susun mengikut kekunci (lalai: susun mengikut kiraan)
--diffstat
paparkan baris yang ditambah/dialih keluar secara berasingan
--alias
fail dengan alias e-mel
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
klonebundle
mengiklankan berkas pra-jana kepada klon benih
"clonebundles" ialah sambungan sebelah pelayan yang digunakan untuk mengiklankan kewujudan
pra-dijana, fail berkas yang dihoskan secara luaran kepada pelanggan yang mengklon supaya pengklonan
boleh menjadi lebih pantas, lebih dipercayai dan memerlukan kurang sumber pada pelayan.
Pengklonan boleh menjadi operasi intensif CPU dan I/O pada pelayan. Secara tradisinya, pelayan, dalam
tindak balas kepada permintaan pelanggan untuk mengklon, secara dinamik menjana berkas yang mengandungi
keseluruhan kandungan repositori dan menghantarnya kepada klien. Tiada caching pada pelayan
dan pelayan perlu menjana secara berlebihan berkas keluar yang sama sebagai tindak balas kepada
setiap permintaan klon. Untuk pelayan dengan repositori yang besar atau dengan volum klon yang tinggi, the
beban daripada klon boleh menjadikan penskalaan pelayan mencabar dan mahal.
Sambungan ini memberikan operator pelayan keupayaan untuk memunggah yang berpotensi mahal
memuatkan klon ke perkhidmatan luaran. Begini cara ia berfungsi.
1. Operator pelayan mewujudkan mekanisme untuk menyediakan fail bundle pada a
perkhidmatan pengehosan di mana pelanggan Mercurial boleh mengambilnya.
2. Fail manifes menyenaraikan URL berkas yang tersedia dan beberapa metadata pilihan ditambahkan pada
repositori Mercurial pada pelayan.
3. Pelanggan memulakan klon terhadap pelayan sedia maklum kumpulan klon.
4. Pelanggan melihat pelayan mengiklankan himpunan klon dan mengambil manifes
menyenaraikan berkas yang tersedia.
5. Pelanggan menapis dan mengisih berkas yang tersedia berdasarkan perkara yang disokong dan
lebih suka.
6. Pelanggan memuat turun dan menggunakan himpunan yang tersedia daripada URL yang ditentukan oleh pelayan.
7. Pelanggan menyambung semula ke pelayan asal dan melakukan yang setara dengan hg tarik kepada
dapatkan semula semua data repositori yang tiada dalam berkas. (Repositori mungkin telah dikemas kini
antara apabila berkas dibuat dan apabila pelanggan memulakan klon.)
Daripada pelayan menjana berkas repositori penuh untuk setiap permintaan klon, ia
menjana berkas penuh sekali dan ia kemudiannya digunakan semula untuk bootstrap klon baharu. The
pelayan masih boleh memindahkan data pada masa klon. Walau bagaimanapun, ini hanya data yang telah
ditambah/diubah sejak berkas dibuat. Untuk repositori yang besar dan mantap, ini boleh
kurangkan beban pelayan untuk klon kepada kurang daripada 1% daripada asal.
Untuk berfungsi, sambungan ini memerlukan operator pelayan berikut:
· Menjana fail berkas kandungan repositori (biasanya secara berkala, seperti sekali setiap
hari).
· Pelayan fail yang pelanggan mempunyai akses rangkaian dan Python tahu cara bercakap dengannya
melalui kemudahan pengendalian URL biasa (biasanya pelayan HTTP).
· Satu proses untuk memastikan himpunan nyata segerak dengan fail berkas yang tersedia.
Tegasnya, menggunakan pelayan pengehosan fail statik tidak diperlukan: pengendali pelayan
boleh menggunakan perkhidmatan dinamik untuk mendapatkan semula data berkas. Walau bagaimanapun, pengehosan fail statik
perkhidmatan adalah mudah dan berskala serta sepatutnya mencukupi untuk kebanyakan keperluan.
Fail bundle boleh dijana dengan hg bundle perintah. Lazimnya hg bundle --semua is
digunakan untuk menghasilkan sekumpulan keseluruhan repositori.
hg debugcreatestreamclonebundle boleh digunakan untuk menghasilkan yang istimewa streaming mengklon bundle.
Ini adalah fail berkas yang sangat cekap untuk dihasilkan dan digunakan (baca: pantas).
Walau bagaimanapun, ia lebih besar daripada format berkas tradisional dan memerlukan sokongan pelanggan
set tepat format stor data repositori yang digunakan oleh repositori yang menciptanya.
Biasanya, pelayan yang lebih baharu boleh menyampaikan data yang serasi dengan pelanggan yang lebih lama. Walau bagaimanapun,
streaming mengklon berkas tidak mempunyai jaminan ini. Server pengendali perlu kepada be sedar Bahawa
lebih baru versi of Mercurial mungkin menghasilkan streaming mengklon berkas tidak serasi bersama lebih tua
Mercurial versi.
Pengendali pelayan bertanggungjawab untuk mencipta a .hg/clonebundles.manifest fail yang mengandungi
senarai fail berkas yang tersedia sesuai untuk pembenihan klon. Jika fail ini tidak
wujud, repositori tidak akan mengiklankan kewujudan berkas klon apabila pelanggan
menyambung.
Fail manifes mengandungi senarai entri yang dibatasi baris baharu ().
Setiap baris dalam fail ini mentakrifkan berkas yang tersedia. Garisan mempunyai format:
[ = [ = ]]
Iaitu, URL diikuti dengan senarai pilihan, dipisahkan ruang bagi pasangan kunci=nilai yang menerangkan
sifat tambahan berkas ini. Kedua-dua kunci dan nilai adalah dikodkan URI.
Kunci dalam huruf besar dikhaskan untuk digunakan oleh Mercurial dan ditakrifkan di bawah. Semua
kekunci bukan huruf besar boleh digunakan oleh pemasangan tapak. Contoh penggunaan untuk sifat tersuai
adalah menggunakan Pusat data atribut untuk menentukan pusat data mana fail dihoskan.
Pelanggan kemudiannya boleh memilih pelayan di pusat data yang paling dekat dengan mereka.
Kekunci simpanan berikut ditakrifkan pada masa ini:
BUNDLESPEC
Rentetan "spesifikasi berkas" yang menerangkan jenis berkas.
Ini ialah nilai rentetan yang diterima oleh hujah "--type" daripada hg bundle.
Nilai dihuraikan dalam mod ketat, yang bermaksud ia mestilah daripada
" - " borang. Lihat mercurial.exchange.parsebundlespec() untuk lebih lanjut
butiran.
hg debugbundle --spec boleh digunakan untuk mencetak rentetan spesifikasi berkas untuk a
fail berkas. Output arahan ini boleh digunakan secara verbatim untuk nilai
BUNDLESPEC (ia sudah terlepas).
Pelanggan secara automatik akan menapis spesifikasi yang tidak diketahui atau
tidak disokong supaya mereka tidak akan cuba memuat turun sesuatu yang mungkin tidak akan digunakan.
Nilai sebenar tidak memberi kesan kepada tingkah laku pelanggan selain daripada penapisan: pelanggan akan
masih menghidu jenis berkas daripada pengepala fail yang dimuat turun.
Penggunaan of ini utama is sangat disyorkan, kerana ia membolehkan pelanggan melangkau dengan mudah
berkas yang tidak disokong. Jika kunci ini tidak ditakrifkan, pelanggan lama boleh cuba memohon
ikatan yang tidak mampu dibacanya.
MEMERLUKAN
Sama ada Petunjuk Nama Pelayan (SNI) diperlukan untuk menyambung ke URL. SNI membenarkan
pelayan untuk menggunakan berbilang sijil pada IP yang sama. Ia agak biasa dalam CDN
dan penyedia pengehosan lain. Versi Python lama tidak menyokong SNI. Menentukan
atribut ini membolehkan pelanggan dengan versi Python yang lebih lama menapis entri ini
tanpa mengalami kegagalan SSL legap pada masa sambungan.
Jika ini ditakrifkan, adalah penting untuk mengiklankan URL sandaran bukan SNI atau pelanggan
menjalankan keluaran Python lama mungkin tidak dapat mengklon dengan klonebundle
kemudahan.
Nilai harus "benar".
Manifes boleh mengandungi berbilang entri. Dengan mengandaikan metadata ditakrifkan, pelanggan akan menapis
entri daripada manifes yang mereka tidak sokong. Penyertaan selebihnya adalah pilihan
diisih mengikut keutamaan pelanggan (eksperimental.clonebundleprefers pilihan konfigurasi). Klien
kemudian cuba untuk mengambil berkas pada URL pertama dalam senarai yang tinggal.
kesilapan apabila muat turun a bundle akan gagal yang keseluruhan mengklon operasi: pelanggan do tidak
secara automatik jatuh kembali kepada a tradisional klon. Sebab untuk ini ialah jika pelayan adalah
menggunakan berkas klon, ia mungkin berbuat demikian kerana ciri tersebut diperlukan untuk membantunya
skala. Dalam erti kata lain, terdapat andaian bahawa beban klon akan diturunkan kepada yang lain
perkhidmatan dan pelayan Mercurial tidak bertanggungjawab untuk menyampaikan beban klon ini. Jika
bahawa perkhidmatan lain mengalami masalah dan pelanggan mula beramai-ramai jatuh kembali kepada asal
Pelayan Mercurial, beban klon tambahan boleh mengatasi pelayan kerana beban yang tidak dijangka
dan membawanya ke luar talian dengan berkesan. Tidak mempunyai pelanggan secara automatik kembali ke pengklonan
daripada pelayan asal mengurangkan senario ini.
Kerana tiada sandaran pelayan Mercurial automatik atas kegagalan pengehosan berkas
perkhidmatan, adalah penting bagi pengendali pelayan untuk melihat perkhidmatan pengehosan berkas sebagai
lanjutan pelayan Mercurial dari segi ketersediaan dan perjanjian tahap perkhidmatan:
jika perkhidmatan pengehosan bundle menurun, begitu juga dengan keupayaan pelanggan untuk mengklon. Nota:
pelanggan akan melihat mesej yang memberitahu mereka cara memintas kemudahan berkas klon apabila a
kegagalan berlaku. Jadi pengendali pelayan harus bersedia untuk sesetengah orang mengikutinya
arahan apabila kegagalan berlaku, sekali gus memacu lebih banyak beban ke Mercurial asal
pelayan apabila perkhidmatan pengehosan berkas gagal.
warna
mewarnakan output daripada beberapa arahan
Sambungan warna mewarnakan output daripada beberapa arahan Mercurial. Sebagai contoh, yang
arahan diff menunjukkan penambahan dalam warna hijau dan pemadaman dalam warna merah, manakala arahan status menunjukkan
fail yang diubah suai dalam magenta. Banyak arahan lain mempunyai warna yang serupa. Ia adalah mungkin untuk
sesuaikan warna ini.
Kesan
Kesan lain selain warna, seperti teks tebal dan bergaris, juga tersedia. Oleh
lalai, pangkalan data terminfo digunakan untuk mencari kod terminal yang digunakan untuk menukar warna dan
kesan. Jika terminfo tidak tersedia, maka kesan diberikan dengan ECMA-48 SGR
fungsi kawalan (aka kod melarikan diri ANSI).
Kesan yang tersedia dalam mod terminfo ialah 'kelip', 'tebal', 'malap', 'terbalik', 'tidak kelihatan',
'italic', 'menonjol' dan 'garis bawah'; dalam mod ECMA-48, pilihan adalah 'bold', 'inverse',
'italic', dan 'underline'. Cara setiap satunya diberikan bergantung pada emulator terminal. Sesetengah
mungkin tidak tersedia untuk jenis terminal tertentu, dan akan diabaikan secara senyap.
label
Teks menerima kesan warna bergantung pada label yang ada padanya. Banyak Mercurial lalai
arahan mengeluarkan teks berlabel. Anda juga boleh menentukan label anda sendiri dalam templat menggunakan
fungsi label, lihat hg membantu template. Satu bahagian teks mungkin mempunyai lebih daripada satu
label. Dalam kes itu, kesan yang diberikan kepada label terakhir akan mengatasi sebarang kesan lain. ini
termasuk kesan khas "tiada", yang membatalkan kesan lain.
Label biasanya tidak kelihatan. Untuk melihat label ini dan kedudukannya dalam
teks, gunakan pilihan global --color=debug. Teks sauh yang sama mungkin dikaitkan dengan
berbilang label, cth
[log.changeset changeset.secret|changeset: 22611:6f0a53c8f587]
Berikut ialah kesan lalai untuk beberapa label lalai. Kesan lalai mungkin
ditindih daripada fail konfigurasi anda:
[warna]
status.modified = biru tebal bergaris bawah latar belakang_merah
status.ditambah = hijau tebal
status.removed = latar belakang_biru tebal merah
status.deleted = garis bawah tebal cyan
status.unknown = garis bawah tebal magenta
status.diabaikan = hitam tebal
# 'tiada' mematikan semua kesan
status.bersih = tiada
status.disalin = tiada
qseries.applied = garis bawah tebal biru
qseries.unapplied = hitam tebal
qseries.missing = merah tebal
diff.diffline = tebal
diff.extended = cyan bold
diff.file_a = merah tebal
diff.file_b = hijau tebal
diff.hunk = magenta
diff.deleted = merah
diff.disisipkan = hijau
berbeza.berubah = putih
diff.tab =
diff.trailingwhitespace = latar belakang_merah tebal
# Kosong supaya ia mewarisi gaya label sekeliling
changeset.public =
changeset.draf =
changeset.rahsia =
azam.tidak diselesaikan = merah tebal
menyelesaikan.menyelesaikan = hijau tebal
penanda buku.aktif = hijau
cawangan.aktif = tiada
dahan.tertutup = hitam tebal
dahan.arus = hijau
cawangan.tidak aktif = tiada
tags.normal = hijau
tags.local = hitam tebal
rebase.rebased = biru
rebase.baki = merah tebal
rak.umur = cyan
rak.terbaru = hijau tebal
shelve.name = biru tebal
histedit.remaining = merah tebal
Adat warna
Kerana hanya terdapat lapan warna standard, modul ini membolehkan anda menentukan nama warna
untuk slot warna lain yang mungkin tersedia untuk jenis terminal anda, dengan mengandaikan terminfo
mod. Sebagai contoh:
warna.biru terang = 12
warna.merah jambu = 207
warna.oren = 202
untuk menetapkan 'brightblue' kepada slot warna 12 (berguna untuk 16 terminal warna yang mempunyai lebih cerah
warna yang ditakrifkan dalam lapan atas) dan, 'merah jambu' dan 'oren' kepada warna dalam xterm 256 warna
kiub warna lalai. Warna yang ditentukan ini kemudiannya boleh digunakan sebagai mana-mana yang telah ditetapkan
lapan, termasuk menambahkan '_background' untuk menetapkan latar belakang kepada warna tersebut.
Mod
Secara lalai, sambungan warna akan menggunakan mod ANSI (atau mod win32 pada Windows) jika ia
mengesan terminal. Untuk mengatasi mod auto (untuk mendayakan mod terminfo, contohnya), tetapkan
pilihan konfigurasi berikut:
[warna]
mod = terminfo
Sebarang nilai selain daripada 'ansi', 'win32', 'terinfo' atau 'auto' akan melumpuhkan warna.
Ambil perhatian bahawa pada sesetengah sistem, mod terminfo boleh menyebabkan masalah apabila menggunakan warna dengan
sambungan kelui dan kurang -R. kurang dengan pilihan -R hanya akan memaparkan warna ECMA-48
kod, dan mod terminfo kadangkala boleh mengeluarkan kod yang kurang faham. Awak boleh
mengatasi ini dengan sama ada menggunakan mod ansi (atau mod auto), atau dengan menggunakan less -r (yang akan
melalui semua kod kawalan terminal, bukan hanya kod kawalan warna).
Pada sesetengah sistem (seperti MSYS dalam Windows), terminal mungkin menyokong mod warna yang berbeza
daripada alat kelui (diaktifkan melalui sambungan "kelui"). Ia adalah mungkin untuk menentukan berasingan
mod bergantung pada sama ada alat kelui aktif:
[warna]
mod = auto
pagermode = ansi
If mod kelui tidak ditakrifkan, iaitu mod akan digunakan.
arahan
menukar
import semakan daripada repositori VCS asing ke dalam Mercurial
arahan
menukar
tukar repositori SCM asing kepada Mercurial.:
hg tukar [PILIHAN]... SUMBER [DEST [REVMAP]]
Format sumber yang diterima [pengecam]:
· Merkuri [hg]
· CVS [cvs]
· Darcs [darcs]
· git [git]
· Subversion [svn]
· Monoton [mtn]
· GNU Arch [gnuarch]
· Bazar [bzr]
· Perforce [p4]
Format destinasi [pengecam] yang diterima:
· Merkuri [hg]
· Subversion [svn] (sejarah pada cawangan tidak dikekalkan)
Jika tiada semakan diberikan, semua semakan akan ditukar. Jika tidak, tukar akan sahaja
import sehingga semakan yang dinamakan (diberikan dalam format yang difahami oleh sumber).
Jika tiada nama direktori destinasi dinyatakan, ia lalai kepada nama asas sumber
bersama -hg dilampirkan. Jika repositori destinasi tidak wujud, ia akan dibuat.
Secara lalai, semua sumber kecuali Mercurial akan menggunakan --branchsort. Kegunaan merkuri
--sourcesort untuk mengekalkan susunan nombor semakan asal. Mod isihan mempunyai yang berikut
kesan:
--cawangan
tukar daripada semakan ibu bapa kepada anak apabila boleh, yang bermaksud cawangan adalah
biasanya ditukar satu demi satu. Ia menjana lebih banyak repositori padat.
--datesort
mengisih semakan mengikut tarikh. Repositori yang ditukar mempunyai log perubahan yang kelihatan baik tetapi adalah
selalunya susunan magnitud lebih besar daripada yang sama yang dijana oleh --branchsort.
--sourcesort
cuba mengekalkan susunan semakan sumber, hanya disokong oleh sumber Mercurial.
--closesort
cuba alihkan semakan tertutup sedekat mungkin ke cawangan induk, sahaja
disokong oleh sumber Mercurial.
If REVMAP tidak diberikan, ia akan diletakkan di lokasi lalai (/.hg/shamap by
lalai). The REVMAP ialah fail teks ringkas yang memetakan setiap ID komit sumber kepada
ID destinasi untuk semakan itu, seperti:
Jika fail itu tidak wujud, ia akan dibuat secara automatik. Ia dikemas kini pada setiap komit yang disalin,
so hg menukar boleh diganggu dan boleh dijalankan berulang kali untuk menyalin komit baharu.
Peta pengarang ialah fail teks ringkas yang memetakan setiap pengarang komit sumber ke destinasi
komit pengarang. Ia berguna untuk SCM sumber yang menggunakan log masuk unix untuk mengenal pasti pengarang (cth:
CVS). Satu baris bagi setiap pengarang pemetaan dan format baris ialah:
pengarang sumber = pengarang destinasi
Baris dan baris kosong bermula dengan a # tidak dipedulikan.
Filemap ialah fail yang membenarkan penapisan dan pemetaan semula fail dan direktori. setiap satu
baris boleh mengandungi salah satu daripada arahan berikut:
sertakan laluan/ke/fail-atau-dir
kecualikan laluan/ke/fail-atau-dir
menamakan semula laluan/ke/laluan sumber/ke/destinasi
Baris komen bermula dengan #. Laluan yang ditentukan sepadan jika ia sama dengan nama relatif penuh
fail atau salah satu daripada direktori induknya. The termasuk or tidak termasuk arahan dengan
laluan padanan terpanjang digunakan, jadi susunan baris tidak penting.
. termasuk arahan menyebabkan fail, atau semua fail di bawah direktori, dimasukkan ke dalam
repositori destinasi. Lalai jika tiada termasuk kenyataan adalah untuk memasukkan
segala-galanya. Jika ada termasuk kenyataan, tiada apa-apa lagi yang disertakan. The tidak termasuk
arahan menyebabkan fail atau direktori ditinggalkan. The menamakan semula arahan menamakan semula fail
atau direktori jika ia ditukar. Untuk menamakan semula daripada subdirektori ke akar
repositori, gunakan . sebagai laluan untuk menamakan semula.
--penuh akan memastikan set perubahan yang ditukar mengandungi betul-betul fail yang betul dengan
kandungan yang betul. Ia akan membuat penukaran penuh semua fail, bukan hanya fail yang ada
berubah. Fail yang sudah betul tidak akan diubah. Ini boleh digunakan untuk memohon
filemap berubah apabila menukar secara berperingkat. Pada masa ini hanya disokong untuk
Mercurial dan Subversion.
Splicemap ialah fail yang membenarkan pemasukan sejarah sintetik, membenarkan anda menentukan
ibu bapa semakan. Ini berguna jika anda ingin contohnya memberikan Subversion merge dua
ibu bapa, atau cantumkan dua siri sejarah yang terputus bersama-sama. Setiap entri mengandungi kunci,
diikuti dengan ruang, diikuti dengan satu atau dua nilai yang dipisahkan koma:
kunci parent1, parent2
Kuncinya ialah ID semakan dalam sistem kawalan semakan sumber yang ibu bapanya sepatutnya
diubah suai (format yang sama seperti kunci dalam .hg/shamap). Nilai adalah ID semakan (dalam sama ada
sumber atau sistem kawalan semakan destinasi) yang sepatutnya digunakan sebagai ibu bapa baharu
untuk nod itu. Sebagai contoh, jika anda telah menggabungkan "release-1.0" ke dalam "trunk", maka anda sepatutnya
tentukan semakan pada "batang" sebagai induk pertama dan yang pada "release-1.0"
cawangan sebagai yang kedua.
Peta cawangan ialah fail yang membolehkan anda menamakan semula cawangan apabila ia dibawa masuk
dari mana-mana repositori luaran. Apabila digunakan bersama-sama dengan splicemap, ia membenarkan
untuk kombinasi yang berkuasa untuk membantu membetulkan repositori yang paling teruk diuruskan dan
mengubahnya menjadi repositori Mercurial yang berstruktur dengan baik. Peta cawangan mengandungi barisan
borang:
original_branch_name new_branch_name
dengan "nama_cawangan_asli" ialah nama cawangan dalam repositori sumber, dan
"new_branch_name" ialah nama cawangan ialah repositori destinasi. Tiada ruang kosong
dibenarkan dalam nama cawangan. Ini boleh digunakan untuk (sebagai contoh) memindahkan kod dalam satu
repositori daripada "lalai" kepada cawangan bernama.
Mercurial Source
Sumber Mercurial mengenali pilihan konfigurasi berikut, yang boleh anda tetapkan
baris arahan dengan --config:
convert.hg.ignoreerrors
abaikan ralat integriti semasa membaca. Gunakannya untuk membetulkan repositori Mercurial dengan
kehilangan revlog, dengan menukar dari dan kepada Mercurial. Lalai ialah Palsu.
convert.hg.saverev
simpan ID semakan asal dalam set perubahan (memaksa ID sasaran ditukar). Ia memerlukan a
hujah boolean dan lalai kepada False.
convert.hg.startrev
nyatakan semakan awal Mercurial. Lalai ialah 0.
convert.hg.revs
revset menyatakan semakan sumber untuk ditukar.
CVS Source
Sumber CVS akan menggunakan kotak pasir (iaitu salinan yang telah didaftarkan) daripada CVS untuk menunjukkan permulaan
titik apa yang akan ditukar. Akses terus ke fail repositori tidak diperlukan,
melainkan sudah tentu repositori adalah :lokal:. Penukaran menggunakan direktori peringkat teratas dalam
kotak pasir untuk mencari repositori CVS, dan kemudian menggunakan arahan rlog CVS untuk mencari fail
menukar. Ini bermakna melainkan jika filemap diberikan, semua fail di bawah direktori permulaan
akan ditukar dan bahawa sebarang penyusunan semula direktori dalam kotak pasir CVS diabaikan.
Pilihan berikut boleh digunakan dengan --config:
convert.cvsps.cache
Tetapkan kepada False untuk melumpuhkan cache log jauh, untuk tujuan ujian dan penyahpepijatan.
Lalai adalah Benar.
convert.cvsps.fuzz
Tentukan masa maksimum (dalam saat) yang dibenarkan antara komit dengan
pengguna yang sama dan mesej log dalam set perubahan tunggal. Apabila fail yang sangat besar
didaftar masuk sebagai sebahagian daripada set perubahan maka lalai mungkin tidak cukup panjang. The
lalai adalah 60.
convert.cvsps.mergeto
Tentukan ungkapan biasa yang mana mesej log komit dipadankan. Jika perlawanan
berlaku, maka proses penukaran akan memasukkan semakan dummy yang menggabungkan cawangan
di mana mesej log ini berlaku kepada cawangan yang ditunjukkan dalam regex. Lalai ialah
{{mergetobranch ([-\w]+)}}
convert.cvsps.mergefrom
Tentukan ungkapan biasa yang mana mesej log komit dipadankan. Jika perlawanan
berlaku, maka proses penukaran akan menambah semakan terkini pada cawangan
ditunjukkan dalam regex sebagai induk kedua set perubahan. Lalai ialah
{{mergefrombranch ([-\w]+)}}
convert.localtimezone
gunakan masa tempatan (seperti yang ditentukan oleh pembolehubah persekitaran TZ) untuk set perubahan
tarikh/masa. Lalai ialah Palsu (gunakan UTC).
cangkuk.cvslog
Tentukan fungsi Python untuk dipanggil pada akhir pengumpulan log CVS. The
fungsi diluluskan senarai dengan entri log, dan boleh mengubah suai entri
di tempat, atau tambah atau padamkannya.
hooks.cvschangesets
Tentukan fungsi Python untuk dipanggil selepas set perubahan dikira daripada
Log CVS. Fungsi ini diluluskan senarai dengan entri changeset, dan boleh mengubah suai
set perubahan di tempat, atau tambah atau padamkannya.
Perintah Mercurial "debugcvsps" tambahan membenarkan kod penggabungan set perubahan terbina ke
dijalankan tanpa melakukan penukaran. Parameter dan outputnya adalah serupa dengan cvsps
2.1. Sila lihat bantuan arahan untuk butiran lanjut.
Subversion Source
Sumber subversion mengesan reka letak batang/cawangan/tag klasik. Secara lalai, yang dibekalkan
svn://repo/path/ URL sumber ditukar sebagai cawangan tunggal. Jika svn://repo/path/trunk
wujud ia menggantikan cawangan lalai. Jika svn://repo/path/branches wujud, ia
subdirektori disenaraikan sebagai cawangan yang mungkin. Jika svn://repo/path/tags wujud, ia adalah
mencari teg yang merujuk kepada cawangan yang ditukar. lalai batang, cawangan and tags nilai
boleh diganti dengan pilihan berikut. Tetapkannya kepada laluan berbanding dengan URL sumber, atau
biarkan ia kosong untuk melumpuhkan pengesanan automatik.
Pilihan berikut boleh ditetapkan dengan --config:
convert.svn. branches
nyatakan direktori yang mengandungi cawangan. Lalainya ialah cawangan.
convert.svn.tags
tentukan direktori yang mengandungi tag. Lalainya ialah tags.
convert.svn.trunk
nyatakan nama dahan batang. Lalainya ialah batang.
convert.localtimezone
gunakan masa tempatan (seperti yang ditentukan oleh pembolehubah persekitaran TZ) untuk set perubahan
tarikh/masa. Lalai ialah Palsu (gunakan UTC).
Sejarah sumber boleh diambil bermula pada semakan khusus, bukannya menjadi
tertukar secara integral. Hanya penukaran cawangan tunggal disokong.
convert.svn.startrev
nyatakan mulakan nombor semakan Subversion. Lalai ialah 0.
Git Source
Pengimport Git menukar komit daripada semua cawangan yang boleh dicapai (rujuk dalam rujukan/kepala) dan
jauh (rujuk dalam rujukan/jarak jauh) kepada Mercurial. Cawangan ditukar kepada penanda halaman dengan
nama yang sama, dengan 'ref/heads' terkemuka dilucutkan. Submodul Git ditukar kepada Git
subrepos dalam Mercurial.
Pilihan berikut boleh ditetapkan dengan --config:
convert.git.similarity
nyatakan cara fail serupa yang diubah suai dalam komit mesti diimport sebagai nama semula atau
salinan, sebagai peratusan antara 0 (kurang upaya) dan 100 (fail mestilah sama). Untuk
contohnya, 90 bermakna pasangan padam/tambah akan diimport sebagai nama semula jika lebih daripada
90% daripada fail tidak berubah. Lalainya ialah 50.
convert.git.findcopiesharder
semasa mengesan salinan, lihat semua fail dalam salinan kerja dan bukannya hanya
yang berubah. Ini sangat mahal untuk projek besar, dan hanya berkesan apabila
convert.git.similarity adalah lebih besar daripada 0. Lalai ialah Palsu.
convert.git.remoterefix
rujukan jauh ditukar sebagai penanda halaman dengan convert.git.remoterefix sebagai awalan
diikuti oleh a /. Lalai ialah 'jauh'.
convert.git.skipsubmodules
tidak menukar fail .gitmodules peringkat akar atau fail dengan mod 160000 menunjukkan
submodul. Lalai ialah Palsu.
Berlubang Source
Pengimport Perforce (P4) boleh diberikan laluan depoh p4 atau spesifikasi pelanggan sebagai
sumber. Ia akan menukar semua fail dalam sumber kepada repositori Mercurial rata, mengabaikan
label, cawangan dan integrasi. Ambil perhatian bahawa apabila laluan depoh diberikan kepada anda maka biasanya
harus menentukan direktori sasaran, kerana jika tidak, sasaran mungkin dinamakan ...-hg.
Pilihan berikut boleh ditetapkan dengan --config:
convert.p4.encoding
nyatakan pengekodan untuk digunakan semasa menyahkod output standard perintah Perforce
alat garisan. Lalai ialah pengekodan sistem lalai.
convert.p4.startrev
nyatakan semakan Perforce awal (nombor senarai tukar Perforce).
Mercurial Destinasi
Destinasi Mercurial akan mengenali subrepositori Mercurial di destinasi
direktori, dan kemas kini fail .hgsubstate secara automatik jika destinasi
subrepositori mengandungi / /.hg/shamap fail. Menukar repositori dengan
subrepositori memerlukan penukaran satu repositori pada satu masa, dari bawah ke atas.
Contoh yang menunjukkan cara menukar repositori dengan subrepositori:
# jadi convert tahu jenis apabila ia melihat destinasi yang tidak kosong
$ hg init ditukar
$ hg tukar orig/sub1 ditukar/sub1
$ hg tukar orig/sub2 ditukar/sub2
$ hg tukar orig ditukar
Pilihan berikut disokong:
convert.hg.clonebranches
menghantar cawangan sumber dalam klon berasingan. Lalai ialah Palsu.
convert.hg.tagsbranch
nama cawangan untuk semakan teg, lalai kepada lalai.
convert.hg.usebranchnames
memelihara nama cawangan. Lalai ialah Benar.
convert.hg.sourcename
merekodkan rentetan yang diberikan sebagai nilai tambahan 'convert_source' pada setiap komit yang dibuat
repositori sasaran. Lalai ialah Tiada.
SEMUA Destinasi
Semua jenis destinasi menerima pilihan berikut:
convert.skiptags
tidak menukar teg daripada repo sumber kepada repo sasaran. Lalainya ialah
Salah.
Pilihan:
--pengarang
nama fail pemetaan nama pengguna (DEPRECATED) (gunakan --authormap sebaliknya)
-ya,--Jenis sumber
jenis repositori sumber
-d,--jenis-dest
jenis repositori destinasi
-r,--rev
import sehingga semakan sumber REV
-A,--peta pengarang
memetakan semula nama pengguna menggunakan fail ini
--peta fail
memetakan semula nama fail menggunakan kandungan fail
--penuh gunakan perubahan filemap dengan menukar semua fail sekali lagi
--splicemap
sambung mensintesis sejarah ke tempatnya
--peta cawangan
menukar nama cawangan semasa menukar
--cawangan
cuba susun perubahan mengikut cawangan
--datesort
cuba susun perubahan mengikut tarikh
--sourcesort
mengekalkan susunan perubahan sumber
--closesort
cuba susun semula semakan tertutup
[+] pilihan bertanda boleh ditentukan beberapa kali
eol
mengurus baris baharu secara automatik dalam fail repositori
Sambungan ini membolehkan anda mengurus jenis penghujung baris (CRLF atau LF) yang digunakan
repositori dan dalam direktori kerja tempatan. Dengan cara itu anda boleh mendapatkan penghujung baris CRLF
pada Windows dan LF pada Unix/Mac, dengan itu membenarkan semua orang menggunakan penghujung baris asli OS mereka.
Sambungan membaca konfigurasinya daripada versi .hgeol fail konfigurasi ditemui dalam
akar direktori kerja. The .hgeol fail menggunakan sintaks yang sama seperti semua yang lain
Fail konfigurasi Mercurial. Ia menggunakan dua bahagian, [corak] and [repositori].
. [corak] bahagian menentukan cara pengakhiran baris harus ditukar antara kerja
direktori dan repositori. Format ditentukan oleh corak fail. Perlawanan pertama
digunakan, jadi letakkan corak yang lebih khusus dahulu. Penghujung baris yang tersedia ialah LF, CRLF, dan
BIN.
Fail dengan format yang diisytiharkan CRLF or LF sentiasa diperiksa dan disimpan dalam
repositori dalam format itu dan fail yang diisytiharkan sebagai binari (BIN) dibiarkan tidak berubah.
Selain itu, asli ialah alias untuk menyemak dalam baris lalai platform berakhir:
LF pada Unix (termasuk Mac OS X) dan CRLF pada Windows. Perhatikan bahawa BIN (buat apa-apa untuk beratur
pengakhiran) ialah tingkah laku lalai Mercurial; ia hanya diperlukan jika anda perlu mengatasi a
kemudian, corak yang lebih umum.
Pilihannya [repositori] bahagian menentukan penghujung baris untuk digunakan untuk fail yang disimpan
repositori. Ia mempunyai tetapan tunggal, asli, yang menentukan penghujung talian storan
untuk fail yang diisytiharkan sebagai asli dalam [corak] bahagian. Ia boleh ditetapkan kepada LF or CRLF. Yang
lalai adalah LF. Sebagai contoh, ini bermakna pada Windows, fail dikonfigurasikan sebagai asli (CRLF
secara lalai) akan ditukar kepada LF apabila disimpan dalam repositori. Fail diisytiharkan sebagai LF,
CRLF, Atau BIN dalam [corak] bahagian sentiasa disimpan seperti sedia ada dalam repositori.
Contoh versi .hgeol fail:
[corak]
**.py = asli
**.vcproj = CRLF
**.txt = asli
Makefile = LF
**.jpg = BIN
[repositori]
asli = LF
Nota Peraturan pertama akan digunakan apabila fail disentuh dalam direktori kerja, cth
mengemas kini kepada null dan kembali ke hujung untuk menyentuh semua fail.
Sambungan menggunakan pilihan [eol] bahagian dibaca daripada kedua-dua Mercurial biasa
fail konfigurasi dan .hgeol fail, dengan yang terakhir mengatasi yang pertama. Awak boleh
gunakan bahagian itu untuk mengawal tingkah laku keseluruhan. Terdapat tiga tetapan:
· eol.asli (lalai os.linesep) boleh ditetapkan kepada LF or CRLF untuk mengatasi lalai
tafsiran asli untuk checkout. Ini boleh digunakan dengan hg arkib pada Unix, katakan, kepada
jana arkib di mana fail mempunyai penghujung baris untuk Windows.
· eol.only-konsisten (lalai Betul) boleh ditetapkan kepada Palsu untuk menukar sambungan
fail dengan EOL yang tidak konsisten. Tidak konsisten bermakna terdapat kedua-duanya CRLF and LF membentangkan
dalam fail. Fail sedemikian biasanya tidak disentuh dengan andaian bahawa mereka ada
bercampur EOL dengan sengaja.
· eol.fix-trailing-newline (lalai Salah) boleh ditetapkan kepada Benar untuk memastikan bahawa ditukar
fail berakhir dengan aksara EOL (sama ada \n or \ r \ n mengikut corak yang dikonfigurasikan).
Sambungan menyediakan cleverencode: and cleverdecode: penapis seperti yang ditamatkan
sambungan win32text tidak. Ini bermakna anda boleh melumpuhkan win32text dan mendayakan eol dan
penapis anda masih akan berfungsi. Anda hanya perlu menggunakan penapis ini sehingga anda telah menyediakan a
.hgeol fail.
. win32text.forbid* cangkuk yang disediakan oleh sambungan win32text telah disatukan menjadi a
cangkuk tunggal bernama eol.checkheadshook. Cangkuk akan mencari penghujung baris yang dijangkakan daripada
yang .hgeol fail, yang bermaksud anda mesti berhijrah ke a .hgeol fail dahulu sebelum menggunakan
cangkuk. eol.checkheadshook hanya memeriksa kepala, semakan tidak sah perantaraan akan ditolak.
Untuk melarang mereka sepenuhnya, gunakan eol.checkallhook cangkuk. Mata kail ini paling baik digunakan sebagai
pretxnchangegroup cangkuk.
Lihat hg membantu corak untuk maklumat lanjut tentang corak glob yang digunakan.
extdiff
arahan untuk membenarkan program luaran membandingkan semakan
Sambungan Extdiff Mercurial membolehkan anda menggunakan program luaran untuk membandingkan semakan,
atau semakan dengan direktori kerja. Program perbezaan luaran dipanggil dengan a
set pilihan boleh dikonfigurasikan dan dua argumen bukan pilihan: laluan ke direktori yang mengandungi
petikan fail untuk dibandingkan.
Sambungan extdiff juga membolehkan anda mengkonfigurasi perintah diff baharu, jadi anda tidak perlu
untuk menaip hg extdiff -p kdiff3 sentiasa.
[extdiff]
# tambah arahan baharu yang menjalankan GNU diff(1) dalam mod 'perbezaan konteks'
cdiff = gdiff -Nprc5
## atau cara lama:
#cmd.cdiff = gdiff
#opts.cdiff = -Nprc5
# tambah arahan baharu yang dipanggil meld, menjalankan meld (tidak perlu menamakan dua kali). Jika
# meld executable tidak tersedia, meld tool dalam [merge-tools]
# akan digunakan, jika ada
bercampur =
# tambah arahan baharu yang dipanggil vimdiff, jalankan gvimdiff dengan pemalam DirDiff
# (lihat http://www.vim.org/scripts/script.php?script_id=102) Bukan
# Pengguna Inggeris, pastikan anda meletakkan "let g:DirDiffDynamicDiffText = 1" dalam
# .vimrc anda
vimdiff = gvim -f "+next" \
"+laksanakan 'DirDiff' fnameescape(argv(0)) fnameescape(argv(1))"
Argumen alat boleh termasuk pembolehubah yang dikembangkan pada masa jalan:
$parent1, $plabel1 - nama fail, label deskriptif induk pertama
$child, $clabel - nama fail, label deskriptif semakan kanak-kanak
$parent2, $plabel2 - nama fail, label deskriptif induk kedua
$root - akar repositori
$parent ialah alias untuk $parent1.
Sambungan extdiff akan melihat dalam bahagian [diff-tools] dan [merge-tools] anda untuk perbezaan
argumen alat, apabila tiada yang dinyatakan dalam [extdiff].
[extdiff]
kdiff3 =
[alat-perbezaan]
kdiff3.diffargs=--L1 '$plabel1' --L2 '$clabel' $ibu bapa $anak
Anda boleh menggunakan -I/-X dan senarai nama fail atau direktori seperti biasa hg diff arahan. The
sambungan extdiff membuat syot kilat fail yang diperlukan sahaja, jadi jalankan perbezaan luaran
program sebenarnya akan menjadi agak pantas (sekurang-kurangnya lebih cepat daripada perlu membandingkan keseluruhan
pokok).
arahan
extdiff
gunakan program luaran untuk menyimpan repositori (atau fail terpilih):
hg extdiff [OPT]... [FAIL]...
Tunjukkan perbezaan antara semakan untuk fail yang ditentukan, menggunakan program luaran. The
program lalai yang digunakan adalah berbeza, dengan pilihan lalai "-Npru".
Untuk memilih program lain, gunakan pilihan -p/--program. Program ini akan diluluskan
nama dua direktori untuk dibandingkan. Untuk menghantar pilihan tambahan kepada program, gunakan
-o/--pilihan. Ini akan diluluskan sebelum nama direktori untuk dibandingkan.
Apabila dua hujah semakan diberikan, maka perubahan ditunjukkan antara semakan tersebut. Jika
hanya satu semakan ditentukan kemudian semakan itu dibandingkan dengan direktori kerja,
dan, apabila tiada semakan ditentukan, fail direktori kerja dibandingkan dengannya
ibu bapa.
Pilihan:
-p,--program
program perbandingan untuk dijalankan
-o,--pilihan
lulus pilihan kepada program perbandingan
-r,--rev
semakan
-c,--ubah
perubahan yang dibuat melalui semakan
--tampalan
bandingkan tampalan untuk dua semakan
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-S, --subrepos
berulang ke dalam subrepositori
[+] pilihan bertanda boleh ditentukan beberapa kali
factotum
pengesahan http dengan factotum
Sambungan ini membolehkan factotum(4) kemudahan pada Pelan 9 daripada platform Bell Labs ke
menyediakan maklumat pengesahan untuk akses HTTP. Entri konfigurasi yang dinyatakan dalam
bahagian auth serta maklumat pengesahan yang disediakan dalam URL repositori adalah
disokong sepenuhnya. Jika tiada awalan dinyatakan, nilai "*" akan diandaikan.
Secara lalai, kunci ditentukan sebagai:
proto=perkhidmatan lulus=awalan hg= pengguna= !kata laluan=
Jika sambungan factotum tidak dapat membaca kunci yang diperlukan, satu akan diminta
secara interaktif.
Bahagian konfigurasi tersedia untuk menyesuaikan tingkah laku masa jalan. Secara lalai, ini
penyertaan ialah:
[factotum]
boleh laku = /bin/auth/factotum
titik lekap = /mnt/factotum
perkhidmatan = hg
Entri boleh laku mentakrifkan laluan penuh ke binari factotum. Kemasukan titik lekap
mentakrifkan laluan ke perkhidmatan fail factotum. Akhir sekali, kemasukan perkhidmatan mengawal
nama perkhidmatan yang digunakan semasa membaca kekunci.
ambil
tarik, kemas kini dan cantumkan dalam satu arahan (DILARANG)
arahan
ambil
tarik perubahan dari repositori jauh, gabungkan perubahan baharu jika perlu.:
hg fetch [SUMBER]
Ini mencari semua perubahan daripada repositori di laluan atau URL yang ditentukan dan menambahkannya pada
repositori tempatan.
Jika perubahan yang ditarik menambah kepala cawangan baharu, kepala digabungkan secara automatik, dan
hasil gabungan itu dilakukan. Jika tidak, direktori kerja dikemas kini untuk disertakan
perubahan baru.
Apabila gabungan diperlukan, direktori kerja mula-mula dikemas kini kepada yang baru ditarik
perubahan. Perubahan setempat kemudiannya digabungkan ke dalam perubahan yang ditarik. Untuk menukar susunan cantuman,
gunakan --switch-parent.
Lihat hg membantu tarikh untuk senarai format yang sah untuk -d/--date.
Mengembalikan 0 pada kejayaan.
Pilihan:
-r,--rev
semakan khusus yang anda ingin tarik
-e, --edit
panggil editor pada komit mesej
--force-editor
edit mesej komitmen (TIDAK HARGA)
--tukar-induk
bertukar ibu bapa apabila bergabung
-m,--mesej
gunakan teks sebagai mesej komit
-l,--fail log
baca mesej komit daripada fail
-d,--Tarikh
rekod tarikh yang ditetapkan sebagai tarikh komit
-u,--pengguna
merekodkan pengguna yang ditentukan sebagai committer
-e,--ssh
tentukan arahan ssh untuk digunakan
--remotecmd
tentukan arahan hg untuk dijalankan pada bahagian jauh
--tidak selamat
jangan sahkan sijil pelayan (mengabaikan konfigurasi web.cacerts)
[+] pilihan bertanda boleh ditentukan beberapa kali
gpg
arahan untuk menandatangani dan mengesahkan perubahan
arahan
sigcheck
sahkan semua tandatangan yang mungkin ada untuk semakan tertentu:
hg tanda REV
sahkan semua tandatangan yang mungkin ada untuk semakan tertentu
menandatangani
tambah tandatangan untuk semakan semasa atau yang diberikan:
tanda hg [PILIHAN]... [REV]...
Jika tiada semakan diberikan, induk direktori kerja digunakan, atau petua jika tidak
semakan disemak.
. gpg.cmd tetapan konfigurasi boleh digunakan untuk menentukan arahan untuk dijalankan. Kunci lalai boleh
ditentukan dengan gpg.key.
Lihat hg membantu tarikh untuk senarai format yang sah untuk -d/--date.
Pilihan:
-l, --tempatan
jadikan tandatangan tempatan
-f, - kekuatan
tandatangan walaupun fail sig diubah suai
--tidak-komit
jangan lakukan sigfile selepas menandatangani
-k,--kunci
id kunci untuk ditandatangani
-m,--mesej
gunakan teks sebagai mesej komit
-e, --edit
panggil editor pada komit mesej
-d,--Tarikh
rekod tarikh yang ditetapkan sebagai tarikh komit
-u,--pengguna
merekodkan pengguna yang ditentukan sebagai committer
tanda-tanda
senaraikan perubahan yang ditandatangani:
hg sigs
senaraikan perubahan yang ditandatangani
graflog
arahan untuk melihat graf semakan daripada cangkerang (DIHENTIKAN)
Kefungsian sambungan ini telah disertakan dalam teras Mercurial sejak versi 2.3.
Sila guna hg log -G ... sebaliknya.
Sambungan ini menambah pilihan --graph pada arahan masuk, keluar dan log. Apabila ini
pilihan diberikan, perwakilan ASCII bagi graf semakan juga ditunjukkan.
arahan
hawthorn
tunjukkan sejarah semakan bersama graf semakan ASCII:
hg glog [PILIHAN]... [FAIL]
Cetak sejarah semakan bersama graf semakan yang dilukis dengan aksara ASCII.
Nod yang dicetak sebagai aksara @ adalah ibu bapa kepada direktori kerja.
Ini adalah alias kepada hg log -G.
Pilihan:
-f, --ikut
ikut sejarah set perubahan, atau sejarah fail merentas salinan dan nama semula
--ikut-dahulu
hanya ikuti induk pertama set perubahan gabungan (TAMAT)
-d,--Tarikh
tunjukkan semakan padanan spesifikasi tarikh
-C, --salinan
tunjukkan fail yang disalin
-k,--kata kunci
lakukan carian tidak peka huruf besar-besaran untuk teks tertentu
-r,--rev
tunjukkan semakan atau set semula yang ditentukan
--dialih keluar
termasuk semakan di mana fail telah dialih keluar
-m, --hanya-bercantum
tunjukkan cantuman sahaja (DILARANG)
-u,--pengguna
semakan yang dilakukan oleh pengguna
--cawangan sahaja
tunjukkan hanya set perubahan dalam cawangan bernama yang diberikan (TIDAK ADA)
-b,--cawangan
tunjukkan perubahan dalam cawangan bernama yang diberikan
-P,--pangkas
tidak memaparkan semakan atau mana-mana nenek moyangnya
-p, --tampalan
tunjukkan tampalan
-g, --git
gunakan format git extended diff
-l,--had
hadkan bilangan perubahan yang dipaparkan
-M, --tidak-bercantum
jangan tunjukkan cantuman
--stat keluaran ringkasan gaya diffstat bagi perubahan
-G, --graf
tunjukkan DAG semakan
--gaya
paparan menggunakan fail peta templat (DILARANG)
-T,--template
paparan dengan templat
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
hgcia
cangkuk untuk menyepadukan dengan perkhidmatan pemberitahuan CIA.vc
Ini bertujuan untuk dijalankan sebagai kumpulan perubahan atau cangkuk masuk. Untuk mengkonfigurasinya, tetapkan
pilihan berikut dalam hgrc anda:
[cia]
# nama pengguna CIA berdaftar anda
pengguna = foo
# nama projek di CIA
projek = foo
# modul (subprojek) (pilihan)
#modul = foo
# Tambahkan diffstat pada mesej log (pilihan)
#diffstat = Salah
# Templat untuk digunakan untuk mesej log (pilihan)
#template = {desc}\n{baseurl}{webroot}/rev/{nod}-- {diffstat}
# Gaya untuk digunakan (pilihan)
#style = foo
# URL perkhidmatan pemberitahuan CIA (pilihan)
# Anda boleh menggunakan mailto: URL untuk dihantar melalui e-mel, cth
# mailto:[e-mel dilindungi]
# Pastikan anda menetapkan email.from jika anda melakukan ini.
#url = http://cia.vc/
# cetak mesej dan bukannya menghantarnya (pilihan)
#test = Salah
# bilangan garis miring untuk dilucutkan untuk laluan url
#jalur = 0
[cangkuk]
# salah satu daripada ini:
changegroup.cia = python:hgcia.hook
#incoming.cia = python:hgcia.hook
[laman web]
# Jika anda mahukan hiperpautan (pilihan)
baseurl = http://server/path/to/repo
hgk
semak imbas repositori dalam cara grafik
Sambungan hgk membolehkan menyemak imbas sejarah repositori dalam cara grafik. Ia
memerlukan Tcl/Tk versi 8.4 atau lebih baru. (Tcl/Tk tidak diedarkan dengan Mercurial.)
hgk terdiri daripada dua bahagian: skrip Tcl yang melakukan paparan dan pertanyaan
maklumat, dan sambungan kepada Mercurial bernama hgk.py, yang menyediakan cangkuk untuk hgk to
dapat maklumat. hgk boleh didapati dalam direktori sumbangan, dan sambungan dihantar
dalam repositori hgext, dan perlu didayakan.
. hg pandangan arahan akan melancarkan skrip hgk Tcl. Untuk arahan ini berfungsi, hgk mestilah
dalam laluan carian anda. Secara bergantian, anda boleh menentukan laluan ke hgk dalam konfigurasi anda
fail:
[hgk]
laluan = /lokasi/of/hgk
hgk boleh menggunakan sambungan extdiff untuk menggambarkan semakan. Dengan andaian anda telah
sudah mengkonfigurasi arahan extdiff vdiff, cuma tambah:
[hgk]
vdiff=vdiff
Menu konteks semakan kini akan memaparkan entri tambahan untuk menyalakan vdiff pada berlegar dan
semakan terpilih.
arahan
pandangan
mulakan pemapar sejarah interaktif:
hg paparan [-l LIMIT] [REVRANGE]
mulakan pemapar sejarah interaktif
Pilihan:
-l,--had
hadkan bilangan perubahan yang dipaparkan
menyerlahkan
penonjolan sintaks untuk hgweb (memerlukan Pygments)
Ia bergantung pada pustaka penonjolan sintaks Pygments: http://pygments.org/
Terdapat pilihan konfigurasi berikut:
[laman web]
pygments_style = (default: colorful)
highlightfiles = (lalai: saiz('<5M'))
highlightonlymatchfilename = (lalai Salah)
highlightonlymatchfilename hanya akan menyerlahkan fail jika jenisnya boleh dikenal pasti oleh
nama fail mereka. Apabila ini tidak didayakan (lalai), Pygments akan berusaha keras untuk melakukannya
mengenal pasti jenis fail daripada kandungan dan sebarang padanan (walaupun padanan dengan keyakinan rendah
skor) akan digunakan.
histedit
penyuntingan sejarah interaktif
Dengan sambungan ini dipasang, Mercurial memperoleh satu arahan baharu: histedit. Penggunaan adalah sebagai
berikut, dengan mengandaikan sejarah berikut:
@ 3[tip] 7c2fd3b9020c 2009-04-27 18:04 -0500 durin42
| Tambah delta
|
o 2 030b686bedc4 2009-04-27 18:04 -0500 durin42
| Tambah gamma
|
o 1 c561b4e977df 2009-04-27 18:04 -0500 durin42
| Tambah beta
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 durin42
Tambah alfa
Jika anda lari hg histedit c561b4e977df, anda akan melihat fail berikut dibuka dalam anda
editor:
pilih c561b4e977df Tambah beta
pilih 030b686bedc4 Tambah gamma
pilih 7c2fd3b9020c Tambah delta
# Edit sejarah antara c561b4e977df dan 7c2fd3b9020c
#
# Komit disenaraikan daripada yang paling kurang kepada yang paling terkini
#
# Perintah:
# p, pilih = gunakan komit
# e, edit = gunakan komit, tetapi berhenti untuk meminda
# f, fold = gunakan commit, tetapi gabungkannya dengan yang di atas
# r, roll = suka lipat, tetapi buang perihalan komit ini
# d, drop = buang komit daripada sejarah
# m, kucar-kacir = edit mesej komit tanpa mengubah kandungan komit
#
Dalam fail ini, baris bermula dengan # tidak diendahkan. Anda mesti menentukan peraturan untuk setiap satu
semakan dalam sejarah anda. Contohnya, jika anda ingin menambah gamma sebelum beta, dan kemudian
ingin menambah delta dalam semakan yang sama seperti beta, anda akan menyusun semula fail untuk dilihat
seperti ini:
pilih 030b686bedc4 Tambah gamma
pilih c561b4e977df Tambah beta
lipat 7c2fd3b9020c Tambah delta
# Edit sejarah antara c561b4e977df dan 7c2fd3b9020c
#
# Komit disenaraikan daripada yang paling kurang kepada yang paling terkini
#
# Perintah:
# p, pilih = gunakan komit
# e, edit = gunakan komit, tetapi berhenti untuk meminda
# f, fold = gunakan commit, tetapi gabungkannya dengan yang di atas
# r, roll = suka lipat, tetapi buang perihalan komit ini
# d, drop = buang komit daripada sejarah
# m, kucar-kacir = edit mesej komit tanpa mengubah kandungan komit
#
Pada ketika itu anda menutup editor dan histedit mula bekerja. Apabila anda menyatakan a kali ganda
operasi, histedit akan membuka editor apabila ia melipat semakan tersebut bersama-sama, menawarkan
anda berpeluang untuk membersihkan mesej komit:
Tambah beta
***
Tambah delta
Edit mesej komit mengikut keinginan anda, kemudian tutup editor. Untuk contoh ini, mari
menganggap bahawa mesej komit telah ditukar kepada Tambah beta and delta. Selepas histedit telah dijalankan
dan mempunyai peluang untuk mengalih keluar sebarang semakan lama atau sementara yang diperlukan, sejarah kelihatan
seperti ini:
@ 2[tip] 989b4d060121 2009-04-27 18:04 -0500 durin42
| Tambah beta dan delta.
|
o 1 081603921c3f 2009-04-27 18:04 -0500 durin42
| Tambah gamma
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 durin42
Tambah alfa
Perhatikan bahawa histedit tidak tidak alih keluar sebarang semakan (walaupun yang sementara) sehingga selepas itu
ia telah menyelesaikan semua operasi penyuntingan, jadi ia mungkin akan melakukan beberapa jalur
operasi apabila ia selesai. Untuk contoh di atas, ia terpaksa menjalankan jalur dua kali. Strip boleh
perlahan bergantung pada pelbagai faktor, jadi anda mungkin perlu bersabar sedikit. Awak boleh
memilih untuk mengekalkan semakan asal dengan melepasi --simpan bendera.
. mengedit operasi akan menjatuhkan anda kembali ke gesaan arahan, membolehkan anda mengedit fail
secara bebas, atau bahkan digunakan hg rekod untuk melakukan beberapa perubahan sebagai komitmen yang berasingan. Apabila anda
selesai, sebarang perubahan tidak komited yang tinggal akan dilakukan juga. Apabila selesai, lari hg
histedit --sambung untuk menyelesaikan langkah ini. Anda akan digesa untuk mesej komit baharu, tetapi
mesej komit lalai akan menjadi mesej asal untuk mengedit semakan ed.
. mesej operasi akan memberi anda peluang untuk menyemak semula mesej komit tanpa mengubah
isi kandungan. Ia adalah jalan pintas untuk melakukan mengedit segera diikuti oleh hg histedit
--sambung`.
If histedit menghadapi konflik apabila memindahkan semakan (semasa mengendalikan memilih or kali ganda),
ia akan berhenti dengan cara yang sama dengan mengedit dengan perbezaan bahawa ia tidak akan menggesa anda untuk a
komit mesej apabila selesai. Jika anda membuat keputusan pada ketika ini bahawa anda tidak suka berapa banyak kerja itu
adalah untuk menyusun semula sejarah, atau anda membuat kesilapan, anda boleh gunakan hg histedit --menggugurkan kandungan
untuk meninggalkan perubahan baharu yang telah anda buat dan kembali ke keadaan sebelum anda cuba melakukannya
edit sejarah anda.
Jika kita mengklonkan repositori contoh histedit di atas dan menambah empat lagi perubahan, seperti itu
kita mempunyai sejarah berikut:
@ 6[tip] 038383181893 2009-04-27 18:04 -0500 stefan
| Tambah theta
|
o 5 140988835471 2009-04-27 18:04 -0500 stefan
| Tambah eta
|
o 4 122930637314 2009-04-27 18:04 -0500 stefan
| Tambah zeta
|
o 3 836302820282 2009-04-27 18:04 -0500 stefan
| Tambah epsilon
|
o 2 989b4d060121 2009-04-27 18:04 -0500 durin42
| Tambah beta dan delta.
|
o 1 081603921c3f 2009-04-27 18:04 -0500 durin42
| Tambah gamma
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 durin42
Tambah alfa
Jika anda berlari hg histedit --keluar pada klon maka ia adalah sama seperti berjalan hg histedit
836302820282. Jika anda perlu merancang untuk menolak ke repositori yang tidak dikesan oleh Mercurial
berkaitan dengan repo sumber, anda boleh menambah a - kekuatan pilihan.
config
Garis peraturan histedit dipotong kepada 80 aksara secara lalai. Anda boleh menyesuaikan ini
tingkah laku dengan menetapkan panjang yang berbeza dalam fail konfigurasi anda:
[sejarah]
linelen = 120 # potong baris peraturan pada 120 aksara
hg histedit cuba memilih semakan asas yang sesuai secara automatik untuk digunakan. Kepada
tukar semakan asas yang digunakan, tentukan set semula dalam fail konfigurasi anda:
[sejarah]
defaultrev = sahaja(.) & draf()
Secara lalai setiap semakan yang diedit perlu ada dalam arahan histedit. Untuk mengeluarkan
semakan yang perlu anda gunakan menggugurkan operasi. Anda boleh mengkonfigurasi penurunan untuk menjadi tersirat
komitmen yang hilang dengan menambah:
[sejarah]
dropmissing = Benar
arahan
histedit
edit sejarah set perubahan secara interaktif:
hg histedit [PILIHAN] ([LEMURU] | --keluar [URL])
Perintah ini membolehkan anda mengedit siri perubahan linear (sehingga dan termasuk kerja
direktori, yang sepatutnya bersih). Awak boleh:
· memilih untuk [semula] memesan set perubahan
· menggugurkan untuk meninggalkan changeset
· mes untuk kata semula mesej komit changeset
· kali ganda untuk menggabungkannya dengan set perubahan sebelumnya
· roll seperti lipat, tetapi membuang penerangan komit ini
· mengedit untuk mengedit set perubahan ini
Terdapat beberapa cara untuk memilih set perubahan akar:
· Tentukan ANCESTOR secara langsung
· Gunakan --outgoing -- ia akan menjadi set perubahan linear pertama yang tidak disertakan dalam destinasi.
(Lihat hg membantu config.default-push)
· Jika tidak, nilai daripada pilihan konfigurasi "histedit.defaultrev" digunakan sebagai set semula kepada
pilih semakan asas apabila ANCESTOR tidak dinyatakan. Semakan pertama dikembalikan oleh
revset digunakan. Secara lalai, ini memilih sejarah boleh diedit yang unik kepada
keturunan direktori kerja.
Jika anda menggunakan --outgoing, arahan ini akan dibatalkan jika terdapat semakan keluar yang samar-samar.
Contohnya, jika terdapat berbilang cawangan yang mengandungi semakan keluar.
Gunakan "min(keluar() dan ::.)" atau spesifikasi tetapan semula yang serupa dan bukannya --keluar ke
nyatakan semakan sasaran edit betul-betul dalam keadaan samar-samar sedemikian. Lihat hg membantu set semula Untuk
terperinci tentang memilih semakan.
Contoh:
· Beberapa perubahan telah dibuat. Semakan 3 tidak lagi diperlukan.
Mulakan penyuntingan sejarah dari semakan 3:
hg histedit -r 3
Editor dibuka, mengandungi senarai semakan, dengan tindakan khusus yang ditentukan:
pilih 5339bf82f0ca 3 Zworgle the foobar
pilih 8ef592ce7cc4 4 Bedazzle the zerlog
pilih 0a9639fcda9d 5 Morgify the cromulancy
Maklumat tambahan tentang kemungkinan tindakan yang perlu diambil muncul di bawah senarai
semakan.
Untuk mengalih keluar semakan 3 daripada sejarah, tindakannya (pada permulaan yang berkaitan
baris) ditukar kepada 'jatuhkan':
lepaskan 5339bf82f0ca 3 Zworgle the foobar
pilih 8ef592ce7cc4 4 Bedazzle the zerlog
pilih 0a9639fcda9d 5 Morgify the cromulancy
· Beberapa perubahan telah dibuat. Semakan 2 dan 4 perlu ditukar.
Mulakan penyuntingan sejarah dari semakan 2:
hg histedit -r 2
Editor dibuka, mengandungi senarai semakan, dengan tindakan khusus yang ditentukan:
pilih 252a1af424ad 2 Blorb morgwazzle
pilih 5339bf82f0ca 3 Zworgle the foobar
pilih 8ef592ce7cc4 4 Bedazzle the zerlog
Untuk menukar semakan 2 dan 4, barisnya ditukar dalam editor:
pilih 8ef592ce7cc4 4 Bedazzle the zerlog
pilih 5339bf82f0ca 3 Zworgle the foobar
pilih 252a1af424ad 2 Blorb morgwazzle
Mengembalikan 0 pada kejayaan, 1 jika campur tangan pengguna diperlukan (bukan sahaja untuk "edit" yang disengajakan
perintah, tetapi juga untuk menyelesaikan konflik yang tidak dijangka).
Pilihan:
--perintah
baca suntingan sejarah daripada fail yang ditentukan
-c, --sambung
teruskan pengeditan yang sedang dijalankan
--edit-plan
edit senarai tindakan yang tinggal
-k, --simpan
jangan tanggalkan nod lama selepas pengeditan selesai
--menggugurkan kandungan
hentikan suntingan yang sedang dijalankan
-o, --keluar
perubahan tidak ditemui di destinasi
-f, - kekuatan
memaksa keluar walaupun untuk repositori yang tidak berkaitan
-r,--rev
semakan pertama untuk disunting
[+] pilihan bertanda boleh ditentukan beberapa kali
kata kunci
mengembangkan kata kunci dalam fail yang dijejaki
Sambungan ini mengembangkan $Kata Kunci$ seperti RCS/CVS atau disesuaikan sendiri dalam fail teks yang dijejaki
dipilih mengikut konfigurasi anda.
Kata kunci hanya dikembangkan dalam repositori tempatan dan tidak disimpan dalam sejarah perubahan. The
mekanisme boleh dianggap sebagai kemudahan untuk pengguna semasa atau untuk arkib
Pengedaran.
Kata kunci berkembang kepada data set perubahan yang berkaitan dengan perubahan terkini berbanding dengan
induk direktori kerja setiap fail.
Konfigurasi dilakukan dalam bahagian [kata kunci], [set kata kunci] dan [peta kata kunci] hgrc
fail.
Contoh:
[kata kunci]
# kembangkan kata kunci dalam setiap fail python kecuali yang sepadan dengan "x*"
**.py =
x* = abaikan
[set kata kunci]
# lebih suka svn- daripada peta kata kunci lalai seperti cvs
svn = Benar
Nota Lebih spesifik anda dalam corak nama fail anda semakin kurang anda kehilangan kelajuan dalam besar
repositori.
Untuk [peta kata kunci] pemetaan templat dan demonstrasi pengembangan dan kawalan dijalankan hg kwdemo.
Lihat hg membantu template untuk senarai templat dan penapis yang tersedia.
Tiga penapis templat tarikh tambahan disediakan:
utcdate
"2006/09/18 15:13:13"
svnutcdate
"2006-09-18 15:13:13Z"
svnisodate
"2006-09-18 08:13:13 -700 (Isnin, 18 Sep 2006)"
Pemetaan templat lalai (lihat dengan hg kwdemo -d) boleh digantikan dengan tersuai
kata kunci dan templat. Sekali lagi, lari hg kwdemo untuk mengawal keputusan konfigurasi anda
perubahan.
Sebelum menukar/melumpuhkan kata kunci aktif, anda mesti menjalankan hg kwshrink untuk mengelakkan penyimpanan
kata kunci yang diperluaskan dalam sejarah perubahan.
Untuk memaksa pengembangan selepas mendayakannya, atau perubahan konfigurasi, jalankan hg kwexpand.
Pengembangan yang merangkumi lebih daripada satu baris dan pengembangan tambahan, seperti $Log$ CVS, adalah
tidak disokong. Peta templat kata kunci "Log = {desc}" berkembang ke baris pertama
penerangan set perubahan.
arahan
kwdemo
cetak konfigurasi [peta kata kunci] dan contoh pengembangan:
hg kwdemo [-d] [-f RCFILE] [TEMPLATEMAP]...
Tunjukkan peta templat kata kunci semasa, tersuai atau lalai dan pengembangannya.
Panjangkan konfigurasi semasa dengan menentukan peta sebagai argumen dan menggunakan -f/--rcfile to
sumber fail hgrc luaran.
Gunakan -d/--default untuk melumpuhkan konfigurasi semasa.
Lihat hg membantu template untuk maklumat tentang templat dan penapis.
Pilihan:
-d, --lalai
tunjukkan peta templat kata kunci lalai
-f,--rcfile
baca peta dari rcfile
kwexpand
kembangkan kata kunci dalam direktori kerja:
hg kwexpand [PILIHAN]... [FAIL]...
Jalankan selepas (semula) mendayakan pengembangan kata kunci.
kwexpand enggan dijalankan jika fail yang diberikan mengandungi perubahan setempat.
Pilihan:
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
kwfiles
tunjukkan fail yang dikonfigurasikan untuk pengembangan kata kunci:
hg kwfiles [PILIHAN]... [FAIL]...
Senaraikan fail dalam direktori kerja yang dipadankan dengan konfigurasi [kata kunci].
corak.
Berguna untuk mengelakkan pengembangan kata kunci yang tidak disengajakan dan untuk mempercepatkan pelaksanaan dengan memasukkan
hanya fail yang merupakan calon sebenar untuk pengembangan.
Lihat hg membantu kata kunci tentang cara membina corak untuk kemasukan dan pengecualian
fail.
Dengan -A/--all dan -v/--verbose kod yang digunakan untuk menunjukkan status fail ialah:
K = calon pengembangan kata kunci
k = calon pengembangan kata kunci (tidak dijejaki)
Saya = tidak diendahkan
i = diabaikan (tidak dijejaki)
Pilihan:
-A, --semua
tunjukkan bendera status kata kunci semua fail
-saya, --abai
tunjukkan fail yang dikecualikan daripada pengembangan
-u, --tidak diketahui
hanya tunjukkan fail yang tidak diketahui (tidak dijejaki).
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
kwshrink
kembalikan kata kunci yang dikembangkan dalam direktori kerja:
hg kwshrink [PILIHAN]... [FAIL]...
Mesti dijalankan sebelum menukar/melumpuhkan kata kunci aktif.
kwshrink enggan dijalankan jika fail yang diberikan mengandungi perubahan setempat.
Pilihan:
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
fail besar
menjejaki fail binari yang besar
Fail binari yang besar cenderung untuk tidak terlalu mampat, tidak boleh difailkan dan tidak sama sekali
boleh digabungkan. Fail sedemikian tidak dikendalikan dengan cekap oleh format storan Mercurial (revlog),
yang berdasarkan delta binari termampat; menyimpan fail binari yang besar seperti biasa
Fail Mercurial membazir lebar jalur dan ruang cakera dan meningkatkan penggunaan memori Mercurial.
Sambungan largefiles menangani masalah ini dengan menambahkan pelayan pelanggan berpusat
lapisan di atas Mercurial: fail besar hidup dalam a pusat menyimpan keluar pada rangkaian
di suatu tempat, dan anda hanya mengambil semakan yang anda perlukan apabila anda memerlukannya.
largefiles berfungsi dengan mengekalkan "standin file" dalam .hglf/ untuk setiap largefile. The
standin adalah kecil (41 bait: cincang SHA-1 ditambah baris baharu) dan dijejaki oleh Mercurial.
Semakan fail besar dikenal pasti oleh cincang SHA-1 kandungannya, yang ditulis
kepada standin. largefiles menggunakan ID semakan itu untuk mendapatkan/meletakkan semakan fail besar dari/ke
kedai pusat. Ini menjimatkan ruang cakera dan lebar jalur, kerana anda tidak perlu melakukannya
dapatkan semula semua semakan sejarah fail besar apabila anda mengklon atau menarik.
Untuk memulakan repositori baharu atau menambah fail binari besar baharu, cuma tambah --large pada fail anda hg menambah
arahan. Sebagai contoh:
$ dd if=/dev/urandom of=randomdata count=2000
$ hg tambah --data rawak besar
$ hg commit -m 'tambah data rawak sebagai fail besar'
Apabila anda menolak set perubahan yang menambah/mengubah suai fail besar ke repositori jauh, ia
semakan fail besar akan dimuat naik bersama-sama dengannya. Ambil perhatian bahawa Mercurial jauh mesti
juga mempunyai sambungan largefiles didayakan untuk ini berfungsi.
Apabila anda menarik set perubahan yang mempengaruhi fail besar dari repositori jauh, fail besar
kerana set perubahan secara lalai tidak akan ditarik ke bawah. Walau bagaimanapun, apabila anda mengemas kini kepada a
semakan, sebarang fail besar yang diperlukan oleh semakan itu dimuat turun dan dicache (jika ada
tidak pernah dimuat turun sebelum ini). Satu cara untuk menarik fail besar apabila menarik adalah dengan menggunakan
--update, yang akan mengemas kini salinan kerja anda kepada semakan ditarik terkini (dan dengan itu
memuat turun mana-mana fail besar baharu).
Jika anda ingin menarik fail besar yang anda belum perlukan kemas kini, maka anda boleh menggunakan pull with
yang --lfrev pilihan atau hg lfpull perintah.
Jika anda tahu anda menarik dari lokasi bukan lalai dan ingin memuat turun semua
fail besar yang sepadan dengan set perubahan baharu pada masa yang sama, kemudian anda boleh tarik dengan
--lfrev "ditarik()".
Jika anda hanya ingin memastikan bahawa anda akan mempunyai fail besar yang diperlukan untuk digabungkan atau pangkalan semula
dengan kepala baru yang anda tarik, maka anda boleh tarik dengan --lfrev "kepala(ditarik())" bendera
untuk memuat turun terlebih dahulu mana-mana fail besar yang baharu dalam tajuk yang anda tarik.
Perlu diingat bahawa akses rangkaian kini mungkin diperlukan untuk mengemas kini kepada set perubahan yang anda miliki
tidak dikemas kini sebelum ini kepada. Sifat sambungan largefiles bermakna pengemaskinian adalah
tidak lagi dijamin sebagai operasi tempatan sahaja.
Jika anda sudah mempunyai fail besar yang dijejaki oleh Mercurial tanpa sambungan largefiles, anda
perlu menukar repositori anda untuk mendapat manfaat daripada fail besar. Ini telah selesai
dengan hg lfconvert arahan:
$ hg lfconvert --saiz 10 oldrepo newrepo
Dalam repositori yang sudah mempunyai fail besar di dalamnya, mana-mana fail baharu melebihi 10MB akan
secara automatik ditambah sebagai fail besar. Untuk menukar ambang ini, tetapkan largefiles.minsize in
fail konfigurasi Mercurial anda kepada saiz minimum dalam megabait untuk dijejaki sebagai fail besar, atau
gunakan pilihan --lfsize untuk arahan tambah (juga dalam megabait):
[fail besar]
saiz kecil = 2
$ hg tambah --lfsize 2
. fail besar.corak pilihan konfigurasi membolehkan anda menentukan senarai corak nama fail
(Lihat hg membantu corak) yang harus sentiasa dijejaki sebagai fail besar:
[fail besar]
corak =
* .jpg
semula:.*\.(png|bmp)$
perpustakaan.zip
kandungan/audio/*
Fail yang sepadan dengan salah satu corak ini akan ditambahkan sebagai fail besar tanpa mengira coraknya
saiz.
. largefiles.minsize and fail besar.corak pilihan konfigurasi akan diabaikan untuk sebarang
repositori belum lagi mengandungi fail besar. Untuk menambah fail besar pertama ke a
repositori, anda mesti melakukannya secara eksplisit dengan bendera --large yang dihantar ke hg menambah perintah.
arahan
lfconvert
tukar repositori biasa kepada repositori largefiles:
hg lfconvert SOURCE DEST [FAIL ...]
Tukar repositori SOURCE kepada DEST repositori baharu, sama dengan SOURCE kecuali itu
fail tertentu akan ditukar sebagai fail besar: khususnya, mana-mana fail yang sepadan dengan mana-mana
CORAK or yang saiznya melebihi ambang saiz minimum ditukarkan sebagai fail besar. The
saiz yang digunakan untuk menentukan sama ada untuk menjejak fail sebagai fail besar atau tidak adalah saiz
versi pertama fail. Saiz minimum boleh ditentukan sama ada dengan --size atau in
konfigurasi sebagai fail besar.saiz.
Selepas menjalankan arahan ini, anda perlu memastikan bahawa fail besar didayakan di mana-mana sahaja
anda berhasrat untuk menolak repositori baharu.
Gunakan --ke-normal untuk menukar fail besar kembali kepada fail biasa; selepas ini, DEST
repositori boleh digunakan tanpa fail besar sama sekali.
Pilihan:
-ya,--saiz
saiz minimum (MB) untuk fail ditukarkan sebagai fail besar
--ke-normal
tukar daripada repo largefiles kepada repo biasa
lfpull
tarik fail besar untuk semakan yang ditentukan dari sumber yang ditentukan:
hg lfpull -r REV... [-e CMD] [--remotecmd CMD] [SUMBER]
Tarik fail besar yang dirujuk daripada set perubahan tempatan tetapi hilang secara setempat, tarik
daripada repositori jauh ke cache setempat.
Jika SOURCE ditinggalkan, laluan 'lalai' akan digunakan. Lihat hg membantu url selama lebih
maklumat.
Beberapa contoh:
· tarik fail besar untuk semua ketua cawangan:
hg lfpull -r "head() dan tidak ditutup()"
· tarik fail besar pada cawangan lalai:
hg lfpull -r "cawangan(lalai)"
Pilihan:
-r,--rev
tarik fail besar untuk semakan ini
-e,--ssh
tentukan arahan ssh untuk digunakan
--remotecmd
tentukan arahan hg untuk dijalankan pada bahagian jauh
--tidak selamat
jangan sahkan sijil pelayan (mengabaikan konfigurasi web.cacerts)
[+] pilihan bertanda boleh ditentukan beberapa kali
mq
menguruskan timbunan tampalan
Sambungan ini membolehkan anda bekerja dengan timbunan tampalan dalam repositori Mercurial. Ia menguruskan
dua timbunan tampalan - semua tampalan yang diketahui, dan tampalan yang digunakan (subset tampung yang diketahui).
Tampalan yang diketahui diwakili sebagai fail tampalan dalam direktori .hg/patches. Tampalan yang digunakan
ialah fail tampalan dan set perubahan.
Tugas biasa (gunakan hg membantu arahan untuk butiran lanjut):
buat patch baru qnew
import patch qimport sedia ada
cetak tampalan siri qseries
cetak tampalan yang digunakan qapplied
tambah patch yang diketahui pada timbunan qpush yang digunakan
keluarkan tampalan daripada timbunan qpop yang digunakan
muat semula kandungan tampalan atas yang digunakan qrefresh
Secara lalai, mq akan menggunakan patch git secara automatik apabila diperlukan untuk mengelakkan kehilangan mod fail
perubahan, menyalin rekod, fail binari atau fail kosong ciptaan atau pemadaman. Tingkah laku ini
boleh dikonfigurasikan dengan:
[mq]
git = auto/keep/ya/tidak
Jika ditetapkan kepada 'keep', mq akan mematuhi konfigurasi bahagian [diff] sambil mengekalkan sedia ada
tampalan git apabila qrefresh. Jika ditetapkan kepada 'ya' atau 'tidak', mq akan mengatasi bahagian [perbezaan].
dan sentiasa menjana patch git atau biasa, mungkin kehilangan data dalam kes kedua.
Ia mungkin wajar untuk mq changeset disimpan dalam fasa rahsia (lihat hg membantu fasa),
yang boleh didayakan dengan tetapan berikut:
[mq]
rahsia = Benar
Anda secara lalai akan menguruskan baris gilir tampung bernama "tampalan". Anda boleh mencipta yang lain,
tampalan beratur bebas dengan hg beratur perintah.
Jika direktori kerja mengandungi fail tidak terikat, qpush, qpop dan qgoto batalkan
serta merta. Jika -f/--force digunakan, perubahan akan dibuang. Tetapan:
[mq]
keepchanges = Benar
buat mereka berkelakuan seolah-olah --keep-changes telah diluluskan, dan perubahan tempatan yang tidak bercanggah akan
diterima dan dipelihara. Jika pilihan yang tidak serasi seperti -f/--force atau --exact adalah
lulus, tetapan ini diabaikan.
Sambungan ini digunakan untuk menyediakan arahan jalur. Perintah ini kini tinggal dalam jalur
sambungan.
arahan
qapplied
cetak tampalan yang telah digunakan:
hg qapplied [-1] [-s] [PATCH]
Mengembalikan 0 pada kejayaan.
Pilihan:
-1, --terakhir
tunjukkan hanya tampalan yang digunakan sebelumnya
-ya, --ringkasan
cetak baris pertama pengepala tampalan
qclone
klon repositori utama dan tampalan pada masa yang sama:
hg qclone [PILIHAN]... SUMBER [DEST]
Jika sumber adalah setempat, destinasi tidak akan menggunakan tampalan. Jika sumber jauh, ini
arahan tidak boleh menyemak sama ada patch digunakan dalam sumber, jadi tidak dapat menjamin bahawa patch
tidak digunakan di destinasi. Jika anda mengklon repositori jauh, pastikan sebelum itu ia ada
tiada tampalan digunakan.
Repositori patch sumber dicari dalam /.hg/patches secara lalai. Gunakan -p kepada
berubah.
Direktori tampalan mestilah repositori Mercurial bersarang, seperti yang akan dibuat oleh hg INIT
--mq.
Pulangan 0 pada kejayaan.
Pilihan:
--tarik gunakan protokol tarik untuk menyalin metadata
-U, --tiada kemas kini
jangan kemas kini direktori kerja baharu
--tidak dimampatkan
gunakan pemindahan tidak termampat (cepat melalui LAN)
-p,--tompok
lokasi repositori patch sumber
-e,--ssh
tentukan arahan ssh untuk digunakan
--remotecmd
tentukan arahan hg untuk dijalankan pada bahagian jauh
--tidak selamat
jangan sahkan sijil pelayan (mengabaikan konfigurasi web.cacerts)
qcommit
melakukan perubahan dalam repositori baris gilir (TIDAK ADA):
hg qcommit [PILIHAN]... [FAIL]...
Perintah ini ditamatkan; guna hg melakukan --mq sebaliknya.
Pilihan:
-A, --addremove
tandakan fail baharu/tiada sebagai ditambah/dialih keluar sebelum melakukan
--cawangan-tutup
tandakan kepala cawangan sebagai tertutup
- amend
meminda induk direktori kerja
-ya, --rahsia
gunakan fasa rahsia untuk melakukan
-e, --edit
panggil editor pada komit mesej
-saya, --interaktif
gunakan mod interaktif
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-m,--mesej
gunakan teks sebagai mesej komit
-l,--fail log
baca mesej komit daripada fail
-d,--Tarikh
rekod tarikh yang ditetapkan sebagai tarikh komit
-u,--pengguna
merekodkan pengguna yang ditentukan sebagai committer
-S, --subrepos
berulang ke dalam subrepositori
[+] pilihan bertanda boleh ditentukan beberapa kali
alias: qci
qdelete
keluarkan patch dari baris gilir:
hg qdelete [-k] [PATCH]...
Tampalan tidak boleh digunakan, dan sekurang-kurangnya satu tampalan diperlukan. Tampalan tepat
pengecam mesti diberikan. Dengan -k/--keep, fail tampalan disimpan dalam tampalan
direktori.
Untuk berhenti mengurus tampung dan mengalihkannya ke dalam sejarah kekal, gunakan hg qfinish perintah.
Pilihan:
-k, --simpan
simpan fail patch
-r,--rev
berhenti mengurus semakan (DITAMAT)
[+] pilihan bertanda boleh ditentukan beberapa kali
alias: qremove qrm
qdiff
perbezaan patch semasa dan pengubahsuaian seterusnya:
hg qdiff [PILIHAN]... [FAIL]...
Menunjukkan perbezaan yang merangkumi tampung semasa serta sebarang perubahan yang telah dibuat
dalam direktori kerja sejak penyegaran terakhir (dengan itu menunjukkan apa yang akan dilakukan oleh patch semasa
menjadi selepas qrefresh).
Penggunaan hg diff jika anda hanya mahu melihat perubahan yang dibuat sejak qrefresh terakhir, atau hg mengeksport
qtip jika anda ingin melihat perubahan yang dibuat oleh tampung semasa tanpa memasukkan perubahan yang dibuat
sejak qrefresh.
Mengembalikan 0 pada kejayaan.
Pilihan:
-A, - teks
layan semua fail sebagai teks
-g, --git
gunakan format git extended diff
--nodates
tinggalkan tarikh daripada pengepala berbeza
--noprefix
tinggalkan awalan a/ dan b/ daripada nama fail
-p, --tunjuk-fungsi
tunjukkan fungsi yang ada pada setiap perubahan
--terbalik
menghasilkan perbezaan yang membatalkan perubahan
-w, --abaikan-semua-ruang
abaikan ruang putih apabila membandingkan garisan
-b, --abaikan-ruang-perubahan
mengabaikan perubahan dalam jumlah ruang putih
-B, --abaikan-garis-kosong
abaikan perubahan yang semua barisnya kosong
-U,--bersatu
bilangan baris konteks untuk ditunjukkan
--stat keluaran ringkasan gaya diffstat bagi perubahan
--akar
menghasilkan perbezaan berbanding dengan subdirektori
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
qfinish
alihkan patch yang digunakan ke dalam sejarah repositori:
hg qfinish [-a] [REV]...
Menyelesaikan semakan yang ditentukan (sepadan dengan patch yang digunakan) dengan mengalihkannya keluar
mq mengawal ke dalam sejarah repositori biasa.
Menerima julat semakan atau pilihan -a/--digunakan. Jika --applied dinyatakan, semua
semakan mq yang digunakan dikeluarkan daripada kawalan mq. Jika tidak, semakan yang diberikan mestilah
di dasar timbunan tampalan yang digunakan.
Ini amat berguna jika perubahan anda telah digunakan pada repositori huluan,
atau jika anda akan menolak perubahan anda ke huluan.
Mengembalikan 0 pada kejayaan.
Pilihan:
-A, --digunakan
selesaikan semua perubahan yang digunakan
qfold
lipat patch bernama ke dalam patch semasa:
hg qfold [-e] [-k] [-m TEKS] [-l FAIL] PATCH...
Tampalan mesti belum digunakan. Setiap tampalan akan digunakan secara berturut-turut pada arus
tampal mengikut susunan yang diberikan. Jika semua patch berjaya digunakan, patch semasa akan menjadi
dimuatkan semula dengan tampalan terkumpul baharu, dan tampalan terlipat akan dipadamkan. Dengan
-k/--simpan, fail tampalan yang dilipat tidak akan dialih keluar selepas itu.
Pengepala untuk setiap tampalan terlipat akan digabungkan dengan pengepala tampalan semasa,
dipisahkan oleh barisan * * *.
Mengembalikan 0 pada kejayaan.
Pilihan:
-e, --edit
panggil editor pada komit mesej
-k, --simpan
simpan fail tampalan yang dilipat
-m,--mesej
gunakan teks sebagai mesej komit
-l,--fail log
baca mesej komit daripada fail
qgoto
tolak atau pop patch sehingga patch bernama berada di atas tindanan:
hg qgoto [PILIHAN]... PATCH
Mengembalikan 0 pada kejayaan.
Pilihan:
--kekalkan-perubahan
bertolak ansur dengan perubahan tempatan yang tidak bercanggah
-f, - kekuatan
tulis ganti sebarang perubahan setempat
--tiada-sandaran
jangan simpan salinan sandaran fail
qguard
tetapkan atau cetak pelindung untuk tampalan:
hg qguard [-l] [-n] [PATCH] [-- [+GUARD]... [-GUARD]...]
Pengawal mengawal sama ada tampalan boleh ditolak. Tampalan tanpa pelindung sentiasa ditolak. A
tampalan dengan pengawal positif ("+foo") ditolak hanya jika hg qselect perintah mempunyai
mengaktifkannya. Tampalan dengan pengawal negatif ("-foo") tidak pernah ditolak jika hg qselect
arahan telah mengaktifkannya.
Tanpa hujah, cetak pengawal yang sedang aktif. Dengan hujah, tetapkan pengawal untuk
bernama patch.
Nota Menentukan pengawal negatif kini memerlukan '--'.
Untuk menetapkan pengawal pada tampalan lain:
hg qguard other.patch -- +2.6.17 -stabil
Mengembalikan 0 pada kejayaan.
Pilihan:
-l, --senarai
senaraikan semua patch dan pengawal
-n, --tiada
turunkan semua pengawal
qheader
cetak pengepala patch paling atas atau yang ditentukan:
hg qheader [PATCH]
Mengembalikan 0 pada kejayaan.
qimport
import patch atau set perubahan sedia ada:
hg qimport [-e] [-n NAMA] [-f] [-g] [-P] [-r REV]... [FAIL]...
Tampalan dimasukkan ke dalam siri selepas tampalan terakhir digunakan. Jika tiada patch mempunyai
telah digunakan, qimport menambah tampalan pada siri.
Tampalan akan mempunyai nama yang sama dengan fail sumbernya melainkan anda memberikannya yang baharu
-n/--nama.
Anda boleh mendaftarkan patch sedia ada di dalam direktori patch dengan -e/--bendera sedia ada.
Dengan -f/--force, patch sedia ada dengan nama yang sama akan ditimpa.
Set perubahan sedia ada boleh diletakkan di bawah kawalan mq dengan -r/--rev (cth qimport --rev .
-n patch akan meletakkan semakan semasa di bawah kawalan mq). Dengan -g/--git, tampalan
diimport dengan --rev akan menggunakan format git diff. Lihat topik bantuan perbezaan untuk mendapatkan maklumat
tentang mengapa ini penting untuk mengekalkan nama semula/menyalin maklumat dan perubahan kebenaran.
Penggunaan hg qfinish untuk mengalih keluar perubahan daripada kawalan mq.
Untuk mengimport tampalan daripada input standard, pas - sebagai fail tampalan. Apabila mengimport dari
input standard, nama tampalan mesti ditentukan menggunakan bendera --name.
Untuk mengimport patch sedia ada semasa menamakan semula:
hg qimport -e-patch sedia ada -n nama-baru
Mengembalikan 0 jika import berjaya.
Pilihan:
-e, --sedia ada
import fail dalam direktori patch
-n,--nama
nama fail tampalan
-f, - kekuatan
tulis ganti fail sedia ada
-r,--rev
letakkan semakan sedia ada di bawah kawalan mq
-g, --git
gunakan format git extended diff
-P, --tolak
qpush selepas mengimport
[+] pilihan bertanda boleh ditentukan beberapa kali
qinit
init repositori baris gilir baharu (TIDAK TERUS):
hg qinit [-c]
Repositori baris gilir dinyahversi secara lalai. Jika -c/--create-repo ditentukan, qinit
akan membuat repositori bersarang yang berasingan untuk patch (qinit -c juga boleh dijalankan kemudian ke
menukar repositori tampalan tidak berversi kepada yang berversi). Anda boleh menggunakan qcommit untuk
lakukan perubahan pada repositori baris gilir ini.
Perintah ini ditamatkan. Tanpa -c, ia tersirat oleh arahan lain yang berkaitan. Dengan -c,
penggunaan hg INIT --mq sebaliknya.
Pilihan:
-c, --buat-repo
buat repositori baris gilir
baru
buat tampalan baharu:
hg qbaharu [-e] [-m TEKS] [-l FAIL] TAMPIL [FAIL]...
qnew mencipta tampalan baharu di atas tampalan yang sedang digunakan (jika ada). Tampalan akan menjadi
dimulakan dengan sebarang perubahan tertunggak dalam direktori kerja. Anda juga boleh menggunakan
-I/--include, -X/--exclude, dan/atau senarai fail selepas nama patch untuk ditambahkan sahaja
perubahan pada memadankan fail dengan tampung baharu, meninggalkan selebihnya sebagai pengubahsuaian tanpa komitmen.
-u/--user dan -d/--date boleh digunakan untuk menetapkan pengguna (diberi) dan tarikh, masing-masing.
-U/--currentuser dan -D/--currentdate menetapkan pengguna kepada pengguna semasa dan tarikh kepada tarikh semasa.
-e/--edit, -m/--message atau -l/--logfile tetapkan pengepala patch serta komit
mesej. Jika tiada yang dinyatakan, pengepala kosong dan mesej komit ialah '[mq]:
PATCH'.
Gunakan pilihan -g/--git untuk mengekalkan tampalan dalam format git extended diff. Baca perbezaannya
topik bantuan untuk mendapatkan maklumat lanjut tentang sebab ini penting untuk mengekalkan perubahan kebenaran
dan menyalin/menamakan semula maklumat.
Mengembalikan 0 apabila berjaya mencipta tampung baharu.
Pilihan:
-e, --edit
panggil editor pada komit mesej
-f, - kekuatan
import perubahan tanpa komitmen (DILARANG)
-g, --git
gunakan format git extended diff
-U, --pengguna semasa
tambah "Dari: "untuk menampal
-u,--pengguna
tambah "Dari: "untuk menampal
-D, --tarikh semasa
tambah "Tarikh: "untuk menampal
-d,--Tarikh
tambah "Tarikh: "untuk menampal
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-m,--mesej
gunakan teks sebagai mesej komit
-l,--fail log
baca mesej komit daripada fail
[+] pilihan bertanda boleh ditentukan beberapa kali
qseterusnya
cetak nama patch boleh tolak seterusnya:
hg qnext [-s]
Mengembalikan 0 pada kejayaan.
Pilihan:
-ya, --ringkasan
cetak baris pertama pengepala tampalan
qpop
pop patch semasa dari timbunan:
hg qpop [-a] [-f] [PATCH | INDEX]
Tanpa hujah, muncul dari bahagian atas timbunan tampalan. Jika diberi nama tampalan, simpan
memunculkan tompok sehingga tampalan yang dinamakan berada di bahagian atas timbunan.
Secara lalai, batalkan jika direktori kerja mengandungi perubahan tanpa komitmen. Dengan
--keep-changes, batalkan hanya jika fail yang tidak terikat bertindih dengan fail yang ditampal. Dengan
-f/--paksa, sandarkan dan buang perubahan yang dibuat pada fail tersebut.
Pulangan 0 pada kejayaan.
Pilihan:
-A, --semua
pop semua patch
-n,--nama
nama baris gilir untuk muncul (DILARANG)
--kekalkan-perubahan
bertolak ansur dengan perubahan tempatan yang tidak bercanggah
-f, - kekuatan
lupakan sebarang perubahan setempat pada fail yang ditambal
--tiada-sandaran
jangan simpan salinan sandaran fail
qprev
cetak nama tampalan yang digunakan sebelumnya:
hg qprev [-s]
Mengembalikan 0 pada kejayaan.
Pilihan:
-ya, --ringkasan
cetak baris pertama pengepala tampalan
qpush
tolak tampalan seterusnya ke timbunan:
hg qpush [-f] [-l] [-a] [--move] [PATCH | INDEX]
Secara lalai, batalkan jika direktori kerja mengandungi perubahan tanpa komitmen. Dengan
--keep-changes, batalkan hanya jika fail yang tidak terikat bertindih dengan fail yang ditampal. Dengan
-f/--force, sandaran dan tampal atas perubahan tanpa komitmen.
Pulangan 0 pada kejayaan.
Pilihan:
--kekalkan-perubahan
bertolak ansur dengan perubahan tempatan yang tidak bercanggah
-f, - kekuatan
memohon di atas perubahan setempat
-e, --tepat
gunakan tampung sasaran pada induknya yang direkodkan
-l, --senarai
senaraikan nama tampalan dalam teks komit
-A, --semua
sapukan semua tampalan
-m, --bercantum
bercantum dari baris gilir lain (TIDAK AMAN)
-n,--nama
cantumkan nama baris gilir (DILARANG)
--bergerak susun semula siri tampalan dan gunakan tampalan sahaja
--tiada-sandaran
jangan simpan salinan sandaran fail
beratur
menguruskan berbilang baris gilir patch:
hg qqueue [PILIHAN] [QUEUE]
Menyokong pertukaran antara baris gilir tampalan yang berbeza, serta mencipta baris gilir tampung baharu
dan memadam yang sedia ada.
Meninggalkan nama baris gilir atau menyatakan -l/--senarai akan menunjukkan kepada anda baris gilir berdaftar - oleh
lalai baris gilir tampalan "biasa" didaftarkan. Barisan gilir yang sedang aktif ialah
ditandakan dengan "(aktif)". Menentukan --active hanya akan mencetak nama baris gilir aktif.
Untuk membuat baris gilir baharu, gunakan -c/--create. Barisan gilir dibuat aktif secara automatik, kecuali dalam
kes di mana terdapat tampung yang digunakan daripada baris gilir yang sedang aktif dalam
repositori. Kemudian baris gilir hanya akan dibuat dan penukaran akan gagal.
Untuk memadam baris gilir sedia ada, gunakan --delete. Anda tidak boleh memadamkan baris gilir yang sedang aktif.
Mengembalikan 0 pada kejayaan.
Pilihan:
-l, --senarai
senaraikan semua baris gilir yang ada
--aktif
cetak nama baris gilir aktif
-c, --buat
buat baris gilir baru
--menamakan semula
menamakan semula baris gilir aktif
--padam
padamkan rujukan kepada baris gilir
--bersihkan
padamkan baris gilir, dan alih keluar patch dir
qrefresh
kemas kini patch semasa:
hg qrefresh [-I] [-X] [-e] [-m TEKS] [-l FAIL] [-s] [FAIL]...
Jika mana-mana corak fail disediakan, tampung yang dimuat semula akan mengandungi hanya pengubahsuaian
yang sepadan dengan corak tersebut; selebihnya pengubahsuaian akan kekal dalam kerja
direktori.
Jika -s/--short ditentukan, fail yang disertakan dalam tampalan pada masa ini akan dimuat semula hanya
seperti fail yang dipadankan dan kekal dalam patch.
Jika -e/--edit ditentukan, Mercurial akan memulakan editor terkonfigurasi anda untuk anda masukkan a
mesej. Sekiranya qrefresh gagal, anda akan menemui sandaran mesej anda
.hg/last-message.txt.
hg tambah/buang/salin/namakan semula kerja seperti biasa, walaupun anda mungkin mahu menggunakan tampung gaya git
(-g/--git atau [diff] git=1) untuk menjejak salinan dan menamakan semula. Lihat topik bantuan perbezaan untuk lebih lanjut
maklumat mengenai format git diff.
Mengembalikan 0 pada kejayaan.
Pilihan:
-e, --edit
panggil editor pada komit mesej
-g, --git
gunakan format git extended diff
-ya, --pendek
muat semula hanya fail yang sudah ada dalam patch dan fail yang ditentukan
-U, --pengguna semasa
tambah/kemas kini medan pengarang dalam tampalan dengan pengguna semasa
-u,--pengguna
tambah/kemas kini medan pengarang dalam tampalan dengan pengguna tertentu
-D, --tarikh semasa
tambah/kemas kini medan tarikh dalam tampalan dengan tarikh semasa
-d,--Tarikh
tambah/kemas kini medan tarikh dalam tampalan dengan tarikh yang diberikan
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-m,--mesej
gunakan teks sebagai mesej komit
-l,--fail log
baca mesej komit daripada fail
[+] pilihan bertanda boleh ditentukan beberapa kali
qrename
menamakan semula patch:
hg qrename PATCH1 [PATCH2]
Dengan satu hujah, namakan semula patch semasa kepada PATCH1. Dengan dua hujah, namakan semula
PATCH1 hingga PATCH2.
Mengembalikan 0 pada kejayaan.
alias: qmv
qrestore
pulihkan keadaan baris gilir yang disimpan oleh semakan (DIHENTIKAN):
hg qrestore [-d] [-u] REV
Perintah ini ditamatkan, gunakan hg melunaskan semula sebaliknya.
Pilihan:
-d, --padam
padam entri simpan
-u, - kemas kini
kemas kini direktori kerja baris gilir
qsave
simpan keadaan baris gilir semasa (TAMAT):
hg qsave [-m TEKS] [-l FAIL] [-c] [-n NAMA] [-e] [-f]
Perintah ini ditamatkan, gunakan hg melunaskan semula sebaliknya.
Pilihan:
-c, --salinan
salin direktori patch
-n,--nama
salin nama direktori
-e, --kosong
kosongkan fail status baris gilir
-f, - kekuatan
salinan paksa
-m,--mesej
gunakan teks sebagai mesej komit
-l,--fail log
baca mesej komit daripada fail
qselect
tetapkan atau cetak patch berkawal untuk menolak:
hg qselect [PILIHAN]... [PENAWAL]...
Menggunakan hg qguard perintah untuk menetapkan atau mencetak pelindung pada tampalan, kemudian gunakan qselect untuk memberitahu mq
yang pengawal untuk digunakan. Tampalan akan ditolak jika ia tidak mempunyai pengawal atau sebarang pengawal positif
sepadan dengan pengawal yang dipilih pada masa ini, tetapi tidak akan ditolak jika mana-mana pengawal negatif sepadan
pengawal semasa. Sebagai contoh:
qguard foo.patch -- -stable (pengawal negatif)
bar qguard.patch +stable (pengawal positif)
qselect stabil
Ini mengaktifkan pengawal "stabil". mq akan melangkau foo.patch (kerana ia mempunyai negatif
perlawanan) tetapi push bar.patch (kerana ia mempunyai padanan positif).
Tanpa hujah, mencetak pengawal yang sedang aktif. Dengan satu hujah, tetapkan aktif
pengawal.
Gunakan -n/--none untuk menyahaktifkan pengawal (tiada hujah lain diperlukan). Apabila tiada pengawal
aktif, tampalan dengan pengawal positif dilangkau dan tampalan dengan pengawal negatif adalah
ditolak.
qselect boleh menukar pengawal pada patch yang digunakan. Ia tidak muncul tompok berkawal
lalai. Gunakan --pop untuk muncul kembali ke patch terakhir yang digunakan yang tidak dijaga. guna
--reapply (yang membayangkan --pop) untuk menolak kembali ke patch semasa selepas itu, tetapi langkau
tompok terjaga.
Gunakan -s/--series untuk mencetak senarai semua pengawal dalam fail siri (tiada argumen lain
diperlukan). Gunakan -v untuk maklumat lanjut.
Mengembalikan 0 pada kejayaan.
Pilihan:
-n, --tiada
lumpuhkan semua pengawal
-ya, --siri
senaraikan semua pengawal dalam fail siri
--pop pop ke sebelum pertama kali dijaga patch yang digunakan
--mohon semula
pop, kemudian gunakan semula tampalan
qseries
cetak keseluruhan fail siri:
hg qseries [-ms]
Mengembalikan 0 pada kejayaan.
Pilihan:
-m, --hilang
tampalan cetakan tidak bersiri
-ya, --ringkasan
cetak baris pertama pengepala tampalan
qtop
cetak nama tampalan semasa:
hg qtop [-s]
Mengembalikan 0 pada kejayaan.
Pilihan:
-ya, --ringkasan
cetak baris pertama pengepala tampalan
Qunapplied
cetak tampalan yang belum digunakan:
hg Qunapplied [-1] [-s] [PATCH]
Mengembalikan 0 pada kejayaan.
Pilihan:
-1, --pertama
tunjukkan hanya patch pertama
-ya, --ringkasan
cetak baris pertama pengepala tampalan
memberitahu
cangkuk untuk menghantar pemberitahuan tolak e-mel
Sambungan ini melaksanakan cangkuk untuk menghantar pemberitahuan e-mel apabila set perubahan dihantar daripada
atau diterima oleh repositori tempatan.
Pertama, dayakan sambungan seperti yang dijelaskan dalam hg membantu sambungan, dan daftarkan cangkuk anda
nak lari. masuk and kumpulan perubahan cangkuk dijalankan apabila changeset diterima, manakala
keluar cangkuk adalah untuk perubahan yang dihantar ke repositori lain:
[cangkuk]
# satu e-mel untuk setiap set perubahan masuk
incoming.notify = python:hgext.notify.hook
# satu e-mel untuk semua set perubahan masuk
changegroup.notify = python:hgext.notify.hook
# satu e-mel untuk semua set perubahan keluar
outgoing.notify = python:hgext.notify.hook
Ini mendaftar mata kail. Untuk mendayakan pemberitahuan, pelanggan mesti ditugaskan untuk
repositori. The [usersubs] bahagian memetakan berbilang repositori kepada penerima tertentu. The
[reposubs] bahagian memetakan berbilang penerima ke satu repositori:
[usersubs]
# kunci ialah e-mel pelanggan, nilai ialah senarai corak repo yang dipisahkan koma
pengguna@hos = corak
[reposubs]
# kunci ialah corak repo, nilai ialah senarai e-mel pelanggan yang dipisahkan koma
corak = pengguna@hos
A pola ialah epal memadankan laluan mutlak ke repositori, digabungkan secara pilihan dengan a
tetapkan semula ungkapan. Ungkapan set semula, jika ada, dipisahkan daripada glob oleh cincang.
Contoh:
[reposubs]
*/widgets#branch(release) = [e-mel dilindungi]
Ini menghantar kepada [e-mel dilindungi] setiap kali set perubahan pada melepaskan pencetus cawangan a
pemberitahuan dalam mana-mana repositori yang berakhir dengan widget.
Untuk meletakkannya di bawah pengurusan pengguna langsung, [usersubs] and [reposubs] bahagian
boleh diletakkan di tempat yang berasingan hgrc fail dan digabungkan dengan rujukan:
[maklumkan]
config = /path/to/subscriptionsfile
Pemberitahuan tidak akan dihantar sehingga memberitahu.ujian nilai ditetapkan kepada Palsu; lihat di bawah.
Kandungan pemberitahuan boleh diubah suai dengan entri konfigurasi berikut:
memberitahu.ujian
If Benar, cetak mesej ke stdout dan bukannya menghantarnya. Lalai: Betul.
memberitahu.sumber
Senarai sumber perubahan yang diasingkan ruang. Pemberitahuan diaktifkan hanya apabila a
Sumber changeset ada dalam senarai ini. Sumber mungkin:
berkhidmat
perubahan yang diterima melalui http atau ssh
tarik
perubahan yang diterima melalui hg tarik
unbundle
perubahan yang diterima melalui hg unbundle
menolak
perubahan yang dihantar atau diterima melalui hg menolak
bundle
set perubahan dihantar melalui hg unbundle
Lalai: berkhidmat.
memberitahu.jalur
Bilangan garis miring utama untuk dilucutkan daripada laluan url. Secara lalai, pemberitahuan
repositori rujukan dengan laluan mutlaknya. memberitahu.jalur membolehkan anda mengubahnya
ke dalam laluan relatif. Sebagai contoh, notify.strip=3 akan berubah /long/path/repository
ke dalam repositori. Lalai: 0.
notify.domain
Domain e-mel lalai untuk pengirim atau penerima tanpa domain eksplisit.
memberitahu.gaya
Gayakan fail untuk digunakan semasa memformat e-mel.
memberitahu.templat
Templat untuk digunakan semasa memformat e-mel.
memberitahu.masuk
Templat untuk digunakan apabila dijalankan sebagai cangkuk masuk, mengatasi memberitahu.templat.
memberitahu.keluar
Templat untuk digunakan apabila dijalankan sebagai cangkuk keluar, mengatasi memberitahu.templat.
notify.changegroup
Templat untuk digunakan apabila dijalankan sebagai cangkuk changegroup, mengatasi memberitahu.templat.
memberitahu.maxdiff
Bilangan maksimum baris perbezaan untuk disertakan dalam e-mel pemberitahuan. Tetapkan kepada 0 untuk melumpuhkan
perbezaan, atau -1 untuk memasukkan kesemuanya. Lalai: 300.
memberitahu.maxsubject
Bilangan maksimum aksara dalam baris subjek e-mel. Lalai: 67.
memberitahu.diffstat
Tetapkan kepada Benar untuk memasukkan diffstat sebelum kandungan diff. Lalai: Betul.
memberitahu.bergabung
Jika Benar, hantar pemberitahuan untuk set perubahan gabungan. Lalai: Betul.
memberitahu.box
Jika ditetapkan, tambahkan mel pada fail mbox ini dan bukannya menghantar. Lalai: Tiada.
notify.fromauthor
Jika ditetapkan, gunakan committer set perubahan pertama dalam kumpulan perubahan untuk "Dari"
medan mel pemberitahuan. Jika tidak ditetapkan, ambil pengguna dari repo menolak.
Lalai: Salah.
Jika ditetapkan, entri berikut juga akan digunakan untuk menyesuaikan pemberitahuan:
e-mel.daripada
E-mel daripada alamat untuk digunakan jika tiada satu pun boleh ditemui dalam kandungan e-mel yang dijana.
web.baseurl
Root URL repositori untuk digabungkan dengan laluan repositori semasa membuat rujukan. Lihat
Juga memberitahu.jalur.
pager
semak imbas output arahan dengan alat kelui luaran
Untuk menetapkan pager yang harus digunakan, tetapkan pembolehubah aplikasi:
[halaman kertas]
pager = kurang -FRX
Jika tiada kelui ditetapkan, sambungan kelui menggunakan pembolehubah persekitaran $PAGER. Jika tiada
pager.pager, mahupun $PAGER ditetapkan, tiada pager digunakan.
Anda boleh melumpuhkan kelui untuk arahan tertentu dengan menambahkannya ke senarai pager.ignore:
[halaman kertas]
abaikan = versi, bantuan, kemas kini
Anda juga boleh mendayakan kelui hanya untuk arahan tertentu menggunakan kelui.menghadiri. Di bawah ialah
senarai lalai arahan untuk dihalakan:
[halaman kertas]
hadir = anotasi, kucing, perbezaan, eksport, glog, log, qdiff
Menetapkan pager.attend kepada nilai kosong akan menyebabkan semua arahan dihalakan.
Jika pager.attend hadir, pager.ignore akan diabaikan.
Akhir sekali, anda boleh mendayakan dan melumpuhkan paging untuk arahan individu dengan
hadir- pilihan. Tetapan ini diutamakan daripada kehadiran sedia ada dan abaikan
pilihan dan lalai:
[halaman kertas]
attend-cat = palsu
Untuk mengabaikan arahan global seperti hg versi or hg membantu, anda perlu menyatakannya dalam anda
fail konfigurasi pengguna.
Untuk mengawal sama ada alat kelui digunakan sama sekali untuk arahan individu, anda boleh gunakan
--pager= :
- gunakan seperti yang diperlukan: `auto`.
- memerlukan alat kelui: `ya` atau `on`.
- menekan alat kelui: `tidak` atau `mati` (sebarang nilai yang tidak dikenali
juga akan berfungsi).
patchbomb
arahan untuk menghantar set perubahan sebagai (siri) e-mel tampalan
Siri ini dimulakan dengan pengenalan "[PATCH 0 of N]", yang menerangkan siri ini
secara keseluruhan.
Setiap e-mel tampalan mempunyai baris Subjek "[PATCH M daripada N] ...", menggunakan baris pertama
ubah set perihalan sebagai teks subjek. Mesej mengandungi dua atau tiga bahagian badan:
· Penerangan set perubahan.
· [Pilihan] Hasil daripada menjalankan diffstat pada tampung.
· Tampalan itu sendiri, seperti yang dihasilkan oleh hg mengeksport.
Setiap mesej merujuk kepada yang pertama dalam siri menggunakan In-Reply-To dan Rujukan
pengepala, jadi ia akan muncul sebagai urutan dalam mel berulir dan pembaca berita, dan dalam mel
arkib.
Untuk mengkonfigurasi lalai lain, tambahkan bahagian seperti ini pada fail konfigurasi anda:
[e-mel]
daripada = Nama Saya
kepada = penerima1, penerima2, ...
cc = cc1, cc2, ...
bcc = bcc1, bcc2, ...
balas-kepada = alamat1, alamat2, ...
Penggunaan [patchbomb] sebagai nama bahagian konfigurasi jika anda perlu mengatasi global [e-mel]
tetapan alamat.
Kemudian anda boleh menggunakan hg e-mel perintah untuk mel siri set perubahan sebagai patchbomb.
Anda juga boleh sama ada mengkonfigurasi pilihan kaedah dalam bahagian e-mel untuk menjadi mel hantar
mel yang serasi atau isikan bahagian [smtp] supaya sambungan patchbomb boleh
menghantar patchbomb secara automatik terus dari baris arahan. Lihat [e-mel] dan [smtp]
bahagian dalam hgrc(5) untuk butiran.
Secara lalai, hg e-mel akan menggesa untuk a Untuk or CC pengepala jika anda tidak membekalkan satu melalui
konfigurasi atau baris arahan. Anda boleh mengatasi ini untuk tidak menggesa dengan mengkonfigurasi
nilai kosong:
[e-mel]
cc =
Anda boleh mengawal kemasukan lalai mesej pengenalan dengan patchbomb.intro
pilihan konfigurasi. Konfigurasi sentiasa ditimpa oleh bendera baris arahan seperti
--intro dan --desc:
[patchbomb]
intro=auto # sertakan mesej pengenalan jika lebih daripada 1 tampung (lalai)
intro=tidak pernah # jangan sekali-kali menyertakan mesej pengenalan
intro=sentiasa # sentiasa sertakan mesej pengenalan
Anda boleh menetapkan patchbomb untuk sentiasa meminta pengesahan dengan menetapkan patchbomb.confirm kepada benar.
arahan
e-mel
hantarkan perubahan melalui e-mel:
e-mel hg [PILIHAN]... [DEST]...
Secara lalai, perbezaan dihantar dalam format yang dijana oleh hg mengeksport, satu setiap mesej. The
siri bermula dengan pengenalan "[PATCH 0 of N]", yang menerangkan siri secara keseluruhan.
Setiap e-mel tampalan mempunyai baris Subjek "[PATCH M daripada N] ...", menggunakan baris pertama
ubah set perihalan sebagai teks subjek. Mesej mengandungi dua atau tiga bahagian.
Pertama, penerangan set perubahan.
Dengan pilihan -d/--diffstat, jika program diffstat dipasang, hasil daripada berjalan
diffstat pada patch dimasukkan.
Akhirnya, patch itu sendiri, seperti yang dihasilkan oleh hg mengeksport.
Dengan pilihan -d/--diffstat atau --confirm, anda akan dibentangkan dengan ringkasan akhir
semua mesej dan meminta pengesahan sebelum mesej dihantar.
Secara lalai patch disertakan sebagai teks dalam badan e-mel untuk semakan mudah. Menggunakan
Pilihan -a/--attach sebaliknya akan membuat lampiran untuk tampung. Dengan -i/--sebaris an
lampiran sebaris akan dibuat. Anda boleh memasukkan tampalan kedua-duanya sebagai teks dalam badan e-mel
dan sebagai lampiran biasa atau sebaris dengan menggabungkan -a/--attach atau -i/--sebaris dengan
pilihan --body.
Dengan -o/--outgoing, e-mel akan dijana untuk patch yang tidak ditemui di destinasi
repositori (atau hanya mereka yang merupakan nenek moyang semakan yang ditentukan jika ada
disediakan)
Dengan -b/--bundle, changeset dipilih sebagai untuk --outgoing, tetapi satu e-mel mengandungi
bundle Mercurial binari sebagai lampiran akan dihantar. Menggunakan patchbomb.bundletype
pilihan konfigurasi untuk mengawal jenis berkas seperti dengan hg bundle - jenis.
Dengan -m/--mbox, bukannya pratonton setiap mesej patchbomb dalam kelui atau menghantar
mesej secara langsung, ia akan mencipta fail peti mel UNIX dengan e-mel tampalan. Peti surat ini
fail boleh dipratonton dengan mana-mana ejen pengguna mel yang menyokong fail mbox UNIX.
Dengan -n/--test, semua langkah akan dijalankan, tetapi mel tidak akan dihantar. Anda akan digesa untuk
alamat penerima e-mel, subjek dan mesej pengenalan yang menerangkan patch
daripada patchbomb anda. Kemudian apabila semuanya selesai, mesej patchbomb dipaparkan. Jika PAGER
pembolehubah persekitaran ditetapkan, alat kelui anda akan dinyalakan sekali untuk setiap mesej patchbomb,
jadi anda boleh mengesahkan semuanya baik-baik saja.
Sekiranya penghantaran e-mel gagal, anda akan menemui sandaran mesej pengenalan siri anda
.hg/last-email.txt.
Tingkah laku lalai arahan ini boleh disesuaikan melalui konfigurasi. (Lihat hg membantu
patchbomb Untuk maklumat lanjut)
Contoh:
hg email -r 3000 # hantar patch 3000 sahaja
e-mel hg -r 3000 -r 3001 # hantar tampalan 3000 dan 3001
e-mel hg -r 3000:3005 # hantar tampalan 3000 hingga 3005
hg e-mel 3000 # hantar tampalan 3000 (ditamatkan)
hg e-mel -o # hantar semua patch bukan dalam lalai
hg e-mel -o DEST # hantar semua patch bukan dalam DEST
hg e-mel -o -r 3000 # hantar semua nenek moyang 3000 bukan secara lalai
hg e-mel -o -r 3000 DEST # hantar semua moyang 3000 bukan dalam DEST
hg e-mel -b # hantar himpunan semua patch bukan dalam lalai
hg e-mel -b DEST # hantar himpunan semua patch yang tiada dalam DEST
hg e-mel -b -r 3000 # himpunan semua nenek moyang 3000 bukan lalai
hg e-mel -b -r 3000 DEST # himpunan semua nenek moyang 3000 bukan dalam DEST
hg email -o -m mbox && # jana fail mbox...
mutt -R -f mbox # ... dan lihat dengan mutt
hg email -o -m mbox && # jana fail mbox ...
formail -s sendmail \ # ... dan gunakan formail untuk menghantar dari mbox
-bm -t < mbox # ... menggunakan sendmail
Sebelum menggunakan arahan ini, anda perlu mendayakan e-mel dalam hgrc anda. Lihat [e-mel]
bahagian dalam hgrc(5) untuk butiran.
Pilihan:
-g, --git
gunakan format git extended diff
--kosong
tinggalkan pengepala tampalan hg
-o, --keluar
hantar perubahan yang tidak ditemui dalam repositori sasaran
-b, --berikat
hantar perubahan bukan dalam sasaran sebagai berkas binari
--nama himpunan
nama fail lampiran berkas (lalai: berkas)
-r,--rev
semakan untuk dihantar
- kekuatan
jalankan walaupun repositori jauh tidak berkaitan (dengan -b/--bundle)
--dasar
set perubahan asas untuk ditentukan dan bukannya destinasi (dengan -b/--bundle)
--intro
hantar e-mel pengenalan untuk satu tampung
--badan hantar tampalan sebagai teks mesej sebaris (lalai)
-A, --lampirkan
hantar patch sebagai lampiran
-saya, --dalam barisan
hantar tampalan sebagai lampiran sebaris
--bcc
alamat e-mel penerima salinan karbon buta
-c,--cc
alamat e-mel penerima salinan
--confirm
minta pengesahan sebelum hantar
-d, --diffstat
tambahkan output diffstat pada mesej
--Tarikh
gunakan tarikh yang diberikan sebagai tarikh penghantaran
--desc
gunakan fail yang diberikan sebagai penerangan siri
-f,--dari
alamat e-mel pengirim
-n, --ujian
mencetak mesej yang akan dihantar
-m,--mbox
tulis mesej ke fail mbox dan bukannya menghantarnya
--balas kepada
alamat e-mel balasan hendaklah dihantar ke
-ya,--subjek
subjek mesej pertama (intro atau tampung tunggal)
--dalam-balas-kepada
pengecam mesej untuk dibalas
--bendera
bendera untuk menambah awalan subjek
-t,--kepada
alamat e-mel penerima
-e,--ssh
tentukan arahan ssh untuk digunakan
--remotecmd
tentukan arahan hg untuk dijalankan pada bahagian jauh
--tidak selamat
jangan sahkan sijil pelayan (mengabaikan konfigurasi web.cacerts)
[+] pilihan bertanda boleh ditentukan beberapa kali
membersihkan
arahan untuk memadam fail yang tidak dijejaki daripada direktori kerja
arahan
membersihkan
mengalih keluar fail yang tidak dijejaki oleh Mercurial:
hg purge [PILIHAN]... [DIR]...
Padam fail yang tidak diketahui Mercurial. Ini berguna untuk menguji perubahan setempat dan tanpa komitmen
dalam pokok sumber yang bersih.
Ini bermakna pembersihan akan memadamkan yang berikut secara lalai:
· Fail tidak diketahui: fail bertanda "?" oleh hg terkini
· Direktori kosong: sebenarnya Mercurial mengabaikan direktori melainkan ia mengandungi fail di bawah
pengurusan kawalan sumber
Tetapi ia tidak akan disentuh:
· Fail jejak yang diubah suai dan tidak diubah suai
· Fail diabaikan (melainkan --semua dinyatakan)
· Fail baharu ditambahkan pada repositori (dengan hg menambah)
Pilihan --files dan --dirs boleh digunakan untuk mengarahkan pembersihan untuk memadam fail sahaja, sahaja
direktori, atau kedua-duanya. Jika tiada pilihan diberikan, kedua-duanya akan dipadamkan.
Jika direktori diberikan pada baris arahan, hanya fail dalam direktori ini
dipertimbangkan.
Berhati-hati dengan pembersihan, kerana anda boleh memadamkan beberapa fail yang anda terlupa untuk menambahnya
repositori. Jika anda hanya ingin mencetak senarai fail yang akan dilakukan oleh program ini
padam, gunakan pilihan --print.
Pilihan:
-A, --abort-on-err
batalkan jika ralat berlaku
--semua bersihkan fail yang diabaikan juga
--dir bersihkan direktori kosong
--fail
bersihkan fail
-p, --cetak
mencetak nama fail dan bukannya memadamkannya
-0, --cetak0
tamatkan nama fail dengan NUL, untuk digunakan dengan xargs (menyiratkan -p/--print)
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
alias: bersih
melunaskan semula
perintah untuk memindahkan set semakan kepada nenek moyang yang berbeza
Sambungan ini membolehkan anda meletakkan semula set perubahan dalam repositori Mercurial sedia ada.
Untuk maklumat lanjut: https://mercurial-scm.org/wiki/RebaseExtension
arahan
melunaskan semula
pindahkan changeset (dan keturunan) ke cawangan lain:
hg rebase [-s REV | -b REV] [-d REV] [PILIHAN]
Rebase menggunakan penggabungan berulang untuk mencantumkan perubahan daripada satu bahagian sejarah (sumber)
ke tempat lain (tujuan). Ini boleh berguna untuk membuat linearisasi tempatan perubahan relatif
kepada pokok pembangunan induk.
Komit yang diterbitkan tidak boleh berdasarkan semula (lihat hg membantu fasa). Untuk menyalin komitmen, lihat hg membantu
rasuah.
Jika anda tidak menentukan set perubahan destinasi (-d/--dest), rebase menggunakan cawangan semasa
tip sebagai destinasi. (Set perubahan destinasi tidak diubah suai dengan asas semula, tetapi baharu
set perubahan ditambah sebagai keturunannya.)
Berikut ialah cara untuk memilih set perubahan:
1. Pilih mereka secara eksplisit menggunakan --rev.
2. Gunakan --sumber untuk memilih set perubahan akar dan memasukkan semua keturunannya.
3. Gunakan --dasar untuk memilih set perubahan; rebase akan mencari nenek moyang dan keturunan mereka
yang bukan juga nenek moyang destinasi.
4. Jika anda tidak menyatakan mana-mana --rev, sumber, Atau --dasar, rebase akan digunakan --dasar . as
atas.
Rebase akan memusnahkan set perubahan asal melainkan anda menggunakan --simpan. Ia juga akan menggerakkan anda
penanda halaman (walaupun anda lakukan).
Beberapa set perubahan mungkin digugurkan jika ia tidak menyumbang perubahan (cth gabungan dari
cawangan destinasi).
Tidak seperti bergabung, rebase tidak akan melakukan apa-apa jika anda berada di hujung cawangan cawangan bernama dengan
dua kepala. Anda perlu menyatakan secara eksplisit sumber dan/atau destinasi.
Jika pangkalan semula diganggu untuk menyelesaikan konflik secara manual, ia boleh diteruskan
--terus/-c atau digugurkan dengan --abort/-a.
Contoh:
· alihkan "perubahan setempat" (komit semasa kembali ke titik cawangan) ke hujung cawangan semasa
selepas ditarik:
hg rebase
· alihkan set perubahan tunggal ke cawangan stabil:
hg rebase -r 5f493448 -d stabil
· sambungkan komit dan semua keturunannya ke bahagian lain dalam sejarah:
hg rebase --source c0c3 --dest 4cf9
· asaskan semula segala-galanya pada cawangan yang ditandakan oleh penanda halaman pada cawangan lalai:
hg rebase --base myfeature --dest lalai
· runtuhkan urutan perubahan menjadi satu komit:
hg rebase --collapse -r 1520:1525 -d .
· memindahkan cawangan bernama sambil mengekalkan namanya:
hg rebase -r "cawangan(ciriX)" -d 1.3 --keepbranches
Mengembalikan 0 pada kejayaan, 1 jika tiada apa yang perlu dibuat semula atau terdapat konflik yang tidak dapat diselesaikan.
Pilihan:
-ya,--sumber
asas semula set perubahan dan keturunan yang ditentukan
-b,--dasar
asaskan semula segala-galanya dari titik percabangan set perubahan yang ditentukan
-r,--rev
asas semula semakan ini
-d,--dest
rebase ke set perubahan yang ditentukan
--runtuh
runtuhkan set perubahan berasaskan semula
-m,--mesej
gunakan teks sebagai mesej komit runtuh
-e, --edit
panggil editor pada komit mesej
-l,--fail log
baca mesej komit runtuh daripada fail
-k, --simpan
simpan perubahan asal
--keep branches
kekalkan nama cawangan asal
-D, --tanggalkan
(TAMAT)
-saya, --interaktif
(TAMAT)
-t,--alat
tentukan alat gabungan
-c, --sambung
meneruskan pangkalan semula yang terganggu
-A, --menggugurkan kandungan
batalkan rebase yang terganggu
--gaya
paparan menggunakan fail peta templat (DILARANG)
-T,--template
paparan dengan templat
[+] pilihan bertanda boleh ditentukan beberapa kali
rekod
arahan untuk memilih perubahan secara interaktif untuk komit/qrefresh
arahan
qrecord
merekodkan tampung baharu secara interaktif:
hg qrecord [PILIHAN]... PATCH [FAIL]...
Lihat hg membantu baru & hg membantu rekod untuk maklumat lanjut dan penggunaan.
rekod
pilih perubahan secara interaktif untuk dilakukan:
rekod hg [PILIHAN]... [FAIL]...
Jika senarai fail ditinggalkan, semua perubahan dilaporkan oleh hg terkini akan menjadi calon untuk
rakaman.
Lihat hg membantu tarikh untuk senarai format yang sah untuk -d/--date.
Anda akan digesa sama ada untuk merekodkan perubahan pada setiap fail yang diubah suai dan untuk fail
dengan berbilang perubahan, untuk setiap perubahan untuk digunakan. Untuk setiap pertanyaan, jawapan berikut ialah
mungkin:
y - rekod perubahan ini
n - langkau perubahan ini
e - edit perubahan ini secara manual
s - langkau baki perubahan pada fail ini
f - rekod baki perubahan pada fail ini
d - selesai, langkau baki perubahan dan fail
a - rekod semua perubahan kepada semua fail yang tinggal
q - berhenti, merekodkan tiada perubahan
? - paparan bantuan
Perintah ini tidak tersedia semasa melakukan gabungan.
Pilihan:
-A, --addremove
tandakan fail baharu/tiada sebagai ditambah/dialih keluar sebelum melakukan
--cawangan-tutup
tandakan kepala cawangan sebagai tertutup
- amend
meminda induk direktori kerja
-ya, --rahsia
gunakan fasa rahsia untuk melakukan
-e, --edit
panggil editor pada komit mesej
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
-m,--mesej
gunakan teks sebagai mesej komit
-l,--fail log
baca mesej komit daripada fail
-d,--Tarikh
rekod tarikh yang ditetapkan sebagai tarikh komit
-u,--pengguna
merekodkan pengguna yang ditentukan sebagai committer
-S, --subrepos
berulang ke dalam subrepositori
-w, --abaikan-semua-ruang
abaikan ruang putih apabila membandingkan garisan
-b, --abaikan-ruang-perubahan
mengabaikan perubahan dalam jumlah ruang putih
-B, --abaikan-garis-kosong
abaikan perubahan yang semua barisnya kosong
[+] pilihan bertanda boleh ditentukan beberapa kali
paut semula
mencipta semula pautan keras antara klon repositori
arahan
paut semula
cipta semula pautan keras antara dua repositori:
hg pautkan semula [ORIGIN]
Apabila repositori diklon secara tempatan, fail data mereka akan dipaut keras supaya mereka
hanya menggunakan ruang repositori tunggal.
Malangnya, tarikan seterusnya ke dalam mana-mana repositori akan memecahkan pautan keras untuk sebarang fail
tersentuh oleh set perubahan baharu, walaupun kedua-dua repositori akhirnya menarik perubahan yang sama.
Begitu juga, menghantar --rev kepada "klon hg" akan gagal menggunakan sebarang pautan keras, kembali kepada
salinan lengkap repositori sumber.
Perintah ini membolehkan anda mencipta semula pautan keras tersebut dan menuntut semula ruang yang terbuang itu.
Repositori ini akan dipautkan semula untuk berkongsi ruang dengan ORIGIN, yang mesti berada pada kedudukan yang sama
cakera tempatan. Jika ORIGIN diabaikan, cari "pautan semula lalai", kemudian "lalai", dalam [paths].
Jangan cuba sebarang operasi baca pada repositori ini semasa arahan sedang dijalankan. (Kedua-duanya
repositori akan dikunci daripada penulisan.)
skim
meluaskan skim dengan pintasan ke kumpulan repositori
Sambungan ini membolehkan anda menentukan pintasan untuk URL induk dengan banyak repositori
untuk bertindak seperti skema, contohnya:
[skim]
py = http://code.python.org/hg/
Selepas itu anda boleh menggunakannya seperti:
hg klon py://trunk/
Selain itu, terdapat sokongan untuk beberapa skema yang lebih kompleks, contohnya digunakan oleh Google
Kod:
[skim]
gcode = http://{1}.googlecode.com/hg/
Sintaks diambil daripada templat Mercurial, dan anda mempunyai bilangan pembolehubah yang tidak terhad,
bermula dengan 1 {} dan meneruskan dengan 2 {}, 3 {} dan sebagainya. Pembolehubah ini akan menerima
bahagian URL yang dibekalkan, dibahagikan mengikut /. Apa-apa yang tidak dinyatakan sebagai {bahagian} hanya akan ditambah
ke URL.
Untuk kemudahan, sambungan menambah skema ini secara lalai:
[skim]
py = http://hg.python.org/
bb = https://bitbucket.org/
bb+ssh = ssh://[e-mel dilindungi]/
gcode = https://{1}.googlecode.com/hg/
tanur = https://{1}.kilnhg.com/Repo/
Anda boleh mengatasi skim yang dipratentukan dengan mentakrifkan skema baharu dengan nama yang sama.
saham
berkongsi sejarah yang sama antara beberapa direktori kerja
automatik Berkumpul Pada Suhu Ambien Untuk Clon
Apabila sambungan ini aktif, hg mengklon boleh dikonfigurasikan untuk berkongsi/menghimpun secara automatik
storan merentas berbilang klon. Mod ini menukar dengan berkesan hg mengklon kepada hg mengklon + hg
saham. Faedah menggunakan mod ini ialah pengurusan automatik laluan kedai dan
pengumpulan pintar repositori berkaitan.
Berikut bahagian. pilihan konfigurasi mempengaruhi ciri ini:
kongsi.kolam
Laluan sistem fail tempat data repositori kongsi akan disimpan. Apabila ditakrifkan, hg mengklon
akan menggunakan storan repositori dikongsi secara automatik dan bukannya membuat stor di dalamnya
setiap klon.
share.poolnaming
Bagaimana nama direktori dalam kongsi.kolam dibina.
"identiti" bermaksud nama itu diperoleh daripada set perubahan pertama dalam repositori. Dalam
mod ini, alat kawalan jauh yang berbeza berkongsi storan jika set perubahan akar/awalnya adalah
sama. Dalam mod ini, repositori kongsi tempatan ialah agregat semua
menemui repositori jauh.
"jauh" bermaksud nama itu diperoleh daripada laluan atau URL repositori sumber. Dalam
mod ini, storan hanya dikongsi jika laluan atau URL diminta dalam hg mengklon
arahan sepadan dengan tepat dengan repositori yang telah diklonkan sebelum ini.
Mod penamaan lalai ialah "identiti."
arahan
saham
buat repositori kongsi baharu:
hg kongsi [-U] [-B] SUMBER [DEST]
Mulakan repositori baharu dan direktori kerja yang berkongsi sejarahnya (dan secara pilihan
penanda buku) dengan repositori lain.
Ambil perhatian penggunaan rollback atau sambungan yang memusnahkan/mengubah suai sejarah (mq, rebase, dll.) boleh
menyebabkan kekeliruan yang besar dengan klon yang dikongsi. Khususnya, jika dua dikongsi
klon kedua-duanya dikemas kini kepada set perubahan yang sama, dan salah satu daripadanya memusnahkannya
changeset dengan rollback, klon lain tiba-tiba akan berhenti berfungsi: semua operasi
akan gagal dengan "abort: working directory has unknown parent". Satu-satunya yang diketahui
penyelesaiannya ialah menggunakan debugsetparents pada klon yang rosak untuk menetapkan semula kepada set perubahan
yang masih wujud.
Pilihan:
-U, --tiada kemas kini
jangan buat direktori kerja
-B, --penanda buku
juga berkongsi penanda buku
nyahkongsi
tukar repositori kongsi kepada repositori biasa:
hg nyahkongsi
Salin data kedai ke repo dan alih keluar data sharedpath.
rak
simpan dan pulihkan perubahan pada direktori kerja
Perintah "hg shelve" menyimpan perubahan yang dibuat pada direktori kerja dan mengembalikannya
perubahan, menetapkan semula direktori kerja kepada keadaan bersih.
Kemudian, arahan "hg unshelve" memulihkan perubahan yang disimpan oleh "hg shelve". Perubahan boleh
dipulihkan walaupun selepas mengemas kini kepada induk yang berbeza, dalam hal ini gabungan Mercurial
jentera akan menyelesaikan sebarang konflik jika perlu.
Anda boleh mempunyai lebih daripada satu perubahan tertunggak pada satu masa; setiap perubahan yang disimpan mempunyai a
nama yang berbeza. Untuk butiran, lihat bantuan untuk "rak hg".
arahan
rak
simpan dan ketepikan perubahan daripada direktori kerja:
hg rak [PILIHAN]... [FAIL]...
Rak mengambil fail yang "status hg" melaporkan sebagai tidak bersih, menyimpan pengubahsuaian kepada a
bundle (perubahan yang disimpan), dan mengembalikan fail supaya keadaannya berfungsi
direktori menjadi bersih.
Untuk memulihkan perubahan ini pada direktori kerja, menggunakan "hg unshelve"; ini akan berjaya
walaupun anda bertukar kepada komitmen yang berbeza.
Apabila tiada fail dinyatakan, "hg shelve" menyimpan semua fail yang tidak bersih. Jika fail tertentu atau
direktori dinamakan, hanya perubahan pada fail tersebut disimpan.
Setiap perubahan yang disimpan mempunyai nama yang memudahkannya dicari kemudian. Nama sebuah rak
tukar lalai kepada berdasarkan penanda halaman aktif, atau jika tiada penanda halaman aktif,
cawangan yang dinamakan semasa. Untuk menentukan nama lain, gunakan --nama.
Untuk melihat senarai perubahan yang sedia ada, gunakan --senarai pilihan. Bagi setiap perubahan yang disimpan,
ini akan mencetak nama, umur dan perihalannya; guna --tampalan or --stat untuk maklumat lanjut.
Untuk memadamkan perubahan tertentu yang disimpan, gunakan --padam. Untuk memadam semua perubahan yang disimpan, gunakan
--bersihkan.
Pilihan:
-A, --addremove
tandakan fail baharu/tiada sebagai ditambah/dialih keluar sebelum disimpan
-u, --tidak diketahui
simpan fail yang tidak diketahui di dalam rak
--bersihkan
padam semua perubahan yang disimpan
--Tarikh
rak dengan tarikh komitmen yang ditentukan
-d, --padam
padamkan perubahan disimpan yang dinamakan
-e, --edit
panggil editor pada komit mesej
-l, --senarai
senaraikan rak semasa
-m,--mesej
gunakan teks sebagai mesej rak
-n,--nama
gunakan nama yang diberikan untuk komit yang ditangguhkan
-p, --tampalan
tunjukkan tampalan
-saya, --interaktif
mod interaktif, hanya berfungsi semasa membuat rak
--stat keluaran ringkasan gaya diffstat bagi perubahan
-saya,--termasuk
sertakan nama yang sepadan dengan corak yang diberikan
-X,--kecualikan
kecualikan nama yang sepadan dengan corak yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
buka rak
memulihkan perubahan yang disimpan pada direktori kerja:
hg buka simpanan [SHELVED]
Perintah ini menerima nama pilihan bagi perubahan yang disimpan untuk dipulihkan. Jika tidak diberikan,
perubahan disimpan terkini digunakan.
Jika perubahan yang disimpan berjaya digunakan, berkas yang mengandungi perubahan yang disimpan itu akan berubah
dialihkan ke lokasi sandaran (.hg/shelve-backup).
Memandangkan anda boleh memulihkan perubahan yang ditangguhkan di atas komit sewenang-wenangnya, ada kemungkinan itu
tidak disimpan akan mengakibatkan konflik antara perubahan anda dan komitmen yang anda lakukan
membuka rak ke. Jika ini berlaku, anda mesti menyelesaikan konflik, kemudian gunakan --sambung kepada
selesaikan operasi buka rak. (Bundel tidak akan dialihkan sehingga anda berjaya
lengkapkan rak.)
(Sebagai alternatif, anda boleh menggunakan --menggugurkan kandungan untuk meninggalkan rak yang menyebabkan konflik. ini
mengembalikan perubahan yang tidak disimpan, dan meninggalkan berkas di tempatnya.)
Selepas pembongkaran berjaya, perubahan yang disimpan disimpan dalam direktori sandaran. Sahaja
N sandaran terbaharu disimpan. N lalai kepada 10 tetapi boleh diganti menggunakan
shelve.maxbackups pilihan konfigurasi.
Cap masa dalam saat digunakan untuk memutuskan susunan sandaran. Lebih daripada maxbackups sandaran adalah
disimpan, jika cap masa yang sama menghalang daripada menentukan susunan tepat mereka, untuk keselamatan.
Pilihan:
-A, --menggugurkan kandungan
batalkan operasi buka rak yang tidak lengkap
-c, --sambung
meneruskan operasi buka rak yang tidak lengkap
-k, --simpan
simpan rak selepas dibuka
-t,--alat
tentukan alat gabungan
--Tarikh
tetapkan tarikh untuk komitmen sementara (TAMAT)
jalur
strip changeset dan keturunan mereka daripada sejarah
Sambungan ini membolehkan anda menanggalkan changeset dan semua keturunannya daripada
repositori. Lihat bantuan arahan untuk butiran.
arahan
jalur
tanggalkan changeset dan semua keturunannya dari repositori:
jalur hg [-k] [-f] [-B penanda halaman] [-r] REV...
Perintah jalur mengalih keluar set perubahan yang ditentukan dan semua keturunannya. Sekiranya
direktori kerja mempunyai perubahan tanpa komitmen, operasi dibatalkan melainkan --force
bendera dibekalkan, dalam hal ini perubahan akan dibuang.
Jika induk direktori kerja dilucutkan, maka direktori kerja akan
dikemas kini secara automatik kepada nenek moyang terbaharu yang tersedia bagi ibu bapa yang dibogelkan
selepas operasi selesai.
Mana-mana set perubahan yang dilucutkan disimpan dalam .hg/strip-backup sebagai satu berkas (lihat hg membantu bundle and
hg membantu unbundle). Mereka boleh dipulihkan dengan berlari hg unbundle .hg/strip-backup/BUNDLE,
di mana BUNDLE ialah fail berkas yang dicipta oleh jalur. Ambil perhatian bahawa nombor semakan tempatan
secara amnya akan berbeza selepas pemulihan.
Gunakan pilihan --no-backup untuk membuang berkas sandaran setelah operasi selesai.
Strip bukan operasi penulisan semula sejarah dan boleh digunakan pada set perubahan di khalayak ramai
fasa. Tetapi jika set perubahan yang dilucutkan telah ditolak ke repositori jauh, anda akan melakukannya
berkemungkinan menarik mereka lagi.
Pulangan 0 pada kejayaan.
Pilihan:
-r,--rev
jalur semakan yang ditentukan (pilihan, boleh menentukan semakan tanpa pilihan ini)
-f, - kekuatan
penyingkiran paksa set perubahan, buang perubahan tidak komited (tiada sandaran)
--tiada-sandaran
tiada sandaran
--tiada sandaran
tiada sandaran (TAMAT)
-n diabaikan (DILARANG)
-k, --simpan
jangan ubah suai direktori kerja semasa jalur
-B,--penanda buku
alih keluar pusingan hanya boleh dicapai daripada penanda halaman yang diberikan
[+] pilihan bertanda boleh ditentukan beberapa kali
pemindahan
perintah untuk memindahkan perubahan dari cawangan lain
Sambungan ini membolehkan anda memindahkan perubahan kepada semakan induk lain, mungkin dalam
repositori lain. Pemindahan dilakukan menggunakan tompok 'diff'.
Tompok yang dipindahkan direkodkan dalam .hg/transplant/transplants, sebagai peta daripada set perubahan
hash kepada hashnya dalam repositori sumber.
arahan
pemindahan
set perubahan pemindahan dari cawangan lain:
pemindahan hg [-s REPO] [-b CAWANGAN [-a]] [-p REV] [-m REV] [REV]...
Set perubahan yang dipilih akan digunakan di atas direktori kerja semasa dengan log
daripada set perubahan asal. Set perubahan disalin dan dengan itu akan muncul dua kali dalam
sejarah dengan identiti yang berbeza.
Pertimbangkan untuk menggunakan perintah cantuman jika semuanya berada di dalam repositori yang sama - ia akan digunakan
bergabung dan biasanya akan memberikan hasil yang lebih baik. Gunakan sambungan rebase jika perubahan ditetapkan
tidak diterbitkan dan anda mahu mengalihkannya dan bukannya menyalinnya.
Jika --log ditentukan, mesej log akan mempunyai ulasan yang dilampirkan pada borang:
(dipindah dari CHANGESETHASH)
Anda boleh menulis semula mesej changelog dengan pilihan --filter. Hujahnya akan
digunakan dengan mesej changelog semasa sebagai $1 dan patch sebagai $2.
--source/-s menentukan repositori lain untuk digunakan untuk memilih set perubahan, sama seperti ia
buat sementara waktu telah ditarik. Jika --branch/-b dinyatakan, semakan ini akan digunakan sebagai
kepala apabila memutuskan perubahan yang perlu dipindahkan, seolah-olah hanya semakan ini
telah ditarik. Jika --all/-a ditentukan, semua semakan sehingga kepala ditentukan dengan
--cabang akan dipindahkan.
Contoh:
· pindahkan semua perubahan sehingga REV di atas semakan semasa anda:
pemindahan hg --cawangan REV --semua
Anda boleh menandai set perubahan yang dipindahkan secara pilihan sebagai set perubahan gabungan. Anda tidak akan
digesa untuk memindahkan mana-mana nenek moyang pemindahan gabungan, dan anda boleh bergabung
keturunan mereka secara normal dan bukannya memindahkan mereka.
Set perubahan gabungan boleh dipindahkan secara langsung dengan menyatakan set perubahan induk yang betul oleh
memanggil hg pemindahan --ibu bapa.
Jika tiada gabungan atau semakan disediakan, hg pemindahan akan memulakan set perubahan interaktif
pelayar.
Jika aplikasi changeset gagal, anda boleh membetulkan gabungan dengan tangan dan kemudian menyambung semula tempat anda
berhenti dengan menelefon hg pemindahan --sambung/-c.
Pilihan:
-ya,--sumber
perubahan pemindahan daripada REPO
-b,--cawangan
gunakan set perubahan sumber ini sebagai kepala
-A, --semua
tarik semua perubahan sehingga semakan --branch
-p,--pangkas
langkau REV
-m,--bercantum
bergabung di REV
--ibu bapa
ibu bapa untuk memilih semasa pemindahan gabungan
-e, --edit
panggil editor pada komit mesej
--log tambah maklumat pemindahan pada mesej log
-c, --sambung
meneruskan sesi pemindahan terakhir selepas menyelesaikan konflik
--penapis
penapis perubahan melalui arahan
[+] pilihan bertanda boleh ditentukan beberapa kali
menang32mbcs
membenarkan penggunaan laluan MBCS dengan pengekodan bermasalah
Sesetengah pengekodan MBCS tidak baik untuk beberapa operasi laluan (iaitu laluan pemisah, kes
penukaran, dsb.) dengan bait yang dikodkan. Kami memanggil pengekodan sedemikian (iaitu shift_jis dan
big5) sebagai "pengekodan bermasalah". Sambungan ini boleh digunakan untuk membetulkan isu tersebut
pengekodan dengan membungkus beberapa fungsi untuk ditukar kepada rentetan Unicode sebelum operasi laluan.
Sambungan ini berguna untuk:
· Pengguna Windows Jepun menggunakan pengekodan shift_jis.
· Pengguna Windows Cina menggunakan pengekodan big5.
· Semua pengguna yang menggunakan repositori dengan salah satu pengekodan bermasalah pada case-insensitive
sistem fail.
Sambungan ini tidak diperlukan untuk:
· Mana-mana pengguna yang hanya menggunakan aksara ASCII dalam laluan.
· Mana-mana pengguna yang tidak menggunakan sebarang pengekodan yang bermasalah.
Ambil perhatian bahawa terdapat beberapa batasan untuk menggunakan sambungan ini:
· Anda harus menggunakan pengekodan tunggal dalam satu repositori.
· Jika laluan repositori berakhir dengan 0x5c, .hg/hgrc tidak boleh dibaca.
· win32mbcs tidak serasi dengan sambungan fixutf8.
Secara lalai, win32mbcs menggunakan pengekodan.pengekodan yang diputuskan oleh Mercurial. Anda boleh menentukan
pengekodan mengikut pilihan konfigurasi:
[win32mbcs]
pengekodan = sjis
Ia berguna untuk pengguna yang ingin berkomitmen dengan mesej log UTF-8.
win32text
lakukan penukaran baris baharu automatik (TIDAK ADA)
Penamatan: Sambungan win32text memerlukan setiap pengguna untuk mengkonfigurasi sambungan
lagi dan lagi untuk setiap klon kerana konfigurasi tidak disalin semasa pengklonan.
Oleh itu kami telah membuat eol sebagai alternatif. The eol menggunakan versi terkawal
fail untuk konfigurasinya dan oleh itu setiap klon akan menggunakan tetapan yang betul dari
permulaan.
Untuk melakukan penukaran baris baharu automatik, gunakan:
[sambungan]
win32text =
[enkod]
** = cleverencode:
# atau ** = macencode:
[nyahkod]
** = cleverdecode:
# atau ** = macdecode:
Jika tidak melakukan penukaran, untuk memastikan anda tidak melakukan CRLF/CR secara tidak sengaja:
[cangkuk]
pretxncommit.crlf = python:hgext.win32text.forbidcrlf
# atau pretxncommit.cr = python:hgext.win32text.forbidcr
Untuk melakukan pemeriksaan yang sama pada pelayan untuk mengelakkan CRLF/CR daripada ditolak atau ditarik:
[cangkuk]
pretxnchangegroup.crlf = python:hgext.win32text.forbidcrlf
# atau pretxnchangegroup.cr = python:hgext.win32text.forbidcr
zeroconf
menemui dan mengiklankan repositori pada rangkaian tempatan
Sambungan zeroconf akan mengiklankan hg berkhidmat kejadian melalui DNS-SD supaya ia boleh
ditemui menggunakan hg laluan arahan tanpa mengetahui alamat pelayan.
Untuk membenarkan orang lain menemui repositori anda menggunakan run hg berkhidmat dalam repositori anda:
ujian $cd
$ hg hidang
Anda boleh menemui repositori yang didayakan Zeroconf dengan menjalankan hg laluan:
$ hg laluan
zc-test = http://example.com:8000/ujian
Gunakan hg dalam talian menggunakan perkhidmatan onworks.net
