A few README tweaks (#73)

* Add a paragraph at the top for users, not builders, of Python.

* Use nicer rst url syntax to avoid borking paragraphs in the plain text.

diff --git a/README.rst b/README.rst
index 71c54b2c6ae20a8774cbff796bbe7a4ed4c8a919..f25b2eea8a532afb107733c9c9944340a338e318 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -19,6 +19,14 @@ especially how built-in objects like dictionaries and strings work,
 have changed considerably, and a lot of deprecated features have finally
 been removed.
 
+Using Python
+------------
+
+Installable Python kits, and information about using Python, are available at
+`python.org`_.
+
+.. _python.org: https://www.python.org/
+
 
 Build Instructions
 ------------------
@@ -156,7 +164,7 @@ IMPORTANT: If the tests fail and you decide to mail a bug report, *don't*
 include the output of ``make test``.  It is useless.  Run the failing test
 manually, as follows::
 
-        ./python -m test -v test_whatever
+    ./python -m test -v test_whatever
 
 (substituting the top of the source tree for '.' if you built in a different
 directory).  This runs the test in verbose mode.
@@ -197,13 +205,12 @@ Proposals for enhancement
 -------------------------
 
 If you have a proposal to change Python, you may want to send an email to the
-comp.lang.python or
-`python-ideas <https://mail.python.org/mailman/listinfo/python-ideas/>`_
-mailing lists for initial feedback.  A Python
+comp.lang.python or `python-ideas`_ mailing lists for initial feedback.  A Python
 Enhancement Proposal (PEP) may be submitted if your idea gains ground.  All
 current PEPs, as well as guidelines for submitting a new PEP, are listed at
 `python.org/dev/peps/ <https://www.python.org/dev/peps/>`_.
 
+.. _python-ideas: https://mail.python.org/mailman/listinfo/python-ideas/
 
 Release Schedule
 ----------------
@@ -232,4 +239,3 @@ so it may be used in proprietary projects.  There are interfaces to some GNU
 code but these are entirely optional.
 
 All trademarks referenced herein are property of their respective holders.
-