1. Carl Meyer
  2. sample-distutils2-project


Éric Araujo  committed 0895fa1

Address feedback from Fred Drake

  • Participants
  • Parent commits 566a417
  • Branches default

Comments (0)

Files changed (1)

File new-config-file.rst

View file
  • Ignore whitespace
-Accepted and Proposed Changes to Configuration Files
+Proposed Changes to Configuration Files
 :Author: Éric Araujo <merwok@netwok.org>
 :Credits: Carl Meyer, folks at PyCon 2010, people in #distutils
 .. TODO take ideas from http://wiki.python.org/moin/Distutils/StaticMetadata
         + add more comments there
-.. TODO document encoding for the config file (UTF-8/mbcs on win32)
 .. highlight:: cfg
 .. TODO understand and integrate Tarek’s thing about declaring commands
-Annex: Making things simple for users
+Appendix: Making things simple for users
 mkpkg (to be given a better name) will help people do the right thing, e.g.
 use a compliant version number, fill the ``license`` field only when there is
 transition their practices and installation documentation.
-Annex: Implementation details
+Appendix: Implementation details
 The `config file parser`_ strips leading and trailing whitespace for free, we
 just have to handle the case of the first line being empty (in the line
 filtered according to the environment, access a config section defined by a
 Distutils2 extension, and so on.
+The encoding of the config file is UTF-8.
 .. XXX use a special section name prefix for those extensions?
-Annex: Mapping from arguments to fields
+Appendix: Mapping from arguments to fields
 ============================ ==============================
 Argument in :file:`setup.py` Field in :file:`setup.cfg`
 ============================ ==============================
-Annex: Rejected ideas
+Appendix: Rejected ideas
 Get metadata from hooks