doc: how to update a subtree #33568
pull Sjors wants to merge 1 commits into bitcoin:master from Sjors:2025/10/subtree-doc changing 1 files +13 −0- 
  
  Sjors commented at 3:18 pm on October 7, 2025: memberWe have instructions on how to verify a subtree update, but not on how to perform one.
- 
    
    DrahtBot added the label Docs on Oct 7, 2025
- 
  
  DrahtBot commented at 3:18 pm on October 7, 2025: contributorThe following sections might be updated with supplementary metadata relevant to reviewers and maintainers. Code Coverage & BenchmarksFor details see: https://corecheck.dev/bitcoin/bitcoin/pulls/33568. ReviewsSee the guideline for information on the review process. If your review is incorrectly listed, please react with 👎 to this comment and the bot will ignore it on the next update. 
- 
    
    Sjors force-pushed on Oct 7, 2025
- 
  
  in doc/developer-notes.md:1132 in da373a20a1 outdated1118@@ -1119,6 +1119,12 @@ to check a subtree directory for consistency with its upstream repository. 1119 1120 The tool instructions also include a list of the subtrees managed by Bitcoin Core. 1121 1122+To update a subtree, follow the instructions for adding it as a remote and then: 1123+ 1124+```sh 1125+git subtree pull --prefix=src/ipc/libmultiprocess libmultiprocess master --squash
 
 furszy commented at 3:58 pm on October 7, 2025:Need to add the remote first. E.g. 0git remote add libmultiprocess <repo_URL> 1git subtree pull --prefix=src/ipc/libmultiprocess libmultiprocess master --squash
 Sjors commented at 4:14 pm on October 7, 2025:That’s explained in the linter doc that’s linked right above, but I can duplicate it if needed.
 fjahr commented at 5:44 pm on October 7, 2025:Might be good to duplicate for the avoidance of doubt.
 Sjors commented at 6:14 pm on October 7, 2025:Done
 achow101 commented at 10:17 pm on October 8, 2025:It’s actually not necessary to add it as a remote. You can give the repo url directly and it will fetch as needed. This avoids adding a bunch of unnecessary refs to your repo.
 Sjors commented at 7:45 am on October 9, 2025:We also recommend this for the verification process and I find it much more convenient than looking up the full URL. I haven’t run out of refs :-)Sjors force-pushed on Oct 7, 2025in doc/developer-notes.md:1125 in 3a2f50a75b1118@@ -1119,6 +1119,19 @@ to check a subtree directory for consistency with its upstream repository. 1119 1120 The tool instructions also include a list of the subtrees managed by Bitcoin Core. 1121 1122+To fully verify or update a subtree, add it as a remote: 1123+ 1124+```sh 1125+git remote add --fetch libmultiprocess https://github.com/bitcoin-core/libmultiprocess.git
 
 furszy commented at 7:25 pm on October 7, 2025:No need to add the--fetchoption. You added agit fetchbelow.
 Sjors commented at 6:38 am on October 8, 2025:You only need to add it as a remote once, but each subsequent update requires a fetch. I’ll drop--fetchfrom the first command though.
 furszy commented at 1:36 pm on October 8, 2025:yeah, that’s what I meant.furszy commented at 7:26 pm on October 7, 2025: memberConcept ACKdoc: how to update a subtree a1226bc760Sjors force-pushed on Oct 8, 2025yuvicc commented at 7:45 am on October 8, 2025: contributorACK a1226bc760c70a22ef4a197d5690aca4d83cb74c This will be useful for new devs while verifying the subtree. DrahtBot requested review from furszy on Oct 8, 2025in doc/developer-notes.md:1122 in a1226bc7601118@@ -1119,6 +1119,19 @@ to check a subtree directory for consistency with its upstream repository. 1119 1120 The tool instructions also include a list of the subtrees managed by Bitcoin Core. 1121 1122+To fully verify or update a subtree, add it as a remote:
 
 janb84 commented at 9:28 am on October 8, 2025:0### Updating subtrees 1 2To fully verify or update a subtree, add it as a remote:NIT add a sub heading to better indicate it’s a subsection. This will help the reader in finding the section and it will nicely bind the section together. 
 Sjors commented at 9:59 am on October 8, 2025:But then I have to move the text below this too, or add even more paragraphs. So going to leave it as is for now.janb84 commented at 9:36 am on October 8, 2025: contributorACK a1226bc760c70a22ef4a197d5690aca4d83cb74c This pr adds a section to subtrees. This section describes how to verify or update a subtree ( commands etc). Adding of this section will help new contributors do a subtrees update without spending time to search how to do this. Added small NIT to add a subsection header, to better subdivide the section. Feel free to ignore. furszy commented at 1:36 pm on October 8, 2025: memberACK a1226bc760c70a22ef4a197d5690aca4d83cb74cfjahr commented at 3:15 pm on October 9, 2025: contributorACk a1226bc760c70a22ef4a197d5690aca4d83cb74cachow101 commented at 5:59 pm on October 9, 2025: memberACK a1226bc760c70a22ef4a197d5690aca4d83cb74cachow101 merged this on Oct 9, 2025achow101 closed this on Oct 9, 2025
 
 github-metadata-mirror
 
 This is a metadata mirror of the GitHub repository bitcoin/bitcoin. This site is not affiliated with GitHub. Content is generated from a GitHub metadata backup.
 generated: 2025-10-31 18:13 UTC
 This site is hosted by @0xB10C
 More mirrored repositories can be found on mirror.b10c.me