Commit Graph

67 Commits

Author SHA1 Message Date
Éric Araujo 79c9d4faa7 Port a few markup edits from 3.x 2011-09-09 19:20:27 +02:00
Éric Araujo e68d4504fd Add documentation for PEP 370 features in distutils (#10745).
Apart from adding a section to describe the user scheme, this changeset
also does some much needed cleanup:

- fixed inverted reST targets
- fixed some paths
- avoided duplicating the same options listing five or six times
- added missing entries for C headers locations
- added documentation for --install-lib
- fixed a few misuses of the option role (see #9312), but not all (not
  worth the time, but will do it in packaging docs)
- fixed some markup

The paths fixes were done with an eye on the source code in the install
command, so they really describe what’s actually done.  The situation on
Mac OS X is rather messy: the fix for #8084 touched site and sysconfig,
but distutils does not use these files anymore since the Great Revert.
I suspect we have a mismatched stdlib at the moment, and the fix is not
even clear (see discussion on #8084).
2011-08-19 08:34:52 +02:00
Éric Araujo afd2fe2aea Improve documentation for PEP 370 support in site module (#8617).
site.USER_BASE and site.USER_SITE are now fully documented.  PEP 370 is
outdated with respects to the Mac framework situation, but the code in
sysconfig and the example in the 3.2 What’s New document helped me find
the right values to document for Mac OS X.

The command-line interface of the site module is also described in the
module docs.

The purpose of the usercustomize module is explained in the site docs,
with a gentle introduction in the tutorial (right after the section that
talks about PYTHONSTARTUP; a comment mentions it should be moved from
the tutorial to another file, but that will be another bug).

Various markup and wording improvements were made along the way in the
site module docs.  Duplicate and incomplete declarations of environment
variables have also been removed (the original bug report was actually
about these entries :).  The site module docs are still a bit messy;
I’ll see about improving them for #11553.

All these sections are copiously interlinked and findable from the doc
indexes.
2011-08-19 08:20:01 +02:00
Éric Araujo 5cf8660f0b Fix a few misuses of :option: I missed in r86521.
Extract of the commit message:

  Fix usage of :option: in the docs (#9312).

  :option: is used to create a link to an option of python, not to mark
  up any instance of any arbitrary command-line option.  These were
  changed to ````.
2011-06-09 14:26:10 +02:00
Georg Brandl 26946ecaed Merged revisions 85548,85572-85573,85606,85609-85612,85614-85616 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r85548 | georg.brandl | 2010-10-15 21:46:19 +0200 (Fr, 15 Okt 2010) | 1 line

  #10072: assume a bit less knowledge of the FTP protocol in the ftplib docs.
........
  r85572 | georg.brandl | 2010-10-16 20:51:05 +0200 (Sa, 16 Okt 2010) | 1 line

  #10122: typo fix.
........
  r85573 | georg.brandl | 2010-10-16 20:53:08 +0200 (Sa, 16 Okt 2010) | 1 line

  #10124: typo fix.
........
  r85606 | georg.brandl | 2010-10-17 08:32:59 +0200 (So, 17 Okt 2010) | 1 line

  #10058: tweak wording about exception returns.
........
  r85609 | georg.brandl | 2010-10-17 11:19:03 +0200 (So, 17 Okt 2010) | 1 line

  #8556: use less confusing mapping key in example.
........
  r85610 | georg.brandl | 2010-10-17 11:23:05 +0200 (So, 17 Okt 2010) | 1 line

  #8686: remove potentially confusing wording that does not add any value.
........
  r85611 | georg.brandl | 2010-10-17 11:33:24 +0200 (So, 17 Okt 2010) | 1 line

  #8811: small fixes to sqlite3 docs.
........
  r85612 | georg.brandl | 2010-10-17 11:37:54 +0200 (So, 17 Okt 2010) | 1 line

  #8855: add shelve security warning.
........
  r85614 | georg.brandl | 2010-10-17 11:46:11 +0200 (So, 17 Okt 2010) | 1 line

  #8968: add actual name of token constants.
........
  r85615 | georg.brandl | 2010-10-17 12:05:13 +0200 (So, 17 Okt 2010) | 1 line

  #459007: merge info from PC/getpathp.c and using/windows.rst to document the forming of sys.path under Windows.
........
  r85616 | georg.brandl | 2010-10-17 12:07:29 +0200 (So, 17 Okt 2010) | 1 line

  Fix copy-paste error in example.
........
2010-11-26 07:42:15 +00:00
Georg Brandl 21946afe3f Merged revisions 82798,82805,83659,83977,84015,84018,84141,84264,84326-84327,84480,84482,84484,84530-84531,84553,84619,84915-84916 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r82798 | georg.brandl | 2010-07-11 11:23:11 +0200 (So, 11 Jul 2010) | 1 line

  #6774: explain shutdown() behavior varying with platform.
........
  r82805 | georg.brandl | 2010-07-11 11:42:10 +0200 (So, 11 Jul 2010) | 1 line

  #7935: cross-reference to ast.literal_eval() from eval() docs.
........
  r83659 | georg.brandl | 2010-08-03 14:06:29 +0200 (Di, 03 Aug 2010) | 1 line

  Terminology fix: exceptions are raised, except in generator.throw().
........
  r83977 | georg.brandl | 2010-08-13 17:10:49 +0200 (Fr, 13 Aug 2010) | 1 line

  Fix copy-paste error.
........
  r84015 | georg.brandl | 2010-08-14 17:44:34 +0200 (Sa, 14 Aug 2010) | 1 line

  Add some maintainers.
........
  r84018 | georg.brandl | 2010-08-14 17:48:49 +0200 (Sa, 14 Aug 2010) | 1 line

  Typo fix.
........
  r84141 | georg.brandl | 2010-08-17 16:11:59 +0200 (Di, 17 Aug 2010) | 1 line

  Markup nits.
........
  r84264 | georg.brandl | 2010-08-22 22:23:38 +0200 (So, 22 Aug 2010) | 1 line

  #9649: fix default value description.
........
  r84326 | georg.brandl | 2010-08-26 16:30:15 +0200 (Do, 26 Aug 2010) | 1 line

  #9689: add links from overview to in-depth class API descriptions.
........
  r84327 | georg.brandl | 2010-08-26 16:30:56 +0200 (Do, 26 Aug 2010) | 1 line

  #9681: typo.
........
  r84480 | georg.brandl | 2010-09-04 00:33:27 +0200 (Sa, 04 Sep 2010) | 1 line

  More inclusive title.
........
  r84482 | georg.brandl | 2010-09-04 00:40:02 +0200 (Sa, 04 Sep 2010) | 1 line

  #9760: clarify what context expression is.
........
  r84484 | georg.brandl | 2010-09-04 00:49:27 +0200 (Sa, 04 Sep 2010) | 1 line

  Fix missing word.
........
  r84530 | georg.brandl | 2010-09-05 19:07:12 +0200 (So, 05 Sep 2010) | 1 line

  #9747: fix copy-paste error in getresgid() doc.
........
  r84531 | georg.brandl | 2010-09-05 19:09:18 +0200 (So, 05 Sep 2010) | 1 line

  #9776: fix some spacing.
........
  r84553 | georg.brandl | 2010-09-06 08:49:07 +0200 (Mo, 06 Sep 2010) | 1 line

  #9780: both { and } are not valid fill characters.
........
  r84619 | georg.brandl | 2010-09-08 12:43:45 +0200 (Mi, 08 Sep 2010) | 1 line

  Add Lukasz.
........
  r84915 | georg.brandl | 2010-09-20 08:27:02 +0200 (Mo, 20 Sep 2010) | 1 line

  Fix typo.
........
  r84916 | georg.brandl | 2010-09-20 08:29:01 +0200 (Mo, 20 Sep 2010) | 1 line

  Mention % as string formatting.
........
2010-10-06 09:28:45 +00:00
Raymond Hettinger 080ad041d2 More descriptive title. 2010-09-01 22:37:17 +00:00
Georg Brandl 90c0718052 Merged revisions 82615 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r82615 | georg.brandl | 2010-07-07 00:58:50 +0200 (Mi, 07 Jul 2010) | 1 line

  Fix typo.
........
2010-07-07 19:09:12 +00:00
Ezio Melotti 9d8d2a4d7c Update whatsnew/2.7.rst, add a few links and fix a couple of XXX. Also add a paragraph about DeprecationWarnings in cmdline.rst. 2010-07-03 07:43:04 +00:00
Georg Brandl 3d0a602c35 Fix URL. 2010-06-27 10:51:44 +00:00
Nick Coghlan 8842c356aa Revert r80580 due to some unintended side effects. See issue #8202 for details. 2010-06-13 06:50:39 +00:00
Nick Coghlan ad709ee06b Add version changed note for -m tinkering with sys.argv[0] during the search process 2010-04-28 14:53:59 +00:00
Nick Coghlan c5e4485248 Issue 8202: when using the -m command line switch, sys.argv[0] is now '-m' instead of '-c' while searching for the module to be executed 2010-04-28 14:51:08 +00:00
Andrew M. Kuchling fced90835c Two grammar fixes 2010-04-11 01:39:36 +00:00
Benjamin Peterson f3a8c6675f tell people to update python.man, too 2010-04-06 23:32:27 +00:00
Philip Jenvey aebbaeb962 #7301: add the environment variable $PYTHONWARNINGS to supplement the -W
command line option
patch from Brian Curtin
2010-04-06 23:24:45 +00:00
Ezio Melotti 425aa2e11b Fix some broken URLs. 2010-04-05 12:51:45 +00:00
Barry Warsaw b1e66ee651 Resolve bug 7847 by including documentation for -J, -U, and -X under "Options
you shouldn't use".
2010-02-05 18:45:25 +00:00
Georg Brandl 96aa3ca242 #7653: clarify how the PythonPath registry key should look like. 2010-01-07 21:48:47 +00:00
Brett Cannon f31d1a0577 Add some missing command-line options to the main list. All but -V were already
documented. Left -V undocumented for now (and -U was already undocumented).
2010-01-01 01:44:57 +00:00
Ezio Melotti 062d2b52f3 #7388: "python".capitalize() in the Doc 2009-12-19 22:41:49 +00:00
Georg Brandl 6c14e587f5 Use "impl-detail" directive where applicable. 2009-10-22 11:48:10 +00:00
Georg Brandl a4314c2b21 Fix broken links found by "make linkcheck". scipy.org seems to be done right now, so I could not verify links going there. 2009-10-11 20:16:16 +00:00
Ezio Melotti 2c7b4934ad #6904 - fix broken link 2009-09-14 00:48:31 +00:00
Georg Brandl d7d4fd7336 builtin -> built-in. 2009-07-26 14:37:28 +00:00
Georg Brandl 5a85d5c4f2 #6332: fix word dupes throughout the source. 2009-06-24 06:41:19 +00:00
Georg Brandl d91f8cf779 Remove ".. warning::" markup that doesnt contain warnings for users, rather todo items. 2009-04-27 15:10:44 +00:00
Georg Brandl a0eea590c7 Add section numbering to some of the larger subdocuments. 2009-03-28 19:57:36 +00:00
Nick Coghlan d39600e69f Issue 4195: Restore the ability to execute packages with the -m switch (but this time in a way that leaves the import machinery in a valid state). (Original patch by Andi Vajda) 2009-02-08 01:26:34 +00:00
Benjamin Peterson a924289e9a fix spelling 2009-01-09 03:03:05 +00:00
Benjamin Peterson fe8076eeb6 specify what -3 warnings are about 2009-01-09 02:53:35 +00:00
Georg Brandl c62ef8b4d9 Remove trailing whitespace. 2009-01-03 20:55:06 +00:00
Georg Brandl fc29f27c16 #4811: fix markup glitches (mostly remains of the conversion),
found by Gabriel Genellina.
2009-01-02 20:25:14 +00:00
Georg Brandl 1966a237fb Markup fix. 2008-12-23 15:44:25 +00:00
Georg Brandl 14da8e800b Fix syntax. 2008-11-07 08:27:39 +00:00
Georg Brandl 73ac29e426 #3916: fixes for docs wrt. Windows directory layout 2008-09-21 07:17:00 +00:00
Georg Brandl 9af9498c6e Remove things specific to the old Macintosh, and spell "Mac OS X" consistently. 2008-09-13 17:41:16 +00:00
Georg Brandl c0f10f34b1 #3472: update Mac-bundled Python version info. 2008-09-09 20:28:31 +00:00
Benjamin Peterson 90f36730e2 fix various doc typos #3320 2008-07-12 20:16:19 +00:00
Georg Brandl d987545d30 Clarify what ":errorhandler" refers to. 2008-06-11 17:57:44 +00:00
Martin v. Löwis 99815892f6 New environment variable PYTHONIOENCODING. 2008-06-01 07:20:46 +00:00
Christian Heimes af748c3ab8 Implemented PEP 370 2008-05-06 22:41:46 +00:00
Nick Coghlan 31f631539e Update command line usage documentation to reflect 2.6 changes (also includes some minor cleanups). Addresses TODO list issue 2258 2008-04-30 14:23:36 +00:00
Georg Brandl 9c06574024 #2239: PYTHONPATH delimiter is os.pathsep. 2008-03-05 19:31:44 +00:00
Georg Brandl 3ef2063ec8 #2194: fix some typos. 2008-02-26 19:13:45 +00:00
Georg Brandl 4425e7cee7 Specify what kind of warning -3 emits. 2008-02-23 23:43:01 +00:00
Georg Brandl 21297fa621 Fix markup. 2008-01-20 21:10:08 +00:00
Georg Brandl 8d10167236 Better method for associating .py files with the interpreter. 2008-01-08 19:42:30 +00:00
Georg Brandl 61d2886491 Fix two further doc build warnings. 2008-01-07 18:57:03 +00:00
Raymond Hettinger 1b0ebb168d Fix inconsistent title levels -- it made the whole doc build crash horribly. 2008-01-07 18:52:19 +00:00