[Python-checkins] devguide: Fix up the directory explanation.

[brett.cannon]

brett.cannon pushed 570608727576 to devguide:

http://hg.python.org/devguide/rev/570608727576
changeset:   21:570608727576
user:        Brett Cannon <brett at python.org>
date:        Tue Jan 04 15:01:52 2011 -0800
summary:
  Fix up the directory explanation.

The 'Getting Set Up' guide is now considered revamped (until I find
something it's lacking).

files:
  setup.rst

diff --git a/setup.rst b/setup.rst
--- a/setup.rst
+++ b/setup.rst
@@ -35,7 +35,7 @@
 that they are consistent across all platforms.  The ``svn:keywords`` settings
 are to automatically substitute ``$keyword$`` arguments in files that match the
 pattern.  ``*.txt`` has more options so as to cover all needed keywords for
-PEPs_.
+PEPs.
 
 The ``[miscellany]`` section and its one option make svn apply the
 various rules in the ``[auto-props]`` section automatically to all added or
@@ -138,7 +138,7 @@
 
 
 Editors and Tools
------------------
+=================
 
 Python is used widely enough that practically all code editors have some form
 of support for writing Python code. Various coding tools also include Python
@@ -153,35 +153,35 @@
 Directory Structure
 ===================
 
-There are several top-level directories in the Python source tree. Knowing what
-which one is meant to hold will help you find where a certain piece of
+There are several top-level directories in the CPython source tree. Knowing what
+each one is meant to hold will help you find where a certain piece of
 functionality is implemented. Do realize, though, there are always exceptions to
 every rule.
 
 ``Doc``
- Â Â Â  The official documentation. This is what http://docs.python.org/ uses. The
-     tools for building the documentation is kept in another repository. To
-     build the docs, see ``Doc/README.txt``.
+ Â Â Â  The official documentation. This is what http://docs.python.org/ uses.
+     To build the docs, see ``Doc/README.txt``.
 
 ``Grammar``
- Â Â Â  Contains the EBNF grammar file for Python.
+     Contains the :abbr:`EBNF (Extended Backus–Naur Form)` grammar file for
+     Python.
 
 ``Include``
  Â Â Â  Contains all interpreter-wide header files.
 
 ``Lib``
- Â Â Â  The part of the standard library implemented in pure Python is here.
+ Â Â Â  The part of the standard library implemented in pure Python.
 
 ``Mac``
- Â Â Â  Mac-specific code for things such as using IDLE as an OS X application.
+ Â Â Â  Mac-specific code (e.g., using IDLE as an OS X application).
 
 ``Misc``
  Â Â Â  Things that do not belong elsewhere. Typically this is varying kinds of
-     documentation.
+     developer-specific documentation.
 
 ``Modules``
  Â Â Â  The part of the standard library (plus some other code) that is implemented
-     as extension modules.
+     in C.
 
 ``Objects``
  Â Â Â  Code for all built-in types.
@@ -198,11 +198,9 @@
      here.
 
 ``Python``
- Â Â Â  The code that makes Python run. This includes the compiler, eval loop and
-     various built-in modules.
+ Â Â Â  The code that makes up the CPython interpreter. This includes the compiler,
+     eval loop and various built-in modules.
 
 ``Tools``
      Various tools that are (or have been) used to maintain Python.
 
-
-.. _dev FAQ: XXX

--
Repository URL: http://hg.python.org/devguide