Rebuild README.md via pandoc -o ../README.md -f rst -t markdown intro…

….rst examples.rst.

README.md

@@ -36,7 +36,11 @@ If you are looking for `ebtables` python bindings, check out
 
 [![Latest Release](https://pypip.in/v/python-iptables/badge.png)](https://pypi.python.org/pypi/python-iptables)
 
-[![Build Status](https://travis-ci.org/ldx/python-iptables.png?branch=master)](https://travis-ci.org/ldx/python-iptables) [![Coverage Status](https://coveralls.io/repos/ldx/python-iptables/badge.svg?branch=codecoverage)](https://coveralls.io/r/ldx/python-iptables?branch=codecoverage) [![Code Health](https://landscape.io/github/ldx/python-iptables/codecoverage/landscape.svg)](https://landscape.io/github/ldx/python-iptables/codecoverage)
+[![Build Status](https://travis-ci.org/ldx/python-iptables.png?branch=master)](https://travis-ci.org/ldx/python-iptables)
+
+[![Coverage Status](https://coveralls.io/repos/ldx/python-iptables/badge.svg?branch=codecoverage)](https://coveralls.io/r/ldx/python-iptables?branch=codecoverage)
+
+[![Code Health](https://landscape.io/github/ldx/python-iptables/codecoverage/landscape.svg)](https://landscape.io/github/ldx/python-iptables/codecoverage)
 
 [![Number of Downloads](https://pypip.in/d/python-iptables/badge.png)](https://pypi.python.org/pypi/python-iptables)
 
@@ -77,6 +81,10 @@ installs into `/usr/local/lib`.
 Now you can run the tests:
 
     % sudo PATH=$PATH python setup.py test
+    WARNING: this test will manipulate iptables rules.
+    Don't do this on a production machine.
+    Would you like to continue? y/n y
+    [...]
 
 The `PATH=$PATH` part is necessary after `sudo` if you have installed
 into a `virtualenv`, since `sudo` will reset your environment to a
@@ -279,17 +287,17 @@ in/out inteface etc is. To print out all rules in the FILTER table:
 As you see in the code snippet above, rules are organized into chains,
 and chains are in tables. You have a fixed set of tables; for IPv4:
 
-    * FILTER,
-    * NAT,
-    * MANGLE and
-    * RAW.
+-   `FILTER`,
+-   `NAT`,
+-   `MANGLE` and
+-   `RAW`.
 
 For IPv6 the tables are:
 
-    * FILTER,
-    * MANGLE,
-    * RAW and
-    * SECURITY.
+-   `FILTER`,
+-   `MANGLE`,
+-   `RAW` and
+-   `SECURITY`.
 
 To access a table:
 
@@ -538,17 +546,16 @@ or more rules, than commit it:
 The drawback is that Table is a singleton, and if you disable
 autocommit, it will be disabled for all instances of that Table.
 
-
 Known Issues
 ============
 
 These issues are mainly caused by complex interaction with upstream's
 Netfilter implementation, and will require quite significant effort to
 fix. Workarounds are available.
 
-* [Issue #201](https://github.com/ldx/python-iptables/issues/201) 
-  -- The `hashlimit` match requires explicitly setting `hashlimit_htable_expire`
-
-* [Issue #204](https://github.com/ldx/python-iptables/issues/204) 
-  -- The `NOTRACK` target is problematic; use `CT --notrack` instead
+-   The `hashlimit` match requires explicitly setting
+    `hashlimit_htable_expire`. See [Issue
+    \#201](https://github.com/ldx/python-iptables/issues/201).
+-   The `NOTRACK` target is problematic; use `CT --notrack` instead. See
+    [Issue \#204](https://github.com/ldx/python-iptables/issues/204).