diff --git a/src/blockdata/block.rs b/src/blockdata/block.rs
index ce0c4e0cd..3761e2b45 100644
--- a/src/blockdata/block.rs
+++ b/src/blockdata/block.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Bitcoin Block
+//! Bitcoin Block
 //!
 //! A block is a bundle of transactions with a proof-of-work attached,
 //! which attaches to an earlier block to form the blockchain. This
diff --git a/src/blockdata/constants.rs b/src/blockdata/constants.rs
index bcf2558a4..c4bd3c2fc 100644
--- a/src/blockdata/constants.rs
+++ b/src/blockdata/constants.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Blockdata constants
+//! Blockdata constants
 //!
 //! This module provides various constants relating to the blockchain and
 //! consensus code. In particular, it defines the genesis block and its
diff --git a/src/blockdata/mod.rs b/src/blockdata/mod.rs
index c56775035..78112b1a6 100644
--- a/src/blockdata/mod.rs
+++ b/src/blockdata/mod.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Blockdata
+//! Blockdata
 //!
 //! This module defines structions and functions for storing the blocks and
 //! transactions which make up the Bitcoin system.
diff --git a/src/blockdata/opcodes.rs b/src/blockdata/opcodes.rs
index 62285147f..d46509cb7 100644
--- a/src/blockdata/opcodes.rs
+++ b/src/blockdata/opcodes.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Opcodes
+//! Opcodes
 //!
 //! Bitcoin's script uses a stack-based assembly language. This module defines
 //! all of the opcodes
diff --git a/src/blockdata/script.rs b/src/blockdata/script.rs
index b5dc44fb2..068cee257 100644
--- a/src/blockdata/script.rs
+++ b/src/blockdata/script.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Script
+//! Script
 //!
 //! Scripts define Bitcoin's digital signature scheme: a signature is formed
 //! from a script (the second half of which is defined by a coin to be spent,
diff --git a/src/blockdata/transaction.rs b/src/blockdata/transaction.rs
index 36a9547ff..dd269185b 100644
--- a/src/blockdata/transaction.rs
+++ b/src/blockdata/transaction.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Bitcoin Transaction
+//! Bitcoin Transaction
 //!
 //! A transaction describes a transfer of money. It consumes previously-unspent
 //! transaction outputs and produces new ones, satisfying the condition to spend
diff --git a/src/macros.rs b/src/macros.rs
index ea6b09a6c..598de5080 100644
--- a/src/macros.rs
+++ b/src/macros.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Macros
+//! Macros
 //!
 //! Macros available to users of the Bitcoin library
 
diff --git a/src/network/address.rs b/src/network/address.rs
index c813e8859..36335f9f4 100644
--- a/src/network/address.rs
+++ b/src/network/address.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Bitcoin network addresses
+//! Bitcoin network addresses
 //!
 //! This module defines the structures and functions needed to encode
 //! network addresses in Bitcoin messages.
diff --git a/src/network/consensus_params.rs b/src/network/consensus_params.rs
index f72b2b5d5..759b4ea86 100644
--- a/src/network/consensus_params.rs
+++ b/src/network/consensus_params.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Consensus parameters
+//! Consensus parameters
 //!
 //! This module provides predefined set of parameters for different chains.
 //!
diff --git a/src/network/encodable.rs b/src/network/encodable.rs
index 71fb201e7..fc843bc65 100644
--- a/src/network/encodable.rs
+++ b/src/network/encodable.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Consensus-encodable types
+//! Consensus-encodable types
 //!
 //! This is basically a replacement of the `Encodable` trait which does
 //! normalization for endianness, etc., to ensure that the encoding
diff --git a/src/network/listener.rs b/src/network/listener.rs
index 2b5d331c7..0dc29cb40 100644
--- a/src/network/listener.rs
+++ b/src/network/listener.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Abstract Bitcoin listener
+//! Abstract Bitcoin listener
 //!
 //! This module defines a listener on the Bitcoin network which is able
 //! to connect to a peer, send network messages, and receive Bitcoin data.
diff --git a/src/network/message.rs b/src/network/message.rs
index c092c2cd9..02084e118 100644
--- a/src/network/message.rs
+++ b/src/network/message.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Network message
+//! Network message
 //!
 //! This module defines the `Message` traits which are used
 //! for (de)serializing Bitcoin objects for transmission on the network. It
diff --git a/src/network/message_blockdata.rs b/src/network/message_blockdata.rs
index 63316e808..a4c2e794e 100644
--- a/src/network/message_blockdata.rs
+++ b/src/network/message_blockdata.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Blockdata network messages
+//! Blockdata network messages
 //!
 //! This module describes network messages which are used for passing
 //! Bitcoin data (blocks and transactions) around.
diff --git a/src/network/message_network.rs b/src/network/message_network.rs
index 3e3f30b21..1229d4a3b 100644
--- a/src/network/message_network.rs
+++ b/src/network/message_network.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Network-related network messages
+//! Network-related network messages
 //!
 //! This module defines network messages which describe peers and their
 //! capabilities
diff --git a/src/network/mod.rs b/src/network/mod.rs
index ad1d522eb..997274548 100644
--- a/src/network/mod.rs
+++ b/src/network/mod.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Network Support
+//! Network Support
 //!
 //! This module defines support for (de)serialization and network transport 
 //! of Bitcoin data and network messages.
diff --git a/src/network/serialize.rs b/src/network/serialize.rs
index cb7c148d5..e626405e2 100644
--- a/src/network/serialize.rs
+++ b/src/network/serialize.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Network Serialization
+//! Network Serialization
 //!
 //! This module defines the `Serializable` trait which is used for
 //! (de)serializing Bitcoin objects for transmission on the network.
diff --git a/src/network/socket.rs b/src/network/socket.rs
index 1bb45f7a9..0b2239fed 100644
--- a/src/network/socket.rs
+++ b/src/network/socket.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Sockets
+//! Sockets
 //!
 //! This module provides support for low-level network communication.
 //!
diff --git a/src/test_macros.rs b/src/test_macros.rs
index 996e79777..9a711ce36 100644
--- a/src/test_macros.rs
+++ b/src/test_macros.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Macros
+//! Macros
 //!
 //! Internal macros used for unit tests
 
diff --git a/src/util/address.rs b/src/util/address.rs
index 76800b5d1..e7ec4cab5 100644
--- a/src/util/address.rs
+++ b/src/util/address.rs
@@ -11,7 +11,8 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Addresses
+//! Addresses
+//!
 //! Support for ordinary base58 Bitcoin addresses and private keys
 //!
 
diff --git a/src/util/base58.rs b/src/util/base58.rs
index 3d0a915ec..976cd10f7 100644
--- a/src/util/base58.rs
+++ b/src/util/base58.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Base58 encoder and decoder
+//! Base58 encoder and decoder
 
 use std::{error, fmt};
 
diff --git a/src/util/bip143.rs b/src/util/bip143.rs
index 0abccc3ed..03ae7f368 100644
--- a/src/util/bip143.rs
+++ b/src/util/bip143.rs
@@ -11,7 +11,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # BIP143 Implementation
+//! BIP143 Implementation
 //!
 //! Implementation of BIP143 Segwit-style signatures. Should be sufficient
 //! to create signatures for Segwit transactions (which should be pushed into
diff --git a/src/util/bip32.rs b/src/util/bip32.rs
index 6408c04d4..78c8e9f32 100644
--- a/src/util/bip32.rs
+++ b/src/util/bip32.rs
@@ -11,7 +11,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # BIP32 Implementation
+//! BIP32 Implementation
 //!
 //! Implementation of BIP32 hierarchical deterministic wallets, as defined
 //! at https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki
diff --git a/src/util/contracthash.rs b/src/util/contracthash.rs
index a08a9f712..3a6a856cc 100644
--- a/src/util/contracthash.rs
+++ b/src/util/contracthash.rs
@@ -12,7 +12,8 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Pay-to-contract-hash supporte
+//! Pay-to-contract-hash supporte
+//!
 //! See Appendix A of the Blockstream sidechains whitepaper
 //! at http://blockstream.com/sidechains.pdf for details of
 //! what this does.
diff --git a/src/util/decimal.rs b/src/util/decimal.rs
index 6436f7831..7694050aa 100644
--- a/src/util/decimal.rs
+++ b/src/util/decimal.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Floating-point decimal type
+//! Floating-point decimal type
 //!
 //! `i64`-based floating-point decimal type designed to hold Bitcoin
 //! amounts. For satoshi amounts (8 decimal places) the maximum
diff --git a/src/util/hash.rs b/src/util/hash.rs
index ec73a8598..134f98ef0 100644
--- a/src/util/hash.rs
+++ b/src/util/hash.rs
@@ -11,7 +11,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Hash functions
+//! Hash functions
 //!
 //! Utility functions related to hashing data, including merkleization
 
diff --git a/src/util/iter.rs b/src/util/iter.rs
index 7a4cbda8e..e950d7874 100644
--- a/src/util/iter.rs
+++ b/src/util/iter.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Iterator adaptors
+//! Iterator adaptors
 //!
 //! Iterator adaptors needed by Bitcoin but not provided by the Rust
 //! standard library.
diff --git a/src/util/misc.rs b/src/util/misc.rs
index 5990404ca..3ee7f610a 100644
--- a/src/util/misc.rs
+++ b/src/util/misc.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Miscellaneous functions
+//! Miscellaneous functions
 //!
 //! Various utility functions
 
diff --git a/src/util/mod.rs b/src/util/mod.rs
index 58f7c79fc..db44b930a 100644
--- a/src/util/mod.rs
+++ b/src/util/mod.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Utility functions
+//! Utility functions
 //!
 //! Functions needed by all parts of the Bitcoin library
 
diff --git a/src/util/privkey.rs b/src/util/privkey.rs
index 52b47e46c..b8447e7ad 100644
--- a/src/util/privkey.rs
+++ b/src/util/privkey.rs
@@ -11,8 +11,9 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # private key
-//!  A private key represents the secret data associated with its proposed use
+//! Private key
+//!
+//! A private key represents the secret data associated with its proposed use
 //!
 use std::str::FromStr;
 use util::Error;
diff --git a/src/util/uint.rs b/src/util/uint.rs
index c6b5650c2..eb026d4e0 100644
--- a/src/util/uint.rs
+++ b/src/util/uint.rs
@@ -12,7 +12,7 @@
 // If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
 //
 
-//! # Big unsigned integer types
+//! Big unsigned integer types
 //!
 //! Implementation of a various large-but-fixed sized unsigned integer types.
 //! The functions here are designed to be fast.