Some cleanup in the docs.
diff --git a/Doc/install/index.rst b/Doc/install/index.rst
index aa2d915..584cb47 100644
--- a/Doc/install/index.rst
+++ b/Doc/install/index.rst
@@ -10,18 +10,17 @@
:Release: |version|
:Date: |today|
-.. % TODO:
-.. % Fill in XXX comments
+.. TODO: Fill in XXX comments
-.. % The audience for this document includes people who don't know anything
-.. % about Python and aren't about to learn the language just in order to
-.. % install and maintain it for their users, i.e. system administrators.
-.. % Thus, I have to be sure to explain the basics at some point:
-.. % sys.path and PYTHONPATH at least. Should probably give pointers to
-.. % other docs on "import site", PYTHONSTARTUP, PYTHONHOME, etc.
-.. %
-.. % Finally, it might be useful to include all the material from my "Care
-.. % and Feeding of a Python Installation" talk in here somewhere. Yow!
+.. The audience for this document includes people who don't know anything
+ about Python and aren't about to learn the language just in order to
+ install and maintain it for their users, i.e. system administrators.
+ Thus, I have to be sure to explain the basics at some point:
+ sys.path and PYTHONPATH at least. Should probably give pointers to
+ other docs on "import site", PYTHONSTARTUP, PYTHONHOME, etc.
+
+ Finally, it might be useful to include all the material from my "Care
+ and Feeding of a Python Installation" talk in here somewhere. Yow!
.. topic:: Abstract
@@ -517,11 +516,7 @@
--install-scripts=python/scripts
--install-data=python/data
-or, equivalently,
-
-.. % $ % -- bow to font-lock
-
-::
+or, equivalently, ::
python setup.py install --home=~/python \
--install-purelib=lib \
@@ -533,8 +528,6 @@
the Distutils as it parses your command line options, just as it does when
parsing your configuration file(s).
-.. % $ % -- bow to font-lock
-
Obviously, specifying the entire installation scheme every time you install a
new module distribution would be very tedious. Thus, you can put these options
into your Distutils config file (see section :ref:`inst-config-files`)::
@@ -574,11 +567,11 @@
the Distutils are the only ones you can use.) See section :ref:`inst-config-files`
for details.
-.. % XXX need some Windows examples---when would custom
-.. % installation schemes be needed on those platforms?
+.. XXX need some Windows examples---when would custom installation schemes be
+ needed on those platforms?
-.. % XXX I'm not sure where this section should go.
+.. XXX I'm not sure where this section should go.
.. _inst-search-path:
@@ -890,8 +883,8 @@
reason you have to convert Python's library :file:`python25.lib` into the
Borland format. You can do this as follows:
-.. % Should we mention that users have to create cfg-files for the compiler?
-.. % see also http://community.borland.com/article/0,1410,21205,00.html
+.. Should we mention that users have to create cfg-files for the compiler?
+.. see also http://community.borland.com/article/0,1410,21205,00.html
::
@@ -949,8 +942,8 @@
http://starship.python.net/crew/kernr/mingw32/Notes.html, see at PExports 0.42h
there.)
-.. % I don't understand what the next line means. --amk
-.. % (inclusive the references on data structures.)
+.. I don't understand what the next line means. --amk
+.. (inclusive the references on data structures.)
::