diff options
| author | MarcoFalke <[email protected]> | 2016-12-02 16:20:17 +0100 |
|---|---|---|
| committer | MarcoFalke <[email protected]> | 2016-12-02 16:20:24 +0100 |
| commit | 98514988a3d3e8b7dbf0463884a5c38f5ed5562d (patch) | |
| tree | 4df5d7fa296ac6eff23521d50c7722b1b5caba24 | |
| parent | Merge #9223: unification of Bloom filter representation (diff) | |
| parent | Developer docs about existing subtrees. (diff) | |
| download | discoin-98514988a3d3e8b7dbf0463884a5c38f5ed5562d.tar.xz discoin-98514988a3d3e8b7dbf0463884a5c38f5ed5562d.zip | |
Merge #9246: Developer docs about existing subtrees.
08ed8c1 Developer docs about existing subtrees. (Gregory Maxwell)
| -rw-r--r-- | doc/developer-notes.md | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/doc/developer-notes.md b/doc/developer-notes.md index b0794e6d3..ba03579e8 100644 --- a/doc/developer-notes.md +++ b/doc/developer-notes.md @@ -408,6 +408,37 @@ GUI should not interact with the user. That's where View classes come in. The converse also holds: try to not directly access core data structures from Views. +Subtrees +---------- + +Several parts of the repository are subtrees of software maintained elsewhere. + +Some of these are maintained by active developers of Bitcoin Core, in which case changes should probably go +directly upstream without being PRed directly against the project. They will be merged back in the next +subtree merge. + +Others are external projects without a tight relationship with our project. Changes to these should also +be sent upstream but bugfixes may also be prudent to PR against Bitcoin Core so that they can be integrated +quickly. Cosmetic changes should be purely taken upstream. + +There is a tool in contrib/devtools/git-subtree-check.sh to check a subtree directory for consistency with +its upstream repository. + +Current subtrees include: + +- src/leveldb + - Upstream at https://github.com/google/leveldb ; Maintained by Google, but open important PRs to Core to avoid delay + +- src/libsecp256k1 + - Upstream at https://github.com/bitcoin-core/secp256k1/ ; actively maintaned by Core contributors. + +- src/crypto/ctaes + - Upstream at https://github.com/bitcoin-core/ctaes ; actively maintained by Core contributors. + +- src/univalue + - Upstream at https://github.com/jgarzik/univalue ; report important PRs to Core to avoid delay. + + Git and github tips --------------------- |