menggoyangkan - Online di Awan

PROGRAM:

NAMA

goyangkan - terapkan tambalan yang ditolak dan lakukan perbedaan kata

RINGKASAN

menggoyangkan [fungsi] [pilihan] fillet [file]

DESKRIPSI

Fungsi utama dari menggoyangkan adalah menerapkan tambalan ke file dengan cara yang mirip dengan
tambalan(1) program.

Perbedaan khas dari menggoyangkan adalah bahwa ia akan mencoba menerapkan tambalan bahkan jika
bagian "sebelum" dari tambalan tidak cocok dengan file target dengan sempurna. Hal ini dicapai dengan
memecah file dan menambal menjadi kata-kata dan menemukan keselarasan kata-kata terbaik dalam file
dengan kata-kata di tambalan. Setelah keselarasan ini ditemukan, perbedaan apa pun (berdasarkan kata)
di patch diterapkan ke file sebaik mungkin.

Juga, menggoyangkan akan (dalam beberapa kasus) mendeteksi perubahan yang telah diterapkan, dan akan
abaikan mereka.

menggoyangkan memastikan bahwa setiap perubahan dalam tambalan diterapkan ke file target entah bagaimana. Jika sebuah
perubahan tertentu tidak dapat dilakukan dalam file, file tersebut dijelaskan untuk menunjukkan di mana
perubahan harus dilakukan dengan cara yang mirip dengan bergabung(1) program dengan -A pilihan. Setiap
anotasi berisi 3 komponen: sebagian dari file asli tempat perubahan seharusnya
diterapkan, sebagian dari tambalan yang tidak dapat dicocokkan dengan tepat di file, dan
teks yang harus menggantikan bagian tambalan itu. Ini dipisahkan oleh garis
mengandung tepat 7 karakter identik, baik '<', '|', '=', atau '>', mungkin
diikuti dengan kata deskriptif. Jadi
<<<<<<< ditemukan
Beberapa bagian dari file asli
||||||| mengharapkan
teks untuk menggantikan
=======
teks untuk menggantinya dengan
>>>>>>> penggantian
menunjukkan bahwa "teks untuk diganti" harus diganti dengan "teks untuk menggantinya dengan" di suatu tempat
di bagian file asli. Namun menggoyangkan tidak dapat menemukan tempat untuk membuat
perubahan ini.

menggoyangkan juga dapat menghasilkan laporan konflik yang hanya menunjukkan kata-kata yang terlibat
daripada menunjukkan seluruh baris. Dalam hal ini outputnya terlihat seperti:
<<<---asli|||lama===baru--->>>

Satu kemungkinan penggunaan menggoyangkan adalah untuk menjalankan tambalan untuk menerapkan beberapa tambalan, dan untuk mengumpulkan daftar
menolak dengan memantau pesan kesalahan dari patch. Kemudian untuk setiap file yang a
tolak ditemukan, jalankan
menggoyangkan --replace originalfile originalfile.rej

Akhirnya setiap file harus diperiksa untuk menyelesaikan konflik yang belum terselesaikan, dan untuk memastikan
tambalan yang diterapkan benar secara semantik.

Sebagai alternatif, file tambalan asli dapat diumpankan ke melihat-lihat mode sebagai
goyangkan -B < patchfile

Ini akan memungkinkan perubahan dan konflik untuk diperiksa dan, sampai batas tertentu, dimodifikasi;
dan kemudian hasilnya dapat disimpan.

PILIHAN
Opsi berikut dipahami oleh menggoyangkan. Beberapa di antaranya dijelaskan lebih lanjut
detail di bagian berikut tentang MERGE, DIFF, EXTRACT, dan BROWSE.

-m, --menggabungkan
Pilih fungsi "gabungkan". Ini adalah fungsi default.

-d, --dif
Pilih fungsi "diff". Ini menampilkan perbedaan antara file. Ini bisa
diberikan setelah --jelajahi (lihat di bawah) dalam hal ini patch atau diff dari dua file dapat
dilihat tanpa aslinya.

-x, --ekstrak
Pilih fungsi "ekstrak". Ini mengekstrak satu cabang tambalan atau file gabungan.

-B, --jelajahi
Pilih fungsi "jelajah". Ini mirip dengan "merge" (atau "diff") hanya dengan a
presentasi yang berbeda. Alih-alih hasilnya hanya dikirim ke standar
output, disajikan menggunakan GUI berbasis ncurses sehingga setiap potongan patch
dapat diperiksa untuk memahami konflik apa yang terlibat dan apa yang perlu
diabaikan agar tambalan digoyangkan ke tempatnya.

-w, --kata-kata
Minta agar semua operasi dan tampilan berbasis kata. Ini adalah default untuk
fungsi "berbeda".

-l, --garis
Minta agar semua operasi dan tampilan berbasis garis.

-b, --abaikan-kosong
Kurangi penekanan spasi (spasi, tab, dan baris baru) menentukan perbedaan dan
perubahan.

Biasanya spasi putih diperlakukan seperti kata yang dapat dicocokkan atau diubah oleh a
tambalan. Saat bendera ini berlaku, spasi hanya berfungsi sebagai pemisah antara
kata lain dan tidak cocok dengan dirinya sendiri. Efek dari ini adalah bahwa perubahan dalam
jumlah ruang putih tidak diperlakukan sebagai signifikan.

Tepatnya, spasi putih apa pun digabungkan dengan kata sebelumnya atau, dalam kasus ini
ruang terdepan pada sebuah garis, dengan kata berikut. Namun tidak terlibat dalam
perbandingan kata itu. Jika tambalan menghapus sebuah kata, spasi putih terlampir
dihapus juga. Jika tambalan menambahkan kata, spasi putih terlampir ditambahkan sebagai
baik.

Baris kosong, atau baris yang hanya berisi kosong, akan diperlakukan sebagai satu kata
yang akan cocok dengan baris kosong lainnya, tidak peduli berapa banyak spasi yang dimilikinya.

-b tidak berpengaruh --garis mode.

-p, --tambalan
Perlakukan file bernama terakhir sebagai tambalan alih-alih file (dengan --diff) atau gabungan
(--ekstrak). Di bergabung or melihat-lihat mode, -p mengharuskan ada tepat satu file yang
adalah tambalan dan yang dapat berisi tambalan ke banyak file. Tambalan digabungkan
ke dalam setiap file. Saat digunakan dalam bergabung mode, penggunaan ini membutuhkan --mengganti Option
karena menulis banyak file gabungan ke standar-out tidak praktis.

Saat memproses tambalan multi-file, -p dapat diikuti oleh argumen numerik
menunjukkan berapa banyak komponen nama file yang harus dihapus dari file yang disebutkan dalam
berkas tambalan. Jika tidak ada argumen numerik yang diberikan, menggoyangkan akan menyimpulkan yang sesuai
nomor berdasarkan file apa yang ada di sistem file.

-r, --mengganti
Biasanya keluaran gabungan ditulis ke keluaran standar. Dengan --mengganti, yang
file asli diganti dengan hasil gabungan. Di melihat-lihat mode, ini menginstruksikan
menggoyangkan untuk selalu menyimpan gabungan yang dihasilkan saat keluar.

-o, --keluaran=
Daripada menulis hasilnya ke stdout atau mengganti file asli, ini
meminta output ditulis ke file yang diberikan. Ini hanya berarti
dengan --menggabungkan or --jelajahi ketika diberi satu gabungan untuk dijelajahi.

Opsi ini menimpa -r.

-R, --membalikkan
Saat digunakan dengan diff fungsi, tukar file sebelum menghitung
perbedaan. Ketika digunakan dengan bergabung or melihat-lihat fungsi, menggoyangkan mencoba untuk
mengembalikan perubahan daripada menerapkannya.

-i, --tidak-abaikan
Biasanya goyangan akan mengabaikan perubahan pada tambalan yang tampaknya sudah terjadi
diterapkan dalam aslinya. Dengan bendera ini, perubahan tersebut dilaporkan sebagai konflik
bukannya diabaikan.

-W, --tunjukkan-goyangan
Saat digunakan dengan --menggabungkan, konflik yang dapat digoyang-goyangkan dilaporkan sebagai
bertentangan dengan bait tambahan yang menunjukkan apa hasilnya jika bendera ini
tidak digunakan. Bait tambahan diperkenalkan dengan baris yang mengandung 7
simbol untuk 'dan (&) karakter demikian:
<<<<<<< ditemukan
Beberapa bagian dari file asli
||||||| mengharapkan
teks untuk menggantikan
=======
teks untuk menggantinya dengan
&&&&&&& resolusi
Teks yang akan dihasilkan dari goyangan yang berhasil
>>>>>>> penggantian

--laporan-menggoyangkan
Jika penggabungan berhasil menerapkan semua perubahan, biasanya akan keluar dengan a
status sukses (0), hanya melaporkan kegagalan (1) jika terjadi konflik dan
beranotasi. Dengan --laporan-menggoyangkan menggoyangkan juga akan melaporkan kegagalan jika ada perubahan
harus digoyangkan. Ini bisa berguna ketika menggoyangkan digunakan untuk penggabungan otomatis
seperti git. Jika ada goyangan yang terjadi, git akan melaporkan kegagalan, dan hasilnya
dapat diperiksa untuk memastikan bahwa mereka dapat diterima.

-h, --membantu
Cetak pesan bantuan sederhana. Jika diberikan setelah salah satu pemilih fungsi
(--menggabungkan, --dif, --ekstrak, --jelajahi) bantuan khusus untuk fungsi tersebut ditampilkan.

-V, --Versi: kapan
Tampilkan nomor versi dari menggoyangkan.

-v, --bertele-tele
Aktifkan mode verbose. Saat ini tidak ada bedanya.

-q, --diam
Aktifkan mode senyap. Ini menekan pesan dari fungsi gabungan ketika ada
merupakan konflik yang tidak dapat diselesaikan.

KATA
menggoyangkan dapat membagi teks menjadi baris atau kata saat melakukan tugasnya. Sebuah garis itu sederhana
string karakter yang diakhiri oleh baris baru. Sebuah kata adalah salah satu dari maximal contiguous
string alfanumerik (termasuk garis bawah), string spasi maksimum yang berdekatan atau
karakter tab, atau karakter tunggal lainnya.

MENGGABUNGKAN
Fungsi gabungan memodifikasi teks yang diberikan dengan menemukan semua perubahan di antara dua teks lainnya
dan memaksakan perubahan tersebut pada teks yang diberikan.

Biasanya menggoyangkan berfokus pada kata-kata mana yang telah diubah untuk memaksimalkan kemungkinan
menemukan kecocokan yang baik dalam teks yang diberikan untuk konteks perubahan tertentu. Namun itu bisa
pertimbangkan hanya seluruh baris saja.

menggoyangkan mengekstrak tiga teks yang dibutuhkan dari file yang terdaftar di baris perintah.
Baik 1, 2, atau 3 file dapat dicantumkan, dan salah satu dari mereka mungkin berupa tanda hubung tunggal yang menandakan
masukan standar.

Jika satu file diberikan dan -p opsi tidak ada, file diperlakukan sebagai bergabung
file, yaitu output dari "merge -A" atau "wiggle". File seperti itu secara implisit berisi tiga
sungai dan ini diekstraksi dan dibandingkan.

Jika dua file diberikan, maka yang pertama hanya berisi teks utama, dan yang kedua adalah
diperlakukan sebagai file patch (output dari "diff -u" atau "diff -c", atau file ".rej" dari
tambalan) dan dua teks lainnya diambil dari itu.

Jika satu file diberikan bersama dengan -p opsi, file tersebut diperlakukan sebagai file tambalan
berisi nama-nama file yang ditambal. Dalam hal ini beberapa operasi penggabungan
dapat terjadi dan masing-masing mengambil satu aliran dari file bernama di tambalan, dan dua lainnya
dari tambalan itu sendiri. Itu --mengganti opsi diperlukan dan hasilnya ditulis kembali
ke file sasaran.

Akhirnya jika tiga file terdaftar, mereka dianggap berisi teks yang diberikan dan keduanya
teks lain secara berurutan.

Biasanya hasil penggabungan ditulis ke output standar. jika -r bendera diberikan,
output ditulis ke file yang menggantikan file asli yang diberikan. Dalam hal ini
file asli diubah namanya menjadi .pori akhiran (untuk "tambalan asli" yang masuk akal
jika Anda pertama kali menggunakan tambalan untuk menerapkan tambalan, dan kemudian gunakan menggoyangkan untuk menggoyangkan penolakan).

Selanjutnya jika -o opsi diberikan dengan nama file, output akan ditulis ke sana
mengajukan. Dalam hal ini tidak ada cadangan yang dibuat.

Jika tidak ada kesalahan yang terjadi (seperti kesalahan akses file) menggoyangkan akan keluar dengan status 0 jika semua
perubahan berhasil digabungkan, dan dengan status keluar 1 dan pesan singkat jika ada
perubahan tidak dapat digabungkan sepenuhnya dan malah disisipkan sebagai anotasi. Namun jika
antara --laporan-menggoyangkan or --tunjukkan-goyangan pilihan yang diberikan, menggoyangkan juga akan ada dengan
status 1 jika ada perubahan yang harus dilakukan meskipun ini berhasil.

Fungsi gabungan dapat beroperasi dalam tiga mode berbeda sehubungan dengan garis atau kata.

Dengan --garis opsi, seluruh baris dibandingkan dan konflik apa pun dilaporkan secara keseluruhan
garis yang perlu diganti.

Dengan --kata-kata pilihan, kata-kata individual dibandingkan dan konflik apa pun dilaporkan hanya
menutupi kata-kata yang terpengaruh. Ini menggunakan format konflik <<<|||===>>>.

Tanpa salah satu dari pilihan ini, pendekatan hybrid diambil. Kata individu adalah
dibandingkan dan digabungkan, tetapi ketika konflik ditemukan, seluruh garis di sekitarnya dilaporkan
seperti sedang berkonflik.

menggoyangkan akan memastikan bahwa setiap perubahan antara dua teks lainnya tercermin dalam
hasil penggabungan entah bagaimana. Ada empat cara berbeda agar perubahan dapat terjadi
tercermin.

1 Jika perubahan mengubah A untuk B dan A ditemukan di tempat yang cocok dalam aslinya
file, itu diganti dengan B. Ini termasuk kemungkinan bahwa B kosong, tapi
tidak A kosong.

2 Jika ditemukan perubahan yang hanya menambahkan B dan teks tepat sebelum dan
setelah penyisipan ditemukan berdekatan dalam file asli di tempat yang sesuai
tempat, lalu B disisipkan di antara teks-teks yang berdekatan.

3 Jika ditemukan perubahan mana yang berubah? A untuk B dan ini muncul (berdasarkan konteks) untuk
sejajar dengan B dalam aslinya, maka diasumsikan bahwa perubahan ini telah terjadi
diterapkan, dan perubahan diabaikan. Ketika ini terjadi, sebuah pesan yang mencerminkan
jumlah perubahan yang diabaikan dicetak oleh menggoyangkan. Pengoptimalan ini dapat
ditekan dengan -i bendera.

4 Jika ditemukan perubahan yang tidak sesuai dengan salah satu kemungkinan di atas, maka a
konflik dilaporkan seperti yang dijelaskan sebelumnya.

BERBEDA
Fungsi diff disediakan terutama untuk memungkinkan pemeriksaan keberpihakan yang menggoyangkan
dihitung antara teks dan yang digunakan untuk melakukan penggabungan.

Keluaran dari fungsi diff mirip dengan keluaran terpadu dari diff. Namun sementara
diff tidak menampilkan bentangan panjang teks umum, menggoyangkanmode diff menampilkan semuanya.

Saat menghitung perataan berbasis kata (default), menggoyangkan mungkin perlu menunjukkan kata-
perbedaan berdasarkan. Ini dilakukan dengan menggunakan ekstensi ke format unified-diff. Jika garis
dimulai dengan batang vertikal, kemudian dapat berisi bagian yang dikelilingi oleh multi-
tanda kurung karakter. Tanda kurung "<<<++" dan "++>>>" mengelilingi teks yang ditambahkan sementara "<<<--"
dan "-->>>" mengelilingi teks yang dihapus.

menggoyangkan dapat diberikan dua teks untuk membandingkan dalam salah satu dari tiga cara.

Jika hanya satu file yang diberikan, maka itu diperlakukan sebagai tambalan dan dua cabang dari itu
patch dibandingkan. Ini secara efektif memungkinkan tambalan untuk disempurnakan dari tambalan berbasis garis
ke tambalan berbasis kata.

Jika dua file diberikan, maka mereka biasanya dianggap sebagai teks sederhana untuk dibandingkan.

Jika dua file diberikan bersama dengan opsi --patch, maka file kedua diasumsikan
menjadi tambalan dan cabang pertama (dengan -1) atau kedua (dengan -2) diekstraksi dan
dibandingkan dengan teks yang ditemukan di file pertama.

Opsi terakhir ini menyebabkan menggoyangkan untuk menerapkan algoritme "paling cocok" untuk menyelaraskan potongan tambalan
dengan file sebelum menghitung perbedaan. Algoritma ini digunakan saat menggabungkan
patch dengan file, dan nilainya dapat dilihat dengan membandingkan perbedaan yang dihasilkan dengan cara ini
dengan perbedaan yang dihasilkan dengan terlebih dahulu mengekstrak satu cabang tambalan ke dalam file, dan
kemudian menghitung perbedaan file tersebut dengan file utama.

EKSTRAK
Fungsi ekstrak dari menggoyangkan hanya mengekspos fungsionalitas internal untuk mengekstrak
satu cabang patch atau file gabungan.

Tepatnya satu file harus diberikan, dan itu akan dianggap sebagai file gabungan kecuali
--tambalan diberikan, dalam hal ini patch diasumsikan.

Pemilihan cabang dilakukan dengan menyediakan salah satu dari -1, -2, atau -3 dengan makna yang jelas.

BROWSE
Fungsi jelajah dari menggoyangkan menyajikan hasil penggabungan atau (dengan -d) perbedaan dalam a
GUI berbasis teks yang dapat dinavigasi menggunakan penekanan tombol yang mirip dengan vi(1) atau emacs(1).

Browser memungkinkan masing-masing dari dua atau tiga aliran untuk dilihat secara individual dengan
warna yang digunakan untuk menyorot berbagai jenis teks - hijau untuk teks yang ditambahkan, merah untuk dihapus
teks dll. Itu juga dapat menampilkan tambalan dengan sendirinya, hasil lengkap penggabungan, atau
menggabungkan dan tambalan berdampingan.

Peramban menyediakan sejumlah halaman bantuan peka konteks yang dapat diakses oleh:
mengetik '?'

Kanan atas GUI akan melaporkan jenis teks di bawah kursor, yang juga
ditunjukkan oleh warna teks. Pilihan adalah Tidak Berubah, Berubah, Tidak Tertandingi,
Asing, Sudah Diterapkan dan Konflik. Jika artinya sedikit jelas
eksperimen akan membantu.

Pengeditan dalam jumlah terbatas diizinkan saat berada di melihat-lihat mode. Saat ini teks itu
yang tidak diinginkan dapat dibuang dengan x. Ini akan mengubah Konflik atau Perubahan menjadi Tidak Berubah,
dan Unmatched to Changed (yang secara efektif mengubahnya menjadi string kosong). Demikian pula
sebuah teks dapat ditandai sebagai diinginkan dengan c. Ini akan mengubah Konflik atau Ekstra menjadi
Berubah. Menggunakan kunci yang sama lagi akan mengembalikan perubahan.

Akhirnya, huruf besar X akan mengembalikan semua perubahan pada baris saat ini.

Untuk membuat lebih banyak perubahan, Anda dapat menggunakan v yang menjalankan editor, lebih memilih $VISUAL or
$ EDITOR jika mereka diatur dalam lingkungan.

Jika Anda membuat perubahan, goyangan akan menanyakan apakah Anda ingin menyimpan perubahan, meskipun
--mengganti tidak diberikan.

PERINGATAN

Perhatian harus selalu dilakukan saat menerapkan tambalan yang ditolak dengan menggoyangkan. Ketika tambalan
menolak tambalan, ia melakukannya untuk alasan yang bagus. Meskipun menggoyangkan mungkin dapat menemukan
tempat yang dapat dipercaya untuk menerapkan setiap perubahan tekstual, tidak ada jaminan bahwa hasilnya adalah
benar dalam arti semantik apa pun. Hasilnya harus selalu diperiksa untuk memastikannya
benar.

CONTOH

menggoyangkan --mengganti fillet file.rej
Ini adalah penggunaan normal dari menggoyangkan dan akan menerima perubahan apa pun dalam file.rej bahwa tambalan bisa
tidak berlaku, dan gabungkan menjadi fillet.

menggoyangkan -dp1 fillet file.rej
Ini akan melakukan perbandingan kata-bijaksana antara fillet dan sebelum cabang dari
berbeda dalam file.rej dan tunjukkan perbedaannya. Ini memungkinkan Anda untuk melihat di mana tambalan yang diberikan
akan berlaku.

menggoyangkan --menggabungkan --membantu
Dapatkan bantuan tentang fungsi gabungan dari menggoyangkan.

menggoyangkan --jelajahi --tambalan perbarui.patch
Mengurai perbarui.patch file untuk tambalan dan sajikan daftar file tambalan yang dapat
menelusuri untuk memeriksa setiap patch secara rinci.

menggoyangkan dapat diintegrasikan dengan git sehingga digunakan sebagai alat penggabungan dan perbedaan default
alat. Ini dapat dicapai dengan menambahkan baris berikut ke .gitconfig di rumah pengguna
direktori.
[gabungkan "goyangan"]
name = "Menggoyangkan penggabungan fleksibel"
driver = menggoyangkan -o %A %A %O %B
rekursif = biner
[menggabungkan]
alat = goyang
[mergetool "menggoyang"]
cmd = menggoyangkan -B -o $MERGED $LOCAL $BASE $REMOTE
[difftool "menggoyangkan"]
cmd = menggoyangkan -Bd $LOCAL $REMOTE
Ini akan membuat git alat gabungan dan git alat diff menggunakan menggoyangkan.

Jika kamu mau git untuk selalu menggunakan menggoyangkan untuk penggabungan (yang mungkin berbahaya), Anda dapat menambahkan
* gabung = goyang
ke yang sesuai gitatribut file seperti $HOME/.config/git/atribut.

KUTIPAN

Nama dari menggoyangkan terinspirasi dari kutipan berikut.

Masalah yang saya temukan adalah saya sering ingin mengambil
(file1+patch) -> file2,
ketika saya tidak memiliki file1. Tapi menggabungkan alat ingin mengambil
(file1|file2) -> file3.
Saya belum melihat alat grafis yang membantu Anda menggoyangkan tambalan
ke dalam sebuah file.
--Andrew Morton - 2002

KEKURANGAN

- menggoyangkan tidak dapat membaca output unified-diff yang diperluas yang dihasilkannya untuk --diff
--kata-kata.

- menggoyangkan tidak dapat membaca format gabungan berbasis kata yang dihasilkannya untuk --merge
--kata-kata.

- menggoyangkan tidak mengerti unicode dan akan memperlakukan semua karakter non-ASCII banyak
sama seperti ia memperlakukan tanda baca - ia akan memperlakukan masing-masing sebagai kata yang terpisah. Itu
browser tidak akan menampilkan karakter non-ASCII dengan benar.

Gunakan goyangan online menggunakan layanan onworks.net