qmk_firmware/newbs_git_resolving_merge_conflicts.html

46 lines
102 KiB
HTML
Raw Normal View History

<!DOCTYPE html>
<html lang="en-US" dir="ltr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Resolving Merge Conflicts | QMK Firmware</title>
<meta name="description" content="Documentation for QMK Firmware">
<meta name="generator" content="VitePress v1.1.3">
<link rel="preload stylesheet" href="/assets/style.R_mF0amW.css" as="style">
<script type="module" src="/assets/app.B02gM4TG.js"></script>
<link rel="preload" href="/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
<link rel="modulepreload" href="/assets/chunks/framework.DyMmIvSC.js">
<link rel="modulepreload" href="/assets/chunks/theme.Y8mokbzj.js">
<link rel="modulepreload" href="/assets/newbs_git_resolving_merge_conflicts.md.72w3BRmm.lean.js">
<script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
<script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
</head>
<body>
<div id="app"><div class="Layout" data-v-5d98c3a5><!--[--><!--]--><!--[--><span tabindex="-1" data-v-0f60ec36></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-0f60ec36> Skip to content </a><!--]--><!----><header class="VPNav" data-v-5d98c3a5 data-v-ae24b3ad><div class="VPNavBar has-sidebar top" data-v-ae24b3ad data-v-ccf7ddec><div class="wrapper" data-v-ccf7ddec><div class="container" data-v-ccf7ddec><div class="title" data-v-ccf7ddec><div class="VPNavBarTitle has-sidebar" data-v-ccf7ddec data-v-ab179fa1><a class="title" href="/" data-v-ab179fa1><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/badge-community-dark.svg" alt data-v-8426fc1a><!--]--><!--[--><img class="VPImage light logo" src="/badge-community-light.svg" alt data-v-8426fc1a><!--]--><!--]--><!--]--><!----><!--[--><!--]--></a></div></div><div class="content" data-v-ccf7ddec><div class="content-body" data-v-ccf7ddec><!--[--><!--]--><div class="VPNavBarSearch search" data-v-ccf7ddec><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-ccf7ddec data-v-7f418b0f><span id="main-nav-aria-label" class="visually-hidden" data-v-7f418b0f>Main Navigation</span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="./" tabindex="0" data-v-7f418b0f data-v-9c663999><!--[--><span data-v-9c663999>Home</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-ccf7ddec data-v-e6aabb21><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title="Switch to dark theme" aria-checked="false" data-v-e6aabb21 data-v-d1f28634 data-v-1d5665e3><span class="check" data-v-1d5665e3><span class="icon" data-v-1d5665e3><!--[--><span class="vpi-sun sun" data-v-d1f28634></span><span class="vpi-moon moon" data-v-d1f28634></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-ccf7ddec data-v-0394ad82 data-v-7bc22406><!--[--><a class="VPSocialLink no-icon" href="https://reddit.com/r/olkb" aria-label target="_blank" rel="noopener" data-v-7bc22406 data-v-eee4e7cb><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 50 50" width="50px" height="50px"><path d="M 29 3 C 28.0625 3 27.164063 3.382813 26.5 4 C 25.835938 4.617188 25.363281 5.433594 25 6.40625 C 24.355469 8.140625 24.085938 10.394531 24.03125 13.03125 C 19.234375 13.179688 14.820313 14.421875 11.28125 16.46875 C 10.214844 15.46875 8.855469 14.96875 7.5 14.96875 C 6.089844 14.96875 4.675781 15.511719 3.59375 16.59375 C 1.425781 18.761719 1.425781 22.238281 3.59375 24.40625 L 3.84375 24.65625 C 3.3125 26.035156 3 27.488281 3 29 C 3 33.527344 5.566406 37.585938 9.5625 40.4375 C 13.558594 43.289063 19.007813 45 25 45 C 30.992188 45 36.441406 43.289063 40.4375 40.4375 C 44.433594 37.585938 47 33.527344 47 29 C 47 27.488281 46.6875 26.035156 46.15625 24.65625 L 46.40625 24.40625 C 48.574219 22.238281 48.574219 18.761719 46.40625 16.59375 C 45.324219 15.511719 43.910156 14.96875 42.5 14.96875 C 41.144531 14.96875 39.785156 15.46875 38.71875 16.46875 C 35.195313 14.433594 30.800781 13.191406 26.03125 13.03125 C 26.09375 10.546875 26.363281 8.46875 26.875 7.09375 C 27.164063 6.316406 27.527344 5.757813 27.875 5.4375 C 28.222656 5.117188 28.539063 5 29 5 C 29.460938 5 29.683594 5.125 30.03125 5.40625 C 30.378906 5.6875 30.785156 6.148438 31.3125 6.6875 C 32.253906 7.652344 33.695313 8.714844 36.09375 8.9375 C 36.539063 11.238281 38.574219 13 41 13 C 43.75 13 46 10.75 46 8 C 46 5.25 43.75 3 41 3 C 38.605469 3 36.574219 4.710938 36.09375 6.96875 C 34.3125 6.796875 33.527344 6.109375 32.75 5.3125 C 32.300781 4.851563 31.886719 4.3125 31.3125 3.843
<span class="line"><span>git rev-list --left-right --count HEAD...upstream/master</span></span></code></pre></div><p>The <code>git rev-list</code> command entered here returns the number of commits that differ between the current branch and QMK&#39;s master branch. We run <code>git fetch</code> first to make sure we have the refs that represent the current state of the upstream repo. The output of the <code>git rev-list</code> command entered returns two numbers:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>$ git rev-list --left-right --count HEAD...upstream/master</span></span>
<span class="line"><span>7 35</span></span></code></pre></div><p>The first number represents the number of commits on the current branch since it was created, and the second number is the number of commits made to <code>upstream/master</code> since the current branch was created, and thus, the changes that are not recorded in the current branch.</p><p>Now that the current states of both the current branch and the upstream repo are known, we can start a rebase operation:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>git rebase upstream/master</span></span></code></pre></div><p>This tells Git to undo the commits on the current branch, and then reapply them against QMK&#39;s master branch.</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>$ git rebase upstream/master</span></span>
<span class="line"><span>First, rewinding head to replay your work on top of it...</span></span>
<span class="line"><span>Applying: Commit #1</span></span>
<span class="line"><span>Using index info to reconstruct a base tree...</span></span>
<span class="line"><span>M conflicting_file_1.txt</span></span>
<span class="line"><span>Falling back to patching base and 3-way merge...</span></span>
<span class="line"><span>Auto-merging conflicting_file_1.txt</span></span>
<span class="line"><span>CONFLICT (content): Merge conflict in conflicting_file_1.txt</span></span>
<span class="line"><span>error: Failed to merge in the changes.</span></span>
<span class="line"><span>hint: Use &#39;git am --show-current-patch&#39; to see the failed patch</span></span>
<span class="line"><span>Patch failed at 0001 Commit #1</span></span>
<span class="line"><span></span></span>
<span class="line"><span>Resolve all conflicts manually, mark them as resolved with</span></span>
<span class="line"><span>&quot;git add/rm &lt;conflicted_files&gt;&quot;, then run &quot;git rebase --continue&quot;.</span></span>
<span class="line"><span>You can instead skip this commit: run &quot;git rebase --skip&quot;.</span></span>
<span class="line"><span>To abort and get back to the state before &quot;git rebase&quot;, run &quot;git rebase --abort&quot;.</span></span></code></pre></div><p>This tells us that we have a merge conflict, and gives the name of the file with the conflict. Open the conflicting file in your text editor, and somewhere in the file, you&#39;ll find something like this:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>&lt;&lt;&lt;&lt;&lt;&lt;&lt; HEAD</span></span>
<span class="line"><span>&lt;p&gt;For help with any issues, email us at support@webhost.us.&lt;/p&gt;</span></span>
<span class="line"><span>=======</span></span>
<span class="line"><span>&lt;p&gt;Need help? Email support@webhost.us.&lt;/p&gt;</span></span>
<span class="line"><span>&gt;&gt;&gt;&gt;&gt;&gt;&gt; Commit #1</span></span></code></pre></div><p>The line <code>&lt;&lt;&lt;&lt;&lt;&lt;&lt; HEAD</code> marks the beginning of a merge conflict, and the <code>&gt;&gt;&gt;&gt;&gt;&gt;&gt; Commit #1</code> line marks the end, with the conflicting sections separated by <code>=======</code>. The part on the <code>HEAD</code> side is from the QMK master version of the file, and the part marked with the commit message is from the current branch and commit.</p><p>Because Git tracks <em>changes to files</em> rather than the contents of the files directly, if Git can&#39;t find the text that was in the file previous to the commit that was made, it won&#39;t know how to edit the file. Re-editing the file will solve the conflict. Make your changes, and then save the file.</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>&lt;p&gt;Need help? Email support@webhost.us.&lt;/p&gt;</span></span></code></pre></div><p>Now run:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>git add conflicting_file_1.txt</span></span>
<span class="line"><span>git rebase --continue</span></span></code></pre></div><p>Git logs the changes to the conflicting file, and continues applying the commits from our branch until it reaches the end.</p></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-09de1c0f><!--[--><!--]--><!----><nav class="prev-next" data-v-09de1c0f><div class="pager" data-v-09de1c0f><a class="VPLink link pager-link prev" href="/newbs_git_using_your_master_branch" data-v-09de1c0f><!--[--><span class="desc" data-v-09de1c0f>Previous page</span><span class="title" data-v-09de1c0f>Your Fork</span><!--]--></a></div><div class="pager" data-v-09de1c0f><a class="VPLink link pager-link next" href="/newbs_git_resynchronize_a_branch" data-v-09de1c0f><!--[--><span class="desc" data-v-09de1c0f>Next page</span><span class="title" data-v-09de1c0f>Fixing Your Branch</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
<script>window.__VP_HASH_MAP__=JSON.parse("{\"feature_programmable_button.md\":\"BP5-HUlT\",\"feature_wpm.md\":\"C-SARAXc\",\"feature_eeprom.md\":\"vdeTTfI0\",\"getting_started_docker.md\":\"mz6HE4Bl\",\"api_development_overview.md\":\"Dcey4ntL\",\"feature_ps2_mouse.md\":\"DgKRvSpd\",\"api_docs.md\":\"CRoD6CbL\",\"arm_debugging.md\":\"BH-H2Ukz\",\"audio_driver.md\":\"YKqJ1wkZ\",\"breaking_changes.md\":\"BtdqWQlY\",\"breaking_changes_history.md\":\"CkzdD6x8\",\"breaking_changes_instructions.md\":\"BAjIGeJb\",\"cli.md\":\"BLzAdA6l\",\"cli_configuration.md\":\"CGSB128P\",\"chibios_upgrade_instructions.md\":\"B5dMtL5R\",\"api_overview.md\":\"0FPaUsMb\",\"coding_conventions_c.md\":\"DdrpXBEh\",\"cli_development.md\":\"CczMJOE3\",\"compatible_microcontrollers.md\":\"6HA6FJZJ\",\"cli_commands.md\":\"DCpejdln\",\"coding_conventions_python.md\":\"BV-OK1s5\",\"cli_tab_complete.md\":\"ChaxfzYo\",\"configurator_architecture.md\":\"DEFTvTlS\",\"changelog_20200829.md\":\"CoqrOffn\",\"data_driven_config.md\":\"BvLQ7P20\",\"changelog_20230226.md\":\"CEQKb2Sw\",\"documentation_best_practices.md\":\"D_UwEt1C\",\"custom_quantum_functions.md\":\"BabGw-ye\",\"documentation_templates.md\":\"Bhkum0wD\",\"driver_installation_zadig.md\":\"BIO-iq8r\",\"easy_maker.md\":\"BLadB4D_\",\"eeprom_driver.md\":\"CJGhJYmK\",\"changelog_20210227.md\":\"BWOtCaeS\",\"changelog_20190830.md\":\"Drtq3lMy\",\"changelog_20231126.md\":\"D2Ok5QAf\",\"feature_advanced_keycodes.md\":\"jN1BLaPG\",\"feature_audio.md\":\"CSdy-B0q\",\"changelog_20201128.md\":\"7XXL02Bn\",\"changelog_20220528.md\":\"BdSPPJS6\",\"changelog_20211127.md\":\"BDzkUAQX\",\"changelog_20230528.md\":\"BMuuw__T\",\"changelog_20220827.md\":\"I6ja7C5w\",\"changelog_20200229.md\":\"DNsowwM1\",\"faq_build.md\":\"Bryo1ywz\",\"faq_general.md\":\"BC3pFw4U\",\"feature_encoders.md\":\"DzEjkR0q\",\"feature_caps_word.md\":\"DFEidvi5\",\"feature_mouse_keys.md\":\"Iyt3Hb3p\",\"feature_command.md\":\"DyD1wEzr\",\"feature_combo.md\":\"BFcSajDz\",\"feature_converters.md\":\"Bmv29bqN\",\"feature_debounce_type.md\":\"CUrSp0Iy\",\"feature_oled_driver.md\":\"C3msZUgf\",\"feature_digitizer.md\":\"D7mG1fUR\",\"feature_dip_switch.md\":\"BRm_919T\",\"feature_dynamic_macros.md\":\"CQqgFNCL\",\"feature_secure.md\":\"DTio1NtX\",\"feature_macros.md\":\"DpKdCniT\",\"feature_tri_layer.md\":\"H5S9g49a\",\"feature_send_string.md\":\"ucKdf_1f\",\"feature_pointing_device.md\":\"D8bKydDH\",\"feature_unicode.md\":\"CmuIgTId\",\"feature_split_keyboard.md\":\"dSXqGTcC\",\"flash_driver.md\":\"BTZjpIxy\",\"feature_rgb_matrix.md\":\"DjrTztSt\",\"flashing_bootloadhid.md\":\"aXGP0bN5\",\"flashing.md\":\"CGYYQUk5\",\"feature_space_cadet.md\":\"BadigqA6\",\"faq_keymap.md\":\"BNm1UZCq\",\"feature_layouts.md\":\"qcy8hNMO\",\"changelog_20200530.md\":\"Dk-vRpTQ\",\"index.md\":\"Q8qZBSI9\",\"pr_checklist.md\":\"B5cKcG_-\",\"quantum_keycodes.md\":\"DM5WeUFF\",\"quantum_painter_qff.md\":\"kLNwshez\",\"quantum_painter_qgf.md\":\"BJNSu2s0\",\"quantum_painter_rle.md\":\"B07V3m-n\",\"isp_flashing_guide.md\":\"DfzdHli4\",\"ref_functions.md\":\"BqUSY2Jo\",\"reference_configurator_support.md\":\"FaBQzIj6\",\"reference_glossary.md\":\"2AN0RaWE\",\"spi_driver.md\":\"BUPXWtdm\",\"serial_driver.md\":\"FRk1ebke\",\"squeezing_avr.md\":\"BmcLYKOr\",\"support_deprecation_policy.md\":\"CCo4ljiw\",\"support.md\":\"CwJ_H6Qx\",\"reference_info_json.md\":\"DLkUuXVh\",\"syllabus.md\":\"0-MOMJnE\",\"uart_driver.md\":\"Cby_2B9q\",\"tap_hold.md\":\"54I6XHRj\",\"changelog_20221126.md\":\"BOpHhXi2\",\"feature_midi.md\":\"6rA7lbe-\",\"feature_sequencer.md\":\"B9A4Z8EN\",\"feature_grave_esc.md\":\"Dfk03Mwq\",\"quantum_painter_lvgl.md\":\"DobNbSgA\",\"hardware_drivers.md\":\"DFF5LGTT\",\"getting_started_introduction.md\":\"BOJreqSs\",\"feature_autocorrect.md\":\"MXySdvB8\",\"feature_bluetooth.md\":\"bG-tYvch\",\"newbs_building_firmware.md\":\"C7XiOjZf\",\"newbs_building_firmware_configurator.md\":\"yyo-1QDE\",\"newbs_flashing.md\":\"B42m5Wln\",\"feature_tap_dance.md\":\"B6ipWqOP\",\"newbs_git_best_practices.md\":\"BI2-EVI5\",\"newbs_git_resolving_merge_conflicts.md\":\"72w3
</body>
</html>