From aeea5e2a2dc3ebe8a99a7926875107b8fb10e8a6 Mon Sep 17 00:00:00 2001 From: Gavin Andresen Date: Wed, 5 Sep 2012 12:09:37 -0400 Subject: [PATCH] Minor documentation updates --- doc/Tor.txt | 4 ---- doc/coding.txt | 2 +- doc/release-notes.txt | 25 +++++++++++++++++++++---- 3 files changed, 22 insertions(+), 9 deletions(-) diff --git a/doc/Tor.txt b/doc/Tor.txt index e088d871..f515f96f 100644 --- a/doc/Tor.txt +++ b/doc/Tor.txt @@ -28,10 +28,6 @@ outgoing connections be anonimized, but more is possible. need to set this if it's the same as -proxy. You can use -notor to explicitly disable access to hidden service. --dnsseed DNS seeds are not resolved directly when a SOCKS5 proxy server is - set. Rather, a short-lived proxy connection to the dns seed - hostname is attempted, and peer addresses are requested. - -listen When using -proxy, listening is disabled by default. If you want to run a hidden service (see next section), you'll need to enable it explicitly. diff --git a/doc/coding.txt b/doc/coding.txt index b3c812a4..0813105e 100644 --- a/doc/coding.txt +++ b/doc/coding.txt @@ -44,7 +44,7 @@ bn CBigNum Locking/mutex usage notes The code is multi-threaded, and uses mutexes and the -CRITICAL_BLOCK/TRY_CRITICAL_BLOCK macros to protect data structures. +LOCK/TRY_LOCK macros to protect data structures. Deadlocks due to inconsistent lock ordering (thread 1 locks cs_main and then cs_wallet, while thread 2 locks them in the opposite order: diff --git a/doc/release-notes.txt b/doc/release-notes.txt index babc56ff..1fe385bd 100644 --- a/doc/release-notes.txt +++ b/doc/release-notes.txt @@ -1,4 +1,3 @@ - (note: this is a temporary file, to be added-to by anybody, and deleted at release time) @@ -6,7 +5,25 @@ Building this from $ git shortlog --no-merges v0.6.3.. +How to Upgrade +-------------- +If you are running an older version, shut it down. Wait +until it has completely shut down (which might take a few minutes for older +versions), then run the installer (on Windows) or just copy over +/Applications/Bitcoin-Qt (on Mac) or bitcoind/bitcoin-qt (on Linux). + +If you were running on Linux with a version that might have been compiled +with a different version of Berkeley DB (for example, if you were using an +Ubuntu PPA version), then run the old version again with the -detachdb +argument and shut it down; if you do not, then the new version will not +be able to read the database files and will exit with an error. + +Incompatible Changes +-------------------- +* Replaced the 'getmemorypool' RPC command with 'getblocktemplate/submitblock' + and 'getrawmempool' commands. +* Remove deprecated RPC 'getblocknumber' Bitcoin Improvement Proposals implemented ----------------------------------------- @@ -24,7 +41,8 @@ Core bitcoin handling and blockchain database * Database: better validation of on-disk stored data * Database: minor optimizations and reliability improvements * -loadblock=FILE will import an external block file -* Additional DoS prevention measures +* Additional DoS (denial-of-service) prevention measures +* New blockchain checkpoint at block 193,000 JSON-RPC API @@ -44,7 +62,6 @@ JSON-RPC API non-wallet TXs now. * Remove deprecated RPC 'getblocknumber' * Remove superceded RPC 'getmemorypool' (see BIP 22, above) -* New blockchain checkpoint at block 193,000 * listtransactions output now displays "smart" times for transactions, and 'blocktime' and 'timereceived' fields were added @@ -52,7 +69,7 @@ JSON-RPC API P2P networking -------------- * IPv6 support -* Tor hidden service support +* Tor hidden service support (see doc/Tor.txt) * Attempts to fix "stuck blockchain download" problems * Replace BDB database "addr.dat" with internally-managed "peers.dat" file containing peer address data.