135 lines
4.7 KiB
Markdown
135 lines
4.7 KiB
Markdown
Contents
|
|
========
|
|
This directory contains tools for developers working on this repository.
|
|
|
|
check-doc.py
|
|
============
|
|
|
|
Check if all command line args are documented. The return value indicates the
|
|
number of undocumented args.
|
|
|
|
clang-format.py
|
|
===============
|
|
|
|
A script to format cpp source code according to [.clang-format](../../src/.clang-format). This should only be applied to new files or files which are currently not actively developed on. Also, git subtrees are not subject to formatting.
|
|
|
|
clang-format-diff.py
|
|
===================
|
|
|
|
A script to format unified git diffs according to [.clang-format](../../src/.clang-format).
|
|
|
|
For instance, to format the last commit with 0 lines of context,
|
|
the script should be called from the git root folder as follows.
|
|
|
|
```
|
|
git diff -U0 HEAD~1.. | ./contrib/devtools/clang-format-diff.py -p1 -i -v
|
|
```
|
|
|
|
fix-copyright-headers.py
|
|
========================
|
|
|
|
Every year newly updated files need to have its copyright headers updated to reflect the current year.
|
|
If you run this script from the root folder it will automatically update the year on the copyright header for all
|
|
source files if these have a git commit from the current year.
|
|
|
|
For example a file changed in 2015 (with 2015 being the current year):
|
|
|
|
```// Copyright (c) 2009-2013 The Bitcoin Core developers```
|
|
|
|
would be changed to:
|
|
|
|
```// Copyright (c) 2009-2015 The Bitcoin Core developers```
|
|
|
|
git-subtree-check.sh
|
|
====================
|
|
|
|
Run this script from the root of the repository to verify that a subtree matches the contents of
|
|
the commit it claims to have been updated to.
|
|
|
|
To use, make sure that you have fetched the upstream repository branch in which the subtree is
|
|
maintained:
|
|
* for `src/secp256k1`: https://github.com/bitcoin-core/secp256k1.git (branch master)
|
|
* for `src/leveldb`: https://github.com/bitcoin-core/leveldb.git (branch bitcoin-fork)
|
|
* for `src/univalue`: https://github.com/bitcoin-core/univalue.git (branch master)
|
|
* for `src/crypto/ctaes`: https://github.com/bitcoin-core/ctaes.git (branch master)
|
|
|
|
Usage: `git-subtree-check.sh DIR (COMMIT)`
|
|
|
|
`COMMIT` may be omitted, in which case `HEAD` is used.
|
|
|
|
github-merge.py
|
|
===============
|
|
|
|
A small script to automate merging pull-requests securely and sign them with GPG.
|
|
|
|
For example:
|
|
|
|
./github-merge.py 3077
|
|
|
|
(in any git repository) will help you merge pull request #3077 for the
|
|
bitcoin/bitcoin repository.
|
|
|
|
What it does:
|
|
* Fetch master and the pull request.
|
|
* Locally construct a merge commit.
|
|
* Show the diff that merge results in.
|
|
* Ask you to verify the resulting source tree (so you can do a make
|
|
check or whatever).
|
|
* Ask you whether to GPG sign the merge commit.
|
|
* Ask you whether to push the result upstream.
|
|
|
|
This means that there are no potential race conditions (where a
|
|
pullreq gets updated while you're reviewing it, but before you click
|
|
merge), and when using GPG signatures, that even a compromised github
|
|
couldn't mess with the sources.
|
|
|
|
Setup
|
|
---------
|
|
Configuring the github-merge tool for the bitcoin repository is done in the following way:
|
|
|
|
git config githubmerge.repository bitcoin/bitcoin
|
|
git config githubmerge.testcmd "make -j4 check" (adapt to whatever you want to use for testing)
|
|
git config --global user.signingkey mykeyid (if you want to GPG sign)
|
|
|
|
optimize-pngs.py
|
|
================
|
|
|
|
A script to optimize png files in the bitcoin
|
|
repository (requires pngcrush).
|
|
|
|
security-check.py and test-security-check.py
|
|
============================================
|
|
|
|
Perform basic ELF security checks on a series of executables.
|
|
|
|
symbol-check.py
|
|
===============
|
|
|
|
A script to check that the (Linux) executables produced by gitian only contain
|
|
allowed gcc, glibc and libstdc++ version symbols. This makes sure they are
|
|
still compatible with the minimum supported Linux distribution versions.
|
|
|
|
Example usage after a gitian build:
|
|
|
|
find ../gitian-builder/build -type f -executable | xargs python contrib/devtools/symbol-check.py
|
|
|
|
If only supported symbols are used the return value will be 0 and the output will be empty.
|
|
|
|
If there are 'unsupported' symbols, the return value will be 1 a list like this will be printed:
|
|
|
|
.../64/test_bitcoin: symbol memcpy from unsupported version GLIBC_2.14
|
|
.../64/test_bitcoin: symbol __fdelt_chk from unsupported version GLIBC_2.15
|
|
.../64/test_bitcoin: symbol std::out_of_range::~out_of_range() from unsupported version GLIBCXX_3.4.15
|
|
.../64/test_bitcoin: symbol _ZNSt8__detail15_List_nod from unsupported version GLIBCXX_3.4.15
|
|
|
|
update-translations.py
|
|
======================
|
|
|
|
Run this script from the root of the repository to update all translations from transifex.
|
|
It will do the following automatically:
|
|
|
|
- fetch all translations
|
|
- post-process them into valid and committable format
|
|
- add missing translations to the build system (TODO)
|
|
|
|
See doc/translation-process.md for more information.
|