Ini adalah perintah hg yang dapat dijalankan di penyedia hosting gratis OnWorks menggunakan salah satu dari beberapa stasiun kerja online gratis kami seperti Ubuntu Online, Fedora Online, emulator online Windows atau emulator online MAC OS
PROGRAM:
NAMA
hg - Sistem manajemen kode sumber Mercurial
RINGKASAN
hg Command [Option]...[argumen] ...
DESKRIPSI
Grafik hg command menyediakan antarmuka baris perintah ke sistem Mercurial.
COMMAND UNSUR
file ...
menunjukkan satu atau lebih nama file atau nama file jalur relatif; lihat Pola Nama File
untuk informasi tentang pencocokan pola
path menunjukkan jalur pada mesin lokal
revisi
menunjukkan changeset yang dapat ditentukan sebagai nomor revisi changeset, tag,
atau substring unik dari nilai hash changeset
gudang path
baik nama path dari repositori lokal atau URI dari repositori jarak jauh.
PILIHAN
-R,--gudang
direktori root repositori atau nama file bundel overlay
--cwd
ubah direktori kerja
-y, --noninteraktif
jangan meminta, secara otomatis memilih pilihan pertama untuk semua petunjuk
-Q, --diam
menekan keluaran
-di, --bertele-tele
aktifkan keluaran tambahan
--konfigurasi
atur/timpa opsi konfigurasi (gunakan 'section.name=value')
--debug
aktifkan keluaran debug
--debug
mulai debugger
--pengkodean
atur pengkodean charset (default: UTF-8)
--mode pengkodean
atur mode penyandian charset (default: ketat)
--melacak kembali
selalu cetak traceback pada pengecualian
--waktu waktu berapa lama perintah itu berlangsung
--Profil
cetak profil eksekusi perintah
--Versi: kapan
menampilkan informasi versi dan keluar
-H, --membantu
tampilkan bantuan dan keluar
--tersembunyi
pertimbangkan perubahan tersembunyi
[+] opsi yang ditandai dapat ditentukan beberapa kali
PERINTAH
menambahkan
tambahkan file yang ditentukan pada komit berikutnya:
hg tambahkan [OPSI]... [FILE]...
Jadwalkan file untuk dikontrol versi dan ditambahkan ke repositori.
File akan ditambahkan ke repositori pada komit berikutnya. Untuk membatalkan penambahan sebelum itu,
melihat hg lupa.
Jika tidak ada nama yang diberikan, tambahkan semua file ke repositori (kecuali file yang cocok .hignore).
contoh:
· File baru (tidak dikenal) ditambahkan secara otomatis oleh hg menambahkan:
$ l
foo.c
status $hg
? foo.c
$hg menambahkan
menambahkan foo.c
status $hg
Sebuah foo.c
· File khusus yang akan ditambahkan dapat ditentukan:
$ l
bar.c foo.c
status $hg
? bar.c
? foo.c
$hg tambahkan bar.c
status $hg
Sebuah bar.c
? foo.c
Mengembalikan 0 jika semua file berhasil ditambahkan.
Pilihan:
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-S, --subrepos
rekursi menjadi subrepositori
-N, --lari-kering
jangan melakukan tindakan, cukup cetak output
[+] opsi yang ditandai dapat ditentukan beberapa kali
hapus
tambahkan semua file baru, hapus semua file yang hilang:
hg addremove [OPSI]... [FILE]...
Tambahkan semua file baru dan hapus semua file yang hilang dari repositori.
Kecuali jika nama diberikan, file baru akan diabaikan jika cocok dengan salah satu pola di
.hignore. Seperti halnya add, perubahan ini berlaku pada komit berikutnya.
Gunakan opsi -s/--similarity untuk mendeteksi file yang diganti namanya. Opsi ini membutuhkan persentase
antara 0 (dinonaktifkan) dan 100 (file harus identik) sebagai parameternya. Dengan parameter
lebih besar dari 0, ini membandingkan setiap file yang dihapus dengan setiap file yang ditambahkan dan mencatatnya
cukup mirip dengan mengganti nama. Mendeteksi file yang diganti namanya dengan cara ini bisa jadi mahal. Setelah menggunakan
pilihan ini, hg status -C dapat digunakan untuk memeriksa file mana yang diidentifikasi sebagai dipindahkan atau
berganti nama. Jika tidak ditentukan, -s/--similarity default ke 100 dan hanya mengganti nama yang identik
file terdeteksi.
contoh:
· Sejumlah file (bar.c dan foo.c) baru, sedangkan foobar.c telah dihapus (tanpa
menggunakan hg menghapus) dari repositori:
$ l
bar.c foo.c
status $hg
! foobar.c
? bar.c
? foo.c
$hg addremove
menambahkan bar.c
menambahkan foo.c
menghapus foobar.c
status $hg
Sebuah bar.c
Sebuah foo.c
R foobar.c
· File foobar.c dipindahkan ke foo.c tanpa menggunakan hg mengubah nama. Setelah itu, itu
diedit sedikit:
$ l
foo.c
status $hg
! foobar.c
? foo.c
$ hg addremove --kesamaan 90
menghapus foobar.c
menambahkan foo.c
merekam penghapusan foobar.c sebagai ganti nama menjadi foo.c (94% serupa)
$hg status -C
Sebuah foo.c
foobar.c
R foobar.c
Mengembalikan 0 jika semua file berhasil ditambahkan.
Pilihan:
-S,--kesamaan
tebak file yang diganti namanya berdasarkan kesamaan (0<=s<=100)
-S, --subrepos
rekursi menjadi subrepositori
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-N, --lari-kering
jangan melakukan tindakan, cukup cetak output
[+] opsi yang ditandai dapat ditentukan beberapa kali
membubuhi keterangan
tampilkan informasi changeset per baris untuk setiap file:
hg membubuhi keterangan [-r REV] [-f] [-a] [-u] [-d] [-n] [-c] [-l] FILE...
Buat daftar perubahan dalam file, yang menunjukkan id revisi yang bertanggung jawab untuk setiap baris.
Perintah ini berguna untuk mengetahui kapan perubahan dibuat dan oleh siapa.
Jika Anda menyertakan --file, --user, atau --date, nomor revisi akan disembunyikan kecuali Anda
juga termasuk --number.
Tanpa opsi -a/--text, anotasi akan menghindari pemrosesan file yang dideteksi sebagai biner.
Dengan -a, anotasi akan tetap memberi anotasi pada file, meskipun hasilnya mungkin seperti
tidak berguna atau diinginkan.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-R,--putaran
anotasi revisi yang ditentukan
--mengikuti
ikuti salinan/ganti nama dan daftarkan nama file (DIHAPUS)
--tidak mengikuti
jangan ikuti salinan dan ganti nama
-Sebuah, --teks
perlakukan semua file sebagai teks
-kamu, --pengguna
daftar penulis (panjang dengan -v)
-F, --mengajukan
daftar nama file
-D, --tanggal
cantumkan tanggalnya (pendek dengan -q)
-N, --nomor
daftar nomor revisi (default)
-C, --ubah set
daftar perubahan
-aku, --nomor-baris
tunjukkan nomor baris pada penampilan pertama
-w, --abaikan-semua-ruang
abaikan spasi saat membandingkan garis
-B, --abaikan-ruang-perubahan
abaikan perubahan jumlah ruang putih
-B, --abaikan-baris-kosong
abaikan perubahan yang barisnya kosong semua
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-T,--templat
tampilan dengan template (EKSPERIMENTAL)
[+] opsi yang ditandai dapat ditentukan beberapa kali
alias: menyalahkan
arsip
buat arsip tidak berversi dari revisi repositori:
hg arsip [OPSI]... TANGGAL
Secara default, revisi yang digunakan adalah induk dari direktori kerja; gunakan -r/--rev untuk
menentukan revisi yang berbeda.
Jenis arsip secara otomatis terdeteksi berdasarkan ekstensi file (untuk mengganti, gunakan
-t/--jenis).
contoh:
· buat file zip yang berisi rilis 1.0:
hg arsip -r 1.0 proyek-1.0.zip
· membuat tarball tidak termasuk file .hg:
hg arsip project.tar.gz -X ".hg*"
Jenis yang valid adalah:
arsip
direktori yang penuh dengan file (default)
ter
arsip tar, tidak terkompresi
tbz2
arsip tar, dikompres menggunakan bzip2
tgz
arsip tar, dikompresi menggunakan gzip
uzip
arsip zip, tidak terkompresi
zip
arsip zip, dikompresi menggunakan deflate
Nama yang tepat dari arsip atau direktori tujuan diberikan menggunakan format string; Lihat
hg membantu ekspor untuk rincian.
Setiap anggota yang ditambahkan ke file arsip memiliki awalan direktori. Gunakan -p/--prefix untuk
tentukan string format untuk awalan. Defaultnya adalah nama dasar arsip, dengan
sufiks dihilangkan.
Mengembalikan 0 pada keberhasilan.
Pilihan:
--tanpa-dekode
jangan melewatkan file melalui dekoder
-P,--awalan
awalan direktori untuk file dalam arsip
-R,--putaran
revisi untuk didistribusikan
-T,--Tipe
jenis distribusi yang akan dibuat
-S, --subrepos
rekursi menjadi subrepositori
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
mundur
efek kebalikan dari changeset sebelumnya:
hg mundur [OPTION]... [-r] REV
Siapkan changeset baru dengan efek REV dibatalkan di direktori kerja saat ini. Jika
tidak ada konflik yang ditemui, itu akan segera dilakukan.
Jika REV adalah induk dari direktori kerja, maka perubahan baru ini dilakukan
secara otomatis (kecuali --no-commit ditentukan).
Note hg mundur tidak dapat digunakan untuk memperbaiki penggabungan yang tidak diinginkan atau salah.
contoh:
· Membalikkan efek induk dari direktori kerja. Backout ini akan menjadi
berkomitmen segera:
hg mundur -r .
· Membalikkan efek dari revisi buruk sebelumnya 23:
hg mundur -r 23
· Membalikkan efek dari revisi buruk sebelumnya 23 dan membiarkan perubahan tidak terikat:
hg backout -r 23 --tidak-komit
hg commit -m "Revisi mundur 23"
Secara default, perubahan yang tertunda akan memiliki satu induk, mempertahankan riwayat linier. Dengan
--merge, perubahan yang tertunda akan memiliki dua orang tua: orang tua lama dari
direktori kerja dan anak baru REV yang hanya membatalkan REV.
Sebelum versi 1.7, perilaku tanpa --merge setara dengan menetapkan --merge
diikuti oleh hg memperbarui --membersihkan . untuk membatalkan penggabungan dan meninggalkan anak REV sebagai kepala
untuk digabungkan secara terpisah.
Lihat hg membantu tanggal untuk daftar format yang valid untuk -d/--date.
Lihat hg membantu kembali untuk cara mengembalikan file ke status revisi lain.
Mengembalikan 0 jika berhasil, 1 jika tidak ada yang mundur atau ada file yang belum terselesaikan.
Pilihan:
--menggabungkan
bergabung dengan orang tua yang buruk setelah mundur
--melakukan
komit jika tidak ada konflik yang ditemukan (DIHAPUS)
--tidak ada komitmen
jangan berkomitmen
--induk
orang tua untuk memilih saat mundur dari penggabungan (DIHAPUS)
-R,--putaran
revisi untuk mundur
-e, --edit
panggil editor pada pesan komit
-T,--alat
tentukan alat gabungan
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-M,--pesan
gunakan teks sebagai pesan komit
-aku,--file log
baca pesan komit dari file
-D,--tanggal
catat tanggal yang ditentukan sebagai tanggal komit
-kamu,--pengguna
rekam pengguna yang ditentukan sebagai pembuat
[+] opsi yang ditandai dapat ditentukan beberapa kali
membagi dua
pencarian subdivisi dari perubahan:
hg membagi dua [-gbsr] [-U] [-c CMD] [REV]
Perintah ini membantu menemukan set perubahan yang menimbulkan masalah. Untuk menggunakan, tandai paling awal
changeset yang Anda tahu menunjukkan masalahnya sebagai masalah, lalu tandai changeset terbaru yaitu
bebas dari masalah sebaik-baiknya. Bisect akan memperbarui direktori kerja Anda ke revisi untuk
pengujian (kecuali opsi -U/--noupdate ditentukan). Setelah Anda melakukan tes,
tandai direktori kerja sebagai baik atau buruk, dan bagi dua akan memperbarui ke yang lain
kandidat changeset atau mengumumkan bahwa telah ditemukan revisi yang buruk.
Sebagai jalan pintas, Anda juga dapat menggunakan argumen revisi untuk menandai revisi sebagai baik atau buruk
tanpa memeriksanya terlebih dahulu.
Jika Anda memberikan perintah, itu akan digunakan untuk pembelahan otomatis. Lingkungan
variabel HG_NODE akan berisi ID dari changeset yang sedang diuji. Status keluar dari
perintah akan digunakan untuk menandai revisi sebagai baik atau buruk: status 0 berarti baik, 125 berarti
lewati revisi, 127 (perintah tidak ditemukan) akan membatalkan pembelahan, dan lainnya
status keluar bukan nol berarti revisinya buruk.
Beberapa contoh:
· memulai pembelahan dengan revisi 34 yang diketahui buruk, dan revisi yang baik 12:
hg membagi dua --buruk 34
hg membagi dua --baik 12
· memajukan pembelahan saat ini dengan menandai revisi saat ini sebagai baik atau buruk:
hg membagi dua --baik
hg membagi dua --buruk
· tandai revisi saat ini, atau revisi yang diketahui, untuk dilewati (misalnya jika revisi itu
tidak dapat digunakan karena masalah lain):
hg membagi dua --skip
hg membagi dua --skip 23
· lewati semua revisi yang tidak menyentuh direktori foo or bar:
hg membagi dua --skip "!( file('path:foo') & file('path:bar') )"
· lupakan pembagian saat ini:
hg membagi dua --reset
· gunakan 'make && make test' untuk secara otomatis menemukan revisi pertama yang rusak:
hg membagi dua --reset
hg membagi dua --buruk 34
hg membagi dua --baik 12
hg membagi dua --perintah "buat && buat tes"
· lihat semua set perubahan yang statusnya sudah diketahui di pembelahan saat ini:
hg log -r "bagi dua (dipangkas)"
· lihat set perubahan yang saat ini sedang dibagi dua (terutama berguna jika dijalankan dengan
-U/--tidak ada pembaruan):
hg log -r "bagi dua (saat ini)"
· lihat semua perubahan yang mengambil bagian dalam pembelahan saat ini:
hg log -r "bagi dua (kisaran)"
· Anda bahkan bisa mendapatkan grafik yang bagus:
hg log --graph -r "bagi dua(kisaran)"
Lihat hg membantu revset untuk lebih lanjut tentang membagi dua() kata kunci.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-R, --mengatur ulang
atur ulang keadaan membagi dua
-G, --bagus
tandai changeset dengan baik
-B, --buruk
tandai changeset buruk
-S, --melewati
lewati pengujian perubahan
-e, --memperpanjang
memperluas jangkauan membagi dua
-C,--memerintah
gunakan perintah untuk memeriksa status changeset
-kamu, --tidak diperbarui
jangan perbarui ke target
bookmark
buat bookmark baru atau daftar bookmark yang ada:
hg bookmark [OPTIONS]... [NAME]...
Bookmark adalah label pada set perubahan untuk membantu melacak jalur pengembangan. Bookmark adalah
tidak berversi dan dapat dipindahkan, diganti namanya, dan dihapus. Menghapus atau memindahkan bookmark tidak dapat
berpengaruh pada perubahan yang terkait.
Membuat atau memperbarui bookmark menyebabkannya ditandai sebagai 'aktif'. yang aktif
bookmark ditandai dengan '*'. Saat komit dibuat, bookmark aktif akan maju
ke komit baru. Sebuah dataran hg memperbarui juga akan memajukan bookmark aktif, jika memungkinkan.
Memperbarui dari bookmark akan menyebabkannya dinonaktifkan.
Bookmark dapat didorong dan ditarik di antara repositori (lihat hg membantu mendorong dan hg membantu menarik
). Jika bookmark bersama telah menyimpang, 'bookmark berbeda' baru dalam bentuk 'nama@jalur'
akan dibuat. Menggunakan hg bergabung akan menyelesaikan divergensi.
Bookmark bernama '@' memiliki properti khusus yang hg clone akan memeriksanya secara default
jika itu ada.
contoh:
· buat bookmark aktif untuk jalur pengembangan baru:
fitur baru buku hg
· buat bookmark tidak aktif sebagai penanda tempat:
hg buku -saya mengulas
· buat bookmark tidak aktif di set perubahan lain:
hg book -r .^ diuji
· ganti nama bookmark turkey menjadi makan malam:
hg book -m makan malam kalkun
· pindahkan penanda '@' dari cabang lain:
buku hg -f @
Pilihan:
-F, --memaksa
kekuatan
-R,--putaran
revisi untuk tindakan bookmark
-D, --menghapus
hapus bookmark yang diberikan
-M,--ganti nama
ganti nama bookmark yang diberikan
-Saya, --tidak aktif
tandai bookmark tidak aktif
-T,--templat
tampilan dengan template (EKSPERIMENTAL)
alias: bookmark
cabang
atur atau tampilkan nama cabang saat ini:
cabang hg [-fC] [NAME]
Catatan Nama cabang bersifat permanen dan global. Menggunakan hg bookmark untuk membuat yang ringan
bookmark sebagai gantinya. Lihat hg membantu glosarium untuk informasi lebih lanjut tentang cabang bernama
dan bookmark.
Tanpa argumen, tunjukkan nama cabang saat ini. Dengan satu argumen, atur kerja
nama cabang direktori (cabang tidak akan ada di repositori sampai komit berikutnya).
Praktik standar merekomendasikan bahwa pengembangan utama dilakukan di cabang 'default'.
Kecuali -f/--force ditentukan, cabang tidak akan membiarkan Anda menetapkan nama cabang yang sudah
ada
Gunakan -C/--clean untuk mengatur ulang cabang direktori kerja ke induk dari yang bekerja
direktori, meniadakan perubahan cabang sebelumnya.
Gunakan perintah hg memperbarui untuk beralih ke cabang yang ada. Menggunakan hg melakukan --dekat-cabang untuk
tandai kepala cabang ini sebagai tutup. Ketika semua kepala cabang ditutup, cabang akan
dianggap tertutup.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-F, --memaksa
atur nama cabang meskipun itu membayangi cabang yang ada
-C, --membersihkan
setel ulang nama cabang ke nama cabang induk
cabang
daftar repositori bernama cabang:
cabang hg [-c]
Buat daftar cabang bernama repositori, yang menunjukkan mana yang tidak aktif. Jika -c/--tertutup
ditentukan, juga daftar cabang yang telah ditandai tutup (lihat hg melakukan
--dekat-cabang).
Gunakan perintah hg memperbarui untuk beralih ke cabang yang ada.
Mengembalikan 0.
Pilihan:
-Sebuah, --aktif
tampilkan hanya cabang yang memiliki kepala yang tidak digabung (DIHAPUS)
-C, --tertutup
tunjukkan cabang normal dan tertutup
-T,--templat
tampilan dengan template (EKSPERIMENTAL)
bundel
buat file grup perubahan:
hg bundel [-f] [-t TYPE] [-a] [-r REV]... [--base REV]... FILE [DEST]
Hasilkan file grup perubahan yang mengumpulkan kumpulan perubahan untuk ditambahkan ke repositori.
Untuk membuat bundel yang berisi semua set perubahan, gunakan -a/--all (atau --base null). Jika tidak, hg
mengasumsikan tujuan akan memiliki semua node yang Anda tentukan dengan parameter --base.
Jika tidak, hg akan menganggap repositori memiliki semua node di tujuan, atau
default-push/default jika tidak ada tujuan yang ditentukan.
Anda dapat mengubah format bundel dengan opsi -t/--type. Anda dapat menentukan kompresi, a
versi bundel atau keduanya menggunakan tanda hubung (versi comp). Metode kompresi yang tersedia adalah:
none, bzip2, dan gzip (secara default, bundel dikompres menggunakan bzip2). yang tersedia
formatnya adalah: v1, v2 (default untuk yang paling sesuai).
File bundel kemudian dapat ditransfer menggunakan cara konvensional dan diterapkan ke yang lain
repositori dengan perintah unbundle atau pull. Ini berguna ketika dorongan dan tarikan langsung adalah
tidak tersedia atau saat mengekspor seluruh repositori tidak diinginkan.
Menerapkan bundel mempertahankan semua konten changeset termasuk izin, salin/ganti nama
informasi, dan riwayat revisi.
Mengembalikan 0 jika berhasil, 1 jika tidak ada perubahan yang ditemukan.
Pilihan:
-F, --memaksa
berjalan bahkan ketika tujuannya tidak terkait
-R,--putaran
set perubahan yang dimaksudkan untuk ditambahkan ke tujuan
-B,--cabang
cabang tertentu yang ingin Anda bundel
--basis
set perubahan dasar yang diasumsikan tersedia di tujuan
-Sebuah, --semua
bundel semua perubahan dalam repositori
-T,--Tipe
jenis kompresi bundel yang akan digunakan (default: bzip2)
-e,--ssh
tentukan perintah ssh untuk digunakan
--jarak jauh
tentukan perintah hg untuk dijalankan di sisi jarak jauh
--merasa tidak aman
jangan verifikasi sertifikat server (abaikan konfigurasi web.cacerts)
[+] opsi yang ditandai dapat ditentukan beberapa kali
kucing
keluaran revisi file saat ini atau yang diberikan:
hg cat [OPSI]... FILE...
Cetak file yang ditentukan seperti pada revisi yang diberikan. Jika tidak ada revisi yang diberikan,
induk dari direktori kerja digunakan.
Output mungkin ke file, dalam hal ini nama file diberikan menggunakan format
rangkaian. Aturan pemformatan sebagai berikut:
%%
karakter "%" literal
%s
nama dasar file yang sedang dicetak
%d
dirname file yang sedang dicetak, atau '.' jika di root repositori
%p
nama jalur relatif root dari file yang sedang dicetak
%H
changeset hash (40 digit heksadesimal)
%R
ubah nomor revisi
%h
hash changeset bentuk pendek (12 digit heksadesimal)
%r
nomor revisi changeset dengan bantalan nol
%b
nama dasar repositori pengekspor
Mengembalikan 0 pada keberhasilan.
Pilihan:
-Hai,--keluaran
hasil cetak ke file dengan nama yang diformat
-R,--putaran
cetak revisi yang diberikan
--membaca sandi
terapkan filter dekode yang cocok
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
clone
buat salinan dari repositori yang ada:
hg clone [OPSI]... SUMBER [TUJUAN]
Buat salinan repositori yang ada di direktori baru.
Jika tidak ada nama direktori tujuan yang ditentukan, defaultnya adalah nama dasar sumber.
Lokasi sumber ditambahkan ke repositori baru .hg/hgrc file, sebagai default
digunakan untuk penarikan di masa depan.
Hanya jalur lokal dan ssh: // URL didukung sebagai tujuan. Untuk ssh: // tujuan,
tidak ada direktori kerja atau .hg/hgrc akan dibuat di sisi remote.
Jika repositori sumber memiliki bookmark yang disebut set '@', revisi itu akan diperiksa
di repositori baru secara default.
Untuk memeriksa versi tertentu, gunakan -u/--update, atau -U/--noupdate untuk membuat klon
tanpa direktori kerja.
Untuk menarik hanya subset dari perubahan, tentukan satu atau lebih pengidentifikasi revisi dengan
-r/--rev atau bercabang dengan -b/--branch. Klon yang dihasilkan hanya akan berisi yang ditentukan
perubahan dan nenek moyang mereka. Opsi ini (atau 'clone src#rev dest') menyiratkan --pull, even
untuk repositori sumber lokal.
Catatan Menentukan tag akan menyertakan changeset yang ditandai tetapi bukan changeset yang mengandung
tag.
Untuk efisiensi, hardlink digunakan untuk kloning setiap kali sumber dan tujuan aktif
sistem file yang sama (perhatikan ini hanya berlaku untuk data repositori, bukan untuk yang berfungsi
direktori). Beberapa sistem file, seperti AFS, salah mengimplementasikan hardlinking, tetapi tidak
melaporkan kesalahan. Dalam kasus ini, gunakan opsi --pull untuk menghindari hardlinking.
Dalam beberapa kasus, Anda dapat mengkloning repositori dan direktori kerja menggunakan hardlink lengkap
dengan
$cp -al REPO REPOCLONE
Ini adalah cara tercepat untuk mengkloning, tetapi tidak selalu aman. Operasi tidak atomik
(pastikan REPO tidak dimodifikasi selama operasi terserah Anda) dan Anda harus membuat
pastikan editor Anda merusak tautan keras (Emacs dan sebagian besar alat Kernel Linux melakukannya). Juga, ini adalah
tidak kompatibel dengan ekstensi tertentu yang menempatkan metadatanya di bawah direktori .hg,
seperti mq.
Mercurial akan memperbarui direktori kerja ke revisi pertama yang berlaku dari ini
Daftar:
A. null jika -U atau repositori sumber tidak memiliki perubahan
B. jika kamu . dan repositori sumber adalah lokal, induk pertama dari repositori sumber
direktori kerja
C. changeset yang ditentukan dengan -u (jika nama cabang, ini berarti kepala terbaru dari itu
cabang)
D. perubahan yang ditentukan dengan -r
e. kepala paling ujung ditentukan dengan -b
F. kepala paling ujung ditentukan dengan sintaks sumber url#branch
G. revisi ditandai dengan penanda '@', jika ada
H. kepala paling ujung dari cabang default
Saya. tip
Saat mengkloning dari server yang mendukungnya, Mercurial dapat mengambil data yang telah dibuat sebelumnya dari a
URL yang diiklankan server. Ketika ini selesai, kait yang beroperasi pada set perubahan yang masuk dan
changegroups dapat diaktifkan dua kali, sekali untuk bundel yang diambil dari URL dan satu lagi untuk semua
data tambahan tidak diambil dari URL ini. Selain itu, jika terjadi kesalahan, repositori
dapat digulung kembali ke klon parsial. Perilaku ini dapat berubah di rilis mendatang. Lihat hg
membantu -e kloning untuk lebih.
contoh:
· mengkloning repositori jarak jauh ke direktori baru bernama hg/:
kloning hg http://selenic.com/hg
· buat klon lokal ringan:
proyek klon hg/fitur-proyek/
· mengkloning dari jalur absolut pada server ssh (perhatikan garis miring ganda):
hg clone ssh://pengguna@server//home/projects/alpha/
· lakukan klon berkecepatan tinggi melalui LAN sambil memeriksa versi yang ditentukan:
hg clone --tidak terkompresi http://server/repo -kamu 1.5
· buat repositori tanpa perubahan setelah revisi tertentu:
hg clone -r 04e544 eksperimental/ bagus/
· mengkloning (dan melacak) cabang bernama tertentu:
kloning hg http://selenic.com/hg#stabil
Lihat hg membantu url untuk detail tentang menentukan URL.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-kamu, --tidak diperbarui
klon akan menyertakan direktori kerja kosong (hanya repositori)
-kamu,--updaterev
revisi, tag, atau cabang untuk diperiksa
-R,--putaran
sertakan set perubahan yang ditentukan
-B,--cabang
klon hanya cabang yang ditentukan
--menarik gunakan protokol tarik untuk menyalin metadata
--tidak terkompresi
gunakan transfer tidak terkompresi (cepat melalui LAN)
-e,--ssh
tentukan perintah ssh untuk digunakan
--jarak jauh
tentukan perintah hg untuk dijalankan di sisi jarak jauh
--merasa tidak aman
jangan verifikasi sertifikat server (abaikan konfigurasi web.cacerts)
[+] opsi yang ditandai dapat ditentukan beberapa kali
melakukan
komit file yang ditentukan atau semua perubahan luar biasa:
hg komit [OPSI]... [FILE]...
Komit perubahan pada file yang diberikan ke dalam repositori. Tidak seperti SCM terpusat, ini
operasi adalah operasi lokal. Lihat hg mendorong cara untuk mendistribusikan perubahan Anda secara aktif.
Jika daftar file dihilangkan, semua perubahan dilaporkan oleh hg status akan berkomitmen.
Jika Anda melakukan hasil penggabungan, jangan berikan nama file apa pun atau -I/-X
filter.
Jika tidak ada pesan komit yang ditentukan, Mercurial memulai editor Anda yang dikonfigurasi di mana Anda bisa
masukkan pesan. Jika komit Anda gagal, Anda akan menemukan cadangan pesan Anda di
.hg/pesan terakhir.txt.
Bendera --close-branch dapat digunakan untuk menandai kepala cabang saat ini ditutup. Ketika semua kepala
cabang ditutup, cabang akan dianggap tutup dan tidak terdaftar lagi.
Bendera --amend dapat digunakan untuk mengubah induk direktori kerja dengan yang baru
komit yang berisi perubahan pada induk selain yang saat ini dilaporkan oleh
hg status, jika ada. Komit lama disimpan dalam bundel cadangan di
.hg/strip-cadangan (Lihat hg membantu bundel dan hg membantu unbundle tentang cara mengembalikannya).
Pesan, pengguna, dan tanggal diambil dari komit yang diubah kecuali ditentukan. Ketika sebuah pesan
tidak ditentukan pada baris perintah, editor akan terbuka dengan pesan yang diubah
melakukan.
Tidak mungkin untuk mengubah set perubahan publik (lihat hg membantu fase) atau perubahan yang memiliki
anak.
Lihat hg membantu tanggal untuk daftar format yang valid untuk -d/--date.
Mengembalikan 0 jika berhasil, 1 jika tidak ada yang berubah.
contoh:
· komit semua file yang diakhiri dengan .py:
hg commit --include "set:**.py"
· komit semua file non-biner:
hg commit --exclude "set:binary()"
· ubah komit saat ini dan atur tanggal menjadi sekarang:
hg komit --ubah --tanggal sekarang
Pilihan:
-SEBUAH, --adremove
tandai file baru/hilang sebagai ditambahkan/dihapus sebelum melakukan
--dekat-cabang
tandai kepala cabang sebagai tutup
--mengubah
ubah induk direktori kerja
-S, --rahasia
gunakan fase rahasia untuk melakukan
-e, --edit
panggil editor pada pesan komit
-Saya, --interaktif
gunakan mode interaktif
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-M,--pesan
gunakan teks sebagai pesan komit
-aku,--file log
baca pesan komit dari file
-D,--tanggal
catat tanggal yang ditentukan sebagai tanggal komit
-kamu,--pengguna
rekam pengguna yang ditentukan sebagai pembuat
-S, --subrepos
rekursi menjadi subrepositori
[+] opsi yang ditandai dapat ditentukan beberapa kali
alias: ci
config
tampilkan pengaturan konfigurasi gabungan dari semua file hgrc:
hg config [-u] [NAMA]...
Tanpa argumen, cetak nama dan nilai semua item konfigurasi.
Dengan satu argumen dari form section.name, cetak hanya nilai item konfigurasi itu.
Dengan banyak argumen, cetak nama dan nilai semua item konfigurasi dengan bagian yang cocok
nama.
Dengan --edit, mulai editor pada file konfigurasi tingkat pengguna. Dengan --global, edit
file konfigurasi seluruh sistem. Dengan --local, edit file konfigurasi tingkat repositori.
Dengan --debug, sumber (nama file dan nomor baris) dicetak untuk setiap item konfigurasi.
Lihat hg membantu config untuk informasi lebih lanjut tentang file konfigurasi.
Mengembalikan 0 jika berhasil, 1 jika NAME tidak ada.
Pilihan:
-kamu, --tidak terpercaya
tampilkan opsi konfigurasi yang tidak tepercaya
-e, --edit
edit konfigurasi pengguna
-aku, --lokal
edit konfigurasi repositori
-G, --global
edit konfigurasi global
alias: showconfig debugconfig
salinan
tandai file sebagai disalin untuk komit berikutnya:
hg salin [OPSI]... [SUMBER]... TUJUAN
Tandai tujuan sebagai memiliki salinan file sumber. Jika dest adalah direktori, salinannya dimasukkan ke dalamnya
direktori. Jika dest adalah file, sumbernya harus berupa file tunggal.
Secara default, perintah ini menyalin konten file seperti yang ada di work
direktori. Jika dipanggil dengan -A/--after, operasi direkam, tetapi tidak ada penyalinan
dilakukan.
Perintah ini berlaku dengan komit berikutnya. Untuk membatalkan salinan sebelum itu, lihat hg kembali.
Mengembalikan 0 jika berhasil, 1 jika ditemukan kesalahan.
Pilihan:
-SEBUAH, --setelah
merekam salinan yang telah terjadi
-F, --memaksa
secara paksa menyalin file terkelola yang ada
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-N, --lari-kering
jangan melakukan tindakan, cukup cetak output
[+] opsi yang ditandai dapat ditentukan beberapa kali
alias: cp
diff
repositori diff (atau file yang dipilih):
hg diff [OPSI]... ([-c REV] | [-r REV1 [-r REV2]]) [FILE]...
Tampilkan perbedaan antara revisi untuk file yang ditentukan.
Perbedaan antar file ditampilkan menggunakan format unified diff.
Note hg diff dapat menghasilkan hasil yang tidak terduga untuk penggabungan, karena ini akan menjadi default untuk membandingkan
terhadap perubahan induk pertama direktori kerja jika tidak ada revisi
ditentukan.
Ketika dua argumen revisi diberikan, maka perubahan ditampilkan di antara revisi tersebut. Jika
hanya satu revisi yang ditentukan kemudian revisi itu dibandingkan dengan direktori kerja,
dan, ketika tidak ada revisi yang ditentukan, file direktori kerja dibandingkan dengan
orang tua pertama.
Atau Anda dapat menentukan -c/--change dengan revisi untuk melihat perubahannya
changeset relatif terhadap induk pertamanya.
Tanpa opsi -a/--text, diff akan menghindari menghasilkan diff file yang dideteksi sebagai
biner. Dengan -a, diff akan tetap menghasilkan diff, mungkin dengan hasil yang tidak diinginkan.
Gunakan opsi -g/--git untuk menghasilkan diff dalam format git extended diff. Untuk lebih
informasi, baca hg membantu perbedaan.
contoh:
· membandingkan file di direktori kerja saat ini dengan induknya:
hg berbeda foo.c
· bandingkan dua versi historis direktori, dengan rename info:
hg diff --git -r 1.0:1.2 lib/
· dapatkan perubahan statistik relatif terhadap perubahan terakhir pada beberapa tanggal:
hg diff --stat -r "tanggal('2 Mei')"
· diff semua file yang baru ditambahkan yang mengandung kata kunci:
hg diff "set:added() dan grep(GNU)"
· membandingkan revisi dan induknya:
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 keberhasilan.
Pilihan:
-R,--putaran
revisi
-C,--mengubah
perubahan yang dibuat dengan revisi
-Sebuah, --teks
perlakukan semua file sebagai teks
-G, --git
gunakan format git extended diff
--nodate
hilangkan tanggal dari header diff
--tidak ada awalan
hilangkan awalan a/ dan b/ dari nama file
-P, --tampilkan-fungsi
tunjukkan fungsi apa saja yang terdapat pada setiap perubahan
--membalikkan
menghasilkan perbedaan yang membatalkan perubahan
-w, --abaikan-semua-ruang
abaikan spasi saat membandingkan garis
-B, --abaikan-ruang-perubahan
abaikan perubahan jumlah ruang putih
-B, --abaikan-baris-kosong
abaikan perubahan yang barisnya kosong semua
-kamu,--bersatu
jumlah baris konteks untuk ditampilkan
--status keluaran ringkasan perubahan gaya diffstat
--akar
menghasilkan perbedaan relatif terhadap subdirektori
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-S, --subrepos
rekursi menjadi subrepositori
[+] opsi yang ditandai dapat ditentukan beberapa kali
ekspor
buang header dan diff untuk satu atau lebih set perubahan:
hg ekspor [OPSI]... [-o OUTFILESPEC] [-r] [REV]...
Cetak header changeset dan diffs untuk satu atau beberapa revisi. Jika tidak ada revisi yang diberikan,
induk dari direktori kerja digunakan.
Informasi yang ditampilkan di header changeset adalah: penulis, tanggal, nama cabang (jika
non-default), changeset hash, parent(s) dan komentar komit.
Note hg ekspor dapat menghasilkan output diff yang tidak terduga untuk menggabungkan perubahan, karena akan
bandingkan kumpulan perubahan gabungan dengan induk pertamanya saja.
Output mungkin ke file, dalam hal ini nama file diberikan menggunakan format
rangkaian. Aturan pemformatan adalah sebagai berikut:
%%
karakter "%" literal
%H
changeset hash (40 digit heksadesimal)
%N
jumlah tambalan yang dihasilkan
%R
ubah nomor revisi
%b
nama dasar repositori pengekspor
%h
hash changeset bentuk pendek (12 digit heksadesimal)
%m
baris pertama dari pesan komit (hanya karakter alfanumerik)
%n
nomor urut nol-empuk, mulai dari 1
%r
nomor revisi changeset dengan bantalan nol
Tanpa opsi -a/--text, ekspor akan menghindari menghasilkan perbedaan file yang dideteksi sebagai
biner. Dengan -a, ekspor akan menghasilkan perbedaan, mungkin dengan hasil yang tidak diinginkan.
Gunakan opsi -g/--git untuk menghasilkan diff dalam format git extended diff. Lihat hg membantu
perbedaan for more information.
Dengan opsi --switch-parent, perbedaannya akan berlawanan dengan parent kedua. Bisa jadi
berguna untuk meninjau gabungan.
contoh:
· gunakan ekspor dan impor untuk mentransplantasikan perbaikan bug ke cabang saat ini:
hg ekspor -r 9353 | impor hg -
· ekspor semua perubahan di antara dua revisi ke file dengan informasi rename:
hg export --git -r 123:150 > changes.txt
· membagi perubahan keluar menjadi serangkaian tambalan dengan nama deskriptif:
hg export -r "keluar()" -o "%n-%m.patch"
Mengembalikan 0 pada keberhasilan.
Pilihan:
-Hai,--keluaran
hasil cetak ke file dengan nama yang diformat
--beralih-induk
berbeda dengan induk kedua
-R,--putaran
revisi untuk mengekspor
-Sebuah, --teks
perlakukan semua file sebagai teks
-G, --git
gunakan format git extended diff
--nodate
hilangkan tanggal dari header diff
[+] opsi yang ditandai dapat ditentukan beberapa kali
arsip
daftar file yang dilacak:
file hg [OPSI]... [POLA]...
Cetak file di bawah kendali Mercurial di direktori kerja atau revisi tertentu yang
nama cocok dengan pola yang diberikan (tidak termasuk file yang dihapus).
Jika tidak ada pola yang cocok, perintah ini akan mencetak nama semua file di bawah
Kontrol Mercurial di direktori kerja.
contoh:
· daftar semua file di bawah direktori saat ini:
file hg.
· menunjukkan ukuran dan bendera untuk revisi saat ini:
file hg -vr .
· daftar semua file bernama README:
hg file -I "**/README"
· daftar semua file biner:
hg file "set: biner ()"
· temukan file yang berisi ekspresi reguler:
hg file "set:grep('bob')"
· cari konten file yang dilacak dengan xargs dan grep:
file hg -0 | xargs -0 grep foo
Lihat hg membantu pola dan hg membantu kumpulan file untuk informasi lebih lanjut tentang menentukan file
pola.
Mengembalikan 0 jika kecocokan ditemukan, 1 sebaliknya.
Pilihan:
-R,--putaran
cari repositori seperti di REV
-0, --cetak0
akhiri nama file dengan NUL, untuk digunakan dengan xargs
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-T,--templat
tampilan dengan template (EKSPERIMENTAL)
-S, --subrepos
rekursi menjadi subrepositori
[+] opsi yang ditandai dapat ditentukan beberapa kali
lupa
lupakan file yang ditentukan pada komit berikutnya:
hg lupa [OPSI]... FILE...
Tandai file yang ditentukan sehingga tidak lagi dilacak setelah komit berikutnya.
Ini hanya menghapus file dari cabang saat ini, bukan dari seluruh riwayat proyek, dan
itu tidak menghapusnya dari direktori kerja.
Untuk menghapus file dari direktori kerja, lihat hg menghapus.
Untuk membatalkan lupa sebelum komit berikutnya, lihat hg menambahkan.
contoh:
· lupakan file biner yang baru ditambahkan:
hg lupa "set:added() dan binary()"
· lupakan file yang akan dikecualikan oleh .hgignore:
hg lupa "set:hgignore()"
Mengembalikan 0 pada keberhasilan.
Pilihan:
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
korupsi
salin perubahan dari cabang lain ke cabang saat ini:
hg graft [OPSI]... [-r REV]... REV...
Perintah ini menggunakan logika penggabungan Mercurial untuk menyalin perubahan individual dari cabang lain
tanpa menggabungkan cabang dalam grafik sejarah. Ini kadang-kadang dikenal sebagai 'backporting' atau
'petik ceri'. Secara default, graft akan menyalin pengguna, tanggal, dan deskripsi dari sumbernya
perubahan
Perubahan yang merupakan nenek moyang dari revisi saat ini, yang telah dicangkokkan, atau
yang menggabungkan akan dilewati.
Jika --log ditentukan, pesan log akan memiliki komentar yang ditambahkan dalam bentuk:
(dicangkok dari CHANGESETHASH)
Jika --force ditentukan, revisi akan dicangkokkan meskipun sudah menjadi nenek moyang
atau telah dicangkokkan ke tempat tujuan. Ini berguna ketika revisi telah terjadi
telah mundur.
Jika penggabungan cangkok mengakibatkan konflik, maka proses pencangkokan terganggu sehingga
penggabungan saat ini dapat diselesaikan secara manual. Setelah semua konflik diatasi, korupsi
proses dapat dilanjutkan dengan opsi -c/--continue.
Catatan Opsi -c/--continue tidak menerapkan kembali opsi sebelumnya, kecuali untuk --force.
contoh:
· salin satu perubahan ke cabang stabil dan edit deskripsinya:
pembaruan hg stabil
hg korupsi --edit 9393
· mencangkokkan serangkaian perubahan dengan satu pengecualian, memperbarui tanggal:
hg graft -D "2085::2093 dan bukan 2091"
· melanjutkan pencangkokan setelah menyelesaikan konflik:
hg cangkok -c
· tunjukkan sumber perubahan yang dicangkokkan:
hg log --debug -r .
· tampilkan revisi yang diurutkan berdasarkan tanggal:
hg log -r 'sort(all(), date)'
Lihat hg membantu revisi dan hg membantu revset untuk lebih lanjut tentang menentukan revisi.
Mengembalikan 0 pada penyelesaian yang berhasil.
Pilihan:
-R,--putaran
revisi untuk cangkok
-C, --melanjutkan
lanjutkan cangkok yang terputus
-e, --edit
panggil editor pada pesan komit
--catatan tambahkan info cangkok ke log pesan
-F, --memaksa
cangkok paksa
-D, --tanggal sekarang
catat tanggal saat ini sebagai tanggal komit
-kamu, --pengguna saat ini
rekam pengguna saat ini sebagai pembuat
-D,--tanggal
catat tanggal yang ditentukan sebagai tanggal komit
-kamu,--pengguna
rekam pengguna yang ditentukan sebagai pembuat
-T,--alat
tentukan alat gabungan
-N, --lari-kering
jangan melakukan tindakan, cukup cetak output
[+] opsi yang ditandai dapat ditentukan beberapa kali
grep
mencari pola dalam file dan revisi yang ditentukan:
hg grep [OPTION]... POLA [FILE]...
Cari revisi file untuk ekspresi reguler.
Perintah ini berperilaku berbeda dari grep Unix. Itu hanya menerima Python/Perl regexps. Dia
mencari riwayat repositori, bukan direktori kerja. Itu selalu mencetak revisi
nomor di mana kecocokan muncul.
Secara default, grep hanya mencetak output untuk revisi pertama dari file yang ditemukan a
cocok. Untuk membuatnya mencetak setiap revisi yang berisi perubahan status kecocokan ("-" untuk a
cocok yang menjadi tidak cocok, atau "+" untuk tidak cocok yang menjadi cocok), gunakan
--semua bendera.
Mengembalikan 0 jika kecocokan ditemukan, 1 sebaliknya.
Pilihan:
-0, --cetak0
akhiri bidang dengan NUL
--semua cetak semua revisi yang cocok
-Sebuah, --teks
perlakukan semua file sebagai teks
-F, --mengikuti
ikuti riwayat perubahan, atau riwayat file di seluruh salinan dan ganti nama
-Saya, --abaikan-kasus
abaikan kasus saat mencocokkan
-aku, --file-dengan-kecocokan
cetak hanya nama file dan revisi yang cocok
-N, --nomor-baris
cetak nomor baris yang cocok
-R,--putaran
hanya file pencarian yang diubah dalam rentang revisi
-kamu, --pengguna
daftar penulis (panjang dengan -v)
-D, --tanggal
cantumkan tanggalnya (pendek dengan -q)
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
kepala
menunjukkan kepala cabang:
hg kepala [-ct] [-r MULAIREV] [REV]...
Tanpa argumen, tampilkan semua kepala cabang yang terbuka di repositori. Kepala cabang adalah
changeset yang tidak memiliki keturunan pada cabang yang sama. Mereka adalah tempat pengembangan
umumnya terjadi dan merupakan target biasa untuk operasi pembaruan dan penggabungan.
Jika satu atau lebih REV diberikan, hanya buka kepala cabang di cabang yang terkait dengan
perubahan yang ditentukan ditampilkan. Ini berarti Anda dapat menggunakan hg kepala . untuk melihat langsung
cabang yang saat ini check-out.
Jika -c/--closed ditentukan, tunjukkan juga kepala cabang yang ditandai tertutup (lihat hg melakukan
--dekat-cabang).
Jika STARTREV ditentukan, hanya kepala yang merupakan keturunan STARTREV yang akan
ditampilkan.
Jika -t/--topo ditentukan, mekanika cabang bernama akan diabaikan dan hanya topologi
kepala (perubahan tanpa anak) akan ditampilkan.
Mengembalikan 0 jika kepala yang cocok ditemukan, 1 jika tidak.
Pilihan:
-R,--putaran
tampilkan hanya kepala yang merupakan keturunan STARTREV
-T, --topo
tampilkan kepala topologi saja
-Sebuah, --aktif
tampilkan hanya kepala cabang yang aktif (DIHAPUS)
-C, --tertutup
tunjukkan kepala cabang normal dan tertutup
--gaya
tampilkan menggunakan file peta template (DIHAPUS)
-T,--templat
tampilan dengan template
membantu
tampilkan bantuan untuk topik tertentu atau ikhtisar bantuan:
hg bantuan [-ecks] [TOPIK]
Tanpa argumen, cetak daftar perintah dengan pesan bantuan singkat.
Diberikan topik, ekstensi, atau nama perintah, cetak bantuan untuk topik itu.
Mengembalikan 0 jika berhasil.
Pilihan:
-e, --perpanjangan
hanya tampilkan bantuan untuk ekstensi
-C, --memerintah
hanya tampilkan bantuan untuk perintah
-k, --kata kunci
tampilkan topik yang cocok dengan kata kunci
-S,--sistem
tampilkan bantuan untuk platform tertentu
[+] opsi yang ditandai dapat ditentukan beberapa kali
mengenali
mengidentifikasi direktori kerja atau revisi yang ditentukan:
hg mengidentifikasi [-nibtB] [-r REV] [SUMBER]
Cetak ringkasan yang mengidentifikasi status repositori di REV menggunakan satu atau dua hash induk
pengenal, diikuti oleh "+" jika direktori kerja memiliki perubahan yang tidak dikomit, the
nama cabang (jika tidak default), daftar tag, dan daftar bookmark.
Ketika REV tidak diberikan, cetak ringkasan status repositori saat ini.
Menentukan jalur ke root repositori atau bundel Mercurial akan menyebabkan pencarian beroperasi
repositori/bundel itu.
contoh:
· menghasilkan pengidentifikasi build untuk direktori kerja:
hg id --id > build-id.dat
· temukan revisi yang sesuai dengan tag:
hg id -n -r 1.3
· periksa revisi terbaru dari repositori jarak jauh:
hg id -r tip http://selenic.com/hg/
Lihat hg mencatat untuk menghasilkan lebih banyak informasi tentang revisi tertentu, termasuk hash lengkap
pengenal.
Mengembalikan 0 jika berhasil.
Pilihan:
-R,--putaran
mengidentifikasi revisi yang ditentukan
-N, --angka
tunjukkan nomor revisi lokal
-Saya, --Indo
tampilkan id revisi global
-B, --cabang
menunjukkan cabang
-T, --tag
tunjukkan tag
-B, --bookmark
tampilkan bookmark
-e,--ssh
tentukan perintah ssh untuk digunakan
--jarak jauh
tentukan perintah hg untuk dijalankan di sisi jarak jauh
--merasa tidak aman
jangan verifikasi sertifikat server (abaikan konfigurasi web.cacerts)
alias: id
mengimpor
impor satu set tambalan yang dipesan:
hg impor [OPSI]... PATCH...
Impor daftar tambalan dan komit satu per satu (kecuali --no-commit ditentukan).
Untuk membaca patch dari input standar, gunakan "-" sebagai nama patch. Jika URL ditentukan,
patch akan diunduh dari sana.
Impor terlebih dahulu menerapkan perubahan ke direktori kerja (kecuali --bypass ditentukan),
impor akan dibatalkan jika ada perubahan yang belum terselesaikan.
Gunakan --bypass untuk menerapkan dan melakukan tambalan langsung ke repositori, tanpa memengaruhi
direktori kerja. Tanpa --exact, tambalan akan diterapkan di atas pekerjaan
revisi induk direktori.
Anda dapat mengimpor patch langsung dari pesan email. Bahkan tambalan sebagai lampiran berfungsi (untuk
gunakan bagian body, harus bertipe text/plain atau text/x-patch). Dari dan Subjek header
dari pesan email digunakan sebagai komit default dan pesan komit. Semua teks/tubuh biasa
bagian sebelum diff pertama ditambahkan ke pesan komit.
Jika tambalan yang diimpor dihasilkan oleh hg ekspor, pengguna dan deskripsi dari patch override
nilai dari header dan isi pesan. Nilai yang diberikan pada baris perintah dengan -m/--message dan
-u/--user menimpa ini.
Jika --exact ditentukan, import akan mengatur direktori kerja ke induk dari setiap tambalan
sebelum menerapkannya, dan akan dibatalkan jika set perubahan yang dihasilkan memiliki ID yang berbeda dari
satu direkam di tambalan. Ini mungkin terjadi karena masalah set karakter atau lainnya
kekurangan dalam format teks patch.
Gunakan --partial untuk memastikan set perubahan akan dibuat dari tambalan meskipun beberapa bingkisan gagal
untuk melamar. Cowok yang gagal melamar akan ditulis ke file .rej. konflik
kemudian dapat diselesaikan dengan tangan sebelumnya hg melakukan --mengubah dijalankan untuk memperbarui yang dibuat
perubahan Bendera ini ada untuk memungkinkan orang mengimpor tambalan yang berlaku sebagian tanpa
kehilangan metadata terkait (penulis, tanggal, deskripsi, ...).
Catatan Bila tidak ada bongkahan yang diterapkan dengan bersih, hg mengimpor --sebagian akan membuat changeset kosong,
hanya mengimpor metadata tambalan.
Dengan -s/--similarity, hg akan mencoba menemukan rename dan copy di patch di
sama seperti hg hapus.
Dimungkinkan untuk menggunakan program tambalan eksternal untuk melakukan tambalan dengan mengatur ui.patch
opsi konfigurasi. Untuk alat internal default, fuzz juga dapat dikonfigurasi melalui
patch.fuzz. Lihat hg membantu config untuk informasi lebih lanjut tentang file konfigurasi dan cara
gunakan opsi ini.
Lihat hg membantu tanggal untuk daftar format yang valid untuk -d/--date.
contoh:
· mengimpor tambalan tradisional dari situs web dan mendeteksi penggantian nama:
hg impor -s 80 http://example.com/bugfix.patch
· impor set perubahan dari server hgweb:
impor hg http://www.selenic.com/hg/rev/5ca8c111e9aa
· impor semua tambalan dalam mbox bergaya Unix:
hg impor tambalan masuk.mbox
· mencoba mengembalikan set perubahan yang diekspor (tidak selalu memungkinkan):
hg import --exact usulan-fix.patch
· gunakan alat eksternal untuk menerapkan tambalan yang terlalu kabur untuk alat internal default.
hg import --config ui.patch="patch --merge" fuzzy.patch
· ubah fuzzing default dari 2 menjadi kurang ketat 7
hg impor --config ui.fuzz=7 fuzz.patch
Mengembalikan 0 pada keberhasilan, 1 pada keberhasilan parsial (lihat --parsial).
Pilihan:
-P,--mengupas
opsi strip direktori untuk patch. Ini memiliki arti yang sama dengan yang sesuai
opsi tambalan (default: 1)
-B,--basis
jalur dasar (DIHAPUS)
-e, --edit
panggil editor pada pesan komit
-F, --memaksa
lewati pemeriksaan untuk perubahan yang belum dikomit (DIHAPUS)
--tidak ada komitmen
jangan komit, cukup perbarui direktori kerja
--jalan pintas
terapkan tambalan tanpa menyentuh direktori kerja
--sebagian
berkomitmen bahkan jika beberapa orang gagal
--akurat
terapkan tambalan ke node dari mana itu dihasilkan
--awalan
terapkan tambalan ke subdirektori
--impor-cabang
gunakan informasi cabang apa pun di tambalan (tersirat oleh --exact)
-M,--pesan
gunakan teks sebagai pesan komit
-aku,--file log
baca pesan komit dari file
-D,--tanggal
catat tanggal yang ditentukan sebagai tanggal komit
-kamu,--pengguna
rekam pengguna yang ditentukan sebagai pembuat
-S,--kesamaan
tebak file yang diganti namanya berdasarkan kesamaan (0<=s<=100)
alias: tambalan
masuk
tampilkan perubahan baru yang ditemukan di sumber:
hg masuk [-p] [-n] [-M] [-f] [-r REV]... [--bundel NAMA FILE] [SUMBER]
Tampilkan kumpulan perubahan baru yang ditemukan di jalur/URL yang ditentukan atau lokasi tarikan default. Ini
adalah set perubahan yang akan ditarik jika ditarik pada saat Anda mengeluarkan ini
perintah.
Lihat tarik untuk detail format sumber yang valid.
Dengan -B/--bookmarks, hasil perbandingan bookmark antara lokal dan jarak jauh
repositori ditampilkan. Dengan -v/--verbose, status juga ditampilkan untuk setiap bookmark
seperti di bawah ini:
BM1 01234567890a ditambahkan
BM2 1234567890ab lanjutan
BM3 234567890abc menyimpang
BM4 34567890abcd berubah
Tindakan yang diambil secara lokal saat menarik bergantung pada status setiap bookmark:
menambahkan
tarik akan membuatnya
maju
tarik akan memperbaruinya
menyimpang
tarik akan membuat bookmark yang berbeda
berubah
hasilnya tergantung pada perubahan jarak jauh
Dari sudut pandang perilaku menarik, bookmark hanya ada di remote
repositori diperlakukan sebagai menambahkan, bahkan jika itu sebenarnya dihapus secara lokal.
Untuk repositori jarak jauh, menggunakan --bundle menghindari mengunduh set perubahan dua kali jika
masuk diikuti oleh tarikan.
contoh:
· tampilkan perubahan yang masuk dengan tambalan dan deskripsi lengkap:
hg masuk -vp
· tampilkan perubahan yang masuk tidak termasuk penggabungan, simpan bundel:
hg di -vpM --bundel masuk.hg
hg tarik masuk.hg
· daftarkan secara singkat perubahan di dalam bundel:
hg di perubahan.hg -T "{desc|baris pertama}\n"
Mengembalikan 0 jika ada perubahan yang masuk, 1 sebaliknya.
Pilihan:
-F, --memaksa
berjalan bahkan jika repositori jarak jauh tidak terkait
-N, --pertama Terbaru
tampilkan rekaman terbaru terlebih dahulu
--bundel
file untuk menyimpan bundel ke dalam
-R,--putaran
set perubahan jarak jauh yang dimaksudkan untuk ditambahkan
-B, --bookmark
bandingkan bookmark
-B,--cabang
cabang tertentu yang ingin Anda tarik
-P, --tambalan
tampilkan tambalan
-G, --git
gunakan format git extended diff
-aku,--membatasi
batasi jumlah perubahan yang ditampilkan
-M, --tanpa penggabungan
jangan tampilkan gabungan
--status keluaran ringkasan perubahan gaya diffstat
-G, --grafik
tampilkan revisi DAG
--gaya
tampilkan menggunakan file peta template (DIHAPUS)
-T,--templat
tampilan dengan template
-e,--ssh
tentukan perintah ssh untuk digunakan
--jarak jauh
tentukan perintah hg untuk dijalankan di sisi jarak jauh
--merasa tidak aman
jangan verifikasi sertifikat server (abaikan konfigurasi web.cacerts)
-S, --subrepos
rekursi menjadi subrepositori
[+] opsi yang ditandai dapat ditentukan beberapa kali
alias: di
init
buat repositori baru di direktori yang diberikan:
hg init [-e CMD] [--remotecmd CMD] [DEST]
Inisialisasi repositori baru di direktori yang diberikan. Jika direktori yang diberikan tidak ada,
itu akan dibuat.
Jika tidak ada direktori yang diberikan, direktori saat ini digunakan.
Hal ini dimungkinkan untuk menentukan ssh: // URL sebagai tujuan. Lihat hg membantu url keahlian yang lebih
informasi.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-e,--ssh
tentukan perintah ssh untuk digunakan
--jarak jauh
tentukan perintah hg untuk dijalankan di sisi jarak jauh
--merasa tidak aman
jangan verifikasi sertifikat server (abaikan konfigurasi web.cacerts)
menemukan
cari file yang cocok dengan pola tertentu (DIHAPUS):
hg cari [OPSI]... [POLA]...
Cetak file di bawah kendali Mercurial di direktori kerja yang namanya cocok dengan yang diberikan
pola.
Secara default, perintah ini mencari semua direktori di direktori kerja. Untuk mencari saja
direktori saat ini dan subdirektorinya, gunakan "--include .".
Jika tidak ada pola yang cocok, perintah ini akan mencetak nama semua file di bawah
Kontrol Mercurial di direktori kerja.
Jika Anda ingin memasukkan output dari perintah ini ke dalam perintah "xargs", gunakan opsi -0
untuk perintah ini dan "xargs". Ini akan menghindari masalah "xargs" memperlakukan single
nama file yang berisi spasi sebagai beberapa nama file.
Lihat hg membantu arsip untuk perintah yang lebih serbaguna.
Mengembalikan 0 jika kecocokan ditemukan, 1 sebaliknya.
Pilihan:
-R,--putaran
cari repositori seperti di REV
-0, --cetak0
akhiri nama file dengan NUL, untuk digunakan dengan xargs
-F, --jalur penuh
cetak jalur lengkap dari root sistem file
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
mencatat
tampilkan riwayat revisi seluruh repositori atau file:
hg log [OPSI]... [FILE]
Cetak riwayat revisi dari file yang ditentukan atau seluruh proyek.
Jika tidak ada rentang revisi yang ditentukan, defaultnya adalah tip: 0 kecuali --follow diatur, di mana
kasus induk direktori kerja digunakan sebagai revisi awal.
Riwayat file ditampilkan tanpa mengubah nama atau menyalin riwayat file. Gunakan -f/--ikuti
dengan nama file untuk mengikuti riwayat di seluruh penggantian nama dan salinan. --ikuti tanpa nama file
hanya akan menampilkan ancestor atau keturunan dari revisi awal.
Secara default perintah ini mencetak nomor revisi dan id changeset, tag, non-sepele
orang tua, pengguna, tanggal dan waktu, dan ringkasan untuk setiap komit. Saat -v/--verbose beralih
digunakan, daftar file yang diubah dan pesan komit penuh ditampilkan.
Dengan --graph revisi ditampilkan sebagai DAG seni ASCII dengan perubahan terbaru di
atas. 'o' adalah changeset, '@' adalah induk direktori yang berfungsi, 'x' sudah usang, dan '+'
mewakili garpu di mana set perubahan dari baris di bawah ini adalah induk dari penggabungan 'o' pada
baris yang sama.
Note hg mencatat --tambalan dapat menghasilkan output diff yang tidak terduga untuk menggabungkan perubahan, karena akan
hanya membandingkan kumpulan perubahan gabungan dengan induk pertamanya. Juga, hanya file
berbeda dari KEDUA orang tua akan muncul di file :.
Catatan Untuk alasan kinerja, hg mencatat FILE dapat menghilangkan duplikat perubahan yang dibuat di cabang
dan tidak akan menampilkan penghapusan atau perubahan mode. Untuk melihat semua perubahan tersebut, gunakan
--menghapus saklar.
Beberapa contoh:
· perubahan dengan deskripsi lengkap dan daftar file:
log hg -v
· perubahan leluhur ke direktori kerja:
hg log -f
· 10 komit terakhir di cabang saat ini:
hg log -l 10 -b .
· perubahan yang menunjukkan semua modifikasi file, termasuk penghapusan:
hg log --dihapus file.c
· semua set perubahan yang menyentuh direktori, dengan perbedaan, tidak termasuk penggabungan:
log hg -Mp lib/
· semua nomor revisi yang cocok dengan kata kunci:
hg log -k bug --template "{rev}\n"
· pengidentifikasi hash lengkap dari induk direktori kerja:
hg log -r . --template "{simpul}\n"
· daftar template log yang tersedia:
hg log -T daftar
· periksa apakah set perubahan yang diberikan disertakan dalam rilis yang diberi tag:
hg log -r "a21ccf dan ancestor(1.9)"
· temukan semua perubahan oleh beberapa pengguna dalam rentang tanggal:
hg log -k alice -d "mei 2008 hingga Juli 2008"
· ringkasan semua perubahan setelah tag terakhir:
hg log -r "terakhir(tagged())::" --template "{desc|firstline}\n"
Lihat hg membantu tanggal untuk daftar format yang valid untuk -d/--date.
Lihat hg membantu revisi dan hg membantu revset untuk lebih lanjut tentang menentukan dan memesan
revisi.
Lihat hg membantu template untuk lebih lanjut tentang gaya pra-paket dan menentukan template khusus.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-F, --mengikuti
ikuti riwayat perubahan, atau riwayat file di seluruh salinan dan ganti nama
--ikuti-pertama
hanya ikuti induk pertama dari kumpulan perubahan gabungan (DIHAPUS)
-D,--tanggal
tampilkan revisi yang cocok dengan spesifikasi tanggal
-C, --salinan
tampilkan file yang disalin
-k,--kata kunci
lakukan pencarian case-insensitive untuk teks tertentu
-R,--putaran
tunjukkan revisi atau revset yang ditentukan
--DIHAPUS
termasuk revisi di mana file dihapus
-M, --hanya-gabungan
hanya tampilkan gabungan (DIHAPUS)
-kamu,--pengguna
revisi yang dilakukan oleh pengguna
--hanya-cabang
tampilkan hanya perubahan di dalam cabang bernama yang diberikan (DIHAPUS)
-B,--cabang
tampilkan perubahan dalam cabang bernama yang diberikan
-P,--memangkas
jangan tampilkan revisi atau leluhurnya
-P, --tambalan
tampilkan tambalan
-G, --git
gunakan format git extended diff
-aku,--membatasi
batasi jumlah perubahan yang ditampilkan
-M, --tanpa penggabungan
jangan tampilkan gabungan
--status keluaran ringkasan perubahan gaya diffstat
-G, --grafik
tampilkan revisi DAG
--gaya
tampilkan menggunakan file peta template (DIHAPUS)
-T,--templat
tampilan dengan template
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
alias: sejarah
nyata
keluaran revisi saat ini atau yang diberikan dari manifes proyek:
hg manifes [-r REV]
Cetak daftar file yang dikontrol versi untuk revisi yang diberikan. Jika tidak ada revisi yang diberikan,
induk pertama dari direktori kerja digunakan, atau revisi nol jika tidak ada revisi
memeriksa.
Dengan -v, cetak izin file, symlink, dan bit yang dapat dieksekusi. Dengan --debug, cetak file
hash revisi.
Jika opsi --all ditentukan, daftar semua file dari semua revisi akan dicetak. Ini
termasuk file yang dihapus dan diganti namanya.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-R,--putaran
revisi untuk ditampilkan
--semua daftar file dari semua revisi
-T,--templat
tampilan dengan template (EKSPERIMENTAL)
bergabung
gabungkan revisi lain ke direktori kerja:
hg menggabungkan [-P] [[-r] REV]
Direktori kerja saat ini diperbarui dengan semua perubahan yang dibuat dalam revisi yang diminta
sejak revisi pendahulu umum terakhir.
File yang diubah antara salah satu induk ditandai sebagai diubah untuk komit berikutnya dan a
komit harus dilakukan sebelum pembaruan lebih lanjut ke repositori diizinkan. NS
komit berikutnya akan memiliki dua orang tua.
--alat dapat digunakan untuk menentukan alat gabungan yang digunakan untuk penggabungan file. Ini menimpa
Variabel lingkungan HGMERGE dan file konfigurasi Anda. Lihat hg membantu menggabungkan-alat untuk
Pilihan.
Jika tidak ada revisi yang ditentukan, induk direktori kerja adalah revisi kepala, dan
cabang saat ini berisi tepat satu kepala lain, kepala lainnya digabungkan dengan secara default.
Jika tidak, revisi eksplisit untuk digabungkan harus disediakan.
Lihat hg membantu menyelesaikan untuk informasi tentang penanganan konflik file.
Untuk membatalkan penggabungan yang belum dikomit, gunakan hg memperbarui --membersihkan . yang akan memeriksa salinan bersih dari
induk gabungan asli, kehilangan semua perubahan.
Mengembalikan 0 jika berhasil, 1 jika ada file yang belum terselesaikan.
Pilihan:
-F, --memaksa
memaksa penggabungan termasuk perubahan yang luar biasa (DIHAPUS)
-R,--putaran
revisi untuk menggabungkan
-P, --pratinjau
tinjau revisi untuk digabungkan (tidak ada penggabungan yang dilakukan)
-T,--alat
tentukan alat gabungan
ramah
tampilkan perubahan yang tidak ditemukan di tujuan:
hg keluar [-M] [-p] [-n] [-f] [-r REV]... [DEST]
Tampilkan perubahan yang tidak ditemukan di repositori tujuan yang ditentukan atau push default
lokasi. Ini adalah set perubahan yang akan didorong jika dorongan diminta.
Lihat tarik untuk detail format tujuan yang valid.
Dengan -B/--bookmarks, hasil perbandingan bookmark antara lokal dan jarak jauh
repositori ditampilkan. Dengan -v/--verbose, status juga ditampilkan untuk setiap bookmark
seperti di bawah ini:
BM1 01234567890a ditambahkan
BM2 dihapus
BM3 234567890abc lanjutan
BM4 34567890abcd menyimpang
BM5 4567890abcde berubah
Tindakan yang diambil saat mendorong tergantung pada status setiap bookmark:
menambahkan
dorong dengan -B akan membuatnya
dihapus
dorong dengan -B akan menghapusnya
maju
push akan memperbaruinya
menyimpang
dorong dengan -B akan memperbaruinya
berubah
dorong dengan -B akan memperbaruinya
Dari sudut pandang perilaku mendorong, bookmark hanya ada di remote
repositori diperlakukan sebagai dihapus, meskipun sebenarnya ditambahkan dari jarak jauh.
Mengembalikan 0 jika ada perubahan keluar, 1 sebaliknya.
Pilihan:
-F, --memaksa
berjalan bahkan ketika tujuannya tidak terkait
-R,--putaran
set perubahan yang dimaksudkan untuk dimasukkan dalam tujuan
-N, --pertama Terbaru
tampilkan rekaman terbaru terlebih dahulu
-B, --bookmark
bandingkan bookmark
-B,--cabang
cabang tertentu yang ingin Anda dorong
-P, --tambalan
tampilkan tambalan
-G, --git
gunakan format git extended diff
-aku,--membatasi
batasi jumlah perubahan yang ditampilkan
-M, --tanpa penggabungan
jangan tampilkan gabungan
--status keluaran ringkasan perubahan gaya diffstat
-G, --grafik
tampilkan revisi DAG
--gaya
tampilkan menggunakan file peta template (DIHAPUS)
-T,--templat
tampilan dengan template
-e,--ssh
tentukan perintah ssh untuk digunakan
--jarak jauh
tentukan perintah hg untuk dijalankan di sisi jarak jauh
--merasa tidak aman
jangan verifikasi sertifikat server (abaikan konfigurasi web.cacerts)
-S, --subrepos
rekursi menjadi subrepositori
[+] opsi yang ditandai dapat ditentukan beberapa kali
alias: keluar
orangtua
tunjukkan orang tua dari direktori kerja atau revisi (DIHAPUS):
hg orang tua [-r REV] [FILE]
Cetak revisi induk direktori kerja. Jika revisi diberikan melalui -r/--rev,
induk dari revisi itu akan dicetak. Jika argumen file diberikan, revisi di
file mana yang terakhir diubah (sebelum revisi direktori kerja atau argumen untuk
--rev jika diberikan) dicetak.
Perintah ini setara dengan:
hg log -r "p1()+p2()" atau
hg log -r "p1(REV)+p2(REV)" atau
hg log -r "max(::p1() and file(FILE))+max(::p2() and file(FILE))" atau
hg log -r "max(::p1(REV) dan file(FILE))+max(::p2(REV) dan file(FILE))"
Lihat hg ringkasan dan hg membantu revset untuk informasi terkait.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-R,--putaran
tunjukkan orang tua dari revisi yang ditentukan
--gaya
tampilkan menggunakan file peta template (DIHAPUS)
-T,--templat
tampilan dengan template
jalan
tampilkan alias untuk repositori jarak jauh:
jalur hg [NAME]
Tampilkan definisi nama jalur simbolis NAME. Jika tidak ada nama yang diberikan, tunjukkan definisi dari semua
nama yang tersedia.
Opsi -q/--quiet menekan semua keluaran saat mencari NAMA dan hanya menampilkan jalur
nama saat mendaftar semua definisi.
Nama jalur ditentukan di bagian [jalur] dari file konfigurasi Anda dan di
/etc/mercurial/hgrc.conf. Jika dijalankan di dalam repositori, .hg/hgrc digunakan juga.
Nama-nama jalan kegagalan dan default-push memiliki arti khusus. Saat melakukan dorongan atau
operasi tarik, mereka digunakan sebagai mundur jika tidak ada lokasi yang ditentukan pada
garis komando. Kapan default-push diatur, itu akan digunakan untuk push dan kegagalan akan digunakan
untuk menarik; sebaliknya kegagalan digunakan sebagai cadangan untuk keduanya. Saat mengkloning repositori,
sumber klon ditulis sebagai kegagalan in .hg/hgrc.
Note kegagalan dan default-push berlaku untuk semua yang masuk (mis hg masuk) dan keluar
(misalnya hg ramah, hg e-mail dan hg bundel) operasi.
Lihat hg membantu url for more information.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-T,--templat
tampilan dengan template (EKSPERIMENTAL)
tahap
atur atau tampilkan nama fase saat ini:
fase hg [-p|-d|-s] [-f] [-r] [REV...]
Tanpa argumen, tunjukkan nama fase dari revisi saat ini.
Dengan salah satu dari -p/--public, -d/--draft atau -s/--secret, ubah nilai fase dari
revisi yang ditentukan.
Kecuali -f/--force ditentukan, hg tahap tidak akan memindahkan perubahan dari fase yang lebih rendah ke
fase yang lebih tinggi. Fase dipesan sebagai berikut:
publik < draft < rahasia
Mengembalikan 0 jika berhasil, 1 jika beberapa fase tidak dapat diubah.
(Untuk informasi lebih lanjut tentang konsep fase, lihat hg membantu fase.)
Pilihan:
-P, --publik
setel fase perubahan ke publik
-D, --minuman
setel fase changeset ke draft
-S, --rahasia
setel fase perubahan menjadi rahasia
-F, --memaksa
memungkinkan untuk memindahkan batas ke belakang
-R,--putaran
target revisi
[+] opsi yang ditandai dapat ditentukan beberapa kali
menarik
tarik perubahan dari sumber yang ditentukan:
hg tarik [-u] [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [SUMBER]
Tarik perubahan dari repositori jarak jauh ke repositori lokal.
Ini menemukan semua perubahan dari repositori di jalur atau URL yang ditentukan dan menambahkannya ke a
repositori lokal (yang sekarang kecuali -R ditentukan). Secara default, ini tidak
perbarui salinan proyek di direktori kerja.
penggunaan hg masuk jika Anda ingin melihat apa yang akan ditambahkan dengan tarikan pada saat Anda
mengeluarkan perintah ini. Jika Anda kemudian memutuskan untuk menambahkan perubahan itu ke repositori, Anda harus
menggunakan hg menarik -r X dimana X adalah perubahan terakhir yang terdaftar oleh hg masuk.
Jika SOURCE dihilangkan, jalur 'default' akan digunakan. Lihat hg membantu url keahlian yang lebih
informasi.
Mengembalikan 0 jika berhasil, 1 jika pembaruan memiliki file yang belum terselesaikan.
Pilihan:
-kamu, --memperbarui
perbarui ke kepala cabang baru jika set perubahan ditarik
-F, --memaksa
berjalan bahkan ketika repositori jarak jauh tidak terkait
-R,--putaran
set perubahan jarak jauh yang dimaksudkan untuk ditambahkan
-B,--penanda buku
bookmark untuk menarik
-B,--cabang
cabang tertentu yang ingin Anda tarik
-e,--ssh
tentukan perintah ssh untuk digunakan
--jarak jauh
tentukan perintah hg untuk dijalankan di sisi jarak jauh
--merasa tidak aman
jangan verifikasi sertifikat server (abaikan konfigurasi web.cacerts)
[+] opsi yang ditandai dapat ditentukan beberapa kali
mendorong
Dorong perubahan ke tujuan yang ditentukan:
hg tekan [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [DEST]
Dorong perubahan set dari repositori lokal ke tujuan yang ditentukan.
Operasi ini simetris untuk menarik: identik dengan tarikan di tujuan
repositori dari yang sekarang.
Secara default, push tidak akan mengizinkan pembuatan kepala baru di tujuan, karena banyak
kepala akan membuat tidak jelas kepala mana yang digunakan. Dalam situasi ini, disarankan untuk
tarik dan gabungkan sebelum mendorong.
Gunakan --new-branch jika Anda ingin mengizinkan Push untuk membuat cabang bernama baru yang bukan
hadir di tempat tujuan. Ini memungkinkan Anda untuk hanya membuat cabang baru tanpa memaksa
perubahan lainnya.
Catatan Perhatian ekstra harus dilakukan dengan opsi -f/--force, yang akan mendorong semua yang baru
mengepalai semua cabang, tindakan yang hampir selalu menyebabkan kebingungan bagi
kolaborator.
Jika -r/--rev digunakan, revisi yang ditentukan dan semua pendahulunya akan didorong ke
gudang jarak jauh.
Jika -B/--bookmark digunakan, revisi bookmark yang ditentukan, leluhurnya, dan
bookmark akan didorong ke repositori jarak jauh.
Silakan lihat hg membantu url untuk detail penting tentang ssh: // URL. Jika TUJUAN adalah
dihilangkan, jalur default akan digunakan.
Mengembalikan 0 jika push berhasil, 1 jika tidak ada yang didorong.
Pilihan:
-F, --memaksa
dorongan paksa
-R,--putaran
set perubahan yang dimaksudkan untuk dimasukkan dalam tujuan
-B,--penanda buku
bookmark untuk mendorong
-B,--cabang
cabang tertentu yang ingin Anda dorong
--cabang baru
izinkan mendorong cabang baru
-e,--ssh
tentukan perintah ssh untuk digunakan
--jarak jauh
tentukan perintah hg untuk dijalankan di sisi jarak jauh
--merasa tidak aman
jangan verifikasi sertifikat server (abaikan konfigurasi web.cacerts)
[+] opsi yang ditandai dapat ditentukan beberapa kali
memulihkan
mengembalikan transaksi yang terputus:
pulih kembali
Pulihkan dari komit atau tarikan yang terputus.
Perintah ini mencoba memperbaiki status repositori setelah operasi terputus. Itu harus
hanya diperlukan ketika Mercurial menyarankannya.
Mengembalikan 0 jika berhasil, 1 jika tidak ada yang dipulihkan atau verifikasi gagal.
menghapus
hapus file yang ditentukan pada komit berikutnya:
hg hapus [OPTION]... FILE...
Jadwalkan file yang ditunjukkan untuk dihapus dari cabang saat ini.
Perintah ini menjadwalkan file yang akan dihapus pada komit berikutnya. Untuk membatalkan penghapusan
sebelum itu, lihat hg kembali. Untuk membatalkan file yang ditambahkan, lihat hg lupa.
-A/--after hanya dapat digunakan untuk menghapus file yang telah dihapus, -f/--force dapat
digunakan untuk memaksa penghapusan, dan -Af dapat digunakan untuk menghapus file dari revisi berikutnya
tanpa menghapusnya dari direktori kerja.
Tabel berikut merinci perilaku penghapusan untuk status file yang berbeda (kolom) dan
kombinasi opsi (baris). Status file adalah Ditambahkan [A], Bersihkan [C], Dimodifikasi [M] dan
Hilang [!] (seperti yang dilaporkan oleh hg status). Tindakannya adalah Peringatkan, Hapus (dari cabang) dan
Hapus (dari disk):
┌──────────┬───┬────┬────┬.
opt/state A C M ! │
├──────────┼───┼────┼────┼.
tidak ada W RD W R
├──────────┼───┼────┼────┼.
-f R RD RD R
├──────────┼───┼────┼────┼.
-A W W W R
├──────────┼───┼────┼────┼.
-Af R R R R
└──────────┴───┴────┴────┴.
Note hg menghapus tidak pernah menghapus file dalam status Ditambahkan [A] dari direktori kerja, bukan
meskipun --memaksa ditentukan.
Mengembalikan 0 jika berhasil, 1 jika ada peringatan yang ditemukan.
Pilihan:
-SEBUAH, --setelah
catatan hapus untuk file yang hilang
-F, --memaksa
hapus (dan hapus) file bahkan jika ditambahkan atau dimodifikasi
-S, --subrepos
rekursi menjadi subrepositori
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
alias: rm
mengubah nama
ganti nama file; setara dengan salin + hapus:
hg ganti nama [OPTION]... SUMBER... TUJUAN
Tandai tujuan sebagai salinan sumber; tandai sumber untuk dihapus. Jika dest adalah direktori, salin
diletakkan di direktori itu. Jika dest adalah file, hanya ada satu sumber.
Secara default, perintah ini menyalin konten file seperti yang ada di work
direktori. Jika dipanggil dengan -A/--after, operasi direkam, tetapi tidak ada penyalinan
dilakukan.
Perintah ini berlaku pada komit berikutnya. Untuk membatalkan penggantian nama sebelum itu, lihat hg kembali.
Mengembalikan 0 jika berhasil, 1 jika ditemukan kesalahan.
Pilihan:
-SEBUAH, --setelah
merekam rename yang sudah terjadi
-F, --memaksa
secara paksa menyalin file terkelola yang ada
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-N, --lari-kering
jangan melakukan tindakan, cukup cetak output
[+] opsi yang ditandai dapat ditentukan beberapa kali
alias: pindahkan mv
menyelesaikan
ulangi penggabungan atau atur/lihat status penggabungan file:
hg menyelesaikan [OPSI]... [FILE]...
Penggabungan dengan konflik yang belum terselesaikan sering kali merupakan hasil dari penggabungan non-interaktif menggunakan
internal: gabungkan pengaturan konfigurasi, atau alat gabungan baris perintah seperti perbedaan3. tekad
perintah digunakan untuk mengelola file yang terlibat dalam penggabungan, setelah hg bergabung telah dijalankan, dan
sebelum hg melakukan dijalankan (yaitu direktori kerja harus memiliki dua orang tua). Melihat hg membantu
menggabungkan-alat untuk informasi tentang mengonfigurasi alat gabungan.
Perintah resolve dapat digunakan dengan cara berikut:
· hg menyelesaikan [--alat ALAT] MENGAJUKAN...: mencoba menggabungkan kembali file yang ditentukan, membuang
upaya penggabungan sebelumnya. Penggabungan ulang tidak dilakukan untuk file yang sudah ditandai sebagai
terselesaikan. Menggunakan --semua/-a untuk memilih semua file yang belum terselesaikan. --alat dapat digunakan untuk menentukan
menggabungkan alat yang digunakan untuk file yang diberikan. Ini menimpa variabel lingkungan HGMERGE dan
file konfigurasi Anda. Konten file sebelumnya disimpan dengan .asal akhiran.
· hg menyelesaikan -m [MENGAJUKAN]: menandai file sebagai telah diselesaikan (misalnya setelah secara manual
memperbaiki file). Standarnya adalah untuk menandai semua file yang belum terselesaikan.
· hg menyelesaikan -u [MENGAJUKAN]...: menandai file sebagai belum terselesaikan. Standarnya adalah untuk menandai semua terselesaikan
file.
· hg menyelesaikan -l: daftar file yang memiliki atau masih memiliki konflik. Dalam daftar tercetak, U =
belum terselesaikan dan R = diselesaikan.
Catatan Mercurial tidak akan membiarkan Anda melakukan file dengan konflik gabungan yang belum terselesaikan. Kamu harus
menggunakan hg menyelesaikan -m ... sebelum Anda dapat melakukan setelah penggabungan yang bertentangan.
Mengembalikan 0 jika berhasil, 1 jika ada file yang gagal dalam upaya penyelesaian.
Pilihan:
-Sebuah, --semua
pilih semua file yang belum terselesaikan
-aku, --Daftar
daftar status file yang perlu digabungkan
-M, --tanda
tandai file sebagai terselesaikan
-kamu, --hapus tanda
tandai file sebagai belum terselesaikan
-N, --tidak ada status
sembunyikan awalan status
-T,--alat
tentukan alat gabungan
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-T,--templat
tampilan dengan template (EKSPERIMENTAL)
[+] opsi yang ditandai dapat ditentukan beberapa kali
kembali
mengembalikan file ke status checkout mereka:
hg kembalikan [OPTION]... [-r REV] [NAME]...
Catatan Untuk memeriksa revisi sebelumnya, Anda harus menggunakan hg memperbarui PUTARAN. Untuk membatalkan
penggabungan tidak terikat (dan kehilangan perubahan Anda), gunakan hg memperbarui --membersihkan ..
Tanpa revisi yang ditentukan, kembalikan file atau direktori yang ditentukan ke konten mereka
ada di induk direktori kerja. Ini mengembalikan konten file ke
status tidak dimodifikasi dan tidak terjadwal menambah, menghapus, menyalin, dan mengganti nama. Jika bekerja
direktori memiliki dua orang tua, Anda harus secara eksplisit menentukan revisi.
Menggunakan opsi -r/--rev atau -d/--date, kembalikan file atau direktori yang diberikan ke
menyatakan sebagai revisi tertentu. Karena revert tidak mengubah direktori kerja
orang tua, ini akan menyebabkan file-file ini tampak dimodifikasi. Ini dapat membantu untuk "mundur"
beberapa atau semua perubahan sebelumnya. Melihat hg mundur untuk metode terkait.
File yang dimodifikasi disimpan dengan akhiran .orig sebelum dikembalikan. Untuk menonaktifkan cadangan ini,
gunakan --no-backup.
Lihat hg membantu tanggal untuk daftar format yang valid untuk -d/--date.
Lihat hg membantu mundur untuk cara membalikkan efek set perubahan sebelumnya.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-Sebuah, --semua
kembalikan semua perubahan saat tidak ada argumen yang diberikan
-D,--tanggal
tanggal pencocokan revisi paling ujung
-R,--putaran
kembali ke revisi yang ditentukan
-C, --tanpa cadangan
jangan simpan salinan cadangan file
-Saya, --interaktif
pilih perubahan secara interaktif (EKSPERIMENTAL)
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-N, --lari-kering
jangan melakukan tindakan, cukup cetak output
[+] opsi yang ditandai dapat ditentukan beberapa kali
rollback
roll back transaksi terakhir (BERBAHAYA) (UUS) :
hg kembalikan
Mohon gunakan hg melakukan --mengubah alih-alih kembalikan untuk memperbaiki kesalahan dalam komit terakhir.
Perintah ini harus digunakan dengan hati-hati. Hanya ada satu tingkat kemunduran, dan ada
tidak ada cara untuk membatalkan rollback. Itu juga akan mengembalikan keadaan buruk pada saat terakhir
transaksi, kehilangan perubahan buruk sejak saat itu. Perintah ini tidak mengubah
direktori kerja.
Transaksi digunakan untuk merangkum efek dari semua perintah yang membuat baru
changeset atau menyebarkan perubahan yang ada ke dalam repositori.
Misalnya, perintah berikut bersifat transaksional, dan efeknya dapat digulirkan
kembali:
· berkomitmen
· impor
· menarik
· push (dengan repositori ini sebagai tujuan)
· pisahkan
Untuk menghindari kehilangan data permanen, rollback akan menolak untuk mengembalikan transaksi komit jika
tidak diperiksa. Gunakan --force untuk mengesampingkan perlindungan ini.
Perintah ini tidak dimaksudkan untuk digunakan pada repositori publik. Setelah perubahan terlihat untuk
ditarik oleh pengguna lain, mengembalikan transaksi secara lokal tidak efektif (orang lain mungkin
sudah menarik perubahan). Selanjutnya, balapan dimungkinkan dengan pembaca
gudang; misalnya penarikan yang sedang berlangsung dari repositori mungkin gagal jika rollback adalah
dilakukan.
Mengembalikan 0 jika berhasil, 1 jika tidak ada data rollback yang tersedia.
Pilihan:
-N, --lari-kering
jangan melakukan tindakan, cukup cetak output
-F, --memaksa
mengabaikan langkah-langkah keamanan
akar
cetak root (atas) dari direktori kerja saat ini:
akar hg
Cetak direktori root dari repositori saat ini.
Mengembalikan 0 pada keberhasilan.
melayani
mulai server web yang berdiri sendiri:
hg servis [OPSI]...
Mulai browser repositori HTTP lokal dan tarik server. Anda dapat menggunakan ini untuk berbagi ad-hoc
dan penjelajahan repositori. Disarankan untuk menggunakan server web nyata untuk melayani
penyimpanan untuk jangka waktu yang lebih lama.
Harap dicatat bahwa server tidak menerapkan kontrol akses. Artinya, dengan
default, siapa pun dapat membaca dari server dan tidak ada yang dapat menulisnya secara default. Mengatur
web.allow_push pilihan untuk * untuk memungkinkan semua orang untuk mendorong ke server. Anda harus menggunakan yang asli
server web jika Anda perlu mengautentikasi pengguna.
Secara default, server mencatat akses ke stdout dan kesalahan ke stderr. Menggunakan
Opsi -A/--accesslog dan -E/--errorlog untuk masuk ke file.
Agar server memilih nomor port gratis untuk didengarkan, tentukan nomor port 0; di
dalam hal ini, server akan mencetak nomor port yang digunakannya.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-SEBUAH,--akseslog
nama file log akses untuk menulis ke
-D, --daemon
jalankan server di latar belakang
--daemon-pipefds
digunakan secara internal oleh mode daemon
-E,--catatan eror
nama file log kesalahan untuk menulis
-P,--Pelabuhan
port untuk mendengarkan (default: 8000)
-Sebuah,--alamat
alamat untuk mendengarkan (default: semua antarmuka)
--awalan
jalur awalan untuk melayani dari (default: root server)
-N,--nama
nama untuk ditampilkan di halaman web (default: direktori kerja)
--web-conf
nama file konfigurasi hgweb (lihat "hg help hgweb")
--webdir-conf
nama file konfigurasi hgweb (DIHAPUS)
--pid-file
nama file untuk menulis ID proses ke
--stdio
untuk klien jarak jauh
--cmdserver
untuk klien jarak jauh
-T,--template
template web untuk digunakan
--gaya
gaya template untuk digunakan
-6, --ipv6
gunakan IPv6 selain IPv4
--sertifikat
File sertifikat SSL
status
tampilkan file yang diubah di direktori kerja:
status hg [OPSI]... [FILE]...
Tampilkan status file dalam repositori. Jika nama diberikan, hanya file yang cocok yang
ditampilkan. File yang bersih atau diabaikan atau sumber dari operasi penyalinan/pemindahan, tidak
terdaftar kecuali -c/--clean, -i/--ignored, -C/--copies atau -A/--semua diberikan. Kecuali pilihan
dijelaskan dengan "hanya tampilkan ...", opsi -mardu digunakan.
Opsi -q/--quiet menyembunyikan file yang tidak terlacak (tidak diketahui dan diabaikan) kecuali jika diminta secara eksplisit
dengan -u/--unknown atau -i/--ignored.
Note hg status mungkin tampak tidak setuju dengan perbedaan jika izin telah diubah atau digabungkan
telah terjadi. Format perbedaan standar tidak melaporkan perubahan dan perbedaan izin
hanya melaporkan perubahan relatif terhadap satu induk gabungan.
Jika satu revisi diberikan, itu digunakan sebagai revisi dasar. Jika diberikan dua kali revisi,
perbedaan di antara mereka ditampilkan. Opsi --change juga dapat digunakan sebagai jalan pintas
untuk membuat daftar file yang diubah dari revisi dari induk pertamanya.
Kode yang digunakan untuk menunjukkan status file adalah:
M = dimodifikasi
A = ditambahkan
R = dihapus
C = bersih
! = hilang (dihapus oleh perintah non-hg, tetapi masih dilacak)
? = tidak dilacak
saya = diabaikan
= asal file sebelumnya (dengan --copy)
contoh:
· tampilkan perubahan di direktori kerja relatif terhadap set perubahan:
status hg --rev 9353
· tampilkan perubahan dalam direktori kerja relatif terhadap direktori saat ini (lihat hg membantu
pola untuk informasi lebih lanjut):
status hg kembali:
· tampilkan semua perubahan termasuk salinan dalam set perubahan yang ada:
hg status --salinan --ubah 9353
· dapatkan daftar file tambahan yang dipisahkan NUL, cocok untuk xargs:
status hg -an0
Mengembalikan 0 pada keberhasilan.
Pilihan:
-SEBUAH, --semua
tampilkan status semua file
-M, --diubah
hanya tampilkan file yang dimodifikasi
-Sebuah, --ditambahkan
hanya tampilkan file yang ditambahkan
-R, --DIHAPUS
hanya tampilkan file yang dihapus
-D, --dihapus
hanya tampilkan file yang dihapus (tetapi dilacak)
-C, --membersihkan
tampilkan hanya file tanpa perubahan
-kamu, --tidak dikenal
hanya tampilkan file yang tidak dikenal (tidak dilacak)
-Saya, --diabaikan
hanya tampilkan file yang diabaikan
-N, --tidak ada status
sembunyikan awalan status
-C, --salinan
tampilkan sumber file yang disalin
-0, --cetak0
akhiri nama file dengan NUL, untuk digunakan dengan xargs
--putaran
menunjukkan perbedaan dari revisi
--mengubah
daftar file yang diubah dari revisi
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-S, --subrepos
rekursi menjadi subrepositori
-T,--templat
tampilan dengan template (EKSPERIMENTAL)
[+] opsi yang ditandai dapat ditentukan beberapa kali
alias: st
ringkasan
meringkas status direktori kerja:
hg ringkasan [--jarak jauh]
Ini menghasilkan ringkasan singkat dari status direktori kerja, termasuk orang tua, cabang,
komit status, fase, dan pembaruan yang tersedia.
Dengan opsi --remote, ini akan memeriksa jalur default untuk masuk dan keluar
perubahan. Ini bisa memakan waktu.
Mengembalikan 0 pada keberhasilan.
Pilihan:
--terpencil
periksa dorong dan tarik
alias: sum
label
tambahkan satu atau beberapa tag untuk revisi saat ini atau yang diberikan:
tag hg [-f] [-l] [-m TEXT] [-d TANGGAL] [-u PENGGUNA] [-r REV] NAMA...
Beri nama revisi tertentu menggunakan .
Tag digunakan untuk menamai revisi tertentu dari repositori dan sangat berguna untuk
membandingkan revisi yang berbeda, untuk kembali ke versi sebelumnya yang signifikan atau untuk menandai cabang
poin sebagai rilis, dll. Mengubah tag yang ada biasanya tidak diizinkan; gunakan -f/--force
untuk menimpa.
Jika tidak ada revisi yang diberikan, induk dari direktori kerja digunakan.
Untuk memfasilitasi kontrol versi, distribusi, dan penggabungan tag, tag disimpan sebagai
file bernama ".hgtags" yang dikelola mirip dengan file proyek lain dan dapat
diedit dengan tangan jika perlu. Ini juga berarti bahwa pemberian tag membuat komit baru. Berkas
".hg/localtags" digunakan untuk tag lokal (tidak dibagikan di antara repositori).
Komit tag biasanya dibuat di kepala cabang. Jika orang tua yang bekerja
direktori bukan kepala cabang, hg label membatalkan; gunakan -f/--force untuk memaksa tag berkomitmen untuk
didasarkan pada perubahan non-kepala.
Lihat hg membantu tanggal untuk daftar format yang valid untuk -d/--date.
Karena nama tag memiliki prioritas di atas nama cabang selama pencarian revisi, menggunakan yang sudah ada
nama cabang sebagai nama tag tidak disarankan.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-F, --memaksa
tanda paksa
-aku, --lokal
buat tag lokal
-R,--putaran
revisi untuk menandai
--menghapus
hapus tanda
-e, --edit
panggil editor pada pesan komit
-M,--pesan
gunakan teks sebagai pesan komit
-D,--tanggal
catat tanggal yang ditentukan sebagai tanggal komit
-kamu,--pengguna
rekam pengguna yang ditentukan sebagai pembuat
tag
daftar tag repositori:
tag hg
Ini mencantumkan tag reguler dan lokal. Saat sakelar -v/--verbose digunakan, sepertiga
kolom "local" dicetak untuk tag lokal. Saat sakelar -q/--quiet digunakan, hanya tombol
nama tag dicetak.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-T,--templat
tampilan dengan template (EKSPERIMENTAL)
ujung
tampilkan revisi tip (DIHAPUS):
hg tip [-p] [-g]
Revisi tip (biasanya hanya disebut tip) adalah set perubahan yang terakhir ditambahkan ke
repositori (dan karenanya kepala yang paling baru diubah).
Jika Anda baru saja membuat komit, komit itu akan menjadi tipnya. Jika Anda baru saja menarik
berubah dari repositori lain, ujung repositori itu menjadi ujung saat ini. Itu
tag "tip" khusus dan tidak dapat diganti namanya atau ditetapkan ke set perubahan yang berbeda.
Perintah ini tidak digunakan lagi, silakan gunakan hg kepala sebagai gantinya.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-P, --tambalan
tampilkan tambalan
-G, --git
gunakan format git extended diff
--gaya
tampilkan menggunakan file peta template (DIHAPUS)
-T,--templat
tampilan dengan template
unbundle
terapkan satu atau lebih file changegroup:
hg pisahkan [-u] FILE...
Terapkan satu atau lebih file changegroup terkompresi yang dihasilkan oleh perintah bundel.
Mengembalikan 0 jika berhasil, 1 jika pembaruan memiliki file yang belum terselesaikan.
Pilihan:
-kamu, --memperbarui
perbarui ke kepala cabang baru jika set perubahan tidak digabungkan
memperbarui
perbarui direktori kerja (atau alihkan revisi):
pembaruan hg [-c] [-C] [-d TANGGAL] [[-r] REV]
Perbarui direktori kerja repositori ke set perubahan yang ditentukan. Jika tidak ada perubahan adalah
ditentukan, perbarui ke ujung cabang bernama saat ini dan pindahkan bookmark aktif (lihat
hg membantu bookmark).
Pembaruan mengatur revisi induk direktori kerja ke set perubahan yang ditentukan (lihat hg
membantu orangtua).
Jika set perubahan bukan turunan atau leluhur dari induk direktori kerja, maka
pembaruan dibatalkan. Dengan opsi -c/--check, direktori kerja diperiksa untuk
perubahan tanpa komitmen; jika tidak ada yang ditemukan, direktori kerja diperbarui ke yang ditentukan
perubahan
Aturan berikut berlaku ketika direktori kerja berisi perubahan yang tidak dikomit:
1. Jika -c/--check atau -C/--clean tidak ditentukan, dan jika changeset yang diminta adalah
leluhur atau keturunan dari induk direktori kerja, perubahan yang tidak dikomit adalah
digabungkan ke dalam set perubahan yang diminta dan hasil gabungan dibiarkan tanpa komitmen. jika
perubahan yang diminta bukanlah leluhur atau keturunan (yaitu, itu ada di yang lain
cabang), pembaruan dibatalkan dan perubahan yang tidak dikomit dipertahankan.
2. Dengan opsi -c/--check, pembaruan dibatalkan dan perubahan yang tidak dikomit adalah
diawetkan.
3. Dengan opsi -C/--clean, perubahan yang tidak dikomit akan dibuang dan direktori kerja
diperbarui ke set perubahan yang diminta.
Untuk membatalkan penggabungan yang tidak terikat (dan kehilangan perubahan Anda), gunakan hg memperbarui --membersihkan ..
Gunakan null sebagai changeset untuk menghapus direktori kerja (seperti hg clone -U).
Jika Anda ingin mengembalikan hanya satu file ke revisi yang lebih lama, gunakan hg kembali [-R PUTARAN] NAMA.
Lihat hg membantu tanggal untuk daftar format yang valid untuk -d/--date.
Mengembalikan 0 jika berhasil, 1 jika ada file yang belum terselesaikan.
Pilihan:
-C, --membersihkan
buang perubahan yang tidak dikomit (tidak ada cadangan)
-C, --memeriksa
perbarui di seluruh cabang jika tidak ada perubahan yang tidak dikomit
-D,--tanggal
tanggal pencocokan revisi paling ujung
-R,--putaran
revisi
-T,--alat
tentukan alat gabungan
alias: up checkout co
memeriksa
verifikasi integritas repositori:
verifikasi hg
Verifikasi integritas repositori saat ini.
Ini akan melakukan pemeriksaan ekstensif terhadap integritas repositori, memvalidasi hash
dan checksum dari setiap entri di changelog, manifes, dan file yang dilacak, serta
integritas tautan silang dan indeks mereka.
Silakan lihat https://mercurial-scm.org/wiki/RepositoryCorruption untuk informasi lebih lanjut tentang
pemulihan dari kerusakan repositori.
Mengembalikan 0 jika berhasil, 1 jika ditemukan kesalahan.
versi
versi keluaran dan informasi hak cipta:
versi hg
versi keluaran dan informasi hak cipta
TANGGAL FORMAT
Beberapa perintah memungkinkan pengguna untuk menentukan tanggal, misalnya:
· mundur, komit, impor, tag: Tentukan tanggal komit.
· log, kembalikan, perbarui: Pilih revisi berdasarkan tanggal.
Banyak format tanggal yang valid. Berikut beberapa contohnya:
· mengawinkan Desember 6 13:18:29 2006 (zona waktu lokal diasumsikan)
· Desember 6 13:18 -0600 (tahun diasumsikan, offset waktu disediakan)
· Desember 6 13:18 UTC (UTC dan GMT adalah alias untuk +0000)
· Desember 6 (Tengah malam)
· 13:18 (hari ini diasumsikan)
· 3:39 (diasumsikan pukul 3:39 pagi)
· 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 Desember 2006)
· hari ini (Tengah malam)
· kemarin (Tengah malam)
· sekarang - sekarang
Terakhir, ada format internal Mercurial:
· 1165411109 0 (Rabu 6 Des 13:18:29 2006 UTC)
Ini adalah format representasi internal untuk tanggal. Bilangan pertama adalah bilangan
detik sejak zaman (1970-01-01 00:00 UTC). Yang kedua adalah offset dari lokal
zona waktu, dalam detik di sebelah barat UTC (negatif jika zona waktu di sebelah timur UTC).
Perintah log juga menerima rentang tanggal:
· <TANGGAL - pada atau sebelum tanggal/waktu tertentu
· >TANGGAL - pada atau setelah tanggal/waktu tertentu
· TANGGAL untuk TANGGAL - rentang tanggal, termasuk
· -HARI - dalam beberapa hari tertentu hari ini
BERBEDA FORMAT
Format default Mercurial untuk menampilkan perubahan antara dua versi file adalah
kompatibel dengan format terpadu GNU diff, yang dapat digunakan oleh patch GNU dan banyak lagi
alat standar lainnya.
Meskipun format standar ini cukup sering, itu tidak menyandikan informasi berikut:
· status yang dapat dieksekusi dan bit izin lainnya
· salin atau ganti nama informasi
· perubahan dalam file biner
· pembuatan atau penghapusan file kosong
Mercurial juga mendukung format diff yang diperluas dari git VCS yang membahas ini
keterbatasan. Format git diff tidak diproduksi secara default karena beberapa alat yang tersebar luas
masih tidak mengerti format ini.
Ini berarti bahwa ketika menghasilkan diff dari repositori Mercurial (misalnya dengan hg ekspor),
Anda harus berhati-hati tentang hal-hal seperti salinan file dan penggantian nama atau hal-hal lain yang disebutkan
di atas, karena ketika menerapkan diff standar ke repositori yang berbeda, tambahan ini
informasi hilang. Operasi internal Mercurial (seperti push dan pull) tidak terpengaruh
dengan ini, karena mereka menggunakan format biner internal untuk mengkomunikasikan perubahan.
Untuk membuat Mercurial menghasilkan format git extended diff, gunakan opsi --git yang tersedia untuk
banyak perintah, atau atur 'git = True' di bagian [diff] file konfigurasi Anda. Anda
tidak perlu menyetel opsi ini saat mengimpor diff dalam format ini atau menggunakannya di mq
perpanjangan.
LINGKUNGAN VARIABEL
HG Jalur ke 'hg' yang dapat dieksekusi, diteruskan secara otomatis saat menjalankan kait, ekstensi, atau
alat eksternal. Jika tidak disetel atau kosong, ini adalah nama hg yang dapat dieksekusi jika dibekukan,
atau executable bernama 'hg' (dengan %PATHEXT% [default ke COM/EXE/BAT/CMD]
ekstensi pada Windows) dicari.
HGEDITOR
Ini adalah nama editor yang akan dijalankan saat melakukan. Lihat EDITOR.
(usang, gunakan file konfigurasi)
HGENCODING
Ini mengesampingkan pengaturan lokal default yang terdeteksi oleh Mercurial. Pengaturan ini adalah
digunakan untuk mengonversi data termasuk nama pengguna, deskripsi changeset, nama tag, dan
ranting. Pengaturan ini dapat diganti dengan opsi baris perintah --encoding.
MODE HGENCODING
Ini mengatur perilaku Mercurial untuk menangani karakter yang tidak dikenal saat transcoding
masukan pengguna. Standarnya adalah "ketat", yang menyebabkan Mercurial dibatalkan jika tidak bisa
memetakan karakter. Pengaturan lain termasuk "ganti", yang menggantikan yang tidak diketahui
karakter, dan "abaikan", yang menjatuhkan mereka. Pengaturan ini dapat diganti dengan
--encodingmode opsi baris perintah.
HGENCODINGAMBIGUOUS
Ini menetapkan perilaku Mercurial untuk menangani karakter dengan lebar "ambigu" seperti
karakter Latin beraksen dengan font Asia Timur. Secara default, Mercurial mengasumsikan
karakter ambigu sempit, atur variabel ini ke "lebar" jika karakter seperti itu
menyebabkan masalah format.
HGMERGE
Eksekusi untuk digunakan untuk menyelesaikan konflik gabungan. Program akan dijalankan
dengan tiga argumen: file lokal, file jarak jauh, file leluhur.
(usang, gunakan file konfigurasi)
HGRCPATH
Daftar file atau direktori untuk mencari file konfigurasi. Pemisah barang adalah
":" di Unix, ";" pada Windows. Jika HGRCPATH tidak disetel, jalur pencarian default platform
digunakan. Jika kosong, hanya .hg/hgrc dari repositori saat ini yang dibaca.
Untuk setiap elemen di HGRCPATH:
· jika itu direktori, semua file yang diakhiri dengan .rc ditambahkan
· jika tidak, file itu sendiri akan ditambahkan
HGPLAIN
Saat disetel, ini menonaktifkan pengaturan konfigurasi apa pun yang mungkin mengubah Mercurial
keluaran standar. Ini termasuk penyandian, default, mode verbose, mode debug, senyap
mode, traceback, dan lokalisasi. Ini bisa berguna saat membuat skrip melawan
Mercurial dalam menghadapi konfigurasi pengguna yang ada.
Opsi yang setara yang disetel melalui flag baris perintah atau variabel lingkungan tidak
diganti.
HGPLAIN KECUALI
Ini adalah daftar fitur yang dipisahkan koma untuk dipertahankan saat HGPLAIN diaktifkan.
Saat ini nilai-nilai berikut didukung:
alias
Jangan hapus alias.
I18n
Pertahankan internasionalisasi.
revsetalias.dll
Jangan hapus alias revset.
Menyetel HGPLAINEXCEPT ke apa pun (bahkan string kosong) akan mengaktifkan mode biasa.
HGUSER Ini adalah string yang digunakan sebagai pembuat komit. Jika tidak disetel, nilai yang tersedia
akan dipertimbangkan dalam urutan ini:
· HGUSER (tidak digunakan lagi)
· file konfigurasi dari HGRCPATH
· SUREL
· prompt interaktif
· LOGNAME (dengan @namahost ditambahkan)
(usang, gunakan file konfigurasi)
EMAIL Dapat digunakan sebagai pembuat komit; lihat HGUSER.
NAMA LOGO
Dapat digunakan sebagai pembuat komit; lihat HGUSER.
VISUAL Ini adalah nama editor yang akan digunakan saat melakukan. Lihat EDITOR.
EDITOR Terkadang Mercurial perlu membuka file teks di editor untuk dimodifikasi pengguna,
misalnya saat menulis pesan komit. Editor yang digunakannya ditentukan oleh
melihat variabel lingkungan HGEDITOR, VISUAL dan EDITOR, dalam urutan itu.
Yang pertama tidak kosong dipilih. Jika semuanya kosong, editor default ke
'editor yang masuk akal'.
PYTHONPATH
Ini digunakan oleh Python untuk menemukan modul yang diimpor dan mungkin perlu diatur
tepat jika Mercurial ini tidak diinstal di seluruh sistem.
MENGGUNAKAN TAMBAHAN FITUR
Mercurial memiliki kemampuan untuk menambahkan fitur baru melalui penggunaan ekstensi. Ekstensi
dapat menambahkan perintah baru, menambahkan opsi ke perintah yang ada, mengubah perilaku default
perintah, atau mengimplementasikan kait.
Untuk mengaktifkan ekstensi "foo", baik dikirimkan dengan Mercurial atau di jalur pencarian Python,
buat entri untuk itu di file konfigurasi Anda, seperti ini:
[ekstensi]
foo =
Anda juga dapat menentukan jalur lengkap ke ekstensi:
[ekstensi]
fitur saya = ~/.hgext/myfeature.py
Lihat hg membantu config untuk informasi lebih lanjut tentang file konfigurasi.
Ekstensi tidak dimuat secara default karena berbagai alasan: ekstensi dapat meningkatkan startup
atas; mereka mungkin dimaksudkan untuk penggunaan tingkat lanjut saja; mereka mungkin memberikan potensi
kemampuan berbahaya (seperti membiarkan Anda menghancurkan atau mengubah sejarah); mereka mungkin tidak
siap untuk prime time; atau mereka dapat mengubah beberapa perilaku biasa dari stok Mercurial. Dia
jadi terserah pengguna untuk mengaktifkan ekstensi sesuai kebutuhan.
Untuk secara eksplisit menonaktifkan ekstensi yang diaktifkan dalam file konfigurasi dengan cakupan yang lebih luas,
awali jalurnya dengan !:
[ekstensi]
# menonaktifkan bilah ekstensi yang berada di /path/to/extension/bar.py
bar = !/path/ke/ekstensi/bar.py
# sama, tetapi tidak ada jalur yang disediakan untuk ekstensi baz
baz = !
ekstensi yang dinonaktifkan:
acl kait untuk mengontrol akses repositori
kotak hitam
log peristiwa repositori ke kotak hitam untuk debugging
bugzilla
kait untuk mengintegrasikan dengan pelacak bug Bugzilla
sensor hapus konten file pada revisi yang diberikan
mengocok perintah untuk menampilkan statistik tentang riwayat repositori
kloning
mengiklankan bundel yang dibuat sebelumnya ke klon benih
warna mewarnai output dari beberapa perintah
mengubah
impor revisi dari repositori VCS asing ke Mercurial
keren secara otomatis mengelola baris baru dalam file repositori
extdiff
perintah untuk mengizinkan program eksternal membandingkan revisi
pembantu
otentikasi http dengan factotum
gpg perintah untuk menandatangani dan memverifikasi set perubahan
hgcia kait untuk mengintegrasikan dengan layanan pemberitahuan CIA.vc
hgk jelajahi repositori dengan cara grafis
menyoroti
penyorotan sintaks untuk hgweb (memerlukan Pigmen)
histedit
pengeditan sejarah interaktif
kata kunci
perluas kata kunci dalam file yang dilacak
file besar
lacak file biner besar
mq mengelola setumpuk tambalan
memberitahukan kait untuk mengirim pemberitahuan push email
pager jelajahi keluaran perintah dengan pager eksternal
bom tambal sulam
perintah untuk mengirim perubahan sebagai (serangkaian) email tambalan
pembersihan perintah untuk menghapus file yang tidak terlacak dari direktori kerja
Rebase perintah untuk memindahkan set revisi ke leluhur yang berbeda
catatan perintah untuk secara interaktif memilih perubahan untuk komit/qrefresh
menghubungkan kembali membuat ulang tautan keras antara klon repositori
skema
memperluas skema dengan pintasan ke kumpulan repositori
'share' berbagi sejarah umum antara beberapa direktori kerja
mengesampingkan simpan dan pulihkan perubahan ke direktori kerja
menelanjangi menghapus perubahan dan keturunan mereka dari sejarah
transplantasi
perintah untuk mentransplantasikan perubahan dari cabang lain
win32mbcs
izinkan penggunaan jalur MBCS dengan penyandian bermasalah
zeroconf
temukan dan iklankan repositori di jaringan lokal
SPESIFIKASI FILE SETS
Mercurial mendukung bahasa fungsional untuk memilih satu set file.
Seperti pola file lainnya, jenis pola ini ditandai dengan awalan, 'set:'. Bahasa
mendukung sejumlah predikat yang digabungkan oleh operator infiks. Tanda kurung bisa menjadi
digunakan untuk pengelompokan.
Pengidentifikasi seperti nama file atau pola harus dikutip dengan tanda kutip tunggal atau ganda jika
mereka mengandung karakter di luar [.*{}[]?/\_a-zA-Z0-9\x80-\xff] atau jika mereka cocok dengan salah satu dari
predikat yang telah ditentukan. Ini umumnya berlaku untuk pola file selain gumpalan dan
argumen untuk predikat.
Karakter khusus dapat digunakan dalam pengidentifikasi yang dikutip dengan menghindarinya, misalnya, \n is
diartikan sebagai baris baru. Untuk mencegahnya diinterpretasikan, string dapat diawali
dengan r, misalnya R'...'.
Ada satu operator awalan:
tidak x
File tidak dalam x. Bentuk singkatnya adalah ! x.
Ini adalah operator infix yang didukung:
x dan y
Perpotongan file dalam x dan y. Bentuk singkatnya adalah x & y.
x or y
Penyatuan file dalam x dan y. Ada dua alternatif bentuk pendek: x | y dan x +
y.
x - y
File dalam x tetapi tidak dalam y.
Predikat berikut didukung:
ditambahkan()
File yang ditambahkan sesuai dengan hg status.
biner()
File yang tampaknya biner (berisi NUL byte).
bersih()
File yang bersih menurut hg status.
disalin()
File yang direkam sedang disalin.
dihapus()
Alias untuk hilang().
pengkodean (nama)
File dapat berhasil didekodekan dengan pengkodean karakter yang diberikan. Mungkin tidak
berguna untuk pengkodean selain ASCII dan UTF-8.
eol (gaya)
File berisi baris baru dari gaya yang diberikan (dos, unix, mac). File biner adalah
dikecualikan, file dengan akhiran baris campuran cocok dengan beberapa gaya.
exec ()
File yang ditandai sebagai dapat dieksekusi.
grep(regex)
File berisi ekspresi reguler yang diberikan.
abaikan()
File yang cocok dengan pola .hgignore yang aktif.
diabaikan()
File yang diabaikan menurut hg status. File-file ini hanya akan dipertimbangkan jika
predikat ini digunakan.
hilang()
File yang hilang menurut hg status.
diubah()
File yang dimodifikasi sesuai dengan hg status.
portabel()
File yang memiliki nama portabel. (Ini tidak termasuk nama file dengan case
tabrakan.)
DIHAPUS()
File yang dihapus menurut hg status.
terselesaikan()
File yang ditandai terselesaikan menurut hg menyelesaikan -l.
ukuran (ekspresi)
Ukuran file cocok dengan ekspresi yang diberikan. Contoh:
· 1k (file dari 1024 hingga 2047 byte)
· <20k (file kurang dari 20480 byte)
· >= .5MB (file minimal 524288 byte)
· 4k - 1MB (file dari 4096 byte hingga 1048576 byte)
subrepo([pola])
Subrepositori yang jalurnya cocok dengan pola yang diberikan.
tautan simbolik()
File yang ditandai sebagai symlink.
tidak dikenal()
File yang tidak diketahui menurut hg status. File-file ini hanya akan dipertimbangkan jika
predikat ini digunakan.
belum terselesaikan()
File yang ditandai belum terselesaikan menurut hg menyelesaikan -l.
Beberapa contoh kueri:
· Tampilkan status file yang tampak seperti biner di direktori kerja:
hg status -A "set: biner ()"
· Lupakan file yang ada di .hgignore tetapi sudah dilacak:
hg lupa "set:hgignore() dan tidak diabaikan()"
· Temukan file teks yang berisi string:
file hg "setel:grep(ajaib) dan bukan biner ()"
· Temukan file C dalam penyandian non-standar:
hg file "set:**.c dan bukan encoding('UTF-8')"
· Kembalikan salinan file biner besar:
hg kembalikan "set: copyed() dan binary() dan size('>1M')"
· Hapus file yang terdaftar di foo.lst yang mengandung huruf a atau b:
hg hapus "set: 'listfile:foo.lst' dan (**a* atau **b*)"
Lihat juga hg membantu pola.
GLOSARIUM
Leluhur
Setiap changeset yang dapat dicapai oleh rantai tak terputus dari changeset induk dari a
set perubahan yang diberikan. Lebih tepatnya, nenek moyang dari sebuah changeset dapat didefinisikan oleh dua
properties: parent dari changeset adalah ancestor, dan parent dari ancestor adalah
seorang leluhur. Lihat juga: 'Keturunan'.
Bookmark
Bookmark adalah penunjuk ke komit tertentu yang bergerak saat melakukan. Mereka
mirip dengan tag di mana dimungkinkan untuk menggunakan nama bookmark di semua tempat di mana
Mercurial mengharapkan ID changeset, misalnya dengan hg memperbarui. Tidak seperti tag, bookmark bergerak
bersama saat Anda membuat komit.
Bookmark dapat diganti namanya, disalin, dan dihapus. Penanda bersifat lokal, kecuali jika ada
didorong atau ditarik secara eksplisit di antara repositori. Mendorong dan menarik bookmark
memungkinkan Anda untuk berkolaborasi dengan orang lain di cabang tanpa membuat cabang bernama.
Cabang (Kata Benda) Sebuah changeset anak yang telah dibuat dari orang tua yang bukan kepala.
Ini dikenal sebagai cabang topologi, lihat 'Cabang, topologi'. Jika sebuah
cabang topologi diberi nama, itu menjadi cabang bernama. Jika cabang topologi adalah
tidak bernama, itu menjadi cabang anonim. Lihat 'Cabang, anonim' dan 'Cabang,
bernama'.
Cabang dapat dibuat ketika perubahan ditarik dari atau didorong ke remote
repositori, karena kepala baru dapat dibuat oleh operasi ini. Perhatikan bahwa istilah
cabang juga dapat digunakan secara informal untuk menggambarkan proses pengembangan di mana
perkembangan tertentu dilakukan secara independen dari perkembangan lainnya. Ini kadang-kadang
dilakukan secara eksplisit dengan cabang bernama, tetapi juga dapat dilakukan secara lokal, menggunakan
bookmark atau klon dan cabang anonim.
Contoh: "Cabang eksperimental."
(Kata kerja) Tindakan membuat set perubahan anak yang mengakibatkan induknya memiliki
lebih dari satu anak.
Contoh: "Saya akan bercabang di X."
Cabang, anonim
Setiap kali set perubahan anak baru dibuat dari orang tua yang bukan kepala dan
nama cabang tidak diubah, cabang anonim baru dibuat.
Cabang, tertutup
Cabang bernama yang semua kepala cabangnya telah ditutup.
Cabang, kegagalan
Cabang yang ditetapkan ke set perubahan saat tidak ada nama yang ditetapkan sebelumnya.
Cabang kepala
Lihat 'Kepala, cabang'.
Cabang, non-aktif
Jika cabang bernama tidak memiliki kepala topologi, itu dianggap tidak aktif. sebagai
contoh, cabang fitur menjadi tidak aktif saat digabungkan ke default
cabang. Itu hg cabang perintah menunjukkan cabang tidak aktif secara default, meskipun mereka bisa
disembunyikan dengan hg cabang --aktif.
CATATAN: konsep ini tidak digunakan lagi karena terlalu implisit. Cabang harus sekarang
secara eksplisit ditutup menggunakan hg melakukan --dekat-cabang saat mereka tidak lagi dibutuhkan.
Cabang, bernama
Kumpulan perubahan yang memiliki nama cabang yang sama. Secara default, anak-anak dari
sebuah changeset di cabang bernama milik cabang bernama yang sama. Seorang anak bisa menjadi
secara eksplisit ditugaskan ke cabang yang berbeda. Melihat hg membantu cabang, hg membantu cabang dan
hg melakukan --dekat-cabang untuk informasi lebih lanjut tentang mengelola cabang.
Cabang bernama dapat dianggap sebagai semacam ruang nama, membagi koleksi
changeset yang terdiri dari repositori menjadi kumpulan subset yang terputus-putus. SEBUAH
cabang bernama belum tentu cabang topologi. Jika cabang bernama baru adalah
dibuat dari kepala cabang bernama lain, atau cabang default, tetapi tidak
set perubahan lebih lanjut ditambahkan ke cabang sebelumnya, lalu cabang sebelumnya itu
akan menjadi cabang dalam nama saja.
Cabang ujung
Lihat 'Kiat, cabang'.
Cabang, topologis
Setiap kali set perubahan anak baru dibuat dari orang tua yang bukan kepala, yang baru
cabang topologi dibuat. Jika cabang topologi diberi nama, itu menjadi bernama
cabang. Jika cabang topologi tidak diberi nama, itu menjadi cabang anonim dari
saat ini, mungkin default, cabang.
changelog
Catatan kumpulan perubahan dalam urutan penambahannya ke repositori.
Ini termasuk detail seperti id changeset, penulis, pesan komit, tanggal, dan daftar
dari file yang diubah.
Perubahan
Cuplikan status repositori yang digunakan untuk merekam perubahan.
Perubahan, anak
Kebalikan dari parent changeset: jika P adalah parent dari C, maka C adalah child dari P.
Tidak ada batasan jumlah anak yang mungkin dimiliki oleh sebuah changeset.
Perubahan id
Sebuah hash SHA-1 yang secara unik mengidentifikasi sebuah changeset. Ini dapat direpresentasikan sebagai
string 40 digit heksadesimal "panjang", atau string 12 digit heksadesimal "pendek".
Perubahan, bergabung
Sebuah changeset dengan dua orang tua. Ini terjadi ketika penggabungan dilakukan.
Perubahan, induk
Revisi yang menjadi dasar set perubahan anak. Secara khusus, perubahan orang tua
dari changeset C adalah changeset yang simpulnya segera mendahului C di DAG.
Changesets memiliki paling banyak dua orang tua.
Pembayaran
(Kata benda) Direktori kerja sedang diperbarui ke revisi tertentu. Penggunaan ini harus
mungkin dihindari jika memungkinkan, karena changeset jauh lebih tepat daripada
checkout dalam konteks ini.
Contoh: "Saya menggunakan checkout X."
(Kata kerja) Memperbarui direktori kerja ke set perubahan tertentu. Melihat hg membantu memperbarui.
Contoh: "Saya akan memeriksa changeset X."
Anak changeset
Lihat 'Perubahan, Nak'.
Penyelesaian changeset
Lihat 'Kepala, cabang tertutup'.
Tertutup cabang
Lihat 'Cabang, tutup'.
Klon (Kata Benda) Salinan seluruh atau sebagian dari repositori. Klon parsial harus dalam
bentuk revisi dan nenek moyangnya.
Contoh: "Apakah klon Anda mutakhir?"
(Kata kerja) Proses membuat tiruan, menggunakan hg clone.
Contoh: "Saya akan mengkloning repositori."
Tertutup cabang kepala
Lihat 'Kepala, cabang tertutup'.
Melakukan (Kata benda) Sebuah sinonim untuk changeset.
Contoh: "Apakah bug telah diperbaiki pada komit Anda baru-baru ini?"
(Kata kerja) Tindakan merekam perubahan ke repositori. Saat file di-commit dalam a
direktori kerja, Mercurial menemukan perbedaan antara file yang dikomit dan
changeset induknya, membuat changeset baru di repositori.
Contoh: "Anda harus melakukan perubahan itu sekarang."
Set Singkatan umum dari istilah changeset.
DAG Repositori perubahan dari sistem kontrol versi terdistribusi (DVCS) dapat:
digambarkan sebagai grafik asiklik terarah (DAG), yang terdiri dari node dan tepi, di mana
node sesuai dengan perubahan dan tepi menyiratkan hubungan induk -> anak. Ini
grafik dapat divisualisasikan dengan alat grafis seperti: hg mencatat --grafik. Di Mercurial,
DAG dibatasi oleh persyaratan bagi anak untuk memiliki paling banyak dua orang tua.
Ditinggalkan
Fitur dihapus dari dokumentasi, tetapi tidak dijadwalkan untuk dihapus.
Default cabang
Lihat 'Cabang, default'.
Menurun
Set perubahan apa pun yang dapat dicapai oleh rantai set perubahan anak dari yang diberikan
perubahan Lebih tepatnya, keturunan dari changeset dapat didefinisikan oleh dua
properti: anak dari changeset adalah keturunan, dan anak dari keturunan
adalah keturunan. Lihat juga: 'Leluhur'.
Diff (Kata Benda) Perbedaan antara isi dan atribut file dalam dua
changesets atau changeset dan direktori kerja saat ini. Perbedaannya adalah
biasanya direpresentasikan dalam bentuk standar yang disebut "diff" atau "patch". "git diff"
format digunakan ketika perubahan termasuk salinan, penggantian nama, atau perubahan ke file
atribut, tidak ada yang dapat diwakili/ditangani oleh "diff" dan "patch" klasik.
Contoh: "Apakah Anda melihat koreksi saya di diff?"
(Kata kerja) Diffing two changesets adalah tindakan membuat diff atau patch.
Contoh: "Jika Anda berbeda dengan changeset X, Anda akan mengerti maksud saya."
Direktori, kerja
Direktori kerja mewakili status file yang dilacak oleh Mercurial, yang
akan dicatat di komit berikutnya. Direktori kerja awalnya sesuai dengan
snapshot di set perubahan yang ada, yang dikenal sebagai induk dari kerja
direktori. Lihat 'Induk, direktori kerja'. Status dapat dimodifikasi dengan perubahan ke
file yang diperkenalkan secara manual atau dengan gabungan. Metadata repositori ada di
.hg direktori di dalam direktori kerja.
Draf Perubahan dalam fase draf belum dibagikan dengan repositori penerbitan dan
dengan demikian dapat diubah dengan aman oleh ekstensi pengubah riwayat. Melihat hg membantu fase.
Eksperimental
Fitur yang dapat berubah atau dihapus di kemudian hari.
Grafik Lihat DAG dan hg mencatat --grafik.
kepala Istilah 'kepala' dapat digunakan untuk merujuk ke kepala cabang atau kepala repositori,
tergantung pada konteksnya. Lihat 'Kepala, cabang' dan 'Kepala, repositori' untuk spesifik
definisi.
Kepala adalah tempat pengembangan umumnya terjadi dan merupakan target biasa untuk
memperbarui dan menggabungkan operasi.
Kepala, cabang
Sebuah changeset tanpa keturunan pada cabang bernama yang sama.
Kepala, tertutup cabang
Sebuah changeset yang menandai kepala sebagai tidak lagi menarik. Kepala tertutup tidak
lagi terdaftar oleh hg kepala. Sebuah cabang dianggap tertutup ketika semua kepalanya
ditutup dan akibatnya tidak terdaftar oleh hg cabang.
Kepala yang tertutup dapat dibuka kembali dengan melakukan perubahan baru sebagai anak dari
changeset yang menandai kepala sebagai ditutup.
Kepala, gudang
Sebuah kepala topologi yang belum ditutup.
Kepala, topologis
Sebuah changeset tanpa anak-anak dalam repositori.
Sejarah, abadi
Setelah di-commit, set perubahan tidak dapat diubah. Ekstensi yang tampaknya berubah
sejarah benar-benar membuat perubahan baru yang menggantikan yang sudah ada, dan kemudian menghancurkan
perubahan lama. Melakukannya di repositori publik dapat menghasilkan set perubahan lama
diperkenalkan kembali ke repositori.
Sejarah, menulis ulang
Perubahan dalam repositori tidak dapat diubah. Namun, ekstensi ke Mercurial dapat
digunakan untuk mengubah repositori, biasanya sedemikian rupa untuk mempertahankan changeset
isi.
Kekal sejarah
Lihat 'Sejarah, tidak dapat diubah'.
Bergabung changeset
Lihat 'Mengubah, menggabungkan'.
Nyata
Setiap set perubahan memiliki manifes, yang merupakan daftar file yang dilacak oleh
perubahan
Bergabung Digunakan untuk menyatukan cabang-cabang pekerjaan yang berbeda. Saat Anda memperbarui ke set perubahan
dan kemudian gabungkan changeset lain, Anda membawa riwayat changeset yang terakhir
ke direktori kerja Anda. Setelah konflik diselesaikan (dan ditandai), penggabungan ini
dapat dilakukan sebagai kumpulan perubahan gabungan, menyatukan dua cabang di DAG.
Bernama cabang
Lihat 'Cabang, bernama'.
Null changeset
Set perubahan kosong. Ini adalah status induk dari repositori yang baru diinisialisasi dan
repositori tanpa revisi yang diperiksa. Dengan demikian adalah induk dari root changesets
dan ancestor yang efektif saat menggabungkan perubahan yang tidak terkait. Dapat ditentukan oleh
alias 'null' atau dengan ID changeset '000000000000'.
Induk Lihat 'Perubahan, orang tua'.
Induk changeset
Lihat 'Perubahan, orang tua'.
Induk, kerja direktori
Induk direktori kerja mencerminkan revisi virtual yang merupakan anak dari
changeset (atau dua changeset dengan penggabungan yang tidak dikomit) ditunjukkan oleh hg orangtua. Ini
diubah dengan hg memperbarui. Perintah lain untuk melihat induk direktori kerja adalah
hg ringkasan dan hg id. Dapat ditentukan dengan alias ".".
tambalan (Kata benda) Produk dari operasi diff.
Contoh: "Saya telah mengirimkan tambalan saya."
(Verb) Proses menggunakan file patch untuk mengubah satu changeset menjadi yang lain.
Contoh: "Anda harus menambal revisi itu."
Tahap Status per set perubahan yang melacak bagaimana set perubahan telah atau harus dibagikan. Melihat
hg membantu fase.
Publik Perubahan dalam fase publik telah dibagikan dengan repositori penerbitan dan
karena itu dianggap tidak berubah. Melihat hg membantu fase.
Tarik Operasi di mana mengubah set di repositori jarak jauh yang tidak ada di lokal
repositori dibawa ke repositori lokal. Perhatikan bahwa operasi ini tanpa
argumen khusus hanya memperbarui repositori, itu tidak memperbarui file di
direktori kerja. Melihat hg membantu menarik.
Dorong Sebuah operasi di mana perubahan di repositori lokal yang tidak di remote
repositori dikirim ke repositori jarak jauh. Perhatikan bahwa operasi ini hanya menambahkan
perubahan yang telah dilakukan secara lokal ke repositori jarak jauh. Tidak terikat
perubahan tidak dikirim. Melihat hg membantu mendorong.
Gudang
Metadata yang menjelaskan semua status rekaman dari kumpulan file. Setiap direkam
state diwakili oleh changeset. Repositori biasanya (tetapi tidak selalu) ditemukan
dalam .HG subdirektori dari direktori kerja. Setiap status yang direkam dapat dibuat ulang
dengan "memperbarui" direktori kerja ke set perubahan tertentu.
Gudang kepala
Lihat 'Kepala, repositori'.
Revisi
Keadaan repositori di beberapa titik waktu. Revisi sebelumnya dapat diperbarui
dengan menggunakan hg memperbarui. Lihat juga 'Nomor revisi'; Lihat juga 'Mengubah'.
Revisi jumlah
Integer ini secara unik mengidentifikasi perubahan dalam repositori tertentu. Dia
mewakili urutan perubahan yang ditambahkan ke repositori, dimulai dengan
nomor revisi 0. Perhatikan bahwa nomor revisi mungkin berbeda di setiap klon dari
sebuah gudang. Untuk mengidentifikasi perubahan secara unik di antara klon yang berbeda, lihat
'Ubah id'.
log balik Mekanisme penyimpanan history yang digunakan oleh Mercurial. Ini adalah bentuk pengkodean delta, dengan
sesekali revisi penuh data diikuti oleh delta dari setiap revisi berturut-turut. Dia
termasuk data dan indeks yang menunjuk ke data.
Menulis ulang sejarah
Lihat 'Sejarah, menulis ulang'.
Akar Changeset yang hanya memiliki null changeset sebagai induknya. Sebagian besar repositori memiliki
hanya satu root changeset.
Rahasia Perubahan dalam fase rahasia tidak boleh dibagikan melalui push, pull, atau clone. Melihat hg
membantu fase.
label Nama alternatif yang diberikan untuk sebuah changeset. Tag dapat digunakan di semua tempat di mana
Mercurial mengharapkan ID changeset, misalnya dengan hg memperbarui. Pembuatan tag adalah
disimpan dalam riwayat dan dengan demikian akan secara otomatis dibagikan dengan yang lain menggunakan push
dan tarik.
jenis Changeset dengan angka revisi tertinggi. Ini adalah perubahan yang paling baru
ditambahkan dalam repositori.
Bung, cabang
Kepala cabang tertentu dengan nomor revisi tertinggi. Ketika nama cabang adalah
digunakan sebagai pengenal revisi, mengacu pada ujung cabang. Lihat juga 'Cabang,
kepala'. Perhatikan bahwa karena nomor revisi mungkin berbeda di repositori yang berbeda
kloning, ujung cabang mungkin berbeda di repositori kloning yang berbeda.
Memperbarui (Kata benda) Sinonim lain dari changeset.
Contoh: "Saya telah mendorong pembaruan."
(Kata kerja) Istilah ini biasanya digunakan untuk menggambarkan memperbarui keadaan kerja
direktori dengan changeset tertentu. Melihat hg membantu memperbarui.
Contoh: "Anda harus memperbarui."
Kerja direktori
Lihat 'Direktori, berfungsi'.
Kerja direktori induk
Lihat 'Induk, direktori kerja'.
SINTAKSIS UNTUK LINCAH LAGI FILE
ringkasan
Sistem Mercurial menggunakan file bernama .hignore di direktori root repositori untuk
mengontrol perilakunya saat mencari file yang saat ini tidak dilacak.
Deskripsi Produk
Direktori kerja dari repositori Mercurial akan sering berisi file yang seharusnya tidak
dilacak oleh Mercurial. Ini termasuk file cadangan yang dibuat oleh editor dan membangun produk
dibuat oleh compiler. File-file ini dapat diabaikan dengan mencantumkannya di a .hignore file dalam
akar dari direktori kerja. Itu .hignore file harus dibuat secara manual. Dia
biasanya diletakkan di bawah kontrol versi, sehingga pengaturan akan menyebar ke yang lain
repositori dengan push dan pull.
File yang tidak terlacak akan diabaikan jika jalurnya relatif terhadap direktori root repositori, atau apapun
jalur awalan dari jalur itu, dicocokkan dengan pola apa pun di .hignore.
Misalnya, kita memiliki file yang tidak terlacak, file.c, di a/b/berkas.c di dalam repositori kami.
Mercurial akan mengabaikan file.c jika ada pola dalam .hignore korek api a/b/berkas.c, a / b or a.
Selain itu, file konfigurasi Mercurial dapat mereferensikan satu set per-pengguna atau global
mengabaikan file. Lihat mengabaikan kunci konfigurasi pada [ui] bagian hg membantu config untuk
rincian tentang cara mengkonfigurasi file-file ini.
Untuk mengontrol penanganan Mercurial atas file yang dikelolanya, banyak perintah mendukung -I dan
-X pilihan; melihat hg membantu dan hg membantu pola untuk rincian.
File yang sudah dilacak tidak terpengaruh oleh .hgignore, meskipun muncul di
.hgignore. File X yang tidak terlacak dapat ditambahkan secara eksplisit dengan hg menambahkan X, bahkan jika X adalah
dikecualikan oleh pola di .hgignore.
Sintaksis
File abaikan adalah file teks biasa yang terdiri dari daftar pola, dengan satu pola per
garis. Baris kosong dilewati. Itu # karakter diperlakukan sebagai karakter komentar, dan
\ karakter diperlakukan sebagai karakter pelarian.
Mercurial mendukung beberapa sintaks pola. Sintaks default yang digunakan adalah gaya Python/Perl
ekspresi reguler.
Untuk mengubah sintaks yang digunakan, gunakan baris formulir berikut:
sintaks: NAMA
dimana NAMA adalah salah satu dari berikut:
regexp
Ekspresi reguler, sintaks Python/Perl.
bola
Gumpalan bergaya cangkang.
Sintaks yang dipilih tetap berlaku saat mem-parsing semua pola yang mengikuti, sampai yang lain
sintaks dipilih.
Baik pola glob maupun regexp tidak di-root. Pola sintaksis glob dari formulir *.C akan
cocok dengan file yang berakhiran .c di direktori mana pun, dan pola regexp dari formulir \.c$ akan melakukan
sama. Untuk melakukan root pada pola regexp, mulailah dengan ^.
Subdirektori dapat memiliki pengaturan .hgignore sendiri dengan menambahkan
subtermasuk: path/to/subdir/.hgignore ke akar .hignore. Lihat hg membantu pola untuk
rincian tentang termasuk: dan meliputi:.
Catatan Pola yang ditentukan selain dari .hignore selalu di-root. Silahkan lihat hg membantu
pola untuk rincian.
Contoh
Berikut adalah contoh file abaikan.
# gunakan sintaks glob.
sintaks: glob
*.elc
*.pyc
*~
# beralih ke sintaks regexp.
sintaks: regexp
^\.pc/
KONFIGURASI HGWEB
Server web internal Mercurial, hgweb, dapat melayani baik repositori tunggal, atau pohon dari
repositori. Dalam kasus kedua, jalur repositori dan opsi global dapat didefinisikan menggunakan
file konfigurasi khusus yang umum untuk hg melayani, hgweb.wsgi, hgweb.cgi dan hgweb.fcgi.
File ini menggunakan sintaks yang sama seperti file konfigurasi Mercurial lainnya tetapi hanya mengenali
bagian berikut:
· jaringan
· jalur
· koleksi
Grafik jaringan opsi dijelaskan secara menyeluruh dalam hg membantu config.
Grafik jalan bagian memetakan jalur URL ke jalur repositori di sistem file. hgweb akan
tidak mengekspos sistem file secara langsung - hanya repositori Mercurial yang dapat dipublikasikan dan hanya
sesuai dengan konfigurasi.
Sisi kiri adalah jalur di URL. Perhatikan bahwa hgweb mencadangkan subpath seperti putaran or
fillet, coba gunakan nama yang berbeda untuk repositori bersarang untuk menghindari efek yang membingungkan.
Sisi kanan adalah jalur di sistem file. Jika jalur yang ditentukan berakhir dengan * or **
sistem file akan dicari secara rekursif untuk repositori di bawah titik itu. Dengan * it
tidak akan muncul kembali ke dalam repositori yang ditemukannya (kecuali untuk .hg/patch). Dengan ** itu akan
juga mencari di dalam direktori kerja repositori dan mungkin menemukan subrepositori.
Dalam contoh ini:
[jalan]
/proyek/a = /srv/tmprepos/a
/proyek/b = c:/repos/b
/ = /srv/repo/*
/pengguna/bob = /home/bob/repos/**
· Dua entri pertama membuat dua repositori di direktori yang berbeda muncul di bawah
direktori yang sama di antarmuka web
· Entri ketiga akan menerbitkan setiap repositori Mercurial yang ditemukan di /srv/repos/, Untuk
contoh repositori /srv/repos/quux/ akan muncul sebagai http://server/quux/
· Entri keempat akan menerbitkan keduanya http://server/user/bob/quux/ dan
http://server/user/bob/quux/testsubrepo/
Grafik koleksi bagian sudah usang dan telah digantikan oleh jalan.
URL dan Umum kasus
URL di bawah setiap repositori memiliki formulir /{perintah}[/{argumen}] dimana {memerintah}
mewakili nama perintah atau penangan dan {argumen} mewakili sejumlah
parameter URL tambahan untuk perintah itu.
Server web memiliki gaya default yang terkait dengannya. Peta gaya ke koleksi bernama
template. Setiap template digunakan untuk merender bagian data tertentu, seperti kumpulan perubahan
atau perbedaan
Gaya untuk permintaan saat ini dapat ditimpa dengan dua cara. Pertama, jika {memerintah}
mengandung tanda hubung (-), teks sebelum tanda hubung mendefinisikan gaya. Sebagai contoh,
/atom-log akan membuat mencatat pengendali perintah dengan atom gaya. Cara kedua untuk mengatur
gayanya dengan gaya argumen string kueri. Sebagai contoh, /log?gaya=atom. itu
parameter URL ditulis dgn tanda penghubung lebih disukai.
Tidak semua template tersedia untuk semua gaya. Mencoba menggunakan gaya yang tidak
memiliki semua template yang ditentukan dapat mengakibatkan kesalahan saat merender halaman.
Banyak perintah mengambil a {revisi} parameter URL. Ini mendefinisikan changeset untuk dioperasikan.
Ini biasanya ditentukan sebagai singkatan pendek, 12 digit heksadesimal untuk 40 . penuh
pengenal revisi unik karakter. Namun, nilai apa pun yang dijelaskan oleh hg membantu revisi
biasanya bekerja.
Perintah dan URL
Perintah web berikut dan URL-nya tersedia:
/annotate/{revisi}/{path}
Tampilkan informasi changeset untuk setiap baris dalam file.
Grafik catatan file template dirender.
/arsip/{revisi}.{format}[/{path}]
Dapatkan arsip konten repositori.
Konten dan jenis arsip ditentukan oleh parameter jalur URL. format adalah
ekstensi file dari jenis arsip yang akan dihasilkan. misalnya zip or tar.bz2. Tidak semua arsip
jenis mungkin diizinkan oleh konfigurasi server Anda.
Opsional path Parameter URL mengontrol konten untuk disertakan dalam arsip. Jika dihilangkan,
setiap file dalam revisi yang ditentukan ada dalam arsip. Jika disertakan, hanya
file tertentu atau isi direktori tertentu akan dimasukkan dalam arsip.
Tidak ada template yang digunakan untuk handler ini. Konten biner mentah dihasilkan.
/bookmark
Tampilkan informasi tentang bookmark.
Tidak ada argumen yang diterima.
Grafik bookmark template dirender.
/ranting
Menampilkan informasi tentang cabang.
Semua cabang yang dikenal terkandung dalam output, bahkan cabang tertutup.
Tidak ada argumen yang diterima.
Grafik cabang template dirender.
/changelog[/{revisi}]
Tampilkan informasi tentang beberapa perubahan.
Jika opsional revisi Argumen URL tidak ada, informasi tentang semua perubahan dimulai
at ujung akan diberikan. jika revisi argumen hadir, perubahan akan ditampilkan
mulai dari revisi yang ditentukan.
If revisi tidak ada, putaran argumen string kueri dapat didefinisikan. Ini akan melakukan
mencari perubahan.
Argumen untuk putaran bisa berupa revisi tunggal, set revisi, atau kata kunci literal untuk
cari di data changeset (setara dengan hg mencatat -k).
Grafik penghitungan kembali argumen string kueri menentukan jumlah maksimum set perubahan yang akan dirender.
Untuk non-penelusuran, changelog template akan dirender.
/changeset[/{revisi}]
Tampilkan informasi tentang satu set perubahan.
Argumen jalur URL adalah pengidentifikasi changeset untuk ditampilkan. Melihat hg membantu revisi untuk
nilai-nilai yang mungkin. Jika tidak didefinisikan, ujung changeset akan ditampilkan.
Grafik changeset template dirender. Isi dari perubahantag, ubahsetbookmark,
tautan filenode, tautan file, dan banyak template yang terkait dengan diff semuanya dapat digunakan untuk
menghasilkan keluaran.
/perbandingan/{revisi}/{jalur}
Menampilkan perbandingan antara file versi lama dan baru dari perubahan yang dibuat pada a
revisi tertentu.
Ini mirip dengan diff pawang Namun, formulir ini memiliki fitur split atau side-by-side
diff daripada diff terpadu.
Grafik konteks argumen string kueri dapat digunakan untuk mengontrol baris konteks dalam diff.
Grafik perbandingan file template dirender.
/diff/{revisi}/{jalur}
Tunjukkan bagaimana file berubah dalam komit tertentu.
Grafik diajukan template dirender.
Handler ini terdaftar di bawah kedua / perbedaan dan /filediff jalan. / perbedaan digunakan dalam
kode modern.
/file/{revisi}[/{path}]
Menampilkan informasi tentang direktori atau file dalam repositori.
Info tentang path diberikan sebagai parameter URL akan dirender.
If path adalah direktori, informasi tentang entri dalam direktori itu akan diberikan.
Bentuk ini setara dengan nyata penangan.
If path adalah file, informasi tentang file itu akan ditampilkan melalui revisi file
Template.
If path tidak ditentukan, informasi tentang direktori root akan diberikan.
/diff/{revisi}/{jalur}
Tunjukkan bagaimana file berubah dalam komit tertentu.
Grafik diajukan template dirender.
Handler ini terdaftar di bawah kedua / perbedaan dan /filediff jalan. / perbedaan digunakan dalam
kode modern.
/filelog/{revisi}/{path}
Menampilkan informasi tentang riwayat file di repositori.
Grafik penghitungan kembali argumen string kueri dapat didefinisikan untuk mengontrol jumlah entri maksimum
memperlihatkan.
Grafik filelog template akan dirender.
/grafik[/{revisi}]
Menampilkan informasi tentang topologi grafis dari repositori.
Informasi yang diberikan oleh handler ini dapat digunakan untuk membuat representasi visual dari
topologi repositori.
Grafik revisi Parameter URL mengontrol set perubahan awal.
Grafik penghitungan kembali argumen string kueri dapat menentukan jumlah perubahan untuk menampilkan informasi
untuk.
Handler ini akan membuat grafik Template.
/bantuan[/{topik}]
Membuat dokumentasi bantuan.
Perintah web ini kira-kira setara dengan hg membantu. Jika sebuah tema didefinisikan, topik bantuan itu
akan diberikan. Jika tidak, indeks topik bantuan yang tersedia akan ditampilkan.
Grafik membantu template akan diberikan saat meminta bantuan untuk suatu topik. Topik-Topik Bantuan akan
diberikan untuk indeks topik bantuan.
/log[/{revisi}[/{jalur}]]
Tampilkan repositori atau riwayat file.
Untuk URL formulir /log/{revisi}, daftar perubahan yang dimulai dari yang ditentukan
pengidentifikasi changeset ditampilkan. Jika {revisi} tidak ditentukan, defaultnya adalah ujung. Formulir ini
setara dengan changelog penangan.
Untuk URL formulir /log/{revisi}/{file}, riwayat untuk file tertentu adalah
ditampilkan. Bentuk ini setara dengan filelog penangan.
/manifest[/{revisi}[/{path}]]
Menampilkan informasi tentang direktori.
Jika argumen jalur URL dihilangkan, informasi tentang direktori root untuk ujung
changeset akan ditampilkan.
Karena handler ini hanya dapat menampilkan informasi untuk direktori, disarankan untuk menggunakan
itu fillet handler sebagai gantinya, karena dapat menangani direktori dan file.
Grafik nyata template akan dirender untuk handler ini.
/changeset[/{revisi}]
Tampilkan informasi tentang satu set perubahan.
Argumen jalur URL adalah pengidentifikasi changeset untuk ditampilkan. Melihat hg membantu revisi untuk
nilai-nilai yang mungkin. Jika tidak didefinisikan, ujung changeset akan ditampilkan.
Grafik changeset template dirender. Isi dari perubahantag, ubahsetbookmark,
tautan filenode, tautan file, dan banyak template yang terkait dengan diff semuanya dapat digunakan untuk
menghasilkan keluaran.
/ shortlog
Tampilkan informasi dasar tentang sekumpulan set perubahan.
Ini menerima parameter yang sama dengan changelog pawang Satu-satunya perbedaan adalah
log pendek template akan dirender alih-alih changelog Template.
/Ringkasan
Tampilkan ringkasan status repositori.
Informasi tentang perubahan terbaru, bookmark, tag, dan cabang ditangkap oleh ini
penangan.
Grafik ringkasan template dirender.
/tag
Tampilkan informasi tentang tag.
Tidak ada argumen yang diterima.
Grafik tag template dirender.
TEKNIS PENERAPAN TOPIK
bundel
wadah untuk pertukaran data repositori
grup ganti
representasi data revlog
revlog
mekanisme penyimpanan revisi
MENGGABUNGKAN ALAT
Untuk menggabungkan file Mercurial menggunakan alat gabungan.
Alat gabungan menggabungkan dua versi file yang berbeda menjadi file gabungan. Menggabungkan alat adalah
mengingat dua file dan nenek moyang terbesar dari dua versi file, sehingga mereka dapat
tentukan perubahan yang dilakukan pada kedua cabang.
Alat gabungan digunakan baik untuk hg menyelesaikan, hg bergabung, hg memperbarui, hg mundur dan di beberapa
ekstensi.
Biasanya, alat gabungan mencoba untuk secara otomatis merekonsiliasi file dengan menggabungkan semua
perubahan non-tumpang tindih yang terjadi secara terpisah dalam dua evolusi yang berbeda dari
file dasar awal yang sama. Selain itu, beberapa program penggabungan interaktif memudahkan untuk
menyelesaikan penggabungan yang bertentangan secara manual, baik dengan cara grafis, atau dengan memasukkan beberapa
penanda konflik. Mercurial tidak menyertakan program penggabungan interaktif apa pun tetapi bergantung pada
alat eksternal untuk itu.
Tersedia bergabung alat
Alat gabungan eksternal dan propertinya dikonfigurasi dalam konfigurasi alat gabungan
bagian - lihat hgrc(5) - tetapi mereka sering kali hanya dapat dinamai dengan executable mereka.
Alat gabungan umumnya dapat digunakan jika eksekusinya dapat ditemukan di sistem dan jika itu
dapat menangani penggabungan. Eksekusi ditemukan jika itu adalah executable absolut atau relatif
jalur atau nama aplikasi di jalur pencarian yang dapat dieksekusi. Alat tersebut diasumsikan
dapat menangani penggabungan jika dapat menangani symlink jika file tersebut adalah symlink, jika dapat
menangani file biner jika file biner, dan jika GUI tersedia jika alat memerlukan
sebuah GUI.
Ada beberapa alat penggabungan internal yang dapat digunakan. Alat penggabungan internal adalah:
:membuang
Membuat tiga versi file untuk digabungkan, berisi konten lokal,
lain dan dasar. File-file ini kemudian dapat digunakan untuk melakukan penggabungan secara manual. jika
file yang akan digabungkan bernama a.txt, file-file ini akan diberi nama
a.txt.lokal, a.txt.lainnya dan a.txt.base dan mereka akan ditempatkan di tempat yang sama
direktori sebagai a.txt.
:gagal
Alih-alih mencoba menggabungkan file yang dimodifikasi di kedua cabang, itu menandai
mereka sebagai belum terselesaikan. Perintah resolve harus digunakan untuk menyelesaikan konflik ini.
:lokal
Menggunakan versi lokal file sebagai versi gabungan.
:menggabungkan
Menggunakan algoritme penggabungan sederhana non-interaktif internal untuk menggabungkan file. Itu akan
gagal jika ada konflik dan meninggalkan penanda di file yang digabungkan sebagian.
Spidol akan memiliki dua bagian, satu untuk setiap sisi gabungan.
:gabung-lokal
Suka: gabungkan, tetapi selesaikan semua konflik secara non-interaktif demi kepentingan lokal
perubahan.
:gabung-lainnya
Suka: gabungkan, tetapi selesaikan semua konflik secara non-interaktif demi yang lain
perubahan.
:gabung3
Menggunakan algoritme penggabungan sederhana non-interaktif internal untuk menggabungkan file. Itu akan
gagal jika ada konflik dan meninggalkan penanda di file yang digabungkan sebagian.
Marker akan memiliki tiga bagian, satu dari setiap sisi gabungan dan satu untuk
konten dasar.
:lainnya
Menggunakan versi file lain sebagai versi gabungan.
:mengingatkan
Menanyakan kepada pengguna yang mana dari versi lokal atau versi lain yang akan disimpan sebagai gabungan
versi.
: penggabungan tag
Menggunakan algoritma penggabungan tag internal (eksperimental).
:Persatuan
Menggunakan algoritme penggabungan sederhana non-interaktif internal untuk menggabungkan file. Itu akan
gunakan kedua sisi kiri dan kanan untuk daerah konflik. Tidak ada penanda yang dimasukkan.
Alat internal selalu tersedia dan tidak memerlukan GUI tetapi secara default tidak akan
menangani symlink atau file biner.
Memilih a bergabung alat
Mercurial menggunakan aturan ini saat memutuskan alat gabungan mana yang akan digunakan:
1. Jika alat telah ditentukan dengan opsi --tool untuk digabungkan atau diselesaikan, alat itu digunakan.
Jika itu adalah nama alat dalam konfigurasi alat gabungan, konfigurasinya adalah
digunakan. Jika tidak, alat yang ditentukan harus dapat dieksekusi oleh shell.
2. Jika HGMERGE variabel lingkungan hadir, nilainya digunakan dan harus
dapat dieksekusi oleh shell.
3. Jika nama file dari file yang akan digabungkan cocok dengan salah satu pola di
bagian konfigurasi merge-patterns, alat penggabungan pertama yang dapat digunakan yang sesuai dengan a
pola yang cocok digunakan. Di sini, kemampuan biner dari alat gabungan tidak
dipertimbangkan.
4. Jika ui.merge diatur, itu akan dipertimbangkan selanjutnya. Jika nilainya bukan nama a
alat yang dikonfigurasi, nilai yang ditentukan digunakan dan harus dapat dieksekusi oleh shell.
Jika tidak, alat bernama digunakan jika dapat digunakan.
5. Jika ada alat gabungan yang dapat digunakan yang ada di bagian konfigurasi alat gabungan, yang
dengan prioritas tertinggi digunakan.
6. Jika sebuah program bernama penggabungan dapat ditemukan di sistem, itu digunakan - tetapi akan dengan
default tidak digunakan untuk symlink dan file biner.
7. Jika file yang akan digabungkan bukan biner dan bukan symlink, maka internal :menggabungkan is
bekas.
8. Penggabungan file gagal dan harus diselesaikan sebelum komit.
Catatan Setelah memilih program gabungan, Mercurial secara default akan mencoba menggabungkan
file menggunakan algoritma penggabungan sederhana terlebih dahulu. Hanya jika tidak berhasil karena
perubahan yang bertentangan Mercurial benar-benar akan menjalankan program gabungan. Apakah akan
gunakan algoritma penggabungan sederhana terlebih dahulu dapat dikontrol oleh pengaturan premerge
alat penggabungan. Premerge diaktifkan secara default kecuali file biner atau a
tautan simbolik.
Lihat bagian alat gabungan dan ui dari hgrc(5) untuk detail tentang konfigurasi penggabungan
alat.
SPESIFIKASI GANDA REVISI
Ketika Mercurial menerima lebih dari satu revisi, mereka dapat ditentukan secara individual, atau
disediakan sebagai rentang topologi kontinu, dipisahkan oleh karakter ":".
Sintaks notasi rentang adalah [BEGIN]:[END], di mana BEGIN dan END adalah revisi
pengenal. Baik BEGIN dan END adalah opsional. Jika BEGIN tidak ditentukan, defaultnya adalah
nomor revisi 0. Jika END tidak ditentukan, defaultnya adalah tip. Rentang ":" demikian
berarti "semua revisi".
Jika BEGIN lebih besar dari END, revisi diperlakukan dalam urutan terbalik.
Rentang bertindak sebagai interval tertutup. Ini berarti bahwa rentang 3:5 menghasilkan 3, 4 dan 5.
Demikian pula, kisaran 9:6 menghasilkan 9, 8, 7, dan 6.
FILE NAMA POLA
Mercurial menerima beberapa notasi untuk mengidentifikasi satu atau lebih file sekaligus.
Secara default, Mercurial memperlakukan nama file sebagai pola glob diperpanjang gaya shell.
Notasi pola alternatif harus ditentukan secara eksplisit.
Catatan Pola yang ditentukan dalam .hignore tidak di-root. Silahkan lihat hg membantu abaikan saja untuk
rincian.
Untuk menggunakan nama jalur biasa tanpa pencocokan pola apa pun, mulailah dengan jalan:. Jalan ini
nama harus benar-benar cocok mulai dari root repositori saat ini.
Untuk menggunakan glob yang diperluas, awali nama dengan gumpal:. Gumpalan berakar pada arus
direktori; gumpalan seperti *.C hanya akan mencocokkan file di direktori saat ini yang diakhiri dengan
.c.
Ekstensi sintaks glob yang didukung adalah ** untuk mencocokkan string apa pun melintasi pemisah jalur dan
{a,b} berarti "a atau b".
Untuk menggunakan ekspresi reguler Perl/Python, awali nama dengan kembali:. Pencocokan pola regexp
berlabuh di akar repositori.
Untuk membaca pola nama dari file, gunakan file daftar: or daftarfile0:. Yang terakhir mengharapkan null
pola yang dibatasi sementara yang pertama mengharapkan umpan baris. Setiap string yang dibaca dari file adalah
itu sendiri diperlakukan sebagai pola file.
Untuk membaca satu set pola dari file, gunakan meliputi: or termasuk:. meliputi: akan menggunakan semua
pola dari file yang diberikan dan memperlakukannya seolah-olah telah diteruskan secara manual.
termasuk: hanya akan menerapkan pola terhadap file yang berada di bawah subinclude
direktori file. Melihat hg membantu abaikan saja untuk detail tentang format file-file ini.
Semua pola, kecuali untuk gumpal: ditentukan dalam baris perintah (bukan untuk -I or -X pilihan), bisa
cocokkan juga dengan direktori: file di bawah direktori yang cocok diperlakukan sebagai cocok.
Contoh sederhana:
path:foo/bar bar nama di direktori bernama foo di root
dari repositori
path:path: beri nama file atau direktori bernama "path:name"
Contoh glob:
glob:*.c nama apa pun yang diakhiri dengan ".c" di direktori saat ini
*.c nama apa pun yang diakhiri dengan ".c" di direktori saat ini
**.c nama apa pun yang diakhiri dengan ".c" di setiap subdirektori dari
direktori saat ini termasuk dirinya sendiri.
foo/*.c nama apa pun yang diakhiri dengan ".c" di direktori foo
foo/**.c nama apa pun yang diakhiri dengan ".c" di setiap subdirektori foo
termasuk dirinya sendiri.
Contoh Regexp:
re:.*\.c$ nama apa pun yang diakhiri dengan ".c", di mana saja di repositori
Contoh berkas:
listfile:list.txt membaca daftar dari list.txt dengan satu pola file per baris
listfile0:list.txt membaca daftar dari list.txt dengan pembatas byte nol
Lihat juga hg membantu kumpulan file.
Sertakan contoh:
include:path/to/mypatternfile membaca pola untuk diterapkan ke semua jalur
subinclude:path/to/subignorefile membaca pola khusus untuk jalur di
subdirektori
KERJA DENGAN TAHAP
Apa adalah fase?
Fase adalah sistem untuk melacak set perubahan mana yang telah atau harus dibagikan. Ini
membantu mencegah kesalahan umum saat memodifikasi riwayat (misalnya, dengan mq atau rebase
ekstensi).
Setiap perubahan dalam repositori berada di salah satu fase berikut:
· publik : changeset terlihat di server publik
· draft : changeset belum dipublikasikan
· rahasia : changeset tidak boleh didorong, ditarik, atau dikloning
Fase-fase ini dipesan (publik < draft < rahasia) dan tidak ada perubahan yang dapat dilakukan di bawah
fase dari nenek moyangnya. Misalnya, jika suatu changeset bersifat publik, semua leluhurnya adalah
juga publik. Terakhir, fase changeset seharusnya hanya diubah menuju fase publik.
Seterpercayaapakah Olymp Trade? Kesimpulan adalah fase dikelola?
Untuk sebagian besar, fase harus bekerja secara transparan. Secara default, sebuah changeset dibuat di
fase draft dan dipindahkan ke fase publik ketika didorong ke yang lain
gudang.
Setelah perubahan menjadi publik, ekstensi seperti mq dan rebase akan menolak untuk beroperasi
mereka untuk mencegah membuat duplikat changesets. Fase juga dapat dimanipulasi secara manual
pada pengatur terkenal. Pengatur ini menawarkan bantuan hukum kepada traderapabila trader berselisih dengan broker yang terdaftar dengan mereka. hg tahap perintah jika diperlukan. Melihat hg membantu -v tahap untuk contoh.
Untuk membuat komit Anda menjadi rahasia secara default, letakkan ini di file konfigurasi Anda:
[fase]
komitmen baru = rahasia
Fase dan server
Biasanya, semua server adalah penerbitan secara default. Ini berarti:
- semua rancangan perubahan yang ditarik atau dikloning muncul dalam fase
publik pada klien
- semua draf perubahan yang didorong muncul sebagai publik di keduanya
klien dan server
- perubahan rahasia tidak didorong, ditarik, atau dikloning
Catatan Menarik draf changeset dari server penerbitan tidak menandainya sebagai publik di
sisi server karena sifat tarik hanya-baca.
Kadang-kadang mungkin diinginkan untuk mendorong dan menarik perubahan dalam fase konsep untuk dibagikan
pekerjaan yang belum selesai. Ini dapat dilakukan dengan mengatur repositori untuk menonaktifkan penerbitan di .-nya
file konfigurasi:
[fase]
terbitkan = Salah
Lihat hg membantu config untuk informasi lebih lanjut tentang file konfigurasi.
Catatan Server yang menjalankan versi Mercurial yang lebih lama diperlakukan sebagai penerbitan.
Catatan Perubahan dalam fase rahasia tidak ditukar dengan server. Ini berlaku untuk mereka
konten: nama file, konten file, dan metadata changeset. Untuk alasan teknis,
pengenal (misalnya d825e4025e39) dari set perubahan rahasia dapat dikomunikasikan ke
server.
contoh
· daftar perubahan dalam fase draf atau rahasia:
hg log -r "bukan publik ()"
· ubah semua perubahan rahasia menjadi draf:
fase hg --draft "rahasia ()"
· pindahkan secara paksa set perubahan dan turunan saat ini dari publik ke draf:
fase hg --force --draft .
· tampilkan daftar revisi dan fase changeset:
hg log --template "{rev} {fase}\n"
· menyinkronkan ulang draft perubahan yang terkait dengan repositori jarak jauh:
hg fase -fd "keluar(URL)"
Lihat hg membantu tahap untuk informasi lebih lanjut tentang manipulasi fase secara manual.
SPESIFIKASI TUNGGAL REVISI
Mercurial mendukung beberapa cara untuk menentukan revisi individu.
Sebuah bilangan bulat biasa diperlakukan sebagai nomor revisi. Bilangan bulat negatif diperlakukan sebagai
offset berurutan dari ujung, dengan -1 menunjukkan ujung, -2 menunjukkan revisi sebelumnya
ke ujung, dan lain sebagainya.
String heksadesimal 40 digit diperlakukan sebagai pengenal revisi unik.
String heksadesimal yang panjangnya kurang dari 40 karakter diperlakukan sebagai revisi unik
pengidentifikasi dan disebut sebagai pengidentifikasi bentuk pendek. Pengidentifikasi bentuk pendek hanya
valid jika itu adalah awalan dari tepat satu pengidentifikasi panjang penuh.
String lainnya diperlakukan sebagai bookmark, tag, atau nama cabang. Bookmark adalah benda bergerak
penunjuk ke revisi. Tag adalah nama permanen yang terkait dengan revisi. Nama cabang
menunjukkan kepala cabang terbuka paling ujung dari cabang itu - atau jika semuanya tertutup,
kepala cabang paling ujung tertutup. Bookmark, tag, dan nama cabang tidak boleh mengandung
karakter ":".
Nama "tip" yang dicadangkan selalu mengidentifikasi revisi terbaru.
Nama yang dicadangkan "null" menunjukkan revisi nol. Ini adalah revisi dari yang kosong
repositori, dan induk dari revisi 0.
Nama yang dipesan "." menunjukkan induk direktori kerja. Jika tidak ada direktori kerja adalah
diperiksa, itu setara dengan nol. Jika penggabungan yang tidak dikomit sedang berlangsung, "." adalah
revisi orang tua pertama.
SPESIFIKASI TINJAUAN SETS
Mercurial mendukung bahasa fungsional untuk memilih satu set revisi.
Bahasa ini mendukung sejumlah predikat yang digabungkan oleh operator infiks.
Tanda kurung dapat digunakan untuk pengelompokan.
Pengidentifikasi seperti nama cabang mungkin perlu mengutip dengan tanda kutip tunggal atau ganda jika mereka
mengandung karakter seperti - atau jika mereka cocok dengan salah satu predikat yang telah ditentukan sebelumnya.
Karakter khusus dapat digunakan dalam pengidentifikasi yang dikutip dengan menghindarinya, misalnya, \n is
diartikan sebagai baris baru. Untuk mencegahnya diinterpretasikan, string dapat diawali
dengan r, misalnya R'...'.
Ada satu operator awalan:
tidak x
Changesets tidak di x. Bentuk singkatnya adalah ! x.
Ini adalah operator infix yang didukung:
x::y
Rentang DAG, artinya semua set perubahan yang merupakan turunan dari x dan nenek moyang dari y,
termasuk x dan y sendiri. Jika titik akhir pertama ditinggalkan, ini setara
untuk nenek moyang (y), jika yang kedua ditinggalkan itu setara dengan keturunan (x).
Sintaks alternatifnya adalah x..y.
x:y
Semua set perubahan dengan nomor revisi antara x dan y, keduanya inklusif. Salah satu
titik akhir dapat ditinggalkan, mereka default ke 0 dan tip.
x dan y
Perpotongan himpunan perubahan di x dan y. Bentuk singkatnya adalah x & y.
x or y
Gabungan himpunan perubahan di x dan y. Ada dua alternatif bentuk pendek: x | y
dan x + y.
x - y
Perubahan di x tetapi tidak di y.
x^n
Induk ke-n dari x, n == 0, 1, atau 2. Untuk n == 0, x; untuk n == 1, orang tua pertama
dari setiap perubahan dalam x; untuk n == 2, parent kedua dari changeset di x.
x~n
Nenek moyang pertama ke-n dari x; x~0 adalah x; x~3 is x^^^.
Ada satu operator postfix:
x^
Setara dengan x^1, orang tua pertama dari setiap perubahan di x.
Predikat berikut didukung:
menambahkan (pola)
Perubahan yang menambahkan pola pencocokan file.
Pola tanpa jenis eksplisit seperti gumpal: diharapkan relatif terhadap
direktori saat ini dan cocok dengan file atau direktori.
semua()
Semua perubahan, sama seperti 0: tip.
leluhur (*perubahan)
Nenek moyang terbesar dari perubahan.
Menerima 0 atau lebih set perubahan. Akan mengembalikan daftar kosong ketika melewati tidak ada argumen.
Nenek moyang terbesar dari satu changeset adalah changeset itu.
nenek moyang (set)
Changesets yang merupakan nenek moyang dari changeset di set.
penulis (string)
Alias untuk pengguna (string).
membagi dua (string)
Perubahan yang ditandai dalam status membagi dua yang ditentukan:
· baik, buruk, melewatkan: csets secara eksplisit ditandai sebagai baik/buruk/lewati
· barang, buruk : cset secara topologi baik/buruk
· jarak : cset mengambil bagian dalam biseksi
· dipangkas : csets yang barang, buruk atau dilewati
· belum dicoba : cset yang nasibnya belum diketahui
· diabaikan : cset diabaikan karena topologi DAG
· arus : cset saat ini sedang dibelah
penanda([nama])
Bookmark bernama atau semua bookmark.
If nama dimulai dengan kembali:, sisa nama diperlakukan sebagai biasa
ekspresi. Untuk mencocokkan bookmark yang sebenarnya dimulai dengan kembali:, gunakan awalan
harfiah:.
cabang (string or mengatur)
Semua set perubahan milik cabang yang diberikan atau cabang yang diberikan
perubahan
If tali dimulai dengan kembali:, sisa nama diperlakukan sebagai biasa
ekspresi. Untuk mencocokkan cabang yang sebenarnya dimulai dengan kembali:, gunakan awalan
harfiah:.
titik cabang()
Changesets dengan lebih dari satu anak.
terbentur()
Kumpulan perubahan yang dapat diubah ditandai sebagai penerus kumpulan perubahan publik.
Hanya perubahan non-publik dan non-usang yang dapat terbentur.
bundel()
Perubahan dalam bundel.
Bundel harus ditentukan oleh opsi -R.
anak-anak (set)
Anak changeset dari changeset di set.
tertutup()
Changeset ditutup.
berisi (pola)
Manifes revisi berisi pola pencocokan file (tetapi mungkin tidak mengubahnya).
Lihat hg membantu pola untuk informasi tentang pola file.
Pola tanpa jenis eksplisit seperti gumpal: diharapkan relatif terhadap
direktori saat ini dan cocokkan dengan file persis untuk efisiensi.
dikonversi([id])
Perubahan yang dikonversi dari pengidentifikasi yang diberikan di repositori lama jika ada, atau
semua perubahan yang dikonversi jika tidak ada pengenal yang ditentukan.
tanggal (interval)
Perubahan dalam interval, lihat hg membantu tanggal.
deskripsi(string)
Cari pesan komit untuk string. Pencocokan tidak peka huruf besar/kecil.
keturunan (set)
Changesets yang merupakan turunan dari changesets di set.
tujuan([set])
Perubahan yang dibuat oleh operasi cangkok, transplantasi, atau rebase, dengan
revisi yang diberikan ditentukan sebagai sumber. Menghilangkan set opsional sama dengan
melewati semua().
berbeda()
Penerus terakhir dari rangkaian perubahan dengan rangkaian alternatif penerus akhir.
minuman()
Changeset dalam fase draft.
punah()
Kumpulan perubahan usang dengan turunan usang saja.
tambahan (label, [nilai])
Perubahan dengan label yang diberikan dalam metadata tambahan, dengan opsi yang diberikan
nilai.
If nilai dimulai dengan kembali:, sisa nilai diperlakukan sebagai regular
ekspresi. Untuk mencocokkan nilai yang sebenarnya dimulai dengan kembali:, gunakan awalan
harfiah:.
berkas (pola)
Perubahan yang memengaruhi file yang dicocokkan dengan pola.
Untuk hasil yang lebih cepat tetapi kurang akurat, pertimbangkan untuk menggunakan log file() sebagai gantinya.
Predikat ini menggunakan gumpal: sebagai jenis pola default.
filelog(pola)
Changesets terhubung ke filelog yang ditentukan.
Untuk alasan kinerja, hanya mengunjungi revisi yang disebutkan dalam filelog tingkat file,
daripada memfilter semua perubahan (jauh lebih cepat, tetapi tidak termasuk
menghapus atau menggandakan perubahan). Untuk hasil yang lebih lambat dan lebih akurat, gunakan mengajukan().
Pola tanpa jenis eksplisit seperti gumpal: diharapkan relatif terhadap
direktori saat ini dan cocokkan dengan file persis untuk efisiensi.
Jika beberapa linkrev menunjuk ke revisi yang difilter oleh tinjauan ulang saat ini, kami akan bekerja
di sekitarnya untuk mengembalikan nilai yang tidak difilter.
pertama (mengatur, [N])
Alias untuk limit().
ikuti([pola])
Sebuah alias untuk ::. (leluhur dari induk pertama direktori kerja). Jika pola
ditentukan, riwayat file yang cocok dengan pola yang diberikan diikuti, termasuk:
eksemplar.
grep(regex)
Seperti kata kunci (string) tetapi menerima ekspresi reguler. Menggunakan grep(r'...') untuk memastikan pelarian khusus
karakter ditangani dengan benar. Tidak seperti kata kunci (string), pertandingannya adalah
hal - hal sensitif.
kepala()
Changeset adalah kepala cabang bernama.
kepala (set)
Anggota himpunan tanpa anak dalam himpunan.
tersembunyi()
Perubahan tersembunyi.
id(tali)
Revisi ditentukan secara tidak ambigu oleh awalan string heksadesimal yang diberikan.
kata kunci (string)
Cari pesan komit, nama pengguna, dan nama file yang diubah untuk string. Pertandingan
tidak peka huruf besar/kecil.
terakhir (mengatur, [N])
N anggota terakhir dari set, default ke 1.
batas(tetapkan[, N[, mengimbangi]])
N anggota set pertama, default ke 1, mulai dari offset.
pencocokan (revisi [, bidang])
Changesets di mana satu set bidang tertentu cocok dengan set bidang di yang dipilih
revisi atau ditetapkan.
Untuk mencocokkan lebih dari satu bidang, berikan daftar bidang yang akan dicocokkan yang dipisahkan oleh spasi
(misalnya penulis deskripsi).
Bidang yang valid adalah bidang revisi paling reguler dan beberapa bidang khusus.
Bidang revisi reguler adalah deskripsi, penulis, cabang, tanggal, arsip, tahap,
orangtua, subnegara bagian, pemakai dan diff. Catat itu penulis dan pemakai adalah sinonim. diff
mengacu pada isi revisi. Dua revisi yang cocok dengan mereka diff juga akan
cocok dengan mereka arsip.
Bidang khusus adalah ringkasan dan metadata: ringkasan cocok dengan baris pertama
deskripsi. metadata setara dengan pencocokan deskripsi pemakai tanggal (yaitu itu
cocok dengan bidang metadata utama).
metadata adalah bidang default yang digunakan ketika tidak ada bidang yang ditentukan. Kamu bisa
mencocokkan lebih dari satu bidang sekaligus.
maks (setel)
Changeset dengan nomor revisi tertinggi di set.
menggabungkan()
Changeset adalah gabungan changeset.
menit(set)
Changeset dengan nomor revisi terendah di set.
memodifikasi (pola)
Changesets memodifikasi file yang cocok dengan pola.
Pola tanpa jenis eksplisit seperti gumpal: diharapkan relatif terhadap
direktori saat ini dan cocok dengan file atau direktori.
bernama(ruang nama)
Perubahan dalam namespace yang diberikan.
If namespace dimulai dengan kembali:, sisa string diperlakukan sebagai regular
ekspresi. Untuk mencocokkan namespace yang sebenarnya dimulai dengan kembali:, gunakan awalan
harfiah:.
usang()
Perubahan yang dapat diubah dengan versi yang lebih baru.
hanya (setel, [mengatur])
Perubahan yang merupakan nenek moyang dari himpunan pertama yang bukan nenek moyang dari yang lain
kepala di repo. Jika set kedua ditentukan, hasilnya adalah nenek moyang dari
himpunan pertama yang bukan merupakan nenek moyang dari himpunan kedua (yaitu :: - :: ).
asal([set])
Perubahan yang ditentukan sebagai sumber untuk cangkok, transplantasi, atau rebase
yang membuat revisi yang diberikan. Menghilangkan set opsional sama dengan melewatkan
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 yang
terpilih.
keluar([jalur])
Perubahan tidak ditemukan di repositori tujuan yang ditentukan, atau push default
lokasi.
p1([kumpulan])
Orang tua pertama dari perubahan di set, atau direktori kerja.
p2([kumpulan])
Induk kedua dari perubahan di set, atau direktori kerja.
orang tua([set])
Himpunan semua orang tua untuk semua perubahan di set, atau direktori kerja.
hadir (set)
Sebuah set kosong, jika ada revisi di set tidak ditemukan; jika tidak, semua revisi di set.
Jika ada revisi yang ditentukan tidak ada di repositori lokal, kuerinya adalah
biasanya dibatalkan. Tetapi predikat ini memungkinkan kueri untuk melanjutkan bahkan dalam keadaan seperti itu
Kasus.
publik()
Changeset dalam fase publik.
jarak jauh([id [,jalur]])
Revisi lokal yang sesuai dengan pengenal yang diberikan dalam repositori jarak jauh, jika
hadiah. Di sini, '.' pengenal adalah sinonim untuk cabang lokal saat ini.
menghapus (pola)
Changesets yang menghapus pola pencocokan file.
Pola tanpa jenis eksplisit seperti gumpal: diharapkan relatif terhadap
direktori saat ini dan cocok dengan file atau direktori.
putaran (angka)
Revisi dengan pengenal numerik yang diberikan.
terbalik (set)
Urutan kebalikan dari himpunan.
akar (set)
Changesets di set tanpa perubahan induk di set.
rahasia()
Changeset dalam fase rahasia.
urutkan(atur[, [-]kunci...])
Urutkan diatur oleh kunci. Urutan pengurutan default adalah menaik, tentukan kunci sebagai -kunci untuk
mengurutkan dalam urutan menurun.
Kuncinya bisa berupa:
· putaran untuk nomor revisi
· cabang untuk nama cabang,
· desc untuk pesan komit (deskripsi),
· pemakai untuk nama pengguna (penulis dapat digunakan sebagai alias),
· tanggal untuk tanggal komitmen
subrepo([pola])
Changesets yang menambah, mengubah atau menghapus subrepo yang diberikan. Jika tidak ada pola subrepo adalah
bernama, setiap perubahan subrepo dikembalikan.
tanda ([nama])
Tag yang ditentukan berdasarkan nama, atau semua revisi yang ditandai jika tidak ada nama yang diberikan.
If nama dimulai dengan kembali:, sisa nama diperlakukan sebagai biasa
ekspresi. Untuk mencocokkan tag yang sebenarnya dimulai dengan kembali:, gunakan awalan harfiah:.
tidak stabil()
Perubahan yang tidak usang dengan leluhur yang sudah usang.
pengguna (string)
Nama pengguna berisi string. Pencocokan tidak peka huruf besar/kecil.
If tali dimulai dengan kembali:, sisa string diperlakukan sebagai regular
ekspresi. Untuk mencocokkan pengguna yang benar-benar berisi kembali:, gunakan awalan harfiah:.
Predikat baru (dikenal sebagai "alias") dapat ditentukan, menggunakan kombinasi apa pun dari yang ada
predikat atau alias lainnya. Definisi alias terlihat seperti:
=
dalam revsetalias.dll bagian dari file konfigurasi Mercurial. Argumen bentuk $1,
$2, dll. diganti dari alias ke dalam definisi.
Sebagai contoh,
[revsetalia]
h = kepala()
d($1) = urutkan($1, tanggal)
rs($1, $2) = terbalik(urutkan($1, $2))
mendefinisikan tiga alias, h, d, dan rs. rs(0:tips, Pengarang) persis sama dengan
terbalik(sort(0:tip, Pengarang)).
Operator infiks ## dapat menggabungkan string dan pengidentifikasi menjadi satu string. Sebagai contoh:
[revsetalia]
issue($1) = grep(r'\bissue[ :]?' ## $1 ## r'\b|\bbug\(' ## $1 ## r'\)')
isu(1234) adalah setara dengan grep(r'\bmasalah[ :]?1234\b|\bbug\(1234\)') pada kasus ini. Ini
cocok dengan semua "issue 1234", "issue:1234", "issue1234" dan "kesalahan(1234) ".
Semua operator prefiks, infiks, dan postfiks lainnya memiliki prioritas lebih rendah daripada ##. Sebagai contoh, $1
## $ 2 ~ 2 adalah setara dengan ($ 1 ## $2)~2.
Setara baris perintah untuk hg mencatat:
-f -> ::.
-dx -> tanggal(x)
-kx -> kata kunci(x)
-m -> gabungkan()
-ux -> pengguna(x)
-bx -> cabang(x)
-Px -> !::x
-lx -> batas (expr, x)
Beberapa contoh kueri:
· Perubahan pada cabang default:
hg log -r "cabang (default)"
· Perubahan pada cabang default sejak tag 1.5 (tidak termasuk penggabungan):
hg log -r "branch(default) dan 1.5:: dan bukan merge()"
· Buka kepala cabang:
hg log -r "head() dan tidak ditutup()"
· Perubahan antara tag 1.3 dan 1.5 yang menyebutkan "bug" yang mempengaruhi hgext/*:
hg log -r "1.3::1.5 dan kata kunci(bug) dan file('hgext/*')"
· Perubahan yang dilakukan pada Mei 2008, diurutkan berdasarkan pengguna:
hg log -r "sort(date('Mei 2008'), pengguna)"
· Perubahan yang menyebutkan "bug" atau "masalah" yang tidak ada dalam rilis yang diberi tag:
hg log -r "(kata kunci(bug) atau kata kunci(masalah)) dan bukan leluhur(tag())"
MENGGUNAKAN LINCAH DARI SKRIP DAN OTOMATISASI
Adalah umum bagi mesin (sebagai lawan dari manusia) untuk mengkonsumsi Mercurial. Topik bantuan ini
menjelaskan beberapa pertimbangan untuk menghubungkan mesin dengan Mercurial.
Memilih an Antarmuka
Mesin memiliki pilihan beberapa metode untuk berinteraksi dengan Mercurial. Ini termasuk:
· Melaksanakan hg proses
· Meminta server HTTP
· Memanggil ke server perintah
Pelaksana hg prosesnya sangat mirip dengan bagaimana manusia berinteraksi dengan Mercurial di dalam cangkang.
Seharusnya sudah tidak asing lagi bagi Anda.
hg melayani dapat digunakan untuk memulai server. Secara default, ini akan memulai server HTTP "hgweb".
Server HTTP ini memiliki dukungan untuk output yang dapat dibaca mesin, seperti JSON. Untuk lebih lanjut, lihat hg
membantu hgweb.
hg melayani juga dapat memulai "server perintah." Klien dapat terhubung ke server ini dan mengeluarkan
Perintah lincah melalui protokol khusus. Untuk detail lebih lanjut tentang server perintah,
termasuk tautan ke pustaka klien, lihat https://mercurial.selenic.com/wiki/CommandServer.
hg melayani antarmuka berbasis (hgweb dan server perintah) memiliki keunggulan dibandingkan yang sederhana
hg proses pemanggilan karena kemungkinan lebih efisien. Ini karena ada
overhead yang signifikan untuk menelurkan proses Python baru.
Tip Jika Anda perlu memanggil beberapa hg proses dalam waktu singkat dan/atau kinerja adalah
penting bagi Anda, penggunaan antarmuka berbasis server sangat dianjurkan.
Lingkungan Hidup Variabel
Seperti yang didokumentasikan dalam hg membantu lingkungan Hidup, berbagai variabel lingkungan mempengaruhi
pengoperasian Mercurial. Berikut ini sangat relevan untuk penggunaan mesin:
Lincah:
HGPLAIN
Jika tidak disetel, keluaran Mercurial dapat dipengaruhi oleh pengaturan konfigurasi yang
memengaruhi penyandiannya, mode verbose, lokalisasi, dll.
Sangat disarankan bagi mesin untuk mengatur variabel ini saat memanggil hg
proses.
HGENCODING
Jika tidak disetel, lokal yang digunakan oleh Mercurial akan dideteksi dari lingkungan. Jika
lokal yang ditentukan tidak mendukung tampilan karakter tertentu, Mercurial mungkin
membuat urutan karakter ini salah (sering dengan menggunakan "?" sebagai pengganti
untuk karakter yang tidak valid di lokal saat ini).
Menetapkan variabel lingkungan ini secara eksplisit adalah praktik yang baik untuk menjamin
hasil yang konsisten. "utf-8" adalah pilihan yang baik pada lingkungan seperti UNIX.
HGRCPATH
Jika tidak disetel, Mercurial akan mewarisi opsi konfigurasi dari file konfigurasi menggunakan
proses yang dijelaskan dalam hg membantu config. Ini termasuk mewarisi pengguna atau seluruh sistem
file konfigurasi.
Ketika kontrol penuh atas konfigurasi Mercurial diinginkan, nilai
HGRCPATH dapat diatur ke file eksplisit dengan konfigurasi bagus yang diketahui. Dalam kasus yang jarang terjadi,
nilai dapat diatur ke file kosong atau perangkat nol (seringkali / dev / null) untuk melewati
memuat file konfigurasi pengguna atau sistem. Perhatikan bahwa pendekatan ini dapat memiliki
konsekuensi yang tidak diinginkan, karena file konfigurasi pengguna dan sistem sering menentukan sesuatu
seperti nama pengguna dan ekstensi yang mungkin diperlukan untuk berinteraksi dengan a
gudang.
Mengkonsumsi perintah Keluaran
Adalah umum bagi mesin untuk perlu mengurai output dari perintah Mercurial untuk yang relevan
data. Bagian ini menjelaskan berbagai teknik untuk melakukannya.
Penguraian Mentah perintah Keluaran
Kemungkinan solusi paling sederhana dan paling efektif untuk menggunakan output perintah adalah dengan
memohon hg perintah seperti yang Anda lakukan sebagai pengguna dan mengurai outputnya.
Output dari banyak perintah dapat dengan mudah diuraikan dengan alat-alat seperti grep, sed, dan Wow.
Kelemahan potensial dengan output perintah parsing adalah output dari perintah dapat berubah
ketika Mercurial ditingkatkan. Sementara Mercurial umumnya berusaha keras untuk mundur
kompatibilitas, keluaran perintah terkadang berubah. Memiliki tes untuk otomatis Anda
interaksi dengan hg perintah umumnya direkomendasikan, tetapi bahkan lebih penting ketika
parsing output perintah mentah terlibat.
Menggunakan template untuk kontrol Keluaran
Banyak hg perintah mendukung output yang ditemplatkan melalui -T/--templat argumen. Untuk lebih lanjut, lihat
hg membantu template.
Template berguna untuk mengontrol output secara eksplisit sehingga Anda mendapatkan data yang tepat
Anda ingin diformat seperti yang Anda inginkan. Sebagai contoh, mencatat -T {simpul}\n dapat digunakan untuk mencetak
daftar node changeset yang dibatasi baris baru alih-alih output yang disesuaikan dengan manusia yang berisi
penulis, tanggal, deskripsi, dll.
Tip Jika mengurai output perintah mentah terlalu rumit, pertimbangkan untuk menggunakan template untuk membuat
hidup Anda lebih mudah.
Grafik -T/--templat argumen memungkinkan menentukan gaya yang telah ditentukan sebelumnya. Kapal Mercurial dengan
gaya yang dapat dibaca mesin json dan xml, yang masing-masing menyediakan keluaran JSON dan XML.
Ini berguna untuk menghasilkan output yang dapat dibaca mesin apa adanya.
penting
Grafik json dan xml gaya dianggap eksperimental. Meskipun mereka mungkin menarik
digunakan untuk mendapatkan keluaran yang dapat dibaca mesin dengan mudah, perilakunya dapat berubah dalam
versi-versi berikutnya.
Gaya-gaya ini juga dapat menunjukkan hasil yang tidak terduga ketika berhadapan dengan tertentu
pengkodean. Mercurial memperlakukan hal-hal seperti nama file sebagai serangkaian byte dan
menormalkan urutan byte tertentu ke JSON atau XML dengan pengaturan pengkodean tertentu
dapat menimbulkan kejutan.
perintah Server Keluaran
Jika menggunakan server perintah untuk berinteraksi dengan Mercurial, kemungkinan besar Anda menggunakan yang sudah ada
library/API yang mengabstraksi detail implementasi dari server perintah. Jika demikian, ini
lapisan antarmuka dapat melakukan penguraian untuk Anda, menghemat pekerjaan Anda untuk mengimplementasikannya
dirimu sendiri.
Keluaran Verbositas
Perintah sering kali memiliki verbositas keluaran yang bervariasi, bahkan ketika gaya yang dapat dibaca mesin sedang
digunakan (misalnya -T json). menambahkan -v/--bertele-tele dan --debug untuk argumen perintah bisa
meningkatkan jumlah data yang diekspos oleh Mercurial.
Cara alternatif untuk mendapatkan data yang Anda butuhkan adalah dengan menentukan template secara eksplisit.
Lainnya Topik
revset
Kumpulan revisi adalah bahasa kueri fungsional untuk memilih kumpulan revisi.
Anggap saja sebagai SQL untuk repositori Mercurial. Revsets berguna untuk query
penyimpanan untuk data tertentu.
Lihat hg membantu revset untuk lebih.
'share' perpanjangan
Grafik 'share' ekstensi menyediakan fungsionalitas untuk berbagi data repositori di seluruh
beberapa copy pekerjaan. Itu bahkan dapat secara otomatis "mengumpulkan" penyimpanan secara logis
repositori terkait saat kloning.
Mengonfigurasi 'share' ekstensi dapat menyebabkan pemanfaatan sumber daya yang signifikan
pengurangan, terutama di sekitar ruang disk dan jaringan. Ini terutama benar
untuk lingkungan integrasi berkelanjutan (CI).
Lihat hg membantu -e 'share' untuk lebih.
SUBREPOSITORI
Subrepositori memungkinkan Anda menyarangkan repositori atau proyek eksternal ke dalam Mercurial induk
repositori, dan membuat perintah beroperasi pada mereka sebagai sebuah grup.
Mercurial saat ini mendukung subrepositori Mercurial, Git, dan Subversion.
Subrepositori terbuat dari tiga komponen:
1. Checkout repositori bersarang. Mereka dapat muncul di mana saja di direktori kerja induk.
2. Referensi repositori bersarang. Mereka didefinisikan dalam .hgsub, yang harus ditempatkan di
root direktori kerja, dan beri tahu dari mana checkout subrepositori berasal.
Subrepositori Mercurial dirujuk seperti:
path/ke/bersarang = https://example.com/nested/repo/path
Subrepo Git dan Subversion juga didukung:
path/ke/bersarang = [git]git://example.com/nested/repo/path
path/ke/bersarang = [svn]https://example.com/nested/trunk/path
dimana jalan/ke/bersarang adalah lokasi checkout relatif terhadap root Mercurial induk,
dan https://example.com/nested/repo/path adalah jalur repositori sumber. Sumbernya bisa
juga mereferensikan jalur sistem file.
Perhatikan bahwa .hgsub tidak ada secara default di repositori Mercurial, Anda harus
buat dan tambahkan ke repositori induk sebelum menggunakan subrepositori.
3. Status repositori bersarang. Mereka didefinisikan dalam .hgsubstat, yang ditempatkan di akar
direktori kerja, dan menangkap informasi apa pun yang diperlukan untuk memulihkan
subrepositori ke keadaan yang mereka komit dalam perubahan repositori induk.
Mercurial secara otomatis merekam status repositori bersarang saat melakukan di
gudang induk.
Note
Grafik .hgsubstat file tidak boleh diedit secara manual.
Menambahkan a Subrepositori
If .hgsub tidak ada, buat dan tambahkan ke repositori induk. Klon atau checkout
proyek eksternal di mana Anda ingin tinggal di repositori induk. Sunting .hgsub dan
tambahkan entri subrepositori seperti yang dijelaskan di atas. Pada titik ini, subrepositori adalah
dilacak dan komit berikutnya akan merekam statusnya di .hgsubstat dan mengikatnya ke
perubahan yang dilakukan.
Sinkronisasi a Subrepositori
Subrepos tidak secara otomatis melacak perubahan terbaru dari sumbernya. Sebaliknya, mereka
diperbarui ke changeset yang sesuai dengan changeset yang diperiksa di
perubahan tingkat atas. Ini agar pengembang selalu mendapatkan kumpulan kode yang kompatibel secara konsisten
dan perpustakaan saat mereka memperbarui.
Dengan demikian, memperbarui subrepos adalah proses manual. Cukup periksa subrepo target di
revisi yang diinginkan, uji di repo tingkat atas, lalu komit di repositori induk ke
merekam kombinasi baru.
menghapus a Subrepositori
Untuk menghapus subrepositori dari repositori induk, hapus referensinya dari .hgsub,
kemudian hapus file nya.
Interaksi dengan lincah Perintah
menambahkan add tidak berulang dalam subrepos kecuali -S/--subrepos ditentukan. Namun, jika
Anda menentukan path lengkap file dalam subrepo, itu akan ditambahkan bahkan tanpa
-S/--subrepos ditentukan. Subrepositori subversi saat ini diam-diam
diabaikan.
hapus
addremove tidak berulang menjadi subrepos kecuali -S/--subrepos ditentukan.
Namun, jika Anda menentukan path lengkap direktori di subrepo, addremove akan
dilakukan di atasnya bahkan tanpa -S/--subrepos ditentukan. Git dan Subversi
subrepositori akan mencetak peringatan dan melanjutkan.
arsip
arsip tidak berulang dalam subrepositori kecuali -S/--subrepos ditentukan.
kucing cat saat ini hanya menangani kecocokan file yang tepat di subrepos. Subversi
subrepositori saat ini diabaikan.
melakukan commit membuat snapshot yang konsisten dari status keseluruhan proyek dan
subrepositori. Jika ada subrepositori yang telah dimodifikasi, Mercurial akan dibatalkan.
Mercurial dapat dibuat untuk melakukan semua subrepositori yang dimodifikasi dengan menentukan
-S/--subrepos, atau menyetel "ui.commitsubrepos=True" dalam file konfigurasi (lihat hg
membantu config). Setelah tidak ada lagi subrepositori yang dimodifikasi, ia mencatat
status mereka dan akhirnya melakukan itu di repositori induk. --adremove
opsi juga menghormati opsi -S/--subrepos. Namun, Git dan Subversion
subrepositori akan mencetak peringatan dan membatalkan.
diff diff tidak berulang dalam subrepos kecuali -S/--subrepos ditentukan. Perubahan adalah
ditampilkan seperti biasa, pada elemen subrepositori. Subrepositori subversi adalah
saat ini diam-diam diabaikan.
arsip file tidak berulang menjadi subrepos kecuali -S/--subrepos ditentukan. Namun,
jika Anda menentukan path lengkap file atau direktori dalam subrepo, itu akan menjadi
ditampilkan bahkan tanpa -S/--subrepos ditentukan. Git dan Subversi
subrepositori saat ini diabaikan secara diam-diam.
lupa lupa saat ini hanya menangani kecocokan file yang tepat di subrepos. Git dan Subversi
subrepositori saat ini diabaikan secara diam-diam.
masuk
masuk tidak berulang dalam subrepos kecuali -S/--subrepos ditentukan. Git dan
Subrepositori subversi saat ini diabaikan secara diam-diam.
ramah
keluar tidak berulang dalam subrepos kecuali -S/--subrepos ditentukan. Git dan
Subrepositori subversi saat ini diabaikan secara diam-diam.
menarik tarik tidak rekursif karena tidak jelas apa yang harus ditarik sebelum dijalankan hg memperbarui
. Mencantumkan dan mengambil semua perubahan subrepositori yang dirujuk oleh induknya
repositori yang ditarik perubahan paling mahal, tidak mungkin di Subversion
kasus.
mendorong Mercurial akan secara otomatis mendorong semua subrepositori terlebih dahulu ketika induknya
repositori sedang didorong. Ini memastikan perubahan subrepositori baru tersedia
ketika direferensikan oleh repositori tingkat atas. Push adalah larangan untuk Subversion
subrepositori.
status status tidak berulang menjadi subrepositori kecuali -S/--subrepos ditentukan.
Perubahan subrepositori ditampilkan sebagai perubahan Mercurial biasa pada
elemen subrepositori. Subrepositori subversi saat ini diabaikan secara diam-diam.
menghapus hapus tidak muncul kembali ke dalam subrepositori kecuali -S/--subrepos ditentukan.
Namun, jika Anda menentukan jalur file atau direktori di subrepo, itu akan dihapus
bahkan tanpa -S/--subrepos. Subrepositori Git dan Subversion saat ini
diam-diam diabaikan.
memperbarui pembaruan mengembalikan subrepos dalam keadaan yang semula mereka lakukan di target
perubahan Jika set perubahan yang direkam tidak tersedia di subrepositori saat ini,
Mercurial akan menariknya terlebih dahulu sebelum memperbarui. Ini berarti bahwa memperbarui dapat
memerlukan akses jaringan saat menggunakan subrepositori.
Memetakan kembali Subrepositori sumber
Lokasi sumber subrepositori dapat berubah selama masa proyek, membuat referensi tidak valid
disimpan dalam riwayat repositori induk. Untuk memperbaikinya, aturan penulisan ulang dapat didefinisikan dalam
gudang induk hgrc file atau dalam konfigurasi Mercurial. Lihat [subpath] bagian dalam
hgrc(5) untuk lebih jelasnya.
TEMPLAT PENGGUNAAN
Mercurial memungkinkan Anda untuk menyesuaikan output dari perintah melalui template. Anda juga bisa
berikan templat atau pilih gaya templat yang ada dari baris perintah, melalui
--opsi template.
Anda dapat menyesuaikan keluaran untuk perintah "seperti log": log, keluar, masuk, tip,
orang tua, dan kepala.
Beberapa gaya bawaan dikemas dengan Mercurial. Ini dapat dicantumkan dengan hg mencatat
--templat daftar. Contoh penggunaan:
$ hg log -r1.0::1.1 --log perubahan templat
Templat adalah sepotong teks, dengan markup untuk menjalankan ekspansi variabel:
$ hg log -r1 --template "{simpul}\n"
b56ce7b07c52de7d5fd79fb89701ea538af65746
String dalam kurung kurawal disebut kata kunci. Ketersediaan kata kunci tergantung pada
konteks yang tepat dari templater. Kata kunci ini biasanya tersedia untuk templating a
perintah seperti log:
tanda aktif
Rangkaian. Bookmark aktif, jika dikaitkan dengan set perubahan
penulis Rangkaian. Penulis set perubahan yang tidak dimodifikasi.
membagi dua Rangkaian. Mengubah status dua bagian.
bookmark
Daftar string. Semua bookmark yang terkait dengan set perubahan. Juga set 'aktif',
nama penanda yang aktif.
cabang Rangkaian. Nama cabang tempat changeset dilakukan.
perubahansincelatesttag
Bilangan bulat. Semua leluhur tidak ada di tag terbaru.
anak-anak
Daftar string. Anak-anak dari changeset.
tanggal Informasi tanggal. Tanggal saat changeset dilakukan.
desc Rangkaian. Teks deskripsi changeset.
diffstat
Rangkaian. Statistik perubahan dengan format berikut: "file yang dimodifikasi:
+menambahkan/-menghapus baris"
ekstrak Daftar dicts dengan kunci, entri nilai bidang 'ekstra' dari changeset ini.
file_adds
Daftar string. File ditambahkan oleh changeset ini.
file_copy
Daftar string. File yang disalin dalam set perubahan ini dengan sumbernya.
file_copy_switch
Daftar string. Seperti "file_copies" tetapi hanya ditampilkan jika tombol --copied adalah
ditetapkan.
file_dels
Daftar string. File dihapus oleh changeset ini.
file_mods
Daftar string. File dimodifikasi oleh changeset ini.
arsip Daftar string. Semua file dimodifikasi, ditambahkan, atau dihapus oleh changeset ini.
simpul grafik
Rangkaian. Karakter yang mewakili node changeset dalam grafik revisi ASCII
tag terbaru
Daftar string. Tag global pada leluhur yang diberi tag global terbaru dari
perubahan ini.
jarak tag terbaru
Bilangan bulat. Jalur terpanjang ke tag terbaru.
ruang nama
Dikte daftar. Nama yang dilampirkan ke set perubahan ini per namespace.
simpul Rangkaian. Hash identifikasi changeset, sebagai string 40 digit heksadesimal.
p1node Rangkaian. Hash identifikasi dari induk pertama changeset, sebagai 40 digit
string heksadesimal. Jika set perubahan tidak memiliki orang tua, semua digit adalah 0.
p1rev Bilangan bulat. Nomor revisi repositori-lokal dari induk pertama changeset, atau
-1 jika set perubahan tidak memiliki orang tua.
p2node Rangkaian. Hash identifikasi dari induk kedua changeset, sebagai 40 digit
string heksadesimal. Jika changeset tidak memiliki induk kedua, semua digit adalah 0.
p2rev Bilangan bulat. Nomor revisi repositori-lokal dari induk kedua changeset, atau
-1 jika changeset tidak memiliki induk kedua.
orangtua
Daftar string. Orang tua dari changeset dalam format "rev:node". jika
changeset hanya memiliki satu induk "alami" (revisi pendahulunya) tidak ada
ditampilkan.
tahap Rangkaian. Nama fase changeset.
faseidx
Bilangan bulat. Indeks fase perubahan.
putaran Bilangan bulat. Nomor revisi changeset lokal-repositori.
subrepo
Daftar string. Subrepositori yang diperbarui di set perubahan.
tag Daftar string. Tag apa pun yang terkait dengan set perubahan.
Kata kunci "tanggal" tidak menghasilkan keluaran yang dapat dibaca manusia. Jika Anda ingin menggunakan tanggal di
output Anda, Anda dapat menggunakan filter untuk memprosesnya. Filter adalah fungsi yang mengembalikan a
string berdasarkan variabel input. Pastikan untuk menggunakan filter stringify terlebih dahulu saat Anda
menerapkan filter input string ke variabel input seperti daftar. Anda juga dapat menggunakan rantai
filter untuk mendapatkan output yang diinginkan:
$ hg tip --template "{tanggal|isodate}\n"
2008-08-21 18:22 +0000
Daftar filter:
tambahan
Teks apa pun. Tambahkan XHTML " " tag sebelum akhir setiap baris kecuali yang terakhir.
usia Tanggal. Mengembalikan perbedaan tanggal/waktu yang dapat dibaca manusia antara tanggal/waktu tertentu dan
tanggal/waktu saat ini.
nama dasar
Teks apa pun. Memperlakukan teks sebagai jalur, dan mengembalikan komponen terakhir jalur
setelah dipisah oleh pemisah jalur (mengabaikan pemisah trailing). Sebagai contoh,
"foo/bar/baz" menjadi "baz" dan "foo/bar//" menjadi "bar".
menghitung Daftar atau teks. Mengembalikan panjang sebagai bilangan bulat.
domain Teks apa pun. Menemukan string pertama yang terlihat seperti alamat email, dan mengekstrak
hanya komponen domain. Contoh: Pengguna <[email dilindungi]> menjadi example.com.
e-mail teks apapun. Ekstrak string pertama yang terlihat seperti alamat email. Contoh: Pengguna
<[email dilindungi]> menjadi [email dilindungi].
pengguna email
Teks apa pun. Mengembalikan bagian pengguna dari alamat email.
melarikan diri Teks apa pun. Mengganti karakter XML/XHTML khusus "&", "<" dan ">" dengan XML
entitas, dan menyaring karakter NUL.
isi68 Teks apa pun. Membungkus teks agar muat dalam 68 kolom.
isi76 Teks apa pun. Membungkus teks agar muat dalam 76 kolom.
garis pertama
Teks apa pun. Mengembalikan baris pertama teks.
hex Teks apa pun. Ubah pengidentifikasi simpul Mercurial biner menjadi heksadesimal panjangnya
perwakilan.
tanggal Tanggal. Mengembalikan tanggal sebagai pasangan angka: "1157407993 25200" (stempel waktu Unix,
offset zona waktu).
isodat
Tanggal. Mengembalikan tanggal dalam format ISO 8601: "2009-08-18 13:00 +0200".
isodatesec
Tanggal. Mengembalikan tanggal dalam format ISO 8601, termasuk detik: "2009-08-18 13:00:13
+0200". Lihat juga filter rfc3339date.
menurunkan Teks apa pun. Mengonversi teks menjadi huruf kecil.
kosong
Teks apa pun. Mengembalikan '(none)' jika string kosong.
menggelapkan
Teks apa pun. Mengembalikan teks input yang dirender sebagai urutan entitas XML.
orang Teks apa pun. Mengembalikan nama sebelum alamat email, menafsirkannya sesuai RFC
5322.
gambar ulang
Teks apa pun. Keluar dari semua karakter "khusus", kecuali @. Garis miring ke depan lolos
dua kali untuk mencegah server web melepaskannya sebelum waktunya. Misalnya, "@foo
bar/baz" menjadi "@foo%20bar%252Fbaz".
tanggal rfc3339
Tanggal. Mengembalikan tanggal menggunakan format tanggal Internet yang ditentukan dalam RFC 3339:
"2009-08-18T13:00:13+02:00".
tanggal rfc822
Tanggal. Mengembalikan tanggal menggunakan format yang sama dengan yang digunakan di header email: "Sel, 18 Agustus 2009
13:00:13 +0200".
pendek Ubah hash. Mengembalikan bentuk pendek dari hash changeset, yaitu 12 heksadesimal
string angka.
potongan pendek
Teks apa pun. suguhan teks sebagai status bagi dua, dan mengembalikan satu karakter
mewakili status (G: baik, B: buruk, S: dilewati, U: belum diuji, I: diabaikan).
Mengembalikan spasi tunggal jika teks bukan status pembelahan yang valid.
kencan singkat
Tanggal. Mengembalikan tanggal seperti "2006-09-18".
garis pemisah
Teks apa pun. Pisahkan teks menjadi daftar baris.
merangkai
Jenis apa pun. Mengubah nilai menjadi teks dengan mengubah nilai menjadi teks dan
menggabungkan mereka.
stripdir
Perlakukan teks sebagai jalur dan hapus level direktori, jika memungkinkan. Misalnya, "fo"
dan "foo/bar" menjadi "foo".
tabindent
Teks apa pun. Mengembalikan teks, dengan setiap baris yang tidak kosong kecuali yang pertama dimulai
dengan karakter tab.
atas Teks apa pun. Mengonversi teks menjadi huruf besar.
pelarian url
Teks apa pun. Melarikan diri dari semua karakter "khusus". Misalnya, "foo bar" menjadi
"foo%20bar".
pemakai Teks apa pun. Mengembalikan representasi singkat dari nama pengguna atau alamat email.
Perhatikan bahwa filter tidak lebih dari panggilan fungsi, yaitu ekspresi|filter setara
untuk filter (expr).
Selain filter, ada beberapa fungsi bawaan dasar:
tanggal(tanggal[, fmt])
Memformat tanggal. Melihat hg membantu tanggal untuk memformat string. Defaultnya adalah tanggal Unix
format, termasuk zona waktu: "Senin 04 Sep 15:13:13 2006 0700".
diff([termasuk pola [, kecualikan pola]])
Tampilkan perbedaan, secara opsional menentukan file yang akan disertakan atau dikecualikan.
isi(teks[, lebar[, identitas awal[, menggantung]]])
Isi banyak paragraf dengan indentasi opsional. Lihat filter "isi".
dapatkan (dikt, kunci)
Dapatkan atribut/kunci dari suatu objek. Beberapa kata kunci adalah tipe yang kompleks. Fungsi ini
memungkinkan Anda untuk mendapatkan nilai atribut pada jenis ini.
jika (expr, kemudian[, kalau tidak])
Eksekusi secara kondisional berdasarkan hasil ekspresi.
ifcontains(cari, benda, kemudian[, kalau tidak])
Eksekusi secara kondisional berdasarkan apakah item "pencarian" ada di "benda".
ifeq(ekspr1, ekspr2, kemudian[, kalau tidak])
Eksekusi secara kondisional berdasarkan apakah 2 item setara.
indentasi (teks, indentchar[, garis pertama])
Indentasi semua baris yang tidak kosong dengan karakter yang diberikan dalam string indentchars. Sebuah
parameter ketiga opsional akan menimpa indentasi untuk baris pertama hanya jika
menyajikan.
bergabung (daftar, Sep)
Gabung item dalam daftar dengan pembatas.
label (label, ekspr)
Terapkan label ke konten yang dihasilkan. Konten dengan label yang diterapkan dapat mengakibatkan
pasca-pemrosesan tambahan, seperti pewarnaan otomatis.
tag terbaru([pola])
Tag global yang cocok dengan pola yang diberikan pada tag global terbaru
nenek moyang dari perubahan ini.
tanggal lokal(tanggal[, tz])
Mengonversi tanggal ke zona waktu yang ditentukan. Standarnya adalah tanggal lokal.
pad (teks, lebar[, isichar=' '[, kanan=Salah]])
Pad teks dengan karakter isi.
setel ulang (permintaan[, formatarg...])
Jalankan kueri kumpulan revisi. Melihat hg membantu setel ulang.
rstdoc(teks, gaya)
Memformat ReStructuredText.
terpendek (simpul, panjang min=4)
Dapatkan representasi terpendek dari sebuah node.
dimulai dengan (pola, teks)
Mengembalikan nilai dari argumen "teks" jika dimulai dengan konten dari
argumen "pola".
strip(teks[, karakter])
Pisahkan karakter dari string. Secara default, hapus semua awal dan akhir
spasi.
sub(pola, penggantian, ekspresi)
Lakukan substitusi teks menggunakan ekspresi reguler.
kata (angka, teks[, pemisah])
Kembalikan kata ke-n dari sebuah string.
Juga, untuk ekspresi apa pun yang mengembalikan daftar, ada operator daftar:
expr % "{templat}"
Seperti yang terlihat pada contoh di atas, {templat} ditafsirkan sebagai pola. Untuk mencegahnya dari
sedang ditafsirkan, Anda dapat menggunakan karakter pelarian \{ atau awalan string mentah, R'...'.
Beberapa contoh templat baris perintah:
· Format daftar, misalnya file:
$ hg log -r 0 --template "file:\n{file % ' {file}\n'}"
· Bergabung dengan daftar file dengan ", ":
$ hg log -r 0 --template "file: {join(files, ', ')}\n"
· Ubah setiap baris deskripsi komit:
$ hg log --template "{splitlines(desc) % '**** {line}\n'}"
· Format tanggal:
$ hg log -r 0 --template "{tanggal(tanggal, '%Y')}\n"
· Tampilkan tanggal dalam UTC:
$ hg log -r 0 --template "{localdate(date, 'UTC')|date}\n"
· Keluarkan deskripsi yang disetel ke lebar isian 30:
$ hg log -r 0 --template "{isi(desc, 30)}"
· Gunakan kondisional untuk menguji cabang default:
$ hg log -r 0 --template "{ifeq(cabang, 'default', 'di cabang utama',
'di cabang {cabang}')}\n"
· Tambahkan baris baru jika tidak kosong:
$ hg tip --template "{jika(penulis, '{penulis}\n')}"
· Label output untuk digunakan dengan ekstensi warna:
$ hg log -r 0 --template "{label('changeset.{phase}', node|short)}\n"
· Balikkan filter baris pertama, yaitu semuanya kecuali baris pertama:
$ hg log -r 0 --template "{sub(r'^.*\n?\n?', '', desc)}\n"
· Menampilkan isi bidang 'ekstra', satu per baris:
$ hg log -r 0 --template "{join(extras, '\n')}\n"
· Tandai bookmark aktif dengan '*':
$ hg log --template "{bookmarks % '{bookmark}{ifeq(bookmark, aktif, '*')} '}\n"
· Temukan tag kandidat rilis sebelumnya, jarak dan perubahan sejak tag:
$hg log -r . --template "{latesttag('re:^.*-rc$') % '{tag}, {perubahan}, {jarak}'}\n"
· Tandai induk copy pekerjaan dengan '@':
$ hg log --template "{ifcontains(rev, revset('.'), '@')}\n"
· Tampilkan detail revisi orang tua:
$ hg log --template "{revset('parents(%d)', rev) % '{desc|firstline}\n'}"
· Hanya tampilkan deskripsi komit yang dimulai dengan "templat":
$ hg log --template "{startswith('template', firstline(desc))}\n"
· Cetak kata pertama dari setiap baris pesan komit:
$ hg log --template "{word(0, desc)}\n"
URL JALAN
URL yang valid berbentuk:
lokal/sistem file/jalur[#revisi]
file://local/filesystem/path[#revisi]
http://[user[:pass]@]host[:port]/[path][#revision]
https://[user[:pass]@]host[:port]/[path][#revision]
ssh://[pengguna@]host[:port]/[jalur][#revisi]
Jalur di sistem file lokal dapat menunjuk ke repositori Mercurial atau ke bundel
file (seperti yang dibuat oleh hg bundel or hg masuk --bundel). Lihat juga hg membantu jalan.
Pengidentifikasi opsional setelah # menunjukkan cabang, tag, atau set perubahan tertentu untuk digunakan
dari repositori jarak jauh. Lihat juga hg membantu revisi.
Beberapa fitur, seperti mendorong ke URL http:// dan https:// hanya dimungkinkan jika
fitur ini secara eksplisit diaktifkan di server Mercurial jarak jauh.
Perhatikan bahwa keamanan URL HTTPS bergantung pada konfigurasi web.cacerts yang tepat.
Beberapa catatan tentang penggunaan SSH dengan Mercurial:
· SSH memerlukan akun shell yang dapat diakses di mesin tujuan dan salinan hg in
jalur jarak jauh atau ditentukan dengan sebagai remotecmd.
· jalur relatif terhadap direktori home pengguna jarak jauh secara default. Gunakan garis miring ekstra di
awal jalur untuk menentukan jalur absolut:
ssh://example.com//tmp/repository
· Mercurial tidak menggunakan kompresinya sendiri melalui SSH; hal yang benar untuk dilakukan adalah mengkonfigurasi
itu di Anda ~ / .ssh / config, misalnya:
Tuan rumah *.mylocalnetwork.example.com
Kompresi tidak
Tuan rumah *
Kompresi ya
Atau tentukan "ssh -C" sebagai perintah ssh Anda di file konfigurasi Anda atau dengan
opsi baris perintah --ssh.
Semua URL ini dapat disimpan di file konfigurasi Anda dengan alias jalur di bawah
[jalur] bagian seperti ini:
[jalan]
alias1 = URL1
alias2 = URL2
...
Anda kemudian dapat menggunakan alias untuk perintah apa pun yang menggunakan URL (misalnya hg menarik alias1
akan diperlakukan sebagai hg menarik URL1).
Dua alias jalur khusus karena digunakan sebagai default saat Anda tidak memberikan
URL ke perintah:
default:
Saat Anda membuat repositori dengan hg clone, perintah clone menyimpan lokasi
repositori sumber sebagai jalur 'default' repositori baru. Ini kemudian digunakan
saat Anda menghilangkan jalur dari perintah seperti push dan pull (termasuk masuk dan
keluar).
default-push:
Perintah push akan mencari jalur bernama 'default-push', dan lebih memilihnya
'default' jika keduanya didefinisikan.
EKSTENSI
Bagian ini berisi bantuan untuk ekstensi yang didistribusikan bersama dengan Mercurial.
Bantuan untuk ekstensi lain tersedia di sistem bantuan.
acl
kait untuk mengontrol akses repositori
Kait ini memungkinkan untuk mengizinkan atau menolak akses tulis ke cabang dan jalur tertentu dari a
repositori saat menerima perubahan yang masuk melalui pretxnchangegroup dan pretxncommit.
Otorisasi dicocokkan berdasarkan nama pengguna lokal pada sistem tempat hook
berjalan, dan bukan pembuat dari set perubahan asli (karena yang terakhir hanyalah
informatif).
Kait acl paling baik digunakan bersama dengan cangkang terbatas seperti hgsh, mencegah
mengautentikasi pengguna dari melakukan apa pun selain mendorong atau menarik. Kaitnya tidak
aman digunakan jika pengguna memiliki akses shell interaktif, karena mereka kemudian dapat menonaktifkan hook. Juga bukan
apakah aman jika pengguna jarak jauh berbagi akun, karena tidak ada cara untuk membedakan
Mereka.
Urutan pemeriksaan akses yang dilakukan adalah:
1. Daftar penolakan untuk cabang (bagian acl.deny.branch)
2. Daftar izin untuk cabang (bagian acl.allow.branch)
3. Daftar tolak untuk jalur (bagian acl.deny)
4. Izinkan daftar jalur (bagian acl.izinkan)
Bagian izinkan dan tolak mengambil pasangan nilai kunci.
Berbasis cabang Mengakses kontrol
Gunakan acl.deny.branch dan acl.allow.branch bagian untuk memiliki akses berbasis cabang
kontrol. Kunci di bagian ini dapat berupa:
· nama cabang, atau
· tanda bintang, untuk mencocokkan cabang mana pun;
Nilai yang sesuai dapat berupa:
· daftar dipisahkan koma yang berisi pengguna dan grup, atau
· tanda bintang, untuk mencocokkan siapa pun;
Anda dapat menambahkan "!" awalan ke nama pengguna atau grup untuk membalikkan arti kecocokan.
Berbasis jalur Mengakses kontrol
Gunakan acl.deny dan acl.izinkan bagian untuk memiliki kontrol akses berbasis jalur. Kunci dalam ini
bagian menerima pola subpohon (dengan sintaks glob secara default). yang sesuai
nilai mengikuti sintaks yang sama seperti bagian lain di atas.
Grup
Nama grup harus diawali dengan @ simbol. Menentukan nama grup memiliki efek yang sama
sebagai menentukan semua pengguna dalam grup itu.
Anda dapat menentukan anggota grup di acl.groups bagian. Jika nama grup tidak ditentukan
di sana, dan Mercurial berjalan di bawah sistem mirip Unix, daftar pengguna akan diambil
dari OSnya. Jika tidak, pengecualian akan dimunculkan.
Contoh konfigurasi
[kait]
# Gunakan ini jika Anda ingin memeriksa pembatasan akses pada waktu komit
pretxncommit.acl = python:hgext.acl.hook
# Gunakan ini jika Anda ingin memeriksa pembatasan akses untuk tarik, dorong,
# bungkus dan sajikan.
pretxnchangegroup.acl = python:hgext.acl.hook
[ac]
# Izinkan atau tolak akses untuk perubahan yang masuk hanya jika sumbernya
# tercantum di sini, biarkan mereka lewat sebaliknya. Sumber adalah "melayani" untuk semua
# akses jarak jauh (http atau ssh), "push", "pull" atau "bundle" ketika
# perintah terkait dijalankan secara lokal.
# Bawaan: sajikan
sumber = melayani
[acl.deny.branch]
# Semua orang ditolak ke cabang beku:
cabang beku = *
# Pengguna yang buruk ditolak di semua cabang:
* = pengguna jahat
[acl.allow.branch]
# Beberapa pengguna diperbolehkan di cabang-a:
cabang-a = pengguna-1, pengguna-2, pengguna-3
# Hanya satu pengguna yang diizinkan di cabang-b:
cabang-b = pengguna-1
# Pengguna super diizinkan di cabang mana pun:
* = pengguna super
# Setiap orang diperbolehkan mengikuti ujian cabang:
cabang-untuk-tes = *
[acl.menyangkal]
# Daftar ini diperiksa terlebih dahulu. Jika kecocokan ditemukan, acl.allow tidak
# diperiksa. Semua pengguna diberikan akses jika acl.deny tidak ada.
# Format untuk kedua daftar: pola glob = pengguna, ..., @grup, ...
# Untuk mencocokkan semua orang, gunakan tanda bintang untuk pengguna:
# saya/glob/pola = *
# user6 tidak akan memiliki akses tulis ke file apa pun:
** = pengguna6
# Grup "hg-denied" tidak akan memiliki akses tulis ke file apa pun:
** = @hg-ditolak
# Tidak ada yang bisa mengubah "DONT-TOUCH-THIS.txt", meskipun
# semua orang dapat mengubah semua file lainnya. Lihat di bawah.
src/main/resources/JANGAN-SENTUH-INI.txt = *
[acl.izinkan]
# jika acl.allow tidak ada, semua pengguna diizinkan secara default
# acl.allow kosong = tidak ada pengguna yang diizinkan
# Pengguna "doc_writer" memiliki akses tulis ke file apa pun di bawah "docs"
# map:
dokumen/** = doc_writer
# Pengguna "jack" dan "desainer" grup memiliki akses tulis ke file apa pun
# di bawah folder "gambar":
gambar/** = jack, @designers
# Semua orang (kecuali untuk "user6" dan "@hg-denied" - lihat acl.deny di atas)
# akan memiliki akses tulis ke file apa pun di bawah folder "sumber daya"
# (kecuali untuk 1 file. Lihat acl.deny):
src/main/sumber daya/** = *
.hgtags = rilis_insinyur
contoh menggunakan itu ! awalan
Misalkan ada cabang yang hanya dapat didorong oleh pengguna (atau grup) tertentu, dan
Anda tidak ingin membatasi akses ke cabang lain yang mungkin dibuat.
"!" awalan memungkinkan Anda untuk mencegah siapa pun kecuali pengguna atau grup tertentu untuk mendorong
perubahan set di cabang atau jalur tertentu.
Dalam contoh di bawah ini, kami akan: 1) Menolak akses ke "ring" cabang kepada siapa pun kecuali pengguna
"gollum" 2) Tolak akses ke cabang "danau" kepada siapa pun kecuali anggota grup "hobbit" 3)
Tolak akses ke file kepada siapa pun kecuali pengguna "gollum"
[acl.allow.branch]
# Kosong
[acl.deny.branch]
# 1) hanya 'gollum' yang dapat melakukan ke cabang 'cincin';
# 'gollum' dan siapa pun masih dapat berkomitmen ke cabang lain mana pun.
cincin = !gollum
# 2) hanya anggota grup 'hobbit' yang dapat berkomitmen ke cabang 'danau';
# Anggota 'hobbit' dan siapa pun masih dapat berkomitmen ke cabang lain mana pun.
danau = !@hobbit
# Anda juga dapat menolak akses berdasarkan jalur file:
[acl.izinkan]
# Kosong
[acl.menyangkal]
# 3) hanya 'gollum' yang dapat mengubah file di bawah ini;
# 'gollum' dan siapa pun masih dapat mengubah file lainnya.
/kabut/pegunungan/gua/cincin = !gollum
kotak hitam
log peristiwa repositori ke kotak hitam untuk debugging
Mencatat informasi acara ke .hg/blackbox.log untuk membantu men-debug dan mendiagnosis masalah. Itu
peristiwa yang dicatat dapat dikonfigurasi melalui kunci konfigurasi blackbox.track. Contoh:
[kotak hitam]
trek = *
[kotak hitam]
track = perintah, perintah selesai, perintah pengecualian, exhook, pythonhook
[kotak hitam]
trek = masuk
[kotak hitam]
# batasi ukuran file log
ukuran maksimal = 1.5 MB
# putar hingga N file log saat yang sekarang menjadi terlalu besar
file maks = 3
Perintah
kotak hitam
lihat acara repositori terbaru:
hg kotak hitam [OPSI]...
lihat acara repositori baru-baru ini
Pilihan:
-aku,--membatasi
jumlah acara yang akan ditampilkan (default: 10)
bugzilla
kait untuk mengintegrasikan dengan pelacak bug Bugzilla
Ekstensi kait ini menambahkan komentar tentang bug di Bugzilla saat mengubah set yang merujuk ke bug
oleh Bugzilla ID terlihat. Komentar diformat menggunakan mekanisme template Mercurial.
Referensi bug secara opsional dapat menyertakan pembaruan untuk Bugzilla dari jam yang dihabiskan
bekerja pada bug. Bug juga dapat ditandai diperbaiki.
Tiga mode dasar akses ke Bugzilla disediakan:
1. Akses melalui antarmuka Bugzilla XMLRPC. Membutuhkan Bugzilla 3.4 atau lebih baru.
2. Periksa data melalui antarmuka Bugzilla XMLRPC dan kirimkan perubahan bug melalui email ke
Antarmuka email Bugzilla. Membutuhkan Bugzilla 3.4 atau lebih baru.
3. Menulis langsung ke database Bugzilla. Hanya instalasi Bugzilla menggunakan MySQL yang
didukung. Membutuhkan Python MySQLdb.
Menulis langsung ke database rentan terhadap perubahan skema, dan bergantung pada a
Skrip kontribusi bugzilla untuk mengirimkan email pemberitahuan perubahan bug. Skrip ini berjalan sebagai
pengguna yang menjalankan Mercurial, harus dijalankan di host dengan instalasi Bugzilla, dan
memerlukan izin untuk membaca detail konfigurasi Bugzilla dan pengguna MySQL yang diperlukan
dan kata sandi untuk memiliki hak akses penuh ke database Bugzilla. Untuk alasan ini
mode akses sekarang dianggap usang, dan tidak akan diperbarui untuk Bugzilla baru
versi ke depan. Hanya menambahkan komentar yang didukung dalam mode akses ini.
Akses melalui XMLRPC membutuhkan nama pengguna dan kata sandi Bugzilla untuk ditentukan di
konfigurasi. Komentar ditambahkan di bawah nama pengguna itu. Karena konfigurasinya harus
dapat dibaca oleh semua pengguna Mercurial, direkomendasikan bahwa hak pengguna tersebut adalah
dibatasi di Bugzilla seminimal mungkin untuk menambahkan komentar. Menandai bug diperbaiki
membutuhkan Bugzilla 4.0 dan yang lebih baru.
Akses melalui XMLRPC/email menggunakan XMLRPC untuk menanyakan Bugzilla, tetapi mengirim email ke Bugzilla
antarmuka email untuk mengirimkan komentar ke bug. Alamat Dari: dalam email disetel ke
alamat email pengguna Mercurial, sehingga komentar tampaknya berasal dari Mercurial
pengguna. Jika email pengguna Mercurial tidak dikenali oleh Bugzilla sebagai
Pengguna Bugzilla, email yang terkait dengan nama pengguna Bugzilla yang digunakan untuk masuk ke Bugzilla
digunakan sebagai sumber komentar. Menandai bug yang diperbaiki berfungsi pada semua yang didukung
Versi Bugzilla.
Item konfigurasi yang umum untuk semua mode akses:
bugzilla.versi
Jenis akses yang akan digunakan. Nilai yang diakui adalah:
xmlrpc
Antarmuka XMLRPC Bugzilla.
xmlrpc+email
Bugzilla XMLRPC dan antarmuka email.
3.0
Akses MySQL, Bugzilla 3.0 dan yang lebih baru.
2.18
Akses MySQL, Bugzilla 2.18 dan lebih tinggi tetapi tidak termasuk 3.0.
2.16
Akses MySQL, Bugzilla 2.16 dan lebih tinggi tetapi tidak termasuk 2.18.
bugzilla.regexp
Ekspresi reguler untuk mencocokkan ID bug untuk pembaruan dalam pesan komit changeset. Dia
harus berisi satu grup bernama "()" berisi ID bug yang dipisahkan oleh
karakter non-digit. Mungkin juga berisi grup bernama dengan
nomor floating-point memberikan jam kerja pada bug. Jika tidak ada grup bernama
saat ini, grup "()" pertama diasumsikan berisi ID bug, dan waktu kerja adalah
tidak diperbarui. Ekspresi default cocok Bug 1234, Bug tidak. 1234, Bug jumlah
1234, Bug 1234,5678, Bug 1234 dan 5678 dan variasinya, diikuti oleh
nomor jam diawali dengan h or jam, misalnya jam 1.5. Pencocokan tidak peka huruf besar/kecil.
bugzilla.fixregexp
Ekspresi reguler untuk mencocokkan ID bug untuk menandai diperbaiki dalam pesan komit changeset.
Ini harus berisi grup bernama "()" ` mengandung itu kesalahan ID dipisahkan by
bukan angka karakter. It mungkin juga mengandung a bernama kelompok `` dengan
nomor floating-point memberikan jam kerja pada bug. Jika tidak ada grup bernama
saat ini, grup "()" pertama diasumsikan berisi ID bug, dan waktu kerja adalah
tidak diperbarui. Ekspresi default cocok Perbaikan 1234, Perbaikan kesalahan 1234, Perbaikan bug
1234,5678, Perbaikan 1234 dan 5678 dan variasinya, diikuti dengan nomor jam
diawali oleh h or jam, misalnya jam 1.5. Pencocokan tidak peka huruf besar/kecil.
bugzilla.fixstatus
Status untuk menetapkan bug saat menandai diperbaiki. Bawaan MEMUTUSKAN.
bugzilla.fix resolution
Resolusi untuk mengatur bug saat menandai diperbaiki. Bawaan TETAP.
bugzilla.style
File gaya yang akan digunakan saat memformat komentar.
bugzilla.template
Template untuk digunakan saat memformat komentar. Mengganti gaya jika ditentukan. Selain itu
ke kata kunci Mercurial biasa, ekstensi menentukan:
{serangga}
ID bug Bugzilla.
{akar}
Nama path lengkap dari repositori Mercurial.
{akar web}
Nama jalur yang dilucuti dari repositori Mercurial.
{hgweb}
URL dasar untuk menjelajahi repositori Mercurial.
Default changeset {simpul|pendek} in repo {akar} mengacu untuk kesalahan
{bug}.\ndetail:\n\t{desc|tabindent}
bugzilla.strip
Jumlah karakter pemisah jalur yang akan dihapus dari depan Mercurial
jalur penyimpanan ({akar} dalam template) untuk menghasilkan {akar web}. Misalnya, a
gudang dengan {akar} /var/local/proyek-saya dengan strip 2 memberikan nilai untuk
{akar web} of proyek saya. Standar 0.
web.baseurl
URL dasar untuk menjelajahi repositori Mercurial. Direferensikan dari template sebagai {hgweb}.
Item konfigurasi yang umum untuk mode akses XMLRPC+email dan MySQL:
bugzilla.usermap
Jalur file yang berisi email committer Mercurial ke pemetaan email pengguna Bugzilla.
Jika ditentukan, file harus berisi satu pemetaan per baris:
pembuat = pengguna Bugzilla
Lihat juga [peta pengguna] bagian.
Grafik [peta pengguna] bagian digunakan untuk menentukan pemetaan email committer Mercurial ke Bugzilla
email pengguna. Lihat juga bugzilla.usermap. Berisi entri formulir committer = Bugzilla
pemakai.
Konfigurasi mode akses XMLRPC:
bugzilla.bzurl
URL dasar untuk instalasi Bugzilla. Bawaan http://localhost/bugzilla.
bugzilla.user
Nama pengguna yang digunakan untuk masuk ke Bugzilla melalui XMLRPC. Bawaan bug.
bugzilla.password
Kata sandi untuk login Bugzilla.
Mode akses email XMLRPC+menggunakan item konfigurasi mode akses XMLRPC, dan juga:
bugzilla.bzemail
Alamat email Bugzilla.
Selain itu, pengaturan email Mercurial harus dikonfigurasi. Lihat dokumentasi di
hgrc(5), bagian [surel] dan [smtp].
Konfigurasi mode akses MySQL:
bugzilla.host
Nama host server MySQL yang menyimpan database Bugzilla. Bawaan localhost.
bugzilla.db
Nama database Bugzilla di MySQL. Bawaan bug.
bugzilla.user
Nama pengguna yang digunakan untuk mengakses server MySQL. Bawaan bug.
bugzilla.password
Kata sandi yang digunakan untuk mengakses server MySQL.
bugzilla.timeout
Batas waktu koneksi database (detik). Standar 5.
bugzilla.bzuser
Ganti nama pengguna Bugzilla untuk merekam komentar, jika pembuat changeset tidak dapat
ditemukan sebagai pengguna Bugzilla.
bugzilla.bzdir
Direktori instal Bugzilla. Digunakan secara default, beri tahu. Bawaan /var/www/html/bugzilla.
bugzilla.notify
Perintah untuk dijalankan agar Bugzilla mengirim email pemberitahuan perubahan bug.
Pengganti dari peta dengan 3 kunci, bzdir, id (id bug) dan pemakai (komitter bugzilla
surel). Default tergantung pada versi; dari 2.18 itu adalah "cd %(bzdir)s && perl -T
contrib/sendbugmail.pl %(id)s %(user)s".
Mengaktifkan ekstensi:
[ekstensi]
bugzila =
[kait]
# jalankan bugzilla hook pada setiap perubahan yang ditarik atau didorong di sini
masuk.bugzilla = python:hgext.bugzilla.hook
Contoh konfigurasi:
Contoh konfigurasi XMLRPC. Ini menggunakan Bugzilla di http://my-project.org/bugzilla,
masuk sebagai pengguna [email dilindungi] dengan kata sandi colokan. Ini digunakan dengan
koleksi repositori Mercurial di /var/local/hg/repos/, dengan antarmuka web di
http://my-project.org/hg.
[bugzilla]
bzurl=http://my-project.org/bugzilla
pengguna =[email dilindungi]
kata sandi = plug
versi=xmlrpc
template=Ubah {node|short} di {root|basename}.
{hgweb}/{webroot}/rev/{simpul|pendek}\n
{desc}\n
strip = 5
[web]
dasar =http://my-project.org/hg
Contoh konfigurasi email XMLRPC+. Ini menggunakan Bugzilla di
http://my-project.org/bugzilla, masuk sebagai pengguna [email dilindungi] dengan kata sandi
colokan. Ini digunakan dengan koleksi repositori Mercurial di /var/local/hg/repos/,
dengan antarmuka web di http://my-project.org/hg. Komentar bug dikirim ke Bugzilla
alamat email [email dilindungi].
[bugzilla]
bzurl=http://my-project.org/bugzilla
pengguna =[email dilindungi]
kata sandi = plug
versi=xmlrpc+email
email=[email dilindungi]
template=Ubah {node|short} di {root|basename}.
{hgweb}/{webroot}/rev/{simpul|pendek}\n
{desc}\n
strip = 5
[web]
dasar =http://my-project.org/hg
[peta pengguna]
[email dilindungi]=[email dilindungi]
Contoh konfigurasi MySQL. Ini memiliki instalasi Bugzilla 3.2 lokal di
/memilih/bugzilla-3.2. Basis data MySQL aktif localhost, nama database Bugzilla adalah bug
dan MySQL diakses dengan nama pengguna MySQL bug kata sandi XYZZY. Ini digunakan dengan
koleksi repositori Mercurial di /var/local/hg/repos/, dengan antarmuka web di
http://my-project.org/hg.
[bugzilla]
tuan rumah=localhost
kata sandi = XYZZY
versi = 3.0
bzuser=[email dilindungi]
bzdir=/opt/bugzilla-3.2
template=Ubah {node|short} di {root|basename}.
{hgweb}/{webroot}/rev/{simpul|pendek}\n
{desc}\n
strip = 5
[web]
dasar =http://my-project.org/hg
[peta pengguna]
[email dilindungi]=[email dilindungi]
Semua hal di atas menambahkan komentar ke catatan bug Bugzilla dari formulir:
Ubah set 3b16791d6642 dalam nama-repositori.
http://my-project.org/hg/repository-name/rev/3b16791d6642
Ubah set komentar komit. Bug 1234.
sensor
hapus konten file pada revisi yang diberikan
Perintah sensor menginstruksikan Mercurial untuk menghapus semua konten file pada revisi yang diberikan
tanpa memperbarui itu changeset hash. Ini memungkinkan riwayat yang ada tetap valid saat
mencegah klon/penarikan di masa mendatang menerima data yang terhapus.
Penggunaan umum untuk sensor adalah karena persyaratan keamanan atau hukum, termasuk:
* Kata sandi, kunci pribadi, materi kriptografi
* Data/kode/perpustakaan berlisensi yang lisensinya telah kedaluwarsa
* Informasi Identifikasi Pribadi atau data pribadi lainnya
Node yang disensor dapat mengganggu operasi khas Mercurial kapan pun data yang dipotong diperlukan
untuk diwujudkan. Beberapa perintah, seperti hg kucing/hg kembali, hanya gagal ketika diminta untuk
menghasilkan data yang disensor. Lainnya, seperti hg memeriksa dan hg memperbarui, harus mampu menoleransi
data yang disensor untuk terus berfungsi dengan cara yang berarti. Perintah seperti itu hanya mentolerir
revisi file yang disensor jika diizinkan oleh opsi konfigurasi "censor.policy=ignore".
Perintah
sensor
hg sensor -r REV [-t TEKS] [FILE]
Pilihan:
-R,--putaran
menyensor file dari revisi yang ditentukan
-T,--batu nisan
data batu nisan pengganti
chgserver
ekstensi server perintah untuk cHg (EKSPERIMENTAL)
'S' saluran (Baca tulis)
menyebarkan permintaan ui.system() ke klien
'attachio' Command
lampirkan stdio klien yang diteruskan oleh sendmsg()
'chdir' Command
ubah direktori saat ini
'getpager' Command
memeriksa apakah pager diaktifkan dan pager mana yang harus dijalankan
'setenv' Command
ganti os.environ sepenuhnya
'SIGHUP' sinyal
muat ulang file konfigurasi
anak-anak
perintah untuk menampilkan perubahan anak (DEPRECATED)
Ekstensi ini tidak digunakan lagi. Kamu harus menggunakan hg mencatat -r "anak-anak (REV)" sebagai gantinya.
Perintah
anak-anak
perlihatkan anak-anak dari revisi direktori yang diberikan atau yang berfungsi:
hg anak [-r REV] [FILE]
Cetak anak-anak dari revisi direktori kerja. Jika revisi diberikan melalui
-r/--rev, anak-anak dari revisi itu akan dicetak. Jika argumen file diberikan,
revisi di mana file terakhir diubah (setelah revisi direktori kerja atau
argumen ke --rev jika diberikan) dicetak.
Mohon gunakan hg mencatat sebagai gantinya:
hg anak => hg log -r 'anak-anak()'
hg anak -r REV => hg log -r 'anak(REV)'
Lihat hg membantu mencatat dan hg membantu revsets.anak-anak.
Pilihan:
-R,--putaran
tunjukkan anak-anak dari revisi yang ditentukan
--gaya
tampilkan menggunakan file peta template (DIHAPUS)
-T,--templat
tampilan dengan template
mengocok
perintah untuk menampilkan statistik tentang riwayat repositori
Perintah
mengocok
histogram perubahan pada repositori:
hg churn [-d TANGGAL] [-r REV] [--alias FILE] [FILE]
Perintah ini akan menampilkan histogram yang mewakili jumlah baris yang diubah atau
revisi, dikelompokkan sesuai dengan template yang diberikan. Template default akan mengelompokkan
perubahan oleh penulis. Opsi --dateformat dapat digunakan untuk mengelompokkan hasil berdasarkan tanggal
sebagai gantinya.
Statistik didasarkan pada jumlah baris yang diubah, atau sebagai alternatif jumlah
revisi yang cocok jika opsi --changesets ditentukan.
contoh:
# menampilkan jumlah baris yang diubah untuk setiap commiter
hg churn -t "{penulis|email}"
# tampilkan grafik aktivitas harian
hg churn -f "%H" -s -c
# menampilkan aktivitas pengembang berdasarkan bulan
hg churn -f "%Y-%m" -s -c
# tampilan jumlah baris berubah setiap tahun
hg churn -f "%Y" -s
Dimungkinkan untuk memetakan alamat email alternatif ke alamat utama dengan menyediakan file
menggunakan format berikut:
=
File tersebut dapat ditentukan dengan opsi --aliases, jika tidak, file .hgchurn akan menjadi
mencari di root direktori kerja. Alias akan dipisah dari "=".
Pilihan:
-R,--putaran
menghitung tingkat untuk revisi atau revset yang ditentukan
-D,--tanggal
menghitung tingkat revisi yang cocok dengan spesifikasi tanggal
-T,--template lama
templat untuk mengelompokkan perubahan set (DIHAPUS)
-T,--templat
template untuk mengelompokkan perubahan (default: {author|email})
-F,--format tanggal
format yang kompatibel dengan strftime untuk pengelompokan berdasarkan tanggal
-C, --perubahan
menghitung tingkat dengan jumlah perubahan
-S, --menyortir
urutkan berdasarkan kunci (default: urutkan berdasarkan jumlah)
--diffstat
tampilkan garis yang ditambahkan/dihapus secara terpisah
--alias
file dengan email alias
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
kloning
mengiklankan bundel yang dibuat sebelumnya ke klon benih
"clonebundles" adalah ekstensi sisi server yang digunakan untuk mengiklankan keberadaan
file bundel yang dibuat sebelumnya dan dihosting secara eksternal ke klien yang mengkloning sehingga kloning
bisa lebih cepat, lebih andal, dan membutuhkan lebih sedikit sumber daya di server.
Kloning dapat menjadi operasi intensif CPU dan I/O di server. Secara tradisional, server, di
menanggapi permintaan klien untuk mengkloning, secara dinamis menghasilkan bundel yang berisi
seluruh konten repositori dan mengirimkannya ke klien. Tidak ada caching di server
dan server harus menghasilkan bundel keluar yang sama secara berlebihan sebagai tanggapan terhadap
setiap permintaan klon. Untuk server dengan repositori besar atau dengan volume kloning tinggi,
memuat dari klon dapat membuat penskalaan server menjadi sulit dan mahal.
Ekstensi ini memberi operator server kemampuan untuk membongkar muatan yang berpotensi mahal
mengkloning beban ke layanan eksternal. Berikut cara kerjanya.
1. Operator server membuat mekanisme untuk membuat file bundel tersedia di a
layanan hosting tempat klien Mercurial dapat mengambilnya.
2. File manifes yang mencantumkan URL bundel yang tersedia dan beberapa metadata opsional ditambahkan ke
repositori Mercurial di server.
3. Seorang klien memulai klon terhadap server yang menyadari bundel klon.
4. Klien melihat server mengiklankan bundel klon dan mengambil manifes
daftar bundel yang tersedia.
5. Klien memfilter dan mengurutkan bundel yang tersedia berdasarkan apa yang didukungnya dan
lebih memilih.
6. Klien mengunduh dan menerapkan bundel yang tersedia dari URL yang ditentukan server.
7. Klien menyambung kembali ke server asli dan melakukan yang setara dengan hg menarik untuk
mengambil semua data repositori tidak dalam bundel. (Repositori bisa saja diperbarui
antara saat bundel dibuat dan saat klien memulai klon.)
Alih-alih server menghasilkan bundel repositori lengkap untuk setiap permintaan klon, itu
menghasilkan bundel penuh sekali dan mereka kemudian digunakan kembali untuk bootstrap klon baru. Itu
server masih dapat mentransfer data pada waktu kloning. Namun, ini hanya data yang telah
ditambahkan/diubah sejak bundel dibuat. Untuk repositori besar dan mapan, ini bisa
mengurangi beban server untuk klon menjadi kurang dari 1% dari aslinya.
Agar berfungsi, ekstensi ini memerlukan operator server berikut:
· Menghasilkan file bundel konten repositori (biasanya secara berkala, seperti sekali per
hari).
· Server file yang klien memiliki akses jaringan dan Python tahu cara berbicara
melalui fasilitas penanganan URL normalnya (biasanya server HTTP).
· Proses untuk menjaga agar bundel tetap sinkron dengan file bundel yang tersedia.
Sebenarnya, menggunakan server hosting file statis tidak diperlukan: operator server
dapat menggunakan layanan dinamis untuk mengambil data bundel. Namun, hosting file statis
layanan sederhana dan terukur dan harus cukup untuk sebagian besar kebutuhan.
File bundel dapat dibuat dengan hg bundel memerintah. Khas hg bundel --semua is
digunakan untuk menghasilkan bundel dari seluruh repositori.
hg debugcreatestreamclonebundle dapat digunakan untuk menghasilkan spesial Streaming clone bundel.
Ini adalah file bundel yang sangat efisien untuk diproduksi dan dikonsumsi (baca: cepat).
Namun, mereka lebih besar dari format bundel tradisional dan memerlukan dukungan klien
kumpulan persis format penyimpanan data repositori yang digunakan oleh repositori yang membuatnya.
Biasanya, server yang lebih baru dapat menyajikan data yang kompatibel dengan klien yang lebih lama. Namun,
Streaming clone bundel tidak memiliki jaminan ini. Server operator perlu untuk be sadar bahwa
baru Versi of lincah mungkin menghasilkan Streaming clone bundel tidak kompatibel dengan lebih tua
lincah versi.
Operator server bertanggung jawab untuk membuat .hg/clonebundles.manifest file yang berisi
daftar file bundel yang tersedia yang cocok untuk penyemaian klon. Jika file ini tidak
ada, repositori tidak akan mengiklankan keberadaan bundel klon ketika klien
Menghubung.
File manifes berisi daftar entri yang dibatasi baris baru ( ).
Setiap baris dalam file ini mendefinisikan bundel yang tersedia. Garis memiliki format:
[ = [ = ]]
Yaitu, URL yang diikuti oleh daftar pasangan kunci=nilai opsional yang dibatasi spasi yang menjelaskan
properti tambahan dari bundel ini. Baik kunci dan nilai dikodekan URI.
Kunci di UPPERCASE dicadangkan untuk digunakan oleh Mercurial dan didefinisikan di bawah ini. Semua
kunci non-huruf besar dapat digunakan oleh instalasi situs. Contoh penggunaan untuk properti khusus
adalah menggunakan Pusat Data atribut untuk menentukan pusat data tempat file dihosting.
Klien kemudian dapat memilih server di pusat data yang paling dekat dengan mereka.
Kunci cadangan berikut saat ini ditentukan:
SPESIFIKASI PAKET
String "spesifikasi bundel" yang menjelaskan jenis bundel.
Ini adalah nilai string yang diterima oleh argumen "--type" dari hg bundel.
Nilai diuraikan dalam mode ketat, yang berarti nilai tersebut harus dari
" - " form. Lihat mercurial.exchange.parsebundlespec() untuk lebih lanjut
rincian.
hg bundel debug --spesifikasi dapat digunakan untuk mencetak string spesifikasi bundel untuk a
berkas bundel. Output dari perintah ini dapat digunakan kata demi kata untuk nilai
SPESIFIKASI PAKET (sudah lolos).
Klien akan secara otomatis menyaring spesifikasi yang tidak diketahui atau
tidak didukung sehingga mereka tidak akan mencoba mengunduh sesuatu yang kemungkinan besar tidak akan berlaku.
Nilai aktual tidak memengaruhi perilaku klien selain pemfilteran: klien akan
masih mengendus jenis bundel dari header file yang diunduh.
penggunaan of ini kunci is sangat direkomendasikan, karena memungkinkan klien untuk dengan mudah melewati
bundel yang tidak didukung. Jika kunci ini tidak ditentukan, klien lama mungkin mencoba untuk menerapkan
bundel yang tidak dapat dibacanya.
DIBUTUHKAN
Apakah Indikasi Nama Server (SNI) diperlukan untuk terhubung ke URL. SNI memungkinkan
server untuk menggunakan beberapa sertifikat pada IP yang sama. Ini agak umum di CDN
dan penyedia hosting lainnya. Versi Python yang lebih lama tidak mendukung SNI. Mendefinisikan
atribut ini memungkinkan klien dengan versi Python yang lebih lama untuk memfilter entri ini
tanpa mengalami kegagalan SSL buram pada waktu koneksi.
Jika ini ditentukan, penting untuk mengiklankan URL atau klien pengganti non-SNI
menjalankan rilis Python lama mungkin tidak dapat mengkloning dengan clonebundles
fasilitas.
Nilai harus "benar".
Manifes dapat berisi banyak entri. Dengan asumsi metadata ditentukan, klien akan memfilter
entri dari manifes yang tidak mereka dukung. Entri yang tersisa adalah opsional
diurutkan berdasarkan preferensi klien (eksperimental.clonebundle lebih suka opsi konfigurasi). Klien
kemudian mencoba mengambil bundel di URL pertama dalam daftar yang tersisa.
kesalahan ketika download a bundel akan gagal itu seluruh clone operasi: klien do tidak
secara otomatis jatuh kembali untuk a tradisional clone. Alasan untuk ini adalah jika server adalah
menggunakan bundel klon, mungkin melakukannya karena fitur tersebut diperlukan untuk membantunya
skala. Dengan kata lain, ada asumsi bahwa beban klon akan dipindahkan ke yang lain
service dan server Mercurial tidak bertanggung jawab untuk melayani beban klon ini. Jika
bahwa layanan lain mengalami masalah dan klien mulai mundur secara massal ke aslinya
Server Mercurial, beban klon tambahan dapat membanjiri server karena beban tak terduga
dan secara efektif membuatnya offline. Tidak memiliki klien secara otomatis kembali ke kloning
dari server asli mengurangi skenario ini.
Karena tidak ada penggantian server Mercurial otomatis pada kegagalan bundel hosting
layanan, penting bagi operator server untuk melihat layanan bundel hosting sebagai
perpanjangan server Mercurial dalam hal ketersediaan dan perjanjian tingkat layanan:
jika layanan bundel hosting turun, begitu juga kemampuan klien untuk mengkloning. Catatan:
klien akan melihat pesan yang memberi tahu mereka cara melewati fasilitas bundel kloning ketika a
kegagalan terjadi. Jadi operator server harus mempersiapkan beberapa orang untuk mengikuti ini
instruksi ketika terjadi kegagalan, sehingga mendorong lebih banyak beban ke Mercurial asli
server ketika layanan bundel hosting gagal.
warna
mewarnai output dari beberapa perintah
Ekstensi warna mewarnai output dari beberapa perintah Mercurial. Misalnya,
perintah diff menunjukkan penambahan dalam warna hijau dan penghapusan dalam warna merah, sedangkan perintah status menunjukkan
file yang dimodifikasi dalam magenta. Banyak perintah lain memiliki warna analog. Apakah mungkin untuk
menyesuaikan warna-warna ini.
efek
Efek lain selain warna, seperti teks tebal dan bergaris bawah, juga tersedia. Oleh
default, database terminfo digunakan untuk menemukan kode terminal yang digunakan untuk mengubah warna dan
memengaruhi. Jika terminfo tidak tersedia, maka efek dirender dengan ECMA-48 SGR
fungsi kontrol (alias kode pelarian ANSI).
Efek yang tersedia dalam mode terminfo adalah 'blink', 'bold', 'redup', 'inverse', 'invisible',
'italic', 'standout', dan 'underline'; dalam mode ECMA-48, opsinya adalah 'bold', 'inverse',
'miring', dan 'garis bawah'. Cara masing-masing dirender bergantung pada emulator terminal. Beberapa
mungkin tidak tersedia untuk tipe terminal tertentu, dan akan diabaikan secara diam-diam.
Label
Teks menerima efek warna tergantung pada label yang dimilikinya. Banyak Mercurial default
perintah memancarkan teks berlabel. Anda juga dapat menentukan label Anda sendiri di template menggunakan
fungsi label, lihat hg membantu template. Satu bagian teks mungkin memiliki lebih dari satu
label. Dalam hal ini, efek yang diberikan pada label terakhir akan menggantikan efek lainnya. Ini
termasuk efek khusus "tidak ada", yang meniadakan efek lainnya.
Label biasanya tidak terlihat. Untuk melihat label ini dan posisinya di
teks, gunakan opsi --color=debug global. Teks jangkar yang sama dapat dikaitkan dengan
beberapa label, misalnya
[log.changeset changeset.secret|changeset: 22611:6f0a53c8f587]
Berikut ini adalah efek default untuk beberapa label default. Efek default mungkin
diganti dari file konfigurasi Anda:
[warna]
status.modified = garis bawah biru tebal red_background
status.added = hijau tebal
status.removed = latar belakang biru tebal merah
status.deleted = garis bawah cyan bold
status.unknown = garis bawah tebal magenta
status.ignored = hitam tebal
# 'tidak ada' mematikan semua efek
status.bersih = tidak ada
status.disalin = tidak ada
qseries.applied = garis bawah biru tebal
qseries.unapplied = hitam tebal
qseries.missing = merah tebal
diff.diffline = tebal
diff.extended = cyan tebal
diff.file_a = merah tebal
diff.file_b = hijau tebal
diff.hunk = magenta
diff.dihapus = merah
diff.inserted = hijau
diff.berubah = putih
diff.tab =
diff.trailingwhitespace = latar belakang merah tebal
# Kosong sehingga mewarisi gaya label sekitarnya
changeset.publik =
changeset.draft =
changeset.rahasia =
resolve.unresolved = merah tebal
resolve.resolved = hijau tebal
bookmarks.active = hijau
cabang.aktif = tidak ada
branch.closed = hitam tebal
cabang. arus = hijau
cabang.inactive = tidak ada
tag.normal = hijau
tag.local = hitam tebal
rebase.rebased = biru
rebase.remaining = merah tebal
rak.umur = cyan
shelve.newest = hijau tebal
rak.nama = biru tebal
histedit.remaining = merah tebal
Kustom warna
Karena hanya ada delapan warna standar, modul ini memungkinkan Anda untuk menentukan nama warna
untuk slot warna lain yang mungkin tersedia untuk tipe terminal Anda, dengan asumsi terminfo
mode. Misalnya:
warna.biru cerah = 12
warna. pink = 207
warna.oranye = 202
untuk mengatur 'brightblue' ke slot warna 12 (berguna untuk terminal 16 warna yang lebih cerah
warna yang ditentukan dalam delapan atas) dan, 'merah muda' dan 'oranye' menjadi warna dalam xterm 256-warna
kubus warna default. Warna-warna yang ditentukan ini kemudian dapat digunakan sebagai salah satu yang telah ditentukan sebelumnya
delapan, termasuk menambahkan '_background' untuk mengatur latar belakang ke warna itu.
Mode
Secara default, ekstensi warna akan menggunakan mode ANSI (atau mode win32 di Windows) jika:
mendeteksi terminal. Untuk mengesampingkan mode otomatis (untuk mengaktifkan mode terminfo, misalnya), atur tombol
opsi konfigurasi berikut:
[warna]
modus = terminfo
Nilai apa pun selain 'ansi', 'win32', 'terminfo', atau 'auto' akan menonaktifkan warna.
Perhatikan bahwa pada beberapa sistem, mode terminfo dapat menyebabkan masalah saat menggunakan warna dengan
ekstensi pager dan lebih sedikit -R. less dengan opsi -R hanya akan menampilkan warna ECMA-48
kode, dan mode terminfo terkadang mengeluarkan kode yang kurang dimengerti. Kamu bisa
mengatasinya dengan menggunakan mode ansi (atau mode otomatis), atau dengan menggunakan less -r (yang akan
melewati semua kode kontrol terminal, bukan hanya kode kontrol warna).
Pada beberapa sistem (seperti MSYS di Windows), terminal mungkin mendukung mode warna yang berbeda
daripada pager (diaktifkan melalui ekstensi "pager"). Dimungkinkan untuk mendefinisikan terpisah
mode tergantung pada apakah pager aktif:
[warna]
modus = otomatis
mode halaman = ansi
If mode halaman tidak terdefinisi, mode akan digunakan.
Perintah
mengubah
impor revisi dari repositori VCS asing ke Mercurial
Perintah
mengubah
mengonversi repositori SCM asing ke repositori Mercurial.:
hg mengonversi [OPTION]... SUMBER [TUJUAN [REVMAP]]
Format sumber yang diterima [pengidentifikasi]:
· Mercurial [hg]
· CVS [cv]
· Darc [darcs]
· git [git]
· Subversi [svn]
· Monoton [mtn]
· Lengkungan GNU [gnuarch]
· Bazar [bzr]
· Paksa [p4]
Format tujuan yang diterima [pengidentifikasi]:
· Mercurial [hg]
· Subversion [svn] (sejarah di cabang tidak disimpan)
Jika tidak ada revisi yang diberikan, semua revisi akan dikonversi. Jika tidak, konversi hanya akan
impor hingga revisi bernama (diberikan dalam format yang dipahami oleh sumber).
Jika tidak ada nama direktori tujuan yang ditentukan, defaultnya adalah nama dasar sumber
dengan -HG ditambahkan. Jika repositori tujuan tidak ada, itu akan dibuat.
Secara default, semua sumber kecuali Mercurial akan menggunakan --branchsort. kegunaan merkuri
--sourcesort untuk mempertahankan urutan nomor revisi asli. Mode pengurutan memiliki yang berikut:
efek:
--cabang
konversi dari revisi orang tua ke anak jika memungkinkan, yang berarti cabang adalah
biasanya dikonversi satu demi satu. Ini menghasilkan repositori yang lebih kompak.
--sortir tanggal
urutkan revisi berdasarkan tanggal. Repositori yang dikonversi memiliki log perubahan yang bagus tetapi
seringkali urutan besarnya lebih besar dari yang sama yang dihasilkan oleh --branchsort.
--sortir sumber
coba pertahankan urutan revisi sumber, hanya didukung oleh sumber Mercurial.
--closesort
coba pindahkan revisi tertutup sedekat mungkin ke cabang induk, hanya
didukung oleh sumber Mercurial.
If REVMAP tidak diberikan, itu akan diletakkan di lokasi default (/.hg/shamap by
bawaan). NS REVMAP adalah file teks sederhana yang memetakan setiap ID komit sumber ke
ID tujuan untuk revisi itu, seperti:
Jika file tidak ada, itu secara otomatis dibuat. Ini diperbarui pada setiap komit yang disalin,
so hg mengubah dapat diinterupsi dan dapat dijalankan berulang kali untuk menyalin komit baru.
Authormap adalah file teks sederhana yang memetakan setiap sumber yang mengkomit penulis ke tujuan
berkomitmen penulis. Sangat berguna untuk SCM sumber yang menggunakan login unix untuk mengidentifikasi penulis (misalnya:
CV). Satu baris per pemetaan penulis dan format baris adalah:
penulis sumber = penulis tujuan
Baris kosong dan baris dimulai dengan a # diabaikan.
Filemap adalah file yang memungkinkan penyaringan dan pemetaan ulang file dan direktori. Setiap
baris dapat berisi salah satu dari arahan berikut:
sertakan jalur/ke/file-atau-dir
kecualikan jalur/ke/file-atau-dir
ganti nama jalur/ke/jalur sumber/ke/tujuan
Baris komentar dimulai dengan #. Jalur yang ditentukan cocok jika sama dengan nama relatif lengkap
dari file atau salah satu direktori induknya. Itu memasukkan or mengecualikan arahan dengan
jalur pencocokan terpanjang berlaku, jadi urutan baris tidak masalah.
Grafik memasukkan direktif menyebabkan file, atau semua file di bawah direktori, dimasukkan ke dalam
gudang tujuan. Defaultnya jika tidak ada memasukkan pernyataan termasuk
semuanya. Jika ada memasukkan pernyataan, tidak ada lagi yang disertakan. Itu mengecualikan
direktif menyebabkan file atau direktori dihilangkan. Itu mengubah nama direktif mengganti nama file
atau direktori jika dikonversi. Untuk mengganti nama dari subdirektori menjadi root dari
gudang, gunakan . sebagai jalur untuk mengganti nama.
--penuh akan memastikan perubahan yang dikonversi berisi file yang tepat dengan
konten yang tepat. Ini akan membuat konversi penuh dari semua file, bukan hanya yang memiliki
berubah. File yang sudah benar tidak akan diubah. Ini bisa digunakan untuk melamar
filemap berubah saat mengonversi secara bertahap. Saat ini hanya didukung untuk
Mercurial dan Subversi.
Splicemap adalah file yang memungkinkan penyisipan riwayat sintetis, memungkinkan Anda menentukan
orang tua dari revisi. Ini berguna jika Anda ingin misalnya memberikan Subversion merge two
orang tua, atau mencangkokkan dua rangkaian sejarah yang terputus bersama-sama. Setiap entri berisi kunci,
diikuti oleh spasi, diikuti oleh satu atau dua nilai yang dipisahkan koma:
kunci induk1, induk2
Kuncinya adalah ID revisi dalam sistem kontrol revisi sumber yang orang tuanya seharusnya
dimodifikasi (format yang sama dengan kunci dalam .hg/shamap). Nilainya adalah ID revisi (di salah satu)
sumber atau sistem kontrol revisi tujuan) yang harus digunakan sebagai orang tua baru
untuk simpul itu. Misalnya, jika Anda telah menggabungkan "release-1.0" menjadi "trunk", maka Anda harus
tentukan revisi pada "trunk" sebagai induk pertama dan revisi pada "release-1.0"
cabang sebagai yang kedua.
Branchmap adalah file yang memungkinkan Anda untuk mengganti nama cabang saat dibawa masuk
dari repositori eksternal apa pun. Ketika digunakan bersama dengan splicemap, itu memungkinkan
untuk kombinasi yang kuat untuk membantu memperbaiki bahkan repositori yang paling salah urus dan
mengubahnya menjadi repositori Mercurial yang terstruktur dengan baik. Peta cabang berisi baris-baris
formulir:
original_branch_name baru_branch_name
di mana "original_branch_name" adalah nama cabang di repositori sumber, dan
"new_branch_name" adalah nama cabang tujuan repositori. Tidak ada spasi
diperbolehkan dalam nama cabang. Ini dapat digunakan untuk (misalnya) memindahkan kode dalam satu
repositori dari "default" ke cabang bernama.
lincah sumber
Sumber Mercurial mengenali opsi konfigurasi berikut, yang dapat Anda atur:
baris perintah dengan --konfigurasi:
convert.hg.ignoreerrors
mengabaikan kesalahan integritas saat membaca. Gunakan untuk memperbaiki repositori Mercurial dengan
revlogs hilang, dengan mengonversi dari dan ke Mercurial. Default adalah Salah.
konversi.hg.saverev
simpan ID revisi asli di changeset (memaksa ID target untuk berubah). Dibutuhkan
argumen boolean dan default ke False.
konversi.hg.startrev
tentukan revisi Mercurial awal. Standarnya adalah 0.
konversi.hg.revs
revset menentukan revisi sumber yang akan dikonversi.
CVS sumber
Sumber CVS akan menggunakan kotak pasir (yaitu salinan yang sudah di-check-out) dari CVS untuk menunjukkan permulaan
titik apa yang akan dikonversi. Akses langsung ke file repositori tidak diperlukan,
kecuali tentu saja repositorinya adalah :lokal:. Konversi menggunakan direktori tingkat atas di
kotak pasir untuk menemukan repositori CVS, dan kemudian menggunakan perintah CVS rlog untuk menemukan file ke
mengubah. Ini berarti bahwa kecuali filemap diberikan, semua file di bawah direktori awal
akan dikonversi, dan reorganisasi direktori apa pun di kotak pasir CVS diabaikan.
Opsi berikut dapat digunakan dengan --konfigurasi:
konversi.cvsps.cache
Atur ke False untuk menonaktifkan cache log jarak jauh, untuk tujuan pengujian dan debugging.
Default adalah Benar.
konversi.cvsps.fuzz
Tentukan waktu maksimum (dalam detik) yang diperbolehkan antara komit dengan
pengguna yang identik dan pesan log dalam satu changeset. Ketika file yang sangat besar adalah
check in sebagai bagian dari changeset maka defaultnya mungkin tidak cukup lama. Itu
defaultnya adalah 60.
convert.cvsps.mergeto
Tentukan ekspresi reguler yang cocok dengan pesan log komit. Jika cocok
terjadi, maka proses konversi akan memasukkan revisi dummy yang menggabungkan cabang
di mana pesan log ini terjadi pada cabang yang ditunjukkan dalam ekspresi reguler. Standarnya adalah
{{mergetobranch ([-\w]+)}}
convert.cvsps.mergefrom
Tentukan ekspresi reguler yang cocok dengan pesan log komit. Jika cocok
terjadi, maka proses konversi akan menambahkan revisi terbaru pada cabang
ditunjukkan dalam regex sebagai induk kedua dari changeset. Standarnya adalah
{{bergabung dari cabang ([-\w]+)}}
convert.localtimezone
gunakan waktu lokal (sebagaimana ditentukan oleh variabel lingkungan TZ) untuk perubahan
tanggal/waktu. Standarnya adalah Salah (gunakan UTC).
hooks.cvslog
Tentukan fungsi Python yang akan dipanggil di akhir pengumpulan log CVS. Itu
fungsi melewati daftar dengan entri log, dan dapat mengubah entri
di tempat, atau menambah atau menghapusnya.
hooks.cvschangesets
Tentukan fungsi Python yang akan dipanggil setelah set perubahan dihitung dari
catatan CVS. Fungsi ini melewati daftar dengan entri changeset, dan dapat memodifikasi
set perubahan di tempat, atau menambah atau menghapusnya.
Perintah Mercurial "debugcvsps" tambahan memungkinkan kode penggabungan changeset bawaan untuk
dijalankan tanpa melakukan konversi. Parameter dan outputnya mirip dengan cvsps
2.1. Silakan lihat bantuan perintah untuk lebih jelasnya.
Subversi sumber
Sumber subversi mendeteksi tata letak batang/cabang/tag klasik. Secara default, yang disediakan
svn://repo/jalur/ URL sumber dikonversi sebagai satu cabang. Jika svn://repo/path/trunk
ada itu menggantikan cabang default. Jika svn://repo/path/branch ada, itu
subdirektori terdaftar sebagai cabang yang memungkinkan. Jika svn://repo/path/tag ada, itu adalah
mencari tag yang merujuk ke cabang yang dikonversi. Bawaan batang, cabang dan tag nilai-nilai
dapat diganti dengan opsi berikut. Setel ke jalur relatif terhadap URL sumber, atau
biarkan kosong untuk menonaktifkan deteksi otomatis.
Opsi berikut dapat diatur dengan --konfigurasi:
convert.svn.branch
tentukan direktori yang berisi cabang. Standarnya adalah cabang.
konversi.svn.tags
tentukan direktori yang berisi tag. Standarnya adalah tag.
convert.svn.trunk
tentukan nama cabang trunk. Standarnya adalah batang.
convert.localtimezone
gunakan waktu lokal (sebagaimana ditentukan oleh variabel lingkungan TZ) untuk perubahan
tanggal/waktu. Standarnya adalah Salah (gunakan UTC).
Riwayat sumber dapat diambil mulai dari revisi tertentu, alih-alih menjadi
dikonversi secara integral. Hanya konversi cabang tunggal yang didukung.
konversi.svn.startrev
tentukan mulai nomor revisi Subversion. Standarnya adalah 0.
pergi sumber
Importir Git mengonversi komit dari semua cabang yang dapat dijangkau (ref dalam referensi/kepala) dan
remote (ref dalam referensi/remote) ke Mercurial. Cabang dikonversi menjadi bookmark dengan
nama yang sama, dengan 'ref/kepala' terkemuka dilucuti. Submodul Git dikonversi ke Git
subrepos di Mercurial.
Opsi berikut dapat diatur dengan --konfigurasi:
convert.git.kesamaan
tentukan bagaimana file serupa yang dimodifikasi dalam komit harus diimpor sebagai ganti nama atau
salinan, sebagai persentase antara 0 (dinonaktifkan) dan 100 (file harus identik). Untuk
contoh, 90 berarti pasangan hapus/tambah akan diimpor sebagai ganti nama jika lebih dari
90% dari file tidak berubah. Standarnya adalah 50.
convert.git.findcopyharder
saat mendeteksi salinan, lihat semua file di copy pekerjaan, bukan hanya
yang berubah. Ini sangat mahal untuk proyek besar, dan hanya efektif jika
convert.git.kesamaan lebih besar dari 0. Standarnya adalah False.
convert.git.remoteprefix
referensi jarak jauh dikonversi sebagai bookmark dengan convert.git.remoteprefix sebagai awalan
diikuti dengan /. Standarnya adalah 'jarak jauh'.
convert.git.skipsubmodules
tidak mengonversi file .gitmodules tingkat root atau file dengan mode 160000 yang menunjukkan
sebuah submodul. Default adalah Salah.
Terpaksa sumber
Importir Perforce (P4) dapat diberikan jalur depot p4 atau spesifikasi klien sebagai
sumber. Itu akan mengonversi semua file di sumber ke repositori Mercurial datar, mengabaikan
label, cabang dan integrasi. Perhatikan bahwa ketika jalur depot diberikan kepada Anda maka biasanya
harus menentukan direktori target, karena jika tidak, target dapat diberi nama ...-HG.
Opsi berikut dapat diatur dengan --konfigurasi:
convert.p4.encoding
tentukan pengkodean yang akan digunakan saat mendekode keluaran standar dari perintah Perforce
alat garis. Standarnya adalah pengkodean sistem default.
convert.p4.startrev
tentukan revisi Perforce awal (nomor daftar perubahan Perforce).
lincah Tujuan
Tujuan Mercurial akan mengenali subrepositori Mercurial di tujuan
direktori, dan perbarui file .hgsubstate secara otomatis jika tujuannya
subrepositori berisi / /.hg/shamap file. Mengonversi repositori dengan
subrepositori membutuhkan konversi satu repositori sekaligus, dari bawah ke atas.
Contoh yang menunjukkan cara mengonversi repositori dengan subrepositori:
# jadi convert tahu tipenya ketika melihat tujuan yang tidak kosong
$hg init dikonversi
$ hg mengonversi asal/sub1 dikonversi/sub1
$ hg mengonversi asal/sub2 dikonversi/sub2
$ hg konversi asal dikonversi
Opsi berikut didukung:
convert.hg.clonebranch
mengirimkan cabang sumber di klon terpisah. Nilai defaultnya salah.
convert.hg.tagsbranch
nama cabang untuk revisi tag, default ke kegagalan.
convert.hg.usebranchnames
mempertahankan nama cabang. Standarnya adalah Benar.
convert.hg.nama sumber
merekam string yang diberikan sebagai nilai ekstra 'convert_source' pada setiap komit yang dibuat
gudang sasaran. Standarnya adalah Tidak Ada.
Semua Tujuan
Semua jenis tujuan menerima opsi berikut:
convert.skiptags
tidak mengonversi tag dari repo sumber ke repo target. Standarnya adalah
Salah.
Pilihan:
--penulis
nama file pemetaan nama pengguna (DIHAPUS) (gunakan --authormap sebagai gantinya)
-S,--jenis-sumber
jenis repositori sumber
-D,--tipe tujuan
jenis repositori tujuan
-R,--putaran
impor hingga revisi sumber REV
-SEBUAH,--peta penulis
memetakan ulang nama pengguna menggunakan file ini
--peta file
memetakan ulang nama file menggunakan isi file
--penuh terapkan perubahan filemap dengan mengonversi semua file lagi
--peta sambungan
sambatan mensintesis sejarah ke tempatnya
--peta cabang
ubah nama cabang saat mengonversi
--cabang
coba urutkan perubahan berdasarkan cabang
--sortir tanggal
coba urutkan perubahan berdasarkan tanggal
--sortir sumber
pertahankan urutan perubahan sumber
--closesort
coba susun ulang revisi tertutup
[+] opsi yang ditandai dapat ditentukan beberapa kali
keren
secara otomatis mengelola baris baru dalam file repositori
Ekstensi ini memungkinkan Anda untuk mengelola jenis akhir baris (CRLF atau LF) yang digunakan dalam
repositori dan di direktori kerja lokal. Dengan begitu Anda bisa mendapatkan akhiran baris CRLF
pada Windows dan LF pada Unix/Mac, sehingga memungkinkan semua orang menggunakan akhiran baris asli OS mereka.
Ekstensi membaca konfigurasinya dari versi .hgeol file konfigurasi ditemukan di
akar dari direktori kerja. Itu .hgeol file menggunakan sintaks yang sama seperti yang lainnya
File konfigurasi Mercurial. Ini menggunakan dua bagian, [pola] dan [gudang].
Grafik [pola] bagian menentukan bagaimana akhir baris harus dikonversi antara kerja
direktori dan repositori. Format ditentukan oleh pola file. Pertandingan pertama
digunakan, jadi letakkan pola yang lebih spesifik terlebih dahulu. Akhiran baris yang tersedia adalah LF, CRLF, dan
BIN.
File dengan format yang dideklarasikan CRLF or LF selalu diperiksa dan disimpan di
repositori dalam format itu dan file yang dinyatakan sebagai biner (BIN) dibiarkan tidak berubah.
Selain itu, asli adalah alias untuk check out di akhir baris default platform:
LF di Unix (termasuk Mac OS X) dan CRLF pada Windows. Perhatikan bahwa BIN (jangan lakukan apa pun untuk garis
endings) adalah perilaku default Mercurial; itu hanya diperlukan jika Anda perlu mengganti a
kemudian, pola yang lebih umum.
Opsional [gudang] bagian menentukan akhir baris yang akan digunakan untuk file yang disimpan di
gudang. Ini memiliki satu pengaturan, asli, yang menentukan akhir jalur penyimpanan
untuk file yang dideklarasikan sebagai asli dalam [pola] bagian. Itu dapat diatur ke LF or CRLF. itu
defaultnya adalah LF. Misalnya, ini berarti bahwa pada Windows, file dikonfigurasi sebagai asli (CRLF
secara default) akan dikonversi ke LF ketika disimpan dalam repositori. File dinyatakan sebagai LF,
CRLF, atau BIN dalam [pola] bagian selalu disimpan apa adanya di repositori.
Contoh versi .hgeol File:
[pola]
**.py = asli
**.vcproj = CRLF
**.txt = asli
Makefile = LF
**.jpg = TEMPAT SAMPAH
[gudang]
asli = LF
Catatan Aturan pertama akan berlaku ketika file disentuh di direktori kerja, misalnya dengan
memperbarui ke nol dan kembali ke ujung untuk menyentuh semua file.
Ekstensi menggunakan opsional [eol] bagian membaca dari Mercurial normal
file konfigurasi dan .hgeol file, dengan yang terakhir mengesampingkan yang pertama. Kamu bisa
gunakan bagian itu untuk mengontrol perilaku secara keseluruhan. Ada tiga pengaturan:
· eol.asli (bawaan os.linesep) dapat diatur ke LF or CRLF untuk mengganti default
interpretasi asli untuk pembayaran. Ini dapat digunakan dengan hg arsip di Unix, katakanlah, untuk
menghasilkan arsip di mana file memiliki akhiran baris untuk Windows.
· eol.hanya-konsisten (default Benar) dapat diatur ke Salah untuk membuat ekstensi dikonversi
file dengan EOL yang tidak konsisten. Tidak konsisten berarti ada keduanya CRLF dan LF menyajikan
dalam file. File tersebut biasanya tidak disentuh dengan asumsi bahwa mereka memiliki
campuran EOL dengan sengaja.
· eol.fix-trailing-baris baru (Default Salah) dapat diatur ke Benar untuk memastikan bahwa dikonversi
file diakhiri dengan karakter EOL (baik \n or \ R \ n sesuai pola yang dikonfigurasi).
Ekstensi menyediakan kode pintar: dan kode pintar: filter seperti yang sudah usang
ekstensi win32text tidak. Ini berarti Anda dapat menonaktifkan win32text dan mengaktifkan eol dan
filter Anda akan tetap berfungsi. Anda hanya perlu menyaring ini sampai Anda menyiapkan
.hgeol file.
Grafik win32text.melarang* kait yang disediakan oleh ekstensi win32text telah disatukan menjadi a
kait tunggal bernama eol.checkheadshook. Hook akan mencari akhir baris yang diharapkan dari
itu .hgeol file, yang berarti Anda harus bermigrasi ke a .hgeol file terlebih dahulu sebelum menggunakan
menghubungkan. eol.checkheadshook hanya memeriksa kepala, revisi tidak valid menengah akan didorong.
Untuk melarang mereka sepenuhnya, gunakan eol.checkallhook kait. Kait ini paling baik digunakan sebagai
pretxnchangegroup kait.
Lihat hg membantu pola untuk informasi lebih lanjut tentang pola glob yang digunakan.
extdiff
perintah untuk mengizinkan program eksternal membandingkan revisi
Ekstensi Mercurial extdiff memungkinkan Anda menggunakan program eksternal untuk membandingkan revisi,
atau revisi dengan direktori kerja. Program diff eksternal disebut dengan a
kumpulan opsi yang dapat dikonfigurasi dan dua argumen non-opsi: jalur ke direktori yang berisi
snapshot dari file untuk membandingkan.
Ekstensi extdiff juga memungkinkan Anda untuk mengonfigurasi perintah diff baru, jadi Anda tidak perlu
mengetik hg extdiff -p kdiff3 selalu.
[extdiff]
# tambahkan perintah baru yang menjalankan GNU diff(1) dalam mode 'perbedaan konteks'
cdiff = gdiff -Nprc5
## atau cara lama:
#cmd.cdiff = gdiff
#opts.cdiff = -Nprc5
# tambahkan perintah baru bernama meld, jalankan meld (tidak perlu menyebutkan nama dua kali). Jika
# executable berbaur tidak tersedia, alat berbaur di [merge-tools]
# akan digunakan, jika tersedia
berbaur =
# tambahkan perintah baru bernama vimdiff, jalankan gvimdiff dengan plugin DirDiff
# (melihat http://www.vim.org/scripts/script.php?script_id=102) Bukan
# Pengguna bahasa Inggris, pastikan untuk memasukkan "let g:DirDiffDynamicDiffText = 1" di
# .vimrc Anda
vimdiff = gvim -f "+berikutnya" \
"+jalankan 'DirDiff' fnameescape(argumen(0)) pelarian nama(argumen(1))"
Argumen alat dapat menyertakan variabel yang diperluas saat runtime:
$parent1, $plabel1 - nama file, label deskriptif dari induk pertama
$anak, $clabel - nama file, label deskriptif revisi anak
$parent2, $plabel2 - nama file, label deskriptif dari induk kedua
$root - root repositori
$parent adalah alias untuk $parent1.
Ekstensi extdiff akan mencari di bagian [diff-tools] dan [merge-tools] Anda untuk diff
argumen alat, ketika tidak ada yang ditentukan dalam [extdiff].
[extdiff]
kdiff3 =
[alat-diff]
kdiff3.diffargs=--L1 '$plabel1' --L2 '$clabel' $parent $child
Anda dapat menggunakan -I/-X dan daftar nama file atau direktori seperti biasa hg diff perintah. Itu
ekstensi extdiff membuat snapshot dari hanya file yang dibutuhkan, jadi jalankan diff eksternal
program sebenarnya akan cukup cepat (setidaknya lebih cepat daripada harus membandingkan keseluruhan
pohon).
Perintah
extdiff
gunakan program eksternal untuk membedakan repositori (atau file yang dipilih):
hg extdiff [OPT]... [FILE]...
Perlihatkan perbedaan antara revisi untuk file yang ditentukan, menggunakan program eksternal. Itu
default program yang digunakan adalah diff, dengan pilihan default “-Npru”.
Untuk memilih program lain, gunakan opsi -p/--program. Program ini akan melewati
nama dua direktori untuk membandingkan. Untuk meneruskan opsi tambahan ke program, gunakan
-o/--pilihan. Ini akan diteruskan sebelum nama direktori untuk dibandingkan.
Ketika dua argumen revisi diberikan, maka perubahan ditampilkan di antara revisi tersebut. Jika
hanya satu revisi yang ditentukan kemudian revisi itu dibandingkan dengan direktori kerja,
dan, ketika tidak ada revisi yang ditentukan, file direktori kerja dibandingkan dengan
induk.
Pilihan:
-P,--program
program perbandingan untuk dijalankan
-Hai,--pilihan
lulus opsi ke program perbandingan
-R,--putaran
revisi
-C,--mengubah
perubahan yang dibuat dengan revisi
--tambalan
bandingkan tambalan untuk dua revisi
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-S, --subrepos
rekursi menjadi subrepositori
[+] opsi yang ditandai dapat ditentukan beberapa kali
pembantu
otentikasi http dengan factotum
Ekstensi ini memungkinkan pembantu(4) fasilitas di Plan 9 dari platform Bell Labs ke
memberikan informasi otentikasi untuk akses HTTP. Entri konfigurasi ditentukan dalam
bagian autentikasi serta informasi autentikasi yang disediakan di URL repositori adalah
didukung penuh. Jika tidak ada awalan yang ditentukan, nilai "*" akan diasumsikan.
Secara default, kunci ditentukan sebagai:
proto=pass service=hg awalan= pengguna = !sandi=
Jika ekstensi factotum tidak dapat membaca kunci yang diperlukan, kunci tersebut akan diminta
secara interaktif.
Bagian konfigurasi tersedia untuk menyesuaikan perilaku runtime. Secara default, ini
entri adalah:
[pembantu]
dapat dieksekusi = /bin/auth/factotum
titik pemasangan = /mnt/factotum
layanan = hg
Entri yang dapat dieksekusi mendefinisikan path lengkap ke biner factotum. Entri titik mount
mendefinisikan jalur ke layanan file factotum. Terakhir, entri layanan mengontrol
nama layanan yang digunakan saat membaca kunci.
mengambil
tarik, perbarui, dan gabungkan dalam satu perintah (DIHAPUS)
Perintah
mengambil
tarik perubahan dari repositori jarak jauh, gabungkan perubahan baru jika diperlukan.:
hg ambil [SUMBER]
Ini menemukan semua perubahan dari repositori di jalur atau URL yang ditentukan dan menambahkannya ke
repositori lokal.
Jika perubahan yang ditarik menambahkan kepala cabang baru, kepala secara otomatis digabungkan, dan
hasil penggabungan dilakukan. Jika tidak, direktori kerja diperbarui untuk menyertakan
perubahan baru.
Saat penggabungan diperlukan, direktori kerja pertama kali diperbarui ke yang baru ditarik
perubahan. Perubahan lokal kemudian digabungkan menjadi perubahan yang ditarik. Untuk mengganti urutan penggabungan,
gunakan --switch-parent.
Lihat hg membantu tanggal untuk daftar format yang valid untuk -d/--date.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-R,--putaran
revisi tertentu yang ingin Anda tarik
-e, --edit
panggil editor pada pesan komit
--kekuatan-editor
edit pesan komit (DIHAPUS)
--beralih-induk
beralih orang tua saat menggabungkan
-M,--pesan
gunakan teks sebagai pesan komit
-aku,--file log
baca pesan komit dari file
-D,--tanggal
catat tanggal yang ditentukan sebagai tanggal komit
-kamu,--pengguna
rekam pengguna yang ditentukan sebagai pembuat
-e,--ssh
tentukan perintah ssh untuk digunakan
--jarak jauh
tentukan perintah hg untuk dijalankan di sisi jarak jauh
--merasa tidak aman
jangan verifikasi sertifikat server (abaikan konfigurasi web.cacerts)
[+] opsi yang ditandai dapat ditentukan beberapa kali
gpg
perintah untuk menandatangani dan memverifikasi set perubahan
Perintah
sigcheck
verifikasi semua tanda tangan yang mungkin ada untuk revisi tertentu:
hg tandatangani REV
verifikasi semua tanda tangan yang mungkin ada untuk revisi tertentu
menandatangani
tambahkan tanda tangan untuk revisi saat ini atau yang diberikan:
tanda hg [OPTION]... [REV]...
Jika tidak ada revisi yang diberikan, induk dari direktori kerja digunakan, atau tip jika tidak ada
revisi diperiksa.
Grafik gpg.cmd pengaturan config dapat digunakan untuk menentukan perintah yang akan dijalankan. Kunci default dapat berupa
ditentukan dengan gpg.kunci.
Lihat hg membantu tanggal untuk daftar format yang valid untuk -d/--date.
Pilihan:
-aku, --lokal
buat tanda tangan lokal
-F, --memaksa
tanda tangani meskipun sigfile diubah
--tidak ada komitmen
jangan komit sigfile setelah menandatangani
-k,--kunci
id kunci untuk ditandatangani
-M,--pesan
gunakan teks sebagai pesan komit
-e, --edit
panggil editor pada pesan komit
-D,--tanggal
catat tanggal yang ditentukan sebagai tanggal komit
-kamu,--pengguna
rekam pengguna yang ditentukan sebagai pembuat
tanda tangan
daftar perubahan yang ditandatangani:
tanda tangan
daftar perubahan yang ditandatangani
graflog
perintah untuk melihat grafik revisi dari shell (DEPRECATED)
Fungsionalitas ekstensi ini telah disertakan dalam inti Mercurial sejak versi 2.3.
Mohon gunakan hg mencatat -G ... sebagai gantinya.
Ekstensi ini menambahkan opsi --graph ke perintah masuk, keluar, dan log. Kapan ini
pilihan diberikan, representasi ASCII dari grafik revisi juga ditampilkan.
Perintah
sejenis semak
tampilkan riwayat revisi di samping grafik revisi ASCII:
hg glo [OPSI]... [FILE]
Cetak riwayat revisi di samping grafik revisi yang digambar dengan karakter ASCII.
Node yang dicetak sebagai karakter @ adalah induk dari direktori kerja.
Ini adalah alias untuk hg mencatat -G.
Pilihan:
-F, --mengikuti
ikuti riwayat perubahan, atau riwayat file di seluruh salinan dan ganti nama
--ikuti-pertama
hanya ikuti induk pertama dari kumpulan perubahan gabungan (DIHAPUS)
-D,--tanggal
tampilkan revisi yang cocok dengan spesifikasi tanggal
-C, --salinan
tampilkan file yang disalin
-k,--kata kunci
lakukan pencarian case-insensitive untuk teks tertentu
-R,--putaran
tunjukkan revisi atau revset yang ditentukan
--DIHAPUS
termasuk revisi di mana file dihapus
-M, --hanya-gabungan
hanya tampilkan gabungan (DIHAPUS)
-kamu,--pengguna
revisi yang dilakukan oleh pengguna
--hanya-cabang
tampilkan hanya perubahan di dalam cabang bernama yang diberikan (DIHAPUS)
-B,--cabang
tampilkan perubahan dalam cabang bernama yang diberikan
-P,--memangkas
jangan tampilkan revisi atau leluhurnya
-P, --tambalan
tampilkan tambalan
-G, --git
gunakan format git extended diff
-aku,--membatasi
batasi jumlah perubahan yang ditampilkan
-M, --tanpa penggabungan
jangan tampilkan gabungan
--status keluaran ringkasan perubahan gaya diffstat
-G, --grafik
tampilkan revisi DAG
--gaya
tampilkan menggunakan file peta template (DIHAPUS)
-T,--templat
tampilan dengan template
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
hgcia
kait untuk mengintegrasikan dengan layanan pemberitahuan CIA.vc
Ini dimaksudkan untuk dijalankan sebagai changegroup atau hook masuk. Untuk mengonfigurasinya, atur
opsi berikut di hgrc Anda:
[cia]
# nama pengguna CIA terdaftar Anda
pengguna = foo
# nama proyek di CIA
proyek = foo
# modul (subproyek) (opsional)
#modul = foo
# Tambahkan diffstat ke pesan log (opsional)
#diffstat = Salah
# Template yang akan digunakan untuk pesan log (opsional)
#template = {desc}\n{baseurl}{webroot}/rev/{node}-- {diffstat}
# Gaya yang akan digunakan (opsional)
#gaya = foo
# URL layanan pemberitahuan CIA (opsional)
# Anda dapat menggunakan mailto: URL untuk mengirim melalui email, mis
# mailto:[email dilindungi]
# Pastikan untuk mengatur email.from jika Anda melakukan ini.
#url = http://cia.vc/
# cetak pesan alih-alih mengirimnya (opsional)
#tes = Salah
# jumlah garis miring yang akan dihapus untuk jalur url
#strip = 0
[kait]
# salah satu dari ini:
changegroup.cia = python:hgcia.hook
#incoming.cia = python:hgcia.hook
[web]
# Jika Anda ingin hyperlink (opsional)
dasar = http://server/path/to/repo
hgk
jelajahi repositori dengan cara grafis
Ekstensi hgk memungkinkan penelusuran riwayat repositori dengan cara grafis. Dia
membutuhkan Tcl/Tk versi 8.4 atau yang lebih baru. (Tcl/Tk tidak didistribusikan dengan Mercurial.)
hgk terdiri dari dua bagian: skrip Tcl yang menampilkan dan menanyakan
informasi, dan ekstensi ke Mercurial bernama hgk.py, yang menyediakan kait untuk hgk ke
mendapatkan informasi. hgk dapat ditemukan di direktori contrib, dan ekstensi dikirimkan
di repositori hgext, dan perlu diaktifkan.
Grafik hg melihat perintah akan meluncurkan skrip hgk Tcl. Agar perintah ini berfungsi, hgk harus
di jalur pencarian Anda. Sebagai alternatif, Anda dapat menentukan jalur ke hgk dalam konfigurasi Anda
File:
[hgk]
jalur = /lokasi/dari/hgk
hgk dapat menggunakan ekstensi extdiff untuk memvisualisasikan revisi. Dengan asumsi Anda memiliki
sudah mengkonfigurasi perintah extdiff vdiff, cukup tambahkan:
[hgk]
vdiff=vdiff
Menu konteks revisi sekarang akan menampilkan entri tambahan untuk mengaktifkan vdiff saat melayang dan
revisi yang dipilih.
Perintah
melihat
mulai penampil riwayat interaktif:
hg tampilan [-l LIMIT] [REVRANGE]
mulai penampil sejarah interaktif
Pilihan:
-aku,--membatasi
batasi jumlah perubahan yang ditampilkan
menyoroti
penyorotan sintaks untuk hgweb (memerlukan Pigmen)
Itu tergantung pada pustaka penyorotan sintaks Pygments: http://pygments.org/
Ada opsi konfigurasi berikut:
[web]
pigmen_style = (default: colorful)
file sorotan = (default: ukuran('<5M'))
highlightonlymatchfilename = (default Salah)
sorotonlymatchnamafile hanya akan menyorot file jika jenisnya dapat diidentifikasi dengan
nama file mereka. Ketika ini tidak diaktifkan (default), Pigmen akan berusaha sangat keras untuk
mengidentifikasi jenis file dari konten dan kecocokan apa pun (bahkan kecocokan dengan keyakinan rendah
skor) akan digunakan.
histedit
pengeditan sejarah interaktif
Dengan ekstensi ini diinstal, Mercurial mendapatkan satu perintah baru: histedit. Penggunaannya adalah sebagai
berikut, dengan asumsi sejarah berikut:
@ 3[tip] 7c2fd3b9020c 2009-04-27 18:04 -0500 selama 42
| Tambahkan delta
|
o 2 030b686bedc4 2009-04-27 18:04 -0500 selama 42
| Tambahkan gamma
|
o 1 c561b4e977df 2009-04-27 18:04 -0500 selama 42
| Tambahkan beta
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 selama 42
Tambahkan alfa
Jika Anda ingin lari hg histedit c561b4e977df, Anda akan melihat file berikut terbuka di . Anda
editor:
pilih c561b4e977df Tambahkan beta
pilih 030b686bedc4 Tambahkan gamma
pilih 7c2fd3b9020c Tambahkan delta
# Edit riwayat antara c561b4e977df dan 7c2fd3b9020c
#
# Komit terdaftar dari yang paling sedikit hingga yang terbaru
#
# Perintah:
# p, pilih = gunakan komit
# e, edit = gunakan komit, tetapi berhenti untuk mengubah
# f, lipat = gunakan komit, tetapi gabungkan dengan yang di atas
# r, gulung = suka lipat, tetapi buang deskripsi komit ini
# d, drop = hapus komit dari riwayat
# m, mess = edit pesan komit tanpa mengubah konten komit
#
Dalam file ini, baris yang dimulai dengan # diabaikan. Anda harus menentukan aturan untuk masing-masing
revisi dalam sejarah Anda. Misalnya, jika Anda bermaksud menambahkan gamma sebelum beta, dan kemudian
ingin menambahkan delta dalam revisi yang sama dengan beta, Anda akan mengatur ulang file agar terlihat
seperti ini:
pilih 030b686bedc4 Tambahkan gamma
pilih c561b4e977df Tambahkan beta
lipat 7c2fd3b9020c Tambahkan delta
# Edit riwayat antara c561b4e977df dan 7c2fd3b9020c
#
# Komit terdaftar dari yang paling sedikit hingga yang terbaru
#
# Perintah:
# p, pilih = gunakan komit
# e, edit = gunakan komit, tetapi berhenti untuk mengubah
# f, lipat = gunakan komit, tetapi gabungkan dengan yang di atas
# r, gulung = suka lipat, tetapi buang deskripsi komit ini
# d, drop = hapus komit dari riwayat
# m, mess = edit pesan komit tanpa mengubah konten komit
#
Pada titik mana Anda menutup editor dan histedit mulai bekerja. Ketika Anda menentukan melipat
operasi, histedit akan membuka editor ketika melipat revisi itu bersama-sama, menawarkan
Anda berkesempatan untuk membersihkan pesan komit:
Tambahkan beta
***
Tambahkan delta
Edit pesan komit sesuai keinginan Anda, lalu tutup editor. Untuk contoh ini, mari kita
asumsikan bahwa pesan komit diubah menjadi Add beta dan delta. Setelah histedit berjalan
dan memiliki kesempatan untuk menghapus revisi lama atau sementara yang diperlukan, riwayatnya terlihat
seperti ini:
@ 2[tip] 989b4d060121 2009-04-27 18:04 -0500 selama 42
| Tambahkan beta dan delta.
|
o 1 081603921c3f 2009-04-27 18:04 -0500 siang42
| Tambahkan gamma
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 selama 42
Tambahkan alfa
Perhatikan bahwa histedit tidak tidak hapus revisi apa pun (bahkan yang sementara) sampai setelahnya
itu telah menyelesaikan semua operasi pengeditan, jadi mungkin akan melakukan beberapa strip
operasi ketika selesai. Untuk contoh di atas, itu harus menjalankan strip dua kali. Strip bisa
lambat tergantung pada berbagai faktor, jadi Anda mungkin perlu sedikit bersabar. Kamu bisa
memilih untuk menyimpan revisi asli dengan melewati --menyimpan bendera.
Grafik mengedit operasi akan mengembalikan Anda ke prompt perintah, memungkinkan Anda untuk mengedit file
bebas, atau bahkan menggunakan hg catatan untuk melakukan beberapa perubahan sebagai komit terpisah. Saat kamu
selesai, setiap perubahan uncommit yang tersisa akan dilakukan juga. Setelah selesai, jalankan hg
histedit --melanjutkan untuk menyelesaikan langkah ini. Anda akan diminta untuk pesan komit baru, tapi
pesan komit default akan menjadi pesan asli untuk mengedit revisi ed.
Grafik pesan operasi akan memberi Anda kesempatan untuk merevisi pesan komit tanpa mengubah
isi. Ini adalah jalan pintas untuk melakukan mengedit segera diikuti oleh hg histedit
--lanjutkan`.
If histedit menghadapi konflik saat memindahkan revisi (sambil menangani memilih or melipat),
itu akan berhenti dengan cara yang mirip dengan mengedit dengan perbedaan bahwa itu tidak akan meminta Anda untuk
komit pesan saat selesai. Jika Anda memutuskan pada titik ini bahwa Anda tidak menyukai seberapa banyak pekerjaan itu
akan mengatur ulang sejarah, atau Anda membuat kesalahan, Anda dapat menggunakan hg histedit --menggugurkan
untuk meninggalkan perubahan baru yang telah Anda buat dan kembali ke keadaan sebelum Anda mencoba
edit riwayat Anda.
Jika kita mengkloning repositori contoh histedit-ed di atas dan menambahkan empat perubahan lagi, sehingga
kami memiliki sejarah berikut:
@ 6[tip] 038383181893 2009-04-27 18:04 -0500 stefan
| Tambahkan theta
|
o 5 140988835471 2009-04-27 18:04 -0500 stefan
| Tambahkan eta
|
o 4 122930637314 2009-04-27 18:04 -0500 stefan
| Tambahkan zeta
|
o 3 836302820282 2009-04-27 18:04 -0500 stefan
| Tambahkan epsilon
|
o 2 989b4d060121 2009-04-27 18:04 -0500 selama 42
| Tambahkan beta dan delta.
|
o 1 081603921c3f 2009-04-27 18:04 -0500 siang42
| Tambahkan gamma
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 selama 42
Tambahkan alfa
Jika kamu lari hg histedit --keluar pada klon maka itu sama dengan menjalankan hg histedit
836302820282. Jika Anda memerlukan rencana untuk mendorong ke repositori yang tidak terdeteksi oleh Mercurial
terkait dengan repo sumber, Anda dapat menambahkan --memaksa .
config
Baris aturan Histedit terpotong menjadi 80 karakter secara default. Anda dapat menyesuaikan ini
perilaku dengan mengatur panjang yang berbeda di file konfigurasi Anda:
[histori]
linelen = 120 # potong garis aturan pada 120 karakter
hg histedit mencoba untuk secara otomatis memilih revisi dasar yang sesuai untuk digunakan. Ke
ubah revisi dasar mana yang digunakan, tentukan revset di file konfigurasi Anda:
[histori]
defaultrev = hanya(.) & draf()
Secara default, setiap revisi yang diedit harus ada dalam perintah histedit. Untuk menghapus
revisi yang perlu Anda gunakan menjatuhkan operasi. Anda dapat mengonfigurasi drop menjadi implisit untuk
komit yang hilang dengan menambahkan:
[histori]
dropmissing = Benar
Perintah
histedit
edit riwayat perubahan secara interaktif:
hg histedit [OPSI] ([LELUHUR] | --keluar [URL])
Perintah ini memungkinkan Anda mengedit serangkaian rangkaian perubahan linier (hingga dan termasuk yang berfungsi
direktori, yang harus bersih). Kamu bisa:
· memilih untuk [kembali] memesan set perubahan
· menjatuhkan untuk menghilangkan set perubahan
· kekacauan untuk menulis ulang pesan komit changeset
· melipat untuk menggabungkannya dengan set perubahan sebelumnya
· menggulung suka lipat, tetapi buang deskripsi komit ini
· mengedit untuk mengedit set perubahan ini
Ada beberapa cara untuk memilih root changeset:
· Tentukan LEluhur secara langsung
· Gunakan --outgoing -- ini akan menjadi rangkaian perubahan linier pertama yang tidak termasuk dalam tujuan.
(Lihat hg membantu config.default-push)
· Jika tidak, nilai dari opsi konfigurasi "histedit.defaultrev" digunakan sebagai penyetelan ulang untuk
pilih revisi dasar ketika ANCESTOR tidak ditentukan. Revisi pertama dikembalikan oleh
penyetelan ulang digunakan. Secara default, ini memilih riwayat yang dapat diedit yang unik untuk
nenek moyang dari direktori kerja.
Jika Anda menggunakan --outgoing, perintah ini akan dibatalkan jika ada revisi keluar yang ambigu.
Misalnya, jika ada beberapa cabang yang berisi revisi keluar.
Gunakan "min(outgoing() dan ::.)" atau spesifikasi revset serupa alih-alih --outgoing to
tentukan edit target revisi persis dalam situasi ambigu seperti itu. Melihat hg membantu revset untuk
detail tentang memilih revisi.
contoh:
· Sejumlah perubahan telah dilakukan. Revisi 3 tidak lagi diperlukan.
Mulai pengeditan riwayat dari revisi 3:
hg histedit -r 3
Editor terbuka, berisi daftar revisi, dengan tindakan spesifik yang ditentukan:
pilih 5339bf82f0ca 3 Zworgle the foobar
pilih 8ef592ce7cc4 4 Bedakan zerlog
pilih 0a9639fcda9d 5 Morgify the cromulancy
Informasi tambahan tentang tindakan yang mungkin diambil muncul di bawah daftar
revisi.
Untuk menghapus revisi 3 dari sejarah, tindakannya (di awal yang relevan
baris) diubah menjadi 'jatuhkan':
jatuhkan 5339bf82f0ca 3 Zworgle foobar
pilih 8ef592ce7cc4 4 Bedakan zerlog
pilih 0a9639fcda9d 5 Morgify the cromulancy
· Sejumlah perubahan telah dilakukan. Revisi 2 dan 4 perlu ditukar.
Mulai pengeditan riwayat dari revisi 2:
hg histedit -r 2
Editor terbuka, berisi daftar revisi, dengan tindakan spesifik yang ditentukan:
pilih 252a1af424ad 2 Blorb a morgwazzle
pilih 5339bf82f0ca 3 Zworgle the foobar
pilih 8ef592ce7cc4 4 Bedakan zerlog
Untuk menukar revisi 2 dan 4, barisnya ditukar di editor:
pilih 8ef592ce7cc4 4 Bedakan zerlog
pilih 5339bf82f0ca 3 Zworgle the foobar
pilih 252a1af424ad 2 Blorb a morgwazzle
Mengembalikan 0 jika berhasil, 1 jika intervensi pengguna diperlukan (tidak hanya untuk "edit" yang disengaja
perintah, tetapi juga untuk menyelesaikan konflik yang tidak terduga).
Pilihan:
--perintah
baca suntingan riwayat dari file yang ditentukan
-C, --melanjutkan
lanjutkan pengeditan yang sedang berlangsung
--edit-rencana
edit daftar tindakan yang tersisa
-k, --menyimpan
jangan hapus node lama setelah pengeditan selesai
--menggugurkan
batalkan pengeditan yang sedang berlangsung
-Hai, --keluar
perubahan tidak ditemukan di tujuan
-F, --memaksa
paksa keluar bahkan untuk repositori yang tidak terkait
-R,--putaran
revisi pertama yang akan diedit
[+] opsi yang ditandai dapat ditentukan beberapa kali
kata kunci
perluas kata kunci dalam file yang dilacak
Ekstensi ini memperluas $Keywords$ seperti RCS/CVS atau yang disesuaikan sendiri dalam file teks yang dilacak
dipilih oleh konfigurasi Anda.
Kata kunci hanya diperluas di repositori lokal dan tidak disimpan dalam riwayat perubahan. Itu
mekanisme dapat dianggap sebagai kemudahan bagi pengguna saat ini atau untuk arsip
distribusi.
Kata kunci diperluas ke data changeset yang berkaitan dengan perubahan terbaru relatif terhadap
induk direktori kerja dari setiap file.
Konfigurasi dilakukan di bagian [keyword], [keywordset] dan [keywordmaps] dari hgrc
file.
Contoh:
[kata kunci]
# perluas kata kunci di setiap file python kecuali yang cocok dengan "x*"
**.py =
x* = abaikan
[kumpulan kata kunci]
# lebih suka svn- daripada peta kata kunci default seperti cvs
svn = Benar
Catatan Semakin spesifik Anda dalam pola nama file Anda, semakin sedikit Anda kehilangan kecepatan dalam jumlah besar
repositori.
Untuk pemetaan template [peta kata kunci] dan demonstrasi perluasan dan kontrol berjalan hg kwdemo.
Lihat hg membantu template untuk daftar template dan filter yang tersedia.
Tiga filter template tanggal tambahan disediakan:
tanggal utc
"2006/09/18 15:13:13"
svnutcdate
"2006-09-18 15:13:13Z"
svnisodat
"2006-09-18 08:13:13 -700 (Senin, 18 Sep 2006)"
Pemetaan template default (lihat dengan hg kwdemo -d) dapat diganti dengan yang disesuaikan
kata kunci dan template. Sekali lagi, lari hg kwdemo untuk mengontrol hasil konfigurasi Anda
perubahan.
Sebelum mengubah/menonaktifkan kata kunci aktif, Anda harus menjalankan hg menyusut untuk menghindari penyimpanan
kata kunci yang diperluas dalam riwayat perubahan.
Untuk memaksa ekspansi setelah mengaktifkannya, atau perubahan konfigurasi, jalankan hg kwexpand.
Perluasan yang mencakup lebih dari satu baris dan perluasan tambahan, seperti $Log$ CVS, adalah
tidak didukung. Peta templat kata kunci "Log = {desc}" diperluas ke baris pertama
deskripsi perubahan.
Perintah
kwdemo
cetak konfigurasi [keywordmaps] dan contoh perluasan:
hg kwdemo [-d] [-f RCFILE] [TEMPLATEMAP]...
Tampilkan peta kerangka kata kunci saat ini, khusus, atau default dan perluasannya.
Perluas konfigurasi saat ini dengan menetapkan peta sebagai argumen dan menggunakan -f/--rcfile untuk
sumber file hgrc eksternal.
Gunakan -d/--default untuk menonaktifkan konfigurasi saat ini.
Lihat hg membantu template untuk informasi tentang template dan filter.
Pilihan:
-D, --bawaan
tampilkan peta templat kata kunci default
-F,--file rc
baca peta dari rcfile
kwexpand
perluas kata kunci di direktori kerja:
hg kwexpand [OPSI]... [FILE]...
Jalankan setelah (kembali) mengaktifkan perluasan kata kunci.
kwexpand menolak untuk dijalankan jika file yang diberikan berisi perubahan lokal.
Pilihan:
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
file kw
tampilkan file yang dikonfigurasi untuk ekspansi kata kunci:
hg kwfiles [OPSI]... [FILE]...
Daftar file mana dalam direktori kerja yang cocok dengan konfigurasi [kata kunci]
pola.
Berguna untuk mencegah perluasan kata kunci yang tidak disengaja dan untuk mempercepat eksekusi dengan menyertakan
hanya file yang merupakan kandidat sebenarnya untuk ekspansi.
Lihat hg membantu kata kunci tentang bagaimana membangun pola baik untuk inklusi dan eksklusi dari
file.
Dengan -A/--all dan -v/--verbose kode yang digunakan untuk menunjukkan status file adalah:
K = kandidat perluasan kata kunci
k = kandidat perluasan kata kunci (tidak terlacak)
saya = diabaikan
i = diabaikan (tidak dilacak)
Pilihan:
-SEBUAH, --semua
tampilkan bendera status kata kunci dari semua file
-Saya, --mengabaikan
tampilkan file yang dikecualikan dari ekspansi
-kamu, --tidak dikenal
hanya tampilkan file yang tidak dikenal (tidak dilacak)
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
menyusut
kembalikan kata kunci yang diperluas di direktori kerja:
hg kwshrink [OPSI]... [FILE]...
Harus dijalankan sebelum mengubah/menonaktifkan kata kunci aktif.
kwshrink menolak untuk dijalankan jika file yang diberikan berisi perubahan lokal.
Pilihan:
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
file besar
lacak file biner besar
File biner besar cenderung tidak terlalu kompresibel, tidak terlalu difabel, dan tidak sama sekali
dapat digabungkan. File tersebut tidak ditangani secara efisien oleh format penyimpanan Mercurial (revlog),
yang didasarkan pada delta biner terkompresi; menyimpan file biner besar seperti biasa
File Mercurial menghabiskan bandwidth dan ruang disk dan meningkatkan penggunaan memori Mercurial.
Ekstensi file besar mengatasi masalah ini dengan menambahkan server klien terpusat
lapisan di atas Mercurial: file besar tinggal di a pusat menyimpan keluar di jaringan
di suatu tempat, dan Anda hanya mengambil revisi yang Anda butuhkan saat Anda membutuhkannya.
largefiles bekerja dengan mempertahankan "file standin" di .hglf/ untuk setiap file besar. Itu
standin berukuran kecil (41 byte: hash SHA-1 plus baris baru) dan dilacak oleh Mercurial.
Revisi file besar diidentifikasi oleh hash SHA-1 dari isinya, yang tertulis
ke standnya. largefiles menggunakan ID revisi itu untuk mendapatkan/menempatkan revisi largefile dari/ke
toko pusat. Ini menghemat ruang disk dan bandwidth, karena Anda tidak perlu
ambil semua revisi historis file besar saat Anda mengkloning atau menarik.
Untuk memulai repositori baru atau menambahkan file biner besar baru, cukup tambahkan --large ke . Anda hg menambahkan
memerintah. Sebagai contoh:
$ dd if=/dev/urandom of=jumlah data acak=2000
$ hg tambahkan --data acak besar
$ hg commit -m 'tambahkan data acak sebagai file besar'
Saat Anda mendorong set perubahan yang menambahkan/memodifikasi file besar ke repositori jarak jauh, itu
revisi file besar akan diunggah bersamaan dengan itu. Perhatikan bahwa Mercurial jarak jauh harus
juga mengaktifkan ekstensi file besar agar ini berfungsi.
Saat Anda menarik set perubahan yang memengaruhi file besar dari repositori jarak jauh, file besar
untuk changeset secara default tidak akan ditarik ke bawah. Namun, ketika Anda memperbarui ke a
revisi, file besar apa pun yang diperlukan oleh revisi itu diunduh dan di-cache (jika ada)
belum pernah diunduh sebelumnya). Salah satu cara untuk menarik file besar saat menarik adalah dengan menggunakan
--update, yang akan memperbarui copy pekerjaan Anda ke revisi terbaru yang ditarik (dan karenanya
mengunduh file besar baru).
Jika Anda ingin menarik file besar yang belum Anda perbarui, Anda dapat menggunakan pull with
itu --lfrev pilihan atau hg tarikan perintah.
Jika Anda tahu Anda menarik dari lokasi non-default dan ingin mengunduh semua
file besar yang sesuai dengan perubahan baru pada saat yang sama, maka Anda dapat menarik dengan
--lfrev "ditarik()".
Jika Anda hanya ingin memastikan bahwa Anda akan memiliki file besar yang diperlukan untuk digabungkan atau di-rebase
dengan kepala baru yang Anda tarik, maka Anda dapat menariknya --lfrev "kepala (ditarik ())" bendera
untuk terlebih dahulu mengunduh file besar apa pun yang baru di kepala yang Anda tarik.
Ingatlah bahwa akses jaringan sekarang mungkin diperlukan untuk memperbarui ke set perubahan yang Anda miliki
sebelumnya tidak diperbarui ke. Sifat ekstensi file besar berarti memperbarui adalah
tidak lagi dijamin sebagai operasi lokal saja.
Jika Anda sudah memiliki file besar yang dilacak oleh Mercurial tanpa ekstensi file besar, Anda
perlu mengonversi repositori Anda untuk mendapatkan manfaat dari file besar. Ini sudah selesai
pada pengatur terkenal. Pengatur ini menawarkan bantuan hukum kepada traderapabila trader berselisih dengan broker yang terdaftar dengan mereka. hg jika dikonversi perintah:
$ hg lfconvert --ukuran 10 oldrepo newrepo
Di repositori yang sudah memiliki file besar di dalamnya, file baru apa pun yang berukuran lebih dari 10MB akan
secara otomatis ditambahkan sebagai file besar. Untuk mengubah ambang batas ini, setel file besar.minsize in
file konfigurasi Mercurial Anda ke ukuran minimum dalam megabyte untuk dilacak sebagai file besar, atau
gunakan opsi --lfsize ke perintah add (juga dalam megabita):
[file besar]
ukuran kecil = 2
$hg tambahkan --lfsize 2
Grafik bigfiles.patterns opsi konfigurasi memungkinkan Anda untuk menentukan daftar pola nama file
(Lihat hg membantu pola) yang harus selalu dilacak sebagai file besar:
[file besar]
pola =
* .jpg
re:.*\.(png|bmp)$
perpustakaan.zip
konten/suara/*
File yang cocok dengan salah satu pola ini akan ditambahkan sebagai file besar terlepas dari jenisnya
ukuran.
Grafik file besar.minsize dan bigfiles.patterns opsi konfigurasi akan diabaikan untuk apa pun
repositori belum berisi file besar. Untuk menambahkan file besar pertama ke a
repositori, Anda harus secara eksplisit melakukannya dengan flag --large yang diteruskan ke hg menambahkan perintah.
Perintah
jika dikonversi
konversi repositori normal ke repositori file besar:
hg lfconvert TUJUAN SUMBER [FILE ...]
Ubah repositori SOURCE ke DEST repositori baru, identik dengan SOURCE kecuali itu
file tertentu akan dikonversi sebagai file besar: khususnya, file apa pun yang cocok dengan apa pun
POLA or yang ukurannya di atas ambang batas ukuran minimum diubah menjadi file besar. Itu
ukuran yang digunakan untuk menentukan apakah akan melacak file sebagai file besar atau tidak adalah ukuran
versi pertama dari file. Ukuran minimum dapat ditentukan dengan --size atau in
konfigurasi sebagai file besar.ukuran.
Setelah menjalankan perintah ini, Anda harus memastikan bahwa file besar diaktifkan di mana saja
Anda bermaksud untuk mendorong repositori baru.
Gunakan --to-normal untuk mengonversi file besar kembali ke file normal; setelah ini, DEST
repositori dapat digunakan tanpa file besar sama sekali.
Pilihan:
-S,--ukuran
ukuran minimum (MB) untuk file yang akan dikonversi sebagai file besar
--untuk-normal
konversi dari repo file besar ke repo normal
tarikan
tarik file besar untuk revisi yang ditentukan dari sumber yang ditentukan:
hg lfpull -r REV... [-e CMD] [--remotecmd CMD] [SUMBER]
Tarik file besar yang direferensikan dari set perubahan lokal tetapi hilang secara lokal, tarik
dari repositori jarak jauh ke cache lokal.
Jika SOURCE dihilangkan, jalur 'default' akan digunakan. Lihat hg membantu url keahlian yang lebih
informasi.
Beberapa contoh:
· tarik file besar untuk semua kepala cabang:
hg lfpull -r "head() dan tidak ditutup()"
· tarik file besar di cabang default:
hg lfpull -r "cabang (default)"
Pilihan:
-R,--putaran
tarik file besar untuk revisi ini
-e,--ssh
tentukan perintah ssh untuk digunakan
--jarak jauh
tentukan perintah hg untuk dijalankan di sisi jarak jauh
--merasa tidak aman
jangan verifikasi sertifikat server (abaikan konfigurasi web.cacerts)
[+] opsi yang ditandai dapat ditentukan beberapa kali
mq
mengelola setumpuk tambalan
Ekstensi ini memungkinkan Anda bekerja dengan tumpukan tambalan di repositori Mercurial. Ini mengelola
dua tumpukan tambalan - semua tambalan yang diketahui, dan tambalan yang diterapkan (bagian dari tambalan yang dikenal).
Patch yang dikenal direpresentasikan sebagai file patch di direktori .hg/patches. Tambalan yang diterapkan
keduanya adalah file tambalan dan set perubahan.
Tugas umum (gunakan hg membantu Command untuk lebih jelasnya):
buat patch baru qnew
impor tambalan yang ada qimport
cetak patch seri qseries
cetak tambalan yang diterapkan qapplied
tambahkan tambalan yang dikenal ke tumpukan qpush
hapus tambalan dari tumpukan qpop yang diterapkan
segarkan konten qrefresh tambalan teratas yang diterapkan
Secara default, mq akan secara otomatis menggunakan patch git saat diperlukan untuk menghindari kehilangan mode file
perubahan, salinan catatan, file biner atau pembuatan atau penghapusan file kosong. Perilaku ini
dapat dikonfigurasi dengan:
[meter persegi]
git = otomatis/simpan/ya/tidak
Jika diatur ke 'keep', mq akan mematuhi konfigurasi bagian [diff] sambil mempertahankan yang ada
git patch pada qrefresh. Jika diatur ke 'ya' atau 'tidak', mq akan menimpa bagian [diff]
dan selalu menghasilkan git atau tambalan biasa, mungkin kehilangan data dalam kasus kedua.
Mungkin diinginkan untuk mq perubahan set untuk disimpan dalam fase rahasia (lihat hg membantu fase),
yang dapat diaktifkan dengan pengaturan berikut:
[meter persegi]
rahasia = benar
Anda akan secara default mengelola antrian tambalan bernama "tambalan". Anda dapat membuat yang lain,
antrian tambalan independen dengan hg antrian perintah.
Jika direktori kerja berisi file yang tidak dikomit, qpush, qpop dan qgoto batalkan
langsung. Jika -f/--force digunakan, perubahan akan dibuang. Setelan:
[meter persegi]
keepchanges = Benar
buat mereka berperilaku seolah-olah --keep-changes diteruskan, dan perubahan lokal yang tidak bertentangan akan
ditoleransi dan dipertahankan. Jika opsi yang tidak kompatibel seperti -f/--force atau --exact adalah
berlalu, pengaturan ini diabaikan.
Ekstensi ini digunakan untuk memberikan perintah strip. Perintah ini sekarang tinggal di strip
perpanjangan.
Perintah
diterapkan
cetak tambalan yang sudah diterapkan:
hg q diterapkan [-1] [-s] [PATCH]
Mengembalikan 0 pada keberhasilan.
Pilihan:
-1, --terakhir
hanya tampilkan tambalan yang diterapkan sebelumnya
-S, --Ringkasan
cetak baris pertama tajuk tambalan
qclone
clone repositori utama dan patch secara bersamaan:
hg qclone [OPSI]... SUMBER [TUJUAN]
Jika sumbernya lokal, tujuan tidak akan memiliki tambalan yang diterapkan. Jika sumbernya jauh, ini
perintah tidak dapat memeriksa apakah tambalan diterapkan di sumber, jadi tidak dapat menjamin tambalan itu
tidak diterapkan di tujuan. Jika Anda mengkloning repositori jarak jauh, pastikan sebelum itu ada
tidak ada patch yang diterapkan.
Repositori patch sumber dicari di /.hg/patches secara default. Gunakan -p ke
berubah.
Direktori patch harus berupa repositori Mercurial bersarang, seperti yang akan dibuat oleh hg init
--mq.
Kembalikan 0 pada keberhasilan.
Pilihan:
--menarik gunakan protokol tarik untuk menyalin metadata
-kamu, --tidak diperbarui
jangan perbarui direktori kerja baru
--tidak terkompresi
gunakan transfer tidak terkompresi (cepat melalui LAN)
-P,--tambalan
lokasi repositori tambalan sumber
-e,--ssh
tentukan perintah ssh untuk digunakan
--jarak jauh
tentukan perintah hg untuk dijalankan di sisi jarak jauh
--merasa tidak aman
jangan verifikasi sertifikat server (abaikan konfigurasi web.cacerts)
qcommit
komit perubahan dalam repositori antrian (DIHAPUS):
hg qcommit [OPSI]... [FILE]...
Perintah ini tidak digunakan lagi; menggunakan hg melakukan --mq sebagai gantinya.
Pilihan:
-SEBUAH, --adremove
tandai file baru/hilang sebagai ditambahkan/dihapus sebelum melakukan
--dekat-cabang
tandai kepala cabang sebagai tutup
--mengubah
ubah induk direktori kerja
-S, --rahasia
gunakan fase rahasia untuk melakukan
-e, --edit
panggil editor pada pesan komit
-Saya, --interaktif
gunakan mode interaktif
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-M,--pesan
gunakan teks sebagai pesan komit
-aku,--file log
baca pesan komit dari file
-D,--tanggal
catat tanggal yang ditentukan sebagai tanggal komit
-kamu,--pengguna
rekam pengguna yang ditentukan sebagai pembuat
-S, --subrepos
rekursi menjadi subrepositori
[+] opsi yang ditandai dapat ditentukan beberapa kali
alias: qci
qhapus
hapus tambalan dari antrian:
hg qhapus [-k] [PATCH]...
Tambalan tidak boleh diterapkan, dan setidaknya satu tambalan diperlukan. tambalan yang tepat
pengenal harus diberikan. Dengan -k/--keep, file tambalan disimpan di tambalan
direktori.
Untuk berhenti mengelola tambalan dan memindahkannya ke riwayat permanen, gunakan hg selesai perintah.
Pilihan:
-k, --menyimpan
simpan file tambalan
-R,--putaran
berhenti mengelola revisi (DIHAPUS)
[+] opsi yang ditandai dapat ditentukan beberapa kali
alias: qremove qrm
qdiff
diff dari tambalan saat ini dan modifikasi selanjutnya:
hg qdiff [OPSI]... [FILE]...
Menampilkan perbedaan yang menyertakan patch saat ini serta perubahan apa pun yang telah dibuat
di direktori kerja sejak penyegaran terakhir (sehingga menunjukkan apa yang akan dilakukan oleh tambalan saat ini
menjadi setelah qrefresh).
penggunaan hg diff jika Anda hanya ingin melihat perubahan yang dibuat sejak qrefresh terakhir, atau hg ekspor
tip q jika Anda ingin melihat perubahan yang dibuat oleh tambalan saat ini tanpa menyertakan perubahan yang dibuat
sejak qrefresh.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-Sebuah, --teks
perlakukan semua file sebagai teks
-G, --git
gunakan format git extended diff
--nodate
hilangkan tanggal dari header diff
--tidak ada awalan
hilangkan awalan a/ dan b/ dari nama file
-P, --tampilkan-fungsi
tunjukkan fungsi apa saja yang terdapat pada setiap perubahan
--membalikkan
menghasilkan perbedaan yang membatalkan perubahan
-w, --abaikan-semua-ruang
abaikan spasi saat membandingkan garis
-B, --abaikan-ruang-perubahan
abaikan perubahan jumlah ruang putih
-B, --abaikan-baris-kosong
abaikan perubahan yang barisnya kosong semua
-kamu,--bersatu
jumlah baris konteks untuk ditampilkan
--status keluaran ringkasan perubahan gaya diffstat
--akar
menghasilkan perbedaan relatif terhadap subdirektori
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
selesai
pindahkan tambalan yang diterapkan ke dalam riwayat repositori:
hg qselesai [-a] [REV]...
Menyelesaikan revisi yang ditentukan (sesuai dengan tambalan yang diterapkan) dengan memindahkannya dari
kontrol mq ke dalam riwayat repositori reguler.
Menerima rentang revisi atau opsi -a/--applied. Jika --applied ditentukan, semua
revisi mq yang diterapkan dihapus dari kontrol mq. Jika tidak, revisi yang diberikan harus
di dasar tumpukan tambalan yang diterapkan.
Ini bisa sangat berguna jika perubahan Anda telah diterapkan ke repositori upstream,
atau jika Anda akan mendorong perubahan Anda ke upstream.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-Sebuah, --terapan
selesaikan semua perubahan yang diterapkan
lipat
lipat tambalan bernama ke tambalan saat ini:
hg qfold [-e] [-k] [-m TEKS] [-l FILE] PATCH...
Tambalan belum boleh diterapkan. Setiap tambalan akan diterapkan secara berurutan ke arus
patch dalam urutan yang diberikan. Jika semua tambalan berhasil diterapkan, tambalan saat ini akan menjadi
disegarkan dengan tambalan kumulatif baru, dan tambalan yang terlipat akan dihapus. Dengan
-k/--keep, file tambalan yang terlipat tidak akan dihapus setelahnya.
Header untuk setiap patch yang dilipat akan digabungkan dengan header patch saat ini,
dipisahkan oleh garis * * *.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-e, --edit
panggil editor pada pesan komit
-k, --menyimpan
simpan file tambalan yang terlipat
-M,--pesan
gunakan teks sebagai pesan komit
-aku,--file log
baca pesan komit dari file
qgoto
push atau pop patch hingga patch bernama berada di atas tumpukan:
hg qgoto [OPSI]... PATCH
Mengembalikan 0 pada keberhasilan.
Pilihan:
--terus-ubah
mentolerir perubahan lokal yang tidak bertentangan
-F, --memaksa
timpa perubahan lokal apa pun
--tanpa cadangan
jangan simpan salinan cadangan file
penjaga q
set atau cetak pelindung untuk tambalan:
hg qguard [-l] [-n] [PATCH] [-- [+PENJAGA]... [-PENJAGA]...]
Penjaga mengontrol apakah tambalan dapat didorong. Sebuah patch tanpa penjaga selalu didorong. SEBUAH
patch dengan pelindung positif ("+foo") didorong hanya jika hg qselect perintah memiliki
diaktifkan. Tambalan dengan pelindung negatif ("-foo") tidak pernah didorong jika hg qselect
perintah telah mengaktifkannya.
Tanpa argumen, cetak penjaga yang sedang aktif. Dengan argumen, atur penjaga untuk
bernama tambalan.
Catatan Menentukan pelindung negatif sekarang membutuhkan '--'.
Untuk mengatur pelindung di tambalan lain:
hg qguard other.patch -- +2.6.17 -stabil
Mengembalikan 0 pada keberhasilan.
Pilihan:
-aku, --Daftar
daftar semua tambalan dan pelindung
-N, --tidak ada
turunkan semua penjaga
qheader
cetak tajuk tambalan paling atas atau yang ditentukan:
hg qheader [PATCH]
Mengembalikan 0 pada keberhasilan.
qimport
impor tambalan atau set perubahan yang ada:
hg qimport [-e] [-n NAMA] [-f] [-g] [-P] [-r REV]... [FILE]...
Tambalan dimasukkan ke dalam seri setelah tambalan terakhir diterapkan. Jika tidak ada tambalan,
telah diterapkan, qimport menambahkan patch ke seri.
Patch akan memiliki nama yang sama dengan file sumbernya kecuali Anda memberinya yang baru dengan
-n/--nama.
Anda dapat mendaftarkan patch yang ada di dalam direktori patch dengan flag -e/--existing.
Dengan -f/--force, patch yang sudah ada dengan nama yang sama akan ditimpa.
Sebuah changeset yang ada dapat ditempatkan di bawah kontrol mq dengan -r/--rev (misalnya qimport --rev .
-n patch akan menempatkan revisi saat ini di bawah kontrol mq). Dengan -g/--git, tambalan
diimpor dengan --rev akan menggunakan format git diff. Lihat topik bantuan perbedaan untuk informasi
tentang mengapa hal ini penting untuk menjaga perubahan nama/salinan dan perubahan izin.
penggunaan hg selesai untuk menghapus set perubahan dari kontrol mq.
Untuk mengimpor patch dari input standar, berikan - sebagai file patch. Saat mengimpor dari
input standar, nama patch harus ditentukan menggunakan flag --name.
Untuk mengimpor tambalan yang ada saat mengganti namanya:
hg qimport -e existing-patch -n nama baru
Mengembalikan 0 jika impor berhasil.
Pilihan:
-e, --ada
impor file di direktori tambalan
-N,--nama
nama file tambalan
-F, --memaksa
menimpa file yang ada
-R,--putaran
tempatkan revisi yang ada di bawah kendali mq
-G, --git
gunakan format git extended diff
-P, --dorongan
qpush setelah mengimpor
[+] opsi yang ditandai dapat ditentukan beberapa kali
qinit
init repositori antrian baru (DIHAPUS):
hg qinit [-c]
Repositori antrian tidak berversi secara default. Jika -c/--create-repo ditentukan, qinit
akan membuat repositori bersarang terpisah untuk tambalan (qinit -c juga dapat dijalankan nanti untuk
mengonversi repositori tambalan yang tidak berversi menjadi yang berversi). Anda dapat menggunakan qcommit untuk
komit perubahan ke repositori antrian ini.
Perintah ini tidak digunakan lagi. Tanpa -c, itu tersirat oleh perintah lain yang relevan. Dengan -c,
menggunakan hg init --mq sebagai gantinya.
Pilihan:
-C, --buat-repo
buat repositori antrian
baru
buat tambalan baru:
hg qnew [-e] [-m TEKS] [-l FILE] PATCH [FILE]...
qnew membuat tambalan baru di atas tambalan yang saat ini diterapkan (jika ada). Patchnya akan menjadi
diinisialisasi dengan perubahan luar biasa di direktori kerja. Anda juga dapat menggunakan
-I/--include, -X/--exclude, dan/atau daftar file setelah nama patch untuk ditambahkan saja
perubahan ke file yang cocok dengan tambalan baru, meninggalkan sisanya sebagai modifikasi yang tidak dikomit.
-u/--user dan -d/--date dapat digunakan untuk mengatur pengguna dan tanggal (yang diberikan).
-U/--currentuser dan -D/--currentdate mengatur pengguna ke pengguna saat ini dan tanggal ke tanggal saat ini.
-e/--edit, -m/--message atau -l/--logfile mengatur header patch serta komit
pesan. Jika tidak ada yang ditentukan, header kosong dan pesan komit adalah '[mq]:
PATCH'.
Gunakan opsi -g/--git untuk menyimpan patch dalam format git extended diff. Baca perbedaannya
topik bantuan untuk informasi lebih lanjut tentang mengapa ini penting untuk mempertahankan perubahan izin
dan menyalin/mengganti nama informasi.
Mengembalikan 0 pada pembuatan patch baru yang berhasil.
Pilihan:
-e, --edit
panggil editor pada pesan komit
-F, --memaksa
impor perubahan yang tidak dikomit (DIHAPUS)
-G, --git
gunakan format git extended diff
-kamu, --pengguna saat ini
tambahkan "Dari: " menambal
-kamu,--pengguna
tambahkan "Dari: " menambal
-D, --tanggal sekarang
tambahkan "Tanggal: " menambal
-D,--tanggal
tambahkan "Tanggal: " menambal
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-M,--pesan
gunakan teks sebagai pesan komit
-aku,--file log
baca pesan komit dari file
[+] opsi yang ditandai dapat ditentukan beberapa kali
berikutnya
cetak nama tambalan yang dapat didorong berikutnya:
hg qberikutnya [-s]
Mengembalikan 0 pada keberhasilan.
Pilihan:
-S, --Ringkasan
cetak baris pertama tajuk tambalan
qpop
lepaskan tambalan saat ini dari tumpukan:
hg qpop [-a] [-f] [PATCH | INDEKS]
Tanpa argumen, muncul dari bagian atas tumpukan tambalan. Jika diberi nama patch, terus
memunculkan patch sampai patch yang disebutkan berada di bagian atas tumpukan.
Secara default, batalkan jika direktori kerja berisi perubahan yang tidak dikomit. Dengan
--keep-changes, batalkan hanya jika file yang tidak dikomit tumpang tindih dengan file yang ditambal. Dengan
-f/--force, buat cadangan dan buang perubahan yang dibuat pada file tersebut.
Kembalikan 0 pada keberhasilan.
Pilihan:
-Sebuah, --semua
buka semua tambalan
-N,--nama
nama antrean untuk dimunculkan (DIHAPUS)
--terus-ubah
mentolerir perubahan lokal yang tidak bertentangan
-F, --memaksa
lupakan perubahan lokal apa pun pada file yang ditambal
--tanpa cadangan
jangan simpan salinan cadangan file
qsebelumnya
cetak nama tambalan yang diterapkan sebelumnya:
hg qsebelumnya [-s]
Mengembalikan 0 pada keberhasilan.
Pilihan:
-S, --Ringkasan
cetak baris pertama tajuk tambalan
qpush
dorong tambalan berikutnya ke tumpukan:
hg qpush [-f] [-l] [-a] [--pindah] [PATCH | INDEKS]
Secara default, batalkan jika direktori kerja berisi perubahan yang tidak dikomit. Dengan
--keep-changes, batalkan hanya jika file yang tidak dikomit tumpang tindih dengan file yang ditambal. Dengan
-f/--force, backup dan patch atas perubahan yang tidak dikomit.
Kembalikan 0 pada keberhasilan.
Pilihan:
--terus-ubah
mentolerir perubahan lokal yang tidak bertentangan
-F, --memaksa
terapkan di atas perubahan lokal
-e, --akurat
terapkan tambalan target ke induknya yang direkam
-aku, --Daftar
daftar nama tambalan dalam teks komit
-Sebuah, --semua
terapkan semua tambalan
-M, --menggabungkan
bergabung dari antrian lain (DIHAPUS)
-N,--nama
gabungkan nama antrean (DIHAPUS)
--pindah susun ulang seri tambalan dan terapkan hanya tambalan
--tanpa cadangan
jangan simpan salinan cadangan file
antrian
mengelola beberapa antrian tambalan:
hg qqueue [OPSI] [ANTRIAN]
Mendukung peralihan antara antrian tambalan yang berbeda, serta membuat antrean tambalan baru
dan menghapus yang sudah ada.
Menghilangkan nama antrian atau menentukan -l/--list akan menampilkan antrian terdaftar - by
default antrian patch "normal" terdaftar. Antrian yang sedang aktif adalah
ditandai dengan "(aktif)". Menentukan --active hanya akan mencetak nama antrian aktif.
Untuk membuat antrian baru, gunakan -c/--create. Antrian secara otomatis diaktifkan, kecuali di
kasus di mana ada tambalan yang diterapkan dari antrian yang sedang aktif di
gudang. Kemudian antrian hanya akan dibuat dan switching akan gagal.
Untuk menghapus antrian yang ada, gunakan --delete. Anda tidak dapat menghapus antrian yang sedang aktif.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-aku, --Daftar
daftar semua antrian yang tersedia
--aktif
cetak nama antrian aktif
-C, --membuat
buat antrian baru
--ganti nama
ganti nama antrian aktif
--menghapus
hapus referensi ke antrian
--membersihkan
hapus antrian, dan hapus direktori tambalan
qrefresh
perbarui tambalan saat ini:
hg qrefresh [-I] [-X] [-e] [-m TEKS] [-l FILE] [-s] [FILE]...
Jika ada pola file yang disediakan, tambalan yang diperbarui hanya akan berisi modifikasi
yang cocok dengan pola tersebut; modifikasi yang tersisa akan tetap dalam pengerjaan
direktori.
Jika -s/--short ditentukan, file yang saat ini disertakan dalam tambalan akan disegarkan saja
seperti file yang cocok dan tetap di patch.
Jika -e/--edit ditentukan, Mercurial akan memulai editor yang dikonfigurasi untuk Anda masukkan
pesan. Jika qrefresh gagal, Anda akan menemukan cadangan pesan Anda di
.hg/pesan terakhir.txt.
hg add/remove/copy/rename berfungsi seperti biasa, meskipun Anda mungkin ingin menggunakan tambalan gaya git
(-g/--git atau [diff] git=1) untuk melacak salinan dan mengganti nama. Lihat topik bantuan perbedaan untuk lebih lanjut
informasi tentang format git diff.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-e, --edit
panggil editor pada pesan komit
-G, --git
gunakan format git extended diff
-S, --pendek
segarkan hanya file yang sudah ada di tambalan dan file yang ditentukan
-kamu, --pengguna saat ini
tambahkan/perbarui bidang penulis di tambalan dengan pengguna saat ini
-kamu,--pengguna
tambahkan/perbarui bidang penulis di tambalan dengan pengguna yang diberikan
-D, --tanggal sekarang
tambahkan/perbarui bidang tanggal di tambalan dengan tanggal saat ini
-D,--tanggal
tambahkan/perbarui bidang tanggal di tambalan dengan tanggal yang diberikan
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-M,--pesan
gunakan teks sebagai pesan komit
-aku,--file log
baca pesan komit dari file
[+] opsi yang ditandai dapat ditentukan beberapa kali
ganti nama
ganti nama tambalan:
hg qrename PATCH1 [PATCH2]
Dengan satu argumen, ganti nama patch saat ini menjadi PATCH1. Dengan dua argumen, ganti nama
PATCH1 ke PATCH2.
Mengembalikan 0 pada keberhasilan.
alias: qmv
qrestore
mengembalikan status antrian yang disimpan oleh revisi (DIHAPUS):
hg qrestore [-d] [-u] REV
Perintah ini tidak digunakan lagi, gunakan hg Rebase sebagai gantinya.
Pilihan:
-D, --menghapus
hapus simpan entri
-kamu, --memperbarui
perbarui direktori kerja antrian
qsave
simpan status antrian saat ini (DIHAPUS):
hg qsave [-m TEKS] [-l FILE] [-c] [-n NAMA] [-e] [-f]
Perintah ini tidak digunakan lagi, gunakan hg Rebase sebagai gantinya.
Pilihan:
-C, --salinan
salin direktori tambalan
-N,--nama
salin nama direktori
-e, --kosong
hapus file status antrian
-F, --memaksa
salinan paksa
-M,--pesan
gunakan teks sebagai pesan komit
-aku,--file log
baca pesan komit dari file
qselect
atur atau cetak tambalan yang dijaga untuk mendorong:
hg qpilih [OPSI]... [PELINDUNG]...
Gunakan hg penjaga q perintah untuk mengatur atau mencetak pelindung pada tambalan, lalu gunakan qselect untuk memberi tahu mq
penjaga mana yang akan digunakan. Tambalan akan didorong jika tidak memiliki pelindung atau pelindung positif apa pun
cocok dengan penjaga yang dipilih saat ini, tetapi tidak akan didorong jika ada penjaga negatif yang cocok
penjaga saat ini. Sebagai contoh:
qguard foo.patch -- -stable (penjaga negatif)
qguard bar.patch +stable (penjaga positif)
qpilih stabil
Ini mengaktifkan penjaga "stabil". mq akan melewati foo.patch (karena memiliki negatif
cocok) tetapi tekan bar.patch (karena memiliki kecocokan positif).
Tanpa argumen, cetak penjaga yang sedang aktif. Dengan satu argumen, setel yang aktif
menjaga.
Gunakan -n/--none untuk menonaktifkan penjaga (tidak perlu argumen lain). Ketika tidak ada penjaga
aktif, tambalan dengan penjaga positif dilewati dan tambalan dengan penjaga negatif adalah
didorong.
qselect dapat mengubah pelindung pada patch yang diterapkan. Itu tidak memunculkan tambalan yang dijaga oleh
bawaan. Gunakan --pop untuk memunculkan kembali tambalan yang terakhir diterapkan yang tidak dilindungi. Menggunakan
--reapply (yang menyiratkan --pop) untuk mendorong kembali ke tambalan saat ini setelahnya, tetapi lewati
patch yang dijaga.
Gunakan -s/--series untuk mencetak daftar semua guard di file seri (tidak ada argumen lain
diperlukan). Gunakan -v untuk informasi lebih lanjut.
Mengembalikan 0 pada keberhasilan.
Pilihan:
-N, --tidak ada
nonaktifkan semua penjaga
-S, --seri
daftar semua penjaga dalam file seri
--pop pop ke sebelum patch yang diterapkan pertama kali
--melamar lagi
pop, lalu terapkan kembali tambalan
seri q
cetak seluruh file seri:
hg seri q [-ms]
Mengembalikan 0 pada keberhasilan.
Pilihan:
-M, --hilang
tambalan cetak tidak seri
-S, --Ringkasan
cetak baris pertama tajuk tambalan
qtop
cetak nama tambalan saat ini:
hg qtop [-s]
Mengembalikan 0 pada keberhasilan.
Pilihan:
-S, --Ringkasan
cetak baris pertama tajuk tambalan
diterapkan
cetak tambalan yang belum diterapkan:
hg qun diterapkan [-1] [-s] [PATCH]
Mengembalikan 0 pada keberhasilan.
Pilihan:
-1, --pertama
tampilkan hanya tambalan pertama
-S, --Ringkasan
cetak baris pertama tajuk tambalan
memberitahukan
kait untuk mengirim pemberitahuan push email
Ekstensi ini mengimplementasikan kait untuk mengirim pemberitahuan email saat set perubahan dikirim dari
atau diterima oleh repositori lokal.
Pertama, aktifkan ekstensi seperti yang dijelaskan di hg membantu ekstensi, dan daftarkan kail Anda
ingin lari. masuk dan ganti grup kait dijalankan ketika set perubahan diterima, sementara
ramah kait untuk perubahan yang dikirim ke repositori lain:
[kait]
# satu email untuk setiap set perubahan yang masuk
masuk.notify = python:hgext.notify.hook
# satu email untuk semua set perubahan yang masuk
changegroup.notify = python:hgext.notify.hook
# satu email untuk semua perubahan keluar
keluar.notify = python:hgext.notify.hook
Ini mendaftarkan kait. Untuk mengaktifkan notifikasi, pelanggan harus ditetapkan ke
repositori. Itu [pelanggan pengguna] bagian memetakan beberapa repositori ke penerima tertentu. Itu
[reposub] bagian memetakan beberapa penerima ke satu repositori:
[pelanggan pengguna]
# kuncinya adalah email pelanggan, nilainya adalah daftar pola repo yang dipisahkan koma
pengguna@host = pola
[reposub]
# kunci adalah pola repo, nilainya adalah daftar email pelanggan yang dipisahkan koma
pola = pengguna@host
A belt hold adalah bola mencocokkan jalur absolut ke repositori, secara opsional dikombinasikan dengan a
ekspresi ulang. Ekspresi revset, jika ada, dipisahkan dari glob dengan hash.
Contoh:
[reposub]
*/widget#branch(rilis) = [email dilindungi]
Ini dikirim ke [email dilindungi] setiap kali terjadi perubahan pada melepaskan pemicu cabang a
pemberitahuan di repositori apa pun yang diakhiri dengan widget.
Untuk menempatkannya di bawah manajemen pengguna langsung, [pelanggan pengguna] dan [reposub] bagian
dapat ditempatkan di tempat terpisah hgrc file dan digabungkan dengan referensi:
[memberitahu]
config = /path/ke/subscriptionsfile
Notifikasi tidak akan dikirim hingga beri tahu.test nilai diatur ke Salah; Lihat di bawah.
Konten notifikasi dapat diubah dengan entri konfigurasi berikut:
beri tahu.test
If Benar, cetak pesan ke stdout alih-alih mengirimnya. Standar: Benar.
beri tahu.sumber
Daftar sumber perubahan yang dipisahkan spasi. Notifikasi diaktifkan hanya ketika a
sumber changeset ada dalam daftar ini. Sumber mungkin:
melayani
perubahan yang diterima melalui http atau ssh
menarik
perubahan yang diterima melalui hg menarik
unbundle
perubahan yang diterima melalui hg unbundle
mendorong
perubahan yang dikirim atau diterima melalui hg mendorong
bundel
perubahan yang dikirim melalui hg unbundle
Standar: melayani.
beri tahu.strip
Jumlah garis miring awal yang akan dihapus dari jalur url. Secara default, notifikasi
referensi repositori dengan jalur absolutnya. beri tahu.strip memungkinkan Anda mengubahnya
menjadi jalur relatif. Sebagai contoh, beri tahu.strip=3 akan berubah /panjang/jalur/repositori
ke gudang. Standar: 0.
beri tahu.domain
Domain email default untuk pengirim atau penerima tanpa domain eksplisit.
beri tahu.style
File gaya untuk digunakan saat memformat email.
beri tahu.templat
Template untuk digunakan saat memformat email.
beri tahu. masuk
Template untuk digunakan saat dijalankan sebagai hook masuk, override beri tahu.templat.
notify.outgoing
Template untuk digunakan saat dijalankan sebagai hook keluar, override beri tahu.templat.
beri tahu.changegroup
Template untuk digunakan saat dijalankan sebagai hook changegroup, overriding beri tahu.templat.
beri tahu.maxdiff
Jumlah maksimum garis perbedaan untuk disertakan dalam email pemberitahuan. Setel ke 0 untuk menonaktifkan
diff, atau -1 untuk memasukkan semuanya. Standar: 300.
beri tahu.maxsubject
Jumlah maksimum karakter dalam baris subjek email. Standar: 67.
beri tahu.diffstat
Setel ke True untuk menyertakan diffstat sebelum konten diff. Standar: Benar.
beri tahu.gabung
Jika Benar, kirim pemberitahuan untuk menggabungkan perubahan. Standar: Benar.
beri tahu.mbox
Jika disetel, tambahkan email ke file mbox ini alih-alih mengirim. Standar: Tidak ada.
beri tahu.daripenulis
Jika disetel, gunakan committer set perubahan pertama dalam grup perubahan untuk "Dari"
bidang surat pemberitahuan. Jika tidak disetel, ambil pengguna dari repo push.
Standar: Salah.
Jika disetel, entri berikut juga akan digunakan untuk menyesuaikan notifikasi:
email.dari
Email Dari alamat yang akan digunakan jika tidak ada yang dapat ditemukan dalam konten email yang dihasilkan.
web.baseurl
Root repositori URL untuk digabungkan dengan jalur repositori saat membuat referensi. Melihat
juga beri tahu.strip.
pager
jelajahi keluaran perintah dengan pager eksternal
Untuk menyetel pager yang harus digunakan, setel variabel aplikasi:
[halaman]
pager = lebih sedikit -FRX
Jika tidak ada pager yang disetel, ekstensi pager menggunakan variabel lingkungan $PAGER. Jika tidak
pager.pager, atau $PAGER disetel, tidak ada pager yang digunakan.
Anda dapat menonaktifkan pager untuk perintah tertentu dengan menambahkannya ke daftar pager.ignore:
[halaman]
abaikan = versi, bantuan, perbarui
Anda juga dapat mengaktifkan pager hanya untuk perintah tertentu menggunakan pager.attend. Di bawah ini adalah
daftar default perintah yang akan di-page:
[halaman]
hadir = membubuhi keterangan, kucing, diff, ekspor, glog, log, qdiff
Mengatur pager.attend ke nilai kosong akan menyebabkan semua perintah di-page.
Jika pager.attend ada, pager.ignore akan diabaikan.
Terakhir, Anda dapat mengaktifkan dan menonaktifkan paging untuk perintah individual dengan
menghadiri- pilihan. Pengaturan ini lebih diutamakan daripada kehadiran dan abaikan yang ada
opsi dan default:
[halaman]
hadir-kucing = salah
Untuk mengabaikan perintah global seperti hg versi or hg membantu, Anda harus menentukannya di
file konfigurasi pengguna.
Untuk mengontrol apakah pager digunakan sama sekali untuk perintah individual, Anda dapat menggunakan
--halaman= :
- gunakan sesuai kebutuhan: `otomatis`.
- memerlukan pager: `yes` atau `on`.
- tekan pager: `no` atau `off` (nilai apa pun yang tidak dikenali
juga akan bekerja).
bom tambal sulam
perintah untuk mengirim perubahan sebagai (serangkaian) email tambalan
Seri ini dimulai dengan pengenalan "[PATCH 0 dari N]", yang menjelaskan seri
secara keseluruhan.
Setiap email tambalan memiliki baris Subjek "[PATCH M of N] ...", menggunakan baris pertama dari
ubah deskripsi sebagai teks subjek. Pesan tersebut berisi dua atau tiga bagian tubuh:
· Deskripsi changeset.
· [Opsional] Hasil menjalankan diffstat pada patch.
· Tambalan itu sendiri, seperti yang dihasilkan oleh hg ekspor.
Setiap pesan mengacu pada yang pertama dalam seri menggunakan In-Reply-To dan Referensi
header, sehingga akan muncul sebagai urutan dalam surat berulir dan pembaca berita, dan dalam surat
arsip.
Untuk mengonfigurasi default lainnya, tambahkan bagian seperti ini ke file konfigurasi Anda:
[surel]
dari = Nama Saya
ke = penerima1, penerima2, ...
cc = cc1, cc2, ...
bcc = bcc1, bcc2, ...
balasan-ke = alamat1, alamat2, ...
penggunaan [bom patch] sebagai nama bagian konfigurasi jika Anda perlu mengganti global [surel]
pengaturan alamat.
Kemudian Anda dapat menggunakan hg e-mail perintah untuk mengirimkan serangkaian perubahan sebagai patchbomb.
Anda juga dapat mengonfigurasi opsi metode di bagian email menjadi sendmail
mailer yang kompatibel atau isi bagian [smtp] agar ekstensi patchbomb dapat
secara otomatis mengirim patchbomb langsung dari commandline. Lihat [email] dan [smtp]
bagian dalam hgrc(5) untuk rincian.
Secara default, hg e-mail akan meminta a Untuk or CC tajuk jika Anda tidak menyediakannya melalui
konfigurasi atau baris perintah. Anda dapat menimpa ini untuk tidak pernah meminta dengan mengonfigurasi
nilai kosong:
[surel]
cc =
Anda dapat mengontrol penyertaan default dari pesan perkenalan dengan patchbomb.intro
opsi konfigurasi. Konfigurasi selalu ditimpa oleh flag baris perintah seperti
--intro dan --desc:
[bom patch]
intro=auto # sertakan pesan perkenalan jika lebih dari 1 patch (default)
intro=tidak pernah # tidak pernah menyertakan pesan perkenalan
intro=selalu # selalu sertakan pesan perkenalan
Anda dapat mengatur patchbomb untuk selalu meminta konfirmasi dengan menyetel patchbomb.konfirmasi benar.
Perintah
kirim perubahan melalui email:
hg email [OPSI]... [TUJUAN]...
Secara default, perbedaan dikirim dalam format yang dihasilkan oleh hg ekspor, satu per pesan. Itu
seri dimulai dengan pengenalan "[PATCH 0 dari N]", yang menjelaskan seri secara keseluruhan.
Setiap email tambalan memiliki baris Subjek "[PATCH M of N] ...", menggunakan baris pertama dari
ubah deskripsi sebagai teks subjek. Pesan berisi dua atau tiga bagian.
Pertama, deskripsi changeset.
Dengan opsi -d/--diffstat, jika program diffstat diinstal, hasil yang dijalankan
diffstat pada patch dimasukkan.
Akhirnya, tambalan itu sendiri, seperti yang dihasilkan oleh hg ekspor.
Dengan opsi -d/--diffstat atau --confirm, Anda akan disajikan ringkasan akhir dari
semua pesan dan meminta konfirmasi sebelum pesan dikirim.
Secara default, tambalan disertakan sebagai teks di badan email agar mudah ditinjau. Menggunakan
-a/--attach opsi akan membuat lampiran untuk tambalan. Dengan -i/--inline an
lampiran sebaris akan dibuat. Anda dapat menyertakan tambalan sebagai teks di badan email
dan sebagai lampiran biasa atau sebaris dengan menggabungkan -a/--attach atau -i/--inline dengan
opsi --body.
Dengan -o/--outgoing, email akan dibuat untuk patch yang tidak ditemukan di tujuan
repositori (atau hanya yang merupakan nenek moyang dari revisi yang ditentukan jika ada
asalkan)
Dengan -b/--bundle, set perubahan dipilih sebagai --outgoing, tetapi satu email berisi
bundel Mercurial biner sebagai lampiran akan dikirim. Menggunakan patchbomb.bundletype
opsi konfigurasi untuk mengontrol jenis bundel seperti hg bundel --Tipe.
Dengan -m/--mbox, alih-alih mempratinjau setiap pesan patchbomb di pager atau mengirim
pesan langsung, itu akan membuat file kotak surat UNIX dengan email patch. Kotak surat ini
file dapat dipratinjau dengan agen pengguna email apa pun yang mendukung file mbox UNIX.
Dengan -n/--test, semua langkah akan berjalan, tetapi email tidak akan terkirim. Anda akan diminta untuk
alamat penerima email, subjek, dan pesan pengantar yang menjelaskan tambalan
dari patchbomb Anda. Kemudian ketika semua selesai, pesan patchbomb ditampilkan. Jika PAGER
variabel lingkungan diatur, pager Anda akan diaktifkan sekali untuk setiap pesan patchbomb,
sehingga Anda dapat memverifikasi semuanya baik-baik saja.
Jika pengiriman email gagal, Anda akan menemukan cadangan pesan pengantar seri Anda di
.hg/email terakhir.txt.
Perilaku default dari perintah ini dapat disesuaikan melalui konfigurasi. (Melihat hg membantu
bom tambal sulam untuk detail)
contoh:
hg email -r 3000 # kirim patch 3000 saja
hg email -r 3000 -r 3001 # kirim patch 3000 dan 3001
hg email -r 3000:3005 # kirim tambalan 3000 hingga 3005
hg email 3000 # kirim patch 3000 (usang)
hg email -o # kirim semua tambalan tidak secara default
hg email -o DEST # kirim semua patch tidak dalam DEST
hg email -o -r 3000 # kirim semua leluhur 3000 tidak di default
hg email -o -r 3000 DEST # kirim semua leluhur 3000 tidak dalam DEST
hg email -b # kirim bundel semua tambalan tidak secara default
hg email -b DEST # kirim bundel semua tambalan yang tidak ada di DEST
hg email -b -r 3000 # bundel semua nenek moyang 3000 tidak di default
hg email -b -r 3000 DEST # bundel semua nenek moyang 3000 tidak dalam DEST
hg email -o -m mbox && # menghasilkan file mbox...
mutt -R -f mbox # ... dan lihat dengan mutt
hg email -o -m mbox && # menghasilkan file mbox ...
formail -s sendmail \ # ... dan gunakan formail untuk mengirim dari mbox
-bm -t < mbox # ... menggunakan sendmail
Sebelum menggunakan perintah ini, Anda harus mengaktifkan email di hgrc. Lihat [email]
bagian dalam hgrc(5) untuk rincian.
Pilihan:
-G, --git
gunakan format git extended diff
--polos
hilangkan tajuk tambalan hg
-Hai, --keluar
kirim perubahan yang tidak ditemukan di repositori target
-B, --bundel
kirim perubahan tidak dalam target sebagai bundel biner
--nama paket
nama file lampiran bundel (default: bundel)
-R,--putaran
revisi untuk dikirim
--memaksa
berjalan bahkan ketika repositori jarak jauh tidak terkait (dengan -b/--bundel)
--basis
set perubahan dasar untuk menentukan alih-alih tujuan (dengan -b/--bundel)
--pengantar
kirim email perkenalan untuk satu tambalan
--tubuh kirim tambalan sebagai teks pesan sebaris (default)
-Sebuah, --menempel
kirim tambalan sebagai lampiran
-Saya, --Di barisan
kirim tambalan sebagai lampiran sebaris
--bcc
alamat email penerima blind carbon copy
-C,--cc
alamat email penerima salinan
--Konfirmasi
minta konfirmasi sebelum kirim
-D, --diffstat
tambahkan output diffstat ke pesan
--tanggal
gunakan tanggal yang diberikan sebagai tanggal pengiriman
--des
gunakan file yang diberikan sebagai deskripsi seri
-F,--dari
alamat email pengirim
-N, --tes
cetak pesan yang akan dikirim
-M,--kotak
tulis pesan ke file mbox alih-alih mengirimnya
--membalas ke
alamat email balasan harus dikirim ke
-S,--subjek
subjek pesan pertama (intro atau patch tunggal)
--dalam-balas-ke
pengenal pesan untuk dibalas
--bendera
bendera untuk menambahkan awalan subjek
-T,--ke
alamat email penerima
-e,--ssh
tentukan perintah ssh untuk digunakan
--jarak jauh
tentukan perintah hg untuk dijalankan di sisi jarak jauh
--merasa tidak aman
jangan verifikasi sertifikat server (abaikan konfigurasi web.cacerts)
[+] opsi yang ditandai dapat ditentukan beberapa kali
pembersihan
perintah untuk menghapus file yang tidak terlacak dari direktori kerja
Perintah
pembersihan
menghapus file yang tidak dilacak oleh Mercurial:
hg bersihkan [OPSI]... [DIR]...
Hapus file yang tidak diketahui Mercurial. Ini berguna untuk menguji perubahan lokal dan tidak terikat
di pohon sumber yang dinyatakan bersih.
Ini berarti pembersihan akan menghapus yang berikut secara default:
· File tidak dikenal: file yang ditandai dengan "?" oleh hg status
· Direktori kosong: sebenarnya Mercurial mengabaikan direktori kecuali direktori tersebut berisi file di bawah
manajemen kontrol sumber
Tapi itu tidak akan tersentuh:
· File terlacak yang dimodifikasi dan tidak dimodifikasi
· File yang diabaikan (kecuali --all ditentukan)
· File baru ditambahkan ke repositori (dengan hg menambahkan)
Opsi --files dan --dirs dapat digunakan untuk pembersihan langsung untuk menghapus hanya file saja
direktori, atau keduanya. Jika tidak ada opsi yang diberikan, keduanya akan dihapus.
Jika direktori diberikan pada baris perintah, hanya file dalam direktori ini yang
dipertimbangkan.
Hati-hati dengan pembersihan, karena Anda dapat menghapus beberapa file yang lupa Anda tambahkan secara permanen
gudang. Jika Anda hanya ingin mencetak daftar file yang akan dibuat oleh program ini
hapus, gunakan opsi --print.
Pilihan:
-Sebuah, --batalkan-jika-salah
batalkan jika terjadi kesalahan
--semua bersihkan juga file yang diabaikan
--dir bersihkan direktori kosong
--file
bersihkan file
-P, --mencetak
cetak nama file alih-alih menghapusnya
-0, --cetak0
akhiri nama file dengan NUL, untuk digunakan dengan xargs (menyiratkan -p/--print)
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
alias: bersih
Rebase
perintah untuk memindahkan set revisi ke leluhur yang berbeda
Ekstensi ini memungkinkan Anda melakukan rebase changesets di repositori Mercurial yang ada.
Untuk informasi lebih lanjut: https://mercurial-scm.org/wiki/RebaseExtension
Perintah
Rebase
pindahkan changeset (dan turunan) ke cabang yang berbeda:
hg rebase [-s REV | -b REV] [-d REV] [OPSI]
Rebase menggunakan penggabungan berulang untuk mencangkokkan perubahan dari satu bagian sejarah (sumber)
ke yang lain (tujuan). Ini dapat berguna untuk linierisasi lokal berubah relatif
ke pohon pengembangan utama.
Komit yang diterbitkan tidak dapat didasarkan ulang (lihat hg membantu fase). Untuk menyalin komit, lihat hg membantu
korupsi.
Jika Anda tidak menentukan set perubahan tujuan (-d/--tujuan), rebase menggunakan cabang saat ini
tip sebagai tujuan. (Set perubahan tujuan tidak dimodifikasi dengan rebasing, tetapi baru
changeset ditambahkan sebagai turunannya.)
Berikut adalah cara untuk memilih set perubahan:
1. Pilih mereka secara eksplisit menggunakan --putaran.
2. Menggunakan --sumber untuk memilih root changeset dan menyertakan semua turunannya.
3. Menggunakan --basis untuk memilih set perubahan; rebase akan menemukan leluhur dan keturunan mereka
yang bukan juga nenek moyang destinasi.
4. Jika Anda tidak menentukan salah satu dari --putaran, sumber, atau --basis, rebase akan menggunakan --basis . as
atas.
Rebase akan menghancurkan set perubahan asli kecuali Anda menggunakan --menyimpan. Itu juga akan menggerakkan
bookmark (bahkan jika Anda melakukannya).
Beberapa set perubahan dapat dihapus jika tidak memberikan kontribusi perubahan (mis. penggabungan dari
cabang tujuan).
Berbeda bergabung, rebase tidak akan melakukan apa-apa jika Anda berada di ujung cabang dari cabang bernama dengan
dua kepala. Anda perlu secara eksplisit menentukan sumber dan/atau tujuan.
Jika rebase diinterupsi untuk menyelesaikan konflik secara manual, itu dapat dilanjutkan dengan
--continue/-c atau dibatalkan dengan --abort/-a.
contoh:
· pindahkan "perubahan lokal" (komit saat ini kembali ke titik percabangan) ke ujung cabang saat ini
setelah tarik:
hg rebase
· pindahkan satu perubahan ke cabang stabil:
hg rebase -r 5f493448 -d stabil
· menyambungkan komit dan semua turunannya ke bagian lain dari sejarah:
hg rebase --sumber c0c3 --dest 4cf9
· rebase semua yang ada di cabang yang ditandai dengan bookmark ke cabang default:
hg rebase --base fitur saya --dest default
· meruntuhkan urutan perubahan menjadi satu komit:
hg rebase --runtuh -r 1520:1525 -d .
· pindahkan cabang bernama sambil mempertahankan namanya:
hg rebase -r "branch(featureX)" -d 1.3 --keepbranches
Mengembalikan 0 jika berhasil, 1 jika tidak ada yang melakukan rebase atau ada konflik yang belum terselesaikan.
Pilihan:
-S,--sumber
rebase set perubahan dan turunan yang ditentukan
-B,--basis
rebase semuanya dari titik percabangan set perubahan yang ditentukan
-R,--putaran
rebase revisi ini
-D,--tujuan
rebase ke set perubahan yang ditentukan
--jatuh
ciutkan set perubahan yang dibuat ulang
-M,--pesan
gunakan teks sebagai pesan komit runtuh
-e, --edit
panggil editor pada pesan komit
-aku,--file log
baca komit pesan komit dari file
-k, --menyimpan
simpan perubahan asli
--keepbranch
pertahankan nama cabang asli
-D, --melepaskan
(DIHAPUS)
-Saya, --interaktif
(DIHAPUS)
-T,--alat
tentukan alat gabungan
-C, --melanjutkan
lanjutkan rebase yang terputus
-Sebuah, --menggugurkan
batalkan rebase yang terputus
--gaya
tampilkan menggunakan file peta template (DIHAPUS)
-T,--templat
tampilan dengan template
[+] opsi yang ditandai dapat ditentukan beberapa kali
catatan
perintah untuk secara interaktif memilih perubahan untuk komit/qrefresh
Perintah
catatan q
merekam patch baru secara interaktif:
hg qrecord [OPSI]... PATCH [FILE]...
Lihat hg membantu baru & hg membantu catatan untuk informasi lebih lanjut dan penggunaan.
catatan
secara interaktif pilih perubahan untuk dikomit:
hg rekam [OPSI]... [FILE]...
Jika daftar file dihilangkan, semua perubahan dilaporkan oleh hg status akan menjadi calon
rekaman.
Lihat hg membantu tanggal untuk daftar format yang valid untuk -d/--date.
Anda akan ditanya apakah akan merekam perubahan pada setiap file yang dimodifikasi, dan untuk file
dengan beberapa perubahan, untuk digunakan setiap perubahan. Untuk setiap pertanyaan, tanggapan berikut adalah:
mungkin:
y - catat perubahan ini
n - lewati perubahan ini
e - edit perubahan ini secara manual
s - lewati sisa perubahan pada file ini
f - catat perubahan yang tersisa ke file ini
d - selesai, lewati perubahan dan file yang tersisa
a - merekam semua perubahan pada semua file yang tersisa
q - berhenti, merekam tidak ada perubahan
? - tampilkan bantuan
Perintah ini tidak tersedia saat melakukan penggabungan.
Pilihan:
-SEBUAH, --adremove
tandai file baru/hilang sebagai ditambahkan/dihapus sebelum melakukan
--dekat-cabang
tandai kepala cabang sebagai tutup
--mengubah
ubah induk direktori kerja
-S, --rahasia
gunakan fase rahasia untuk melakukan
-e, --edit
panggil editor pada pesan komit
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
-M,--pesan
gunakan teks sebagai pesan komit
-aku,--file log
baca pesan komit dari file
-D,--tanggal
catat tanggal yang ditentukan sebagai tanggal komit
-kamu,--pengguna
rekam pengguna yang ditentukan sebagai pembuat
-S, --subrepos
rekursi menjadi subrepositori
-w, --abaikan-semua-ruang
abaikan spasi saat membandingkan garis
-B, --abaikan-ruang-perubahan
abaikan perubahan jumlah ruang putih
-B, --abaikan-baris-kosong
abaikan perubahan yang barisnya kosong semua
[+] opsi yang ditandai dapat ditentukan beberapa kali
menghubungkan kembali
membuat ulang tautan keras antara klon repositori
Perintah
menghubungkan kembali
buat ulang tautan keras antara dua repositori:
hg menautkan ulang [ASAL]
Ketika repositori dikloning secara lokal, file data mereka akan di-hardlink sehingga mereka
hanya menggunakan ruang dari satu repositori.
Sayangnya, penarikan berikutnya ke salah satu repositori akan merusak tautan keras untuk file apa pun
tersentuh oleh perubahan baru, bahkan jika kedua repositori akhirnya menarik perubahan yang sama.
Demikian pula, meneruskan --rev ke "hg clone" akan gagal menggunakan hardlink apa pun, kembali ke a
salinan lengkap dari repositori sumber.
Perintah ini memungkinkan Anda membuat ulang tautan keras tersebut dan mendapatkan kembali ruang yang terbuang itu.
Repositori ini akan ditautkan ulang untuk berbagi ruang dengan ORIGIN, yang harus berada di tempat yang sama
disk lokal. Jika ORIGIN dihilangkan, cari "default-relink", lalu "default", di [paths].
Jangan mencoba operasi baca apa pun pada repositori ini saat perintah sedang berjalan. (Keduanya
repositori akan dikunci terhadap penulisan.)
skema
memperluas skema dengan pintasan ke kumpulan repositori
Ekstensi ini memungkinkan Anda menentukan pintasan untuk URL induk dengan banyak repositori
untuk bertindak seperti skema, misalnya:
[skema]
pi = http://code.python.org/hg/
Setelah itu Anda dapat menggunakannya seperti:
hg klon py://trunk/
Selain itu ada dukungan untuk beberapa skema yang lebih kompleks, misalnya digunakan oleh Google
Kode:
[skema]
gcode = http://{1}.googlecode.com/hg/
Sintaksnya diambil dari template Mercurial, dan Anda memiliki jumlah variabel yang tidak terbatas,
dimulai dengan 1 {} dan melanjutkan 2 {}, 3 {} dan seterusnya. Variabel ini akan menerima
bagian dari URL yang disediakan, dibagi dengan /. Apa pun yang tidak ditentukan sebagai {bagian} hanya akan ditambahkan
ke sebuah URL.
Untuk kenyamanan, ekstensi menambahkan skema ini secara default:
[skema]
pi = http://hg.python.org/
bb = https://bitbucket.org/
bb+ssh = ssh://[email dilindungi]/
gcode = https://{1}.googlecode.com/hg/
tungku = https://{1}.kilnhg.com/Repo/
Anda dapat mengganti skema yang telah ditentukan sebelumnya dengan mendefinisikan skema baru dengan nama yang sama.
'share'
berbagi sejarah umum antara beberapa direktori kerja
secara otomatis Dikumpulkan Storage untuk Klon
Saat ekstensi ini aktif, hg clone dapat dikonfigurasi untuk berbagi/kumpulan secara otomatis
penyimpanan di beberapa klon. Mode ini secara efektif mengkonversi hg clone untuk hg clone + hg
'share'. Manfaat menggunakan mode ini adalah manajemen otomatis jalur toko dan
pengumpulan cerdas dari repositori terkait.
Berikut ini berbagi. opsi konfigurasi memengaruhi fitur ini:
bagikan.pool
Jalur sistem file tempat data repositori bersama akan disimpan. Ketika didefinisikan, hg clone
akan secara otomatis menggunakan penyimpanan repositori bersama alih-alih membuat toko di dalam
setiap klon.
share.poolnaming
Bagaimana nama direktori di bagikan.pool dibangun.
"identitas" berarti nama tersebut berasal dari perubahan pertama dalam repositori. Di dalam
mode ini, remote yang berbeda berbagi penyimpanan jika root/perubahan awalnya adalah
identik. Dalam mode ini, repositori bersama lokal adalah agregat dari semua
menemukan repositori jarak jauh.
"jarak jauh" berarti nama tersebut berasal dari jalur atau URL repositori sumber. Di dalam
mode ini, penyimpanan hanya dibagikan jika jalur atau URL diminta di hg clone
perintah cocok persis dengan repositori yang dikloning sebelumnya.
Mode penamaan default adalah "identitas".
Perintah
'share'
buat repositori bersama baru:
hg berbagi [-U] [-B] SUMBER [DEST]
Inisialisasi repositori baru dan direktori kerja yang membagikan riwayatnya (dan secara opsional
bookmark) dengan repositori lain.
Catatan menggunakan rollback atau ekstensi yang merusak/memodifikasi riwayat (mq, rebase, dll.) dapat
menyebabkan kebingungan yang cukup besar dengan klon bersama. Khususnya, jika dua dibagikan
klon keduanya diperbarui ke set perubahan yang sama, dan salah satunya menghancurkannya
changeset dengan rollback, klon lain tiba-tiba akan berhenti bekerja: semua operasi
akan gagal dengan "abort: direktori kerja memiliki induk yang tidak dikenal". Satu-satunya yang diketahui
solusinya adalah dengan menggunakan debugsetparents pada klon yang rusak untuk mengatur ulang ke changeset
yang masih ada.
Pilihan:
-kamu, --tidak diperbarui
jangan buat direktori kerja
-B, --bookmark
juga bagikan bookmark
berhenti berbagi
mengonversi repositori bersama menjadi yang normal:
hg berhenti berbagi
Salin data penyimpanan ke repo dan hapus data jalur bersama.
mengesampingkan
simpan dan pulihkan perubahan ke direktori kerja
Perintah "hg shelve" menyimpan perubahan yang dibuat ke direktori kerja dan mengembalikannya
perubahan, mengatur ulang direktori kerja ke keadaan bersih.
Kemudian, perintah "hg unshelve" mengembalikan perubahan yang disimpan oleh "hg shelve". Perubahan bisa
dipulihkan bahkan setelah memperbarui ke induk yang berbeda, dalam hal ini Mercurial bergabung
mesin akan menyelesaikan konflik jika perlu.
Anda dapat memiliki lebih dari satu perubahan yang disimpan dalam satu waktu; setiap perubahan yang disimpan memiliki
nama yang berbeda. Untuk detailnya, lihat bantuan untuk "rak hg".
Perintah
mengesampingkan
simpan dan sisihkan perubahan dari direktori kerja:
hg rak [OPSI]... [FILE]...
Rak mengambil file yang "status hg" laporkan sebagai tidak bersih, menyimpan modifikasi ke a
bundel (perubahan yang disimpan), dan mengembalikan file sehingga statusnya berfungsi
direktori menjadi bersih.
Untuk mengembalikan perubahan ini ke direktori kerja, gunakan "hg unshelve"; ini akan berhasil
bahkan jika Anda beralih ke komit yang berbeda.
Ketika tidak ada file yang ditentukan, "hg shelve" menyimpan semua file yang tidak bersih. Jika file tertentu atau
direktori diberi nama, hanya perubahan pada file-file itu yang disimpan.
Setiap perubahan yang disimpan memiliki nama yang membuatnya lebih mudah ditemukan nanti. Nama rak
ubah default menjadi berdasarkan bookmark aktif, atau jika tidak ada bookmark aktif,
cabang bernama saat ini. Untuk menentukan nama yang berbeda, gunakan --nama.
Untuk melihat daftar perubahan yang disimpan, gunakan: --Daftar pilihan. Untuk setiap perubahan yang disimpan,
ini akan mencetak nama, usia, dan deskripsinya; menggunakan --tambalan or --status lebih lanjut.
Untuk menghapus perubahan tertentu yang disimpan, gunakan --menghapus. Untuk menghapus semua perubahan yang disimpan, gunakan
--membersihkan.
Pilihan:
-SEBUAH, --adremove
tandai file baru/hilang sebagai ditambahkan/dihapus sebelum disimpan
-kamu, --tidak dikenal
simpan file yang tidak dikenal di rak
--membersihkan
hapus semua perubahan yang disimpan
--tanggal
rak dengan tanggal komit yang ditentukan
-D, --menghapus
hapus perubahan yang disimpan bernama
-e, --edit
panggil editor pada pesan komit
-aku, --Daftar
daftar rak saat ini
-M,--pesan
gunakan teks sebagai pesan rak
-N,--nama
gunakan nama yang diberikan untuk komit yang disimpan
-P, --tambalan
tampilkan tambalan
-Saya, --interaktif
mode interaktif, hanya berfungsi saat membuat rak
--status keluaran ringkasan perubahan gaya diffstat
-SAYA,--termasuk
sertakan nama yang cocok dengan pola yang diberikan
-X,--mengecualikan
mengecualikan nama yang cocok dengan pola yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
buka rak
mengembalikan perubahan yang disimpan ke direktori kerja:
hg unsheve [DIPERBAIKI]
Perintah ini menerima nama opsional dari perubahan yang disimpan untuk dipulihkan. Jika tidak ada yang diberikan,
perubahan disimpan terbaru digunakan.
Jika perubahan yang disimpan berhasil diterapkan, bundel yang berisi perubahan yang disimpan
dipindahkan ke lokasi cadangan (.hg/shelf-backup).
Karena Anda dapat memulihkan perubahan yang disimpan di atas komit sewenang-wenang, ada kemungkinan bahwa
pelepasan rak akan mengakibatkan konflik antara perubahan Anda dan komitmen Anda
unsheving ke. Jika ini terjadi, Anda harus menyelesaikan konflik, lalu gunakan --melanjutkan untuk
menyelesaikan operasi pelepasan rak. (Bundel tidak akan dipindahkan sampai Anda berhasil
menyelesaikan penguraian.)
(Atau, Anda dapat menggunakan --menggugurkan untuk meninggalkan unshelves yang menyebabkan konflik. Ini
mengembalikan perubahan yang tidak disimpan, dan membiarkan bundel di tempatnya.)
Setelah pelepasan yang berhasil, perubahan yang disimpan disimpan dalam direktori cadangan. Hanya
N cadangan terbaru disimpan. N default ke 10 tetapi dapat diganti menggunakan
rak.maxbackups opsi konfigurasi.
Stempel waktu dalam detik digunakan untuk menentukan urutan pencadangan. Lebih dari maxbackup cadangan adalah
disimpan, jika stempel waktu yang sama mencegah penentuan urutan yang tepat, demi keamanan.
Pilihan:
-Sebuah, --menggugurkan
batalkan operasi unshelve yang tidak lengkap
-C, --melanjutkan
melanjutkan operasi pelepasan yang tidak lengkap
-k, --menyimpan
simpan rak setelah unshelf
-T,--alat
tentukan alat gabungan
--tanggal
tetapkan tanggal untuk komit sementara (DIHAPUS)
menelanjangi
menghapus perubahan dan keturunan mereka dari sejarah
Ekstensi ini memungkinkan Anda untuk menghapus set perubahan dan semua turunannya dari
gudang. Lihat bantuan perintah untuk detailnya.
Perintah
menelanjangi
hapus set perubahan dan semua turunannya dari repositori:
hg strip [-k] [-f] [-B penanda] [-r] REV...
Perintah strip menghapus perubahan yang ditentukan dan semua turunannya. jika
direktori kerja memiliki perubahan yang tidak dikomit, operasi dibatalkan kecuali --force
bendera disediakan, dalam hal ini perubahan akan dibuang.
Jika induk dari direktori kerja dilucuti, maka direktori kerja akan
secara otomatis diperbarui ke leluhur terbaru yang tersedia dari induk yang dilucuti
setelah operasi selesai.
Setiap perubahan yang dilucuti disimpan di .hg/strip-cadangan sebagai satu bundel (lihat hg membantu bundel dan
hg membantu unbundle). Mereka dapat dipulihkan dengan menjalankan hg unbundle .hg/strip-backup/BUNDLE,
di mana BUNDLE adalah file bundel yang dibuat oleh strip. Perhatikan bahwa nomor revisi lokal
secara umum akan berbeda setelah restore.
Gunakan opsi --no-backup untuk membuang bundel cadangan setelah operasi selesai.
Strip bukanlah operasi penulisan ulang sejarah dan dapat digunakan pada perubahan di publik
fase. Tetapi jika set perubahan yang dilucuti telah didorong ke repositori jarak jauh, Anda akan
kemungkinan menarik mereka lagi.
Kembalikan 0 pada keberhasilan.
Pilihan:
-R,--putaran
strip revisi yang ditentukan (opsional, dapat menentukan revisi tanpa opsi ini)
-F, --memaksa
penghapusan paksa perubahan, buang perubahan yang tidak dikomit (tidak ada cadangan)
--tanpa cadangan
tidak ada cadangan
--tanpa cadangan
tidak ada cadangan (DIHAPUS)
-n diabaikan (DIHAPUS)
-k, --menyimpan
jangan ubah direktori kerja selama strip
-B,--penanda buku
hapus putaran yang hanya dapat dijangkau dari bookmark yang diberikan
[+] opsi yang ditandai dapat ditentukan beberapa kali
transplantasi
perintah untuk mentransplantasikan perubahan dari cabang lain
Ekstensi ini memungkinkan Anda untuk mentransplantasikan perubahan ke revisi induk lain, mungkin di
repositori lain. Transplantasi dilakukan dengan menggunakan tambalan 'diff'.
Patch yang ditransplantasikan dicatat dalam .hg/transplant/transplants, sebagai peta dari set perubahan
hash ke hashnya di repositori sumber.
Perintah
transplantasi
transplantasi perubahan dari cabang lain:
transplantasi hg [-s REPO] [-b CABANG [-a]] [-p REV] [-m REV] [REV]...
Kumpulan perubahan yang dipilih akan diterapkan di atas direktori kerja saat ini dengan log
dari set perubahan asli. Kumpulan perubahan disalin dan dengan demikian akan muncul dua kali di
sejarah dengan identitas yang berbeda.
Pertimbangkan untuk menggunakan perintah graft jika semuanya ada di dalam repositori yang sama - itu akan menggunakan
menyatu dan biasanya akan memberikan hasil yang lebih baik. Gunakan ekstensi rebase jika perubahan terjadi
tidak dipublikasikan dan Anda ingin memindahkannya alih-alih menyalinnya.
Jika --log ditentukan, pesan log akan memiliki komentar yang ditambahkan dalam bentuk:
(ditransplantasikan dari CHANGESETHASH)
Anda dapat menulis ulang pesan changelog dengan opsi --filter. Argumennya adalah
dipanggil dengan pesan changelog saat ini sebagai $1 dan patch sebagai $2.
--source/-s menentukan repositori lain yang akan digunakan untuk memilih set perubahan, seperti halnya
ditarik sementara. Jika --branch/-b ditentukan, revisi ini akan digunakan sebagai
kepala ketika memutuskan perubahan mana yang akan ditransplantasikan, seolah-olah hanya revisi ini yang dilakukan
telah ditarik. Jika --all/-a ditentukan, semua revisi hingga kepala ditentukan dengan
--cabang akan ditransplantasikan.
Contoh:
· transplantasi semua perubahan hingga REV di atas revisi Anda saat ini:
transplantasi hg --branch REV --all
Anda dapat secara opsional menandai kumpulan perubahan yang ditransplantasikan sebagai kumpulan perubahan gabungan. Anda tidak akan
diminta untuk mentransplantasikan leluhur apa pun dari transplantasi gabungan, dan Anda dapat menggabungkan
keturunan mereka secara normal alih-alih mencangkoknya.
Merge changesets dapat ditransplantasikan secara langsung dengan menentukan parent changeset yang tepat dengan
panggilan hg transplantasi --induk.
Jika tidak ada penggabungan atau revisi yang disediakan, hg transplantasi akan memulai rangkaian perubahan interaktif
Browser.
Jika aplikasi changeset gagal, Anda dapat memperbaiki penggabungan dengan tangan dan kemudian melanjutkan di mana Anda
tinggalkan dengan menelepon hg transplantasi --lanjutkan/-c.
Pilihan:
-S,--sumber
perubahan transplantasi dari REPO
-B,--cabang
gunakan set perubahan sumber ini sebagai kepala
-Sebuah, --semua
tarik semua perubahan hingga revisi --branch
-P,--memangkas
lewati REV
-M,--menggabungkan
bergabung di REV
--induk
orang tua untuk memilih saat mencangkokkan gabungan
-e, --edit
panggil editor pada pesan komit
--catatan tambahkan info transplantasi ke log pesan
-C, --melanjutkan
lanjutkan sesi transplantasi terakhir setelah memperbaiki konflik
--Saring
filter perubahan melalui perintah
[+] opsi yang ditandai dapat ditentukan beberapa kali
win32mbcs
izinkan penggunaan jalur MBCS dengan penyandian bermasalah
Beberapa pengkodean MBCS tidak baik untuk beberapa operasi jalur (yaitu jalur pemisahan, kasus
konversi, dll.) dengan byte yang disandikan. Kami menyebut pengkodean seperti itu (yaitu shift_jis dan
big5) sebagai "pengkodean bermasalah". Ekstensi ini dapat digunakan untuk memperbaiki masalah dengan itu
pengkodean dengan membungkus beberapa fungsi untuk dikonversi ke string Unicode sebelum operasi jalur.
Ekstensi ini berguna untuk:
· Pengguna Windows Jepang menggunakan pengkodean shift_jis.
· Pengguna Windows Cina menggunakan pengkodean big5.
· Semua pengguna yang menggunakan repositori dengan salah satu penyandian bermasalah pada case-insensitive
berkas sistem.
Ekstensi ini tidak diperlukan untuk:
· Setiap pengguna yang hanya menggunakan karakter ASCII di jalur.
· Setiap pengguna yang tidak menggunakan penyandian bermasalah.
Perhatikan bahwa ada beberapa batasan dalam menggunakan ekstensi ini:
· Anda harus menggunakan pengkodean tunggal dalam satu repositori.
· Jika jalur repositori diakhiri dengan 0x5c, .hg/hgrc tidak dapat dibaca.
· win32mbcs tidak kompatibel dengan ekstensi fixutf8.
Secara default, win32mbcs menggunakan encoding.encoding diputuskan oleh Mercurial. Anda dapat menentukan
pengkodean dengan opsi konfigurasi:
[win32mbcs]
pengkodean = sjis
Ini berguna bagi pengguna yang ingin melakukan dengan pesan log UTF-8.
win32teks
lakukan konversi baris baru otomatis (DIHAPUS)
Penghentian: Ekstensi win32text mengharuskan setiap pengguna untuk mengonfigurasi ekstensi
lagi dan lagi untuk setiap kloning karena konfigurasi tidak disalin saat kloning.
Oleh karena itu kami telah membuat keren sebagai alternatif. Itu keren menggunakan versi yang dikendalikan
file untuk konfigurasinya dan setiap klon karenanya akan menggunakan pengaturan yang tepat dari
permulaan.
Untuk melakukan konversi baris baru otomatis, gunakan:
[ekstensi]
teks win32 =
[menyandi]
** = kode pintar:
# atau ** = kode macen:
[membaca sandi]
** = smartdecode:
# atau ** = macdecode:
Jika tidak melakukan konversi, untuk memastikan Anda tidak melakukan CRLF/CR secara tidak sengaja:
[kait]
pretxncommit.crlf = python:hgext.win32text.forbidcrlf
# atau pretxncommit.cr = python:hgext.win32text.forbidcr
Untuk melakukan pemeriksaan yang sama pada server untuk mencegah CRLF/CR didorong atau ditarik:
[kait]
pretxnchangegroup.crlf = python:hgext.win32text.forbidcrlf
# atau pretxnchangegroup.cr = python:hgext.win32text.forbidcr
zeroconf
temukan dan iklankan repositori di jaringan lokal
Ekstensi zeroconf akan beriklan hg melayani instance melalui DNS-SD sehingga dapat
ditemukan menggunakan hg jalan perintah tanpa mengetahui alamat server.
Untuk mengizinkan orang lain menemukan repositori Anda menggunakan run hg melayani di repositori Anda:
$cd tes
$hg servis
Anda dapat menemukan repositori yang mendukung Zeroconf dengan menjalankan hg jalan:
jalur $hg
zc-tes = http://example.com:8000/tes
Gunakan hg online menggunakan layanan onworks.net
