Commit Graph

482 Commits

Author SHA1 Message Date
Larry Hastings 3732ed2414 Merge in all documentation changes since branching 3.4.0rc1. 2014-03-15 21:13:56 -07:00
Nick Coghlan f7614d55a2 Close #19407: New installation & distribution guides
- based on pip and other PyPA tools
- includes references to the new Python Packaging User Guide
  where appropriate (and the relevant section is at least
  partially filled in)
- started new FAQ sections
- both guides aim to introduce users to basic open source
  concepts if they aren't aware of them
- existing guides have been relocated (now linked from the
  distutils docs) rather then removed, since there is
  some needed material that has yet to be relocated to the
  distutils docs as a reference for the legacy formats
2014-03-13 22:13:45 +10:00
Ezio Melotti c5f5e625aa #20740: merge with 3.3. 2014-02-24 20:59:48 +02:00
Ezio Melotti 6b532349d0 #20740: desquarify 2. 2014-02-24 20:58:31 +02:00
Brett Cannon f811bbfe6c Issue #6386: When executing a script that's a symlink, the directory
where the symlink resolves to is added to sys.path, not the directory
containing the symlink itself.

Thanks to Sanko Resic for an initial attempt at the patch.
2014-02-06 09:22:51 -05:00
Andrew Kuchling ae376e5ddc Merge from 3.3 2014-02-03 09:20:22 -05:00
Andrew Kuchling 3633da239e Use different word 2014-02-03 09:04:02 -05:00
Zachary Ware 1bef5c6cc8 Merge typo fix. 2014-01-14 08:45:38 -06:00
Zachary Ware 26d5fab8c8 Fix typo. Found by David Pesta on docs@. 2014-01-14 08:44:49 -06:00
Zachary Ware f6cb6c5e11 Merge typo fix. 2014-01-14 08:41:41 -06:00
Zachary Ware 2d13036769 Fix typo. Found by David Pesta on docs@. 2014-01-14 08:40:53 -06:00
Antoine Pitrou 710280b6d6 Issue #18840: Introduce the json module in the tutorial, and deemphasize the pickle module. 2013-12-05 23:48:10 +01:00
Antoine Pitrou dd799d2e32 Issue #18840: Introduce the json module in the tutorial, and deemphasize the pickle module. 2013-12-05 23:46:32 +01:00
Ezio Melotti 58b7166202 Merge indentation fix in doc example from 3.3. 2013-11-17 22:09:24 +02:00
Ezio Melotti e65cb190a6 Fix indentation in doc example. 2013-11-17 22:07:48 +02:00
Georg Brandl 325a1c2f37 Fix markup errors in the docs and amend suspicious ignores. 2013-10-27 09:16:01 +01:00
Georg Brandl 186729e812 merge with 3.3 2013-10-27 09:54:53 +01:00
Georg Brandl b9e8712a54 merge with 3.3 2013-10-12 19:13:38 +02:00
Georg Brandl 5db7c54f96 Closes #13915: update tutorial with respect to .pyc files (__pycache__ / PEP 3147).
Initial wording proposed by John Roth.
2013-10-12 19:13:23 +02:00
Serhiy Storchaka 3226d87747 Issue #19193: Improved cross-references in the tutorial. 2013-10-09 09:55:21 +03:00
Serhiy Storchaka 91aaeac050 Issue #19193: Improved cross-references in the tutorial. 2013-10-09 09:54:46 +03:00
Georg Brandl 59e3b23161 merge with 3.3 2013-10-06 19:21:20 +02:00
Georg Brandl ac39addd72 Fix typo in example file name. Found by John Bokma on docs@. 2013-10-06 19:21:14 +02:00
Georg Brandl 449709272f merge with 3.3 2013-10-06 13:01:23 +02:00
Georg Brandl a12b682033 Add missing list methods. Found by Leonardo Pereira on docs@. 2013-10-06 13:01:19 +02:00
Georg Brandl 9c45050300 merge with 3.3 2013-10-06 11:09:02 +02:00
Georg Brandl 22a1fd75cc Fix wrong Python highlighting in directory hierarchy code block. 2013-10-06 11:08:24 +02:00
Georg Brandl 6930777c63 merge with 3.3 2013-10-06 10:28:48 +02:00
Georg Brandl 242e6a0bce Use "lambda expression" as preferred to "lambda form". 2013-10-06 10:28:39 +02:00
Georg Brandl ce28e2c24b merge with 3.3 2013-10-06 10:22:54 +02:00
Georg Brandl de5aff1bdc Closes #18646: improve lambda docs in tutorial. Original patch by Terry Reedy. 2013-10-06 10:22:45 +02:00
Georg Brandl 7cf231f695 merge with 3.3 2013-10-06 09:42:52 +02:00
Georg Brandl a0ec296599 Remove newline in method that makes it possible to copy example to the interactive interpreter. 2013-10-06 09:42:46 +02:00
Georg Brandl 4f00dc570c merge with 3.3 2013-10-06 09:17:07 +02:00
Georg Brandl 53bf15af47 Fix ZeroDivisionError message (reported by Pavel Fedotov on docs@) 2013-10-06 09:11:14 +02:00
R David Murray bc47d7bb4f Merge: #16273: Fix tutorial discussion of seek/tell (opaque text-mode values). 2013-07-30 15:53:30 -04:00
R David Murray 1c4e443ea2 #16273: Fix tutorial discussion of seek/tell (opaque text-mode values).
Patch by Sijin Joseph.
2013-07-30 15:51:57 -04:00
Ezio Melotti d95bb3f981 #18403: merge with 3.3. 2013-07-08 17:53:32 +02:00
Ezio Melotti 93dd6934ff #18403: fix an off-by-one typo noticed by Xue Fuqiao. 2013-07-08 17:52:54 +02:00
Serhiy Storchaka fef952a607 Issue #18079: Fix a typo in the tutorial. 2013-05-28 12:49:34 +03:00
Raymond Hettinger c1939b8f75 Issue #18031: %-formatting isn't dead yet and might pull through. 2013-05-23 00:14:47 -07:00
Ezio Melotti 86aecc360f #14097: improve the "introduction" page of the tutorial. 2013-05-20 08:12:32 +03:00
Serhiy Storchaka 3801f632dc Issue #18079: Fix a typo in the tutorial. 2013-05-28 12:50:54 +03:00
Raymond Hettinger 8f34da3f5f merge 2013-05-23 00:15:19 -07:00
Ezio Melotti 93c6770c72 #14097: merge with 3.3. 2013-05-20 08:14:14 +03:00
Antoine Pitrou 1a6cb30a34 Issue #5845: Enable tab-completion in the interactive interpreter by default, thanks to a new sys.__interactivehook__.
(original patch by Éric Araujo)
2013-05-04 20:08:35 +02:00
R David Murray ca3f29413e #15575: Clarify tutorial description of when modules are executed. 2013-04-21 16:59:04 -04:00
R David Murray 25187e666b #15575: Clarify tutorial description of when modules are executed. 2013-04-21 16:58:36 -04:00
Ezio Melotti acfc454c10 #13510: merge with 3.3. 2013-04-15 19:09:29 +03:00
Ezio Melotti ed3cd7e445 #13510: clarify that f.readlines() is note necessary to iterate over a file. Patch by Dan Riti. 2013-04-15 19:08:31 +03:00
Georg Brandl 015427e659 merge with 3.3 2013-04-14 11:55:44 +02:00
Georg Brandl 5e2954e083 Clarify that the function *definition* creates the function and the binding in the module globals. 2013-04-14 11:47:46 +02:00
Raymond Hettinger 671ddbe5a0 merge 2013-03-22 07:26:57 -07:00
Raymond Hettinger 8f35c891e7 Modernize unittest example 2013-03-22 07:26:18 -07:00
Petri Lehtinen 827b36bed8 Issue #8890: Stop advertising an insecure use of /tmp in docs 2013-02-23 19:37:01 +01:00
Petri Lehtinen 3c75a48c86 Issue #8890: Stop advertising an insecure use of /tmp in docs 2013-02-23 19:34:44 +01:00
Petri Lehtinen 9f74c6cf7d Issue #8890: Stop advertising an insecure use of /tmp in docs 2013-02-23 19:27:49 +01:00
Benjamin Peterson 668d2cc3d8 merge 3.3 2013-01-20 10:09:51 -05:00
Benjamin Peterson 648fa19745 end is a keyword argument 2013-01-20 10:09:44 -05:00
Benjamin Peterson e7ce184fe8 merge 3.3 2013-01-20 10:05:28 -05:00
Benjamin Peterson 0781900068 expressions -> arguments 2013-01-20 10:05:13 -05:00
Andrew Svetlov d9569fa90d Drop double newlines printed in some file iteration examples.
Patch by Steven Kryskalla.
2012-12-08 17:59:58 +02:00
Andrew Svetlov a7129d38ed Drop double newlines printed in some file iteration examples.
Patch by Steven Kryskalla.
2012-12-08 17:59:23 +02:00
Andrew Svetlov 09974b4e9e Drop double newlines printed in some file iteration examples.
Patch by Steven Kryskalla.
2012-12-08 17:59:03 +02:00
Ezio Melotti ac6ca3dc02 Merge updates about dir() with 3.3. 2012-11-17 12:56:29 +02:00
Ezio Melotti 4a42ec5089 Merge updates about dir() with 3.2. 2012-11-17 12:54:45 +02:00
Ezio Melotti 52e855084d Update section about dir() in the tutorial. 2012-11-17 12:50:14 +02:00
Ezio Melotti 2264825cae Merge rephrasing with 3.3. 2012-11-17 12:06:44 +02:00
Ezio Melotti 0bbfae3be4 Merge rephrasing with 3.2. 2012-11-17 12:06:26 +02:00
Ezio Melotti 89b03b0ec6 Rephrase a sentence in the set and dict comprehensions tutorial page. 2012-11-17 12:06:01 +02:00
Chris Jerdonek 86b3053411 Merge from 3.3: improve FAQ link in documentation (for issue #16435). 2012-11-09 17:54:21 -08:00
Chris Jerdonek fe08756743 Merge from 3.2: improve FAQ link in documentation (for issue #16435). 2012-11-09 17:53:14 -08:00
Chris Jerdonek 4ed4b1c7fe Improve FAQ link in documentation (for issue #16435). 2012-11-09 17:52:30 -08:00
Andrew Svetlov 73b56c8d57 Merge issue #16435: Link in tutorial now points to python3 FAQ.
Thanks to Yongzhi Pan from docs@
2012-11-08 16:11:44 +02:00
Andrew Svetlov b5570e9909 Merge issue #16435: Link in tutorial now points to python3 FAQ.
Thanks to Yongzhi Pan from docs@
2012-11-08 16:11:22 +02:00
Andrew Svetlov 0e9a065275 Issue #16435: Link in tutorial now points to python3 FAQ.
Thanks to Yongzhi Pan from docs@
2012-11-08 16:10:49 +02:00
Andrew Svetlov 553408fe08 Merge issue #14893: Add function annotation example to function tutorial.
Patch by Zachary Ware.
2012-11-01 21:28:40 +02:00
Andrew Svetlov 7c91dbec0e Merge issue #14893: Add function annotation example to function tutorial.
Patch by Zachary Ware.
2012-11-01 21:27:23 +02:00
Andrew Svetlov 1491cbdf63 Issue #14893: Add function annotation example to function tutorial.
Patch by Zachary Ware.
2012-11-01 21:26:55 +02:00
Chris Jerdonek 21fecc764c Merge from 3.3: remove unneeded "Release" and "Date" markers from index pages. 2012-10-28 11:13:51 -07:00
Chris Jerdonek d285029ee8 Merge from 3.2: remove unneeded "Release" and "Date" markers from index pages. 2012-10-28 11:10:24 -07:00
Chris Jerdonek 8b7f9f581d Remove unneeded "Release" and "Date" markers from doc index pages. 2012-10-28 11:08:26 -07:00
Ezio Melotti afa46abab8 #16317: merge with 3.3. 2012-10-26 19:33:37 +03:00
Ezio Melotti 0ada6f1a52 #16317: mention lzma in the tutorial. Patch by Serhiy Storchaka. 2012-10-26 19:33:07 +03:00
Jesus Cea 145ce8e38b MERGE: Closes #16294: 8 space indent in tutorial 2012-10-22 13:16:05 +02:00
Jesus Cea 80c2f4fc43 MERGE: Closes #16294: 8 space indent in tutorial 2012-10-22 13:15:45 +02:00
Jesus Cea af38774b5f Closes #16294: 8 space indent in tutorial 2012-10-22 13:15:17 +02:00
Chris Jerdonek 56d279fe35 Merge from 3.3: clarify universal-newline wording in tutorial (issue #16266).
This also null merges from a previous commit.
2012-10-17 20:29:07 -07:00
Chris Jerdonek 206f962f32 Merge from 3.2: clarify universal-newline wording in tutorial (issue #16266). 2012-10-17 20:21:05 -07:00
Chris Jerdonek 5bf7f1f6e3 Clarify universal-newline wording in tutorial (issue #16266). 2012-10-17 20:17:41 -07:00
Andrew Svetlov a3f862e915 Merge issue #16265: Fix collapsing of code sample in tutorial.
Thanks to Yongzhi Pan from docs@
2012-10-17 16:46:50 +03:00
Andrew Svetlov 65b4b40e24 Merge issue #16265: Fix collapsing of code sample in tutorial.
Thanks to Yongzhi Pan from docs@
2012-10-17 16:46:00 +03:00
Andrew Svetlov e9cf97cf20 Issue #16265: Fix collapsing of code sample in tutorial.
Thanks to Yongzhi Pan from docs@
2012-10-17 16:41:28 +03:00
Chris Jerdonek c7633e684b Issue #16225: Merge from 3.3: Add additional note to tutorial about looping. 2012-10-15 19:47:32 -07:00
Chris Jerdonek 38049bb251 Issue #16225: Merge from 3.2: Add additional note to tutorial about looping. 2012-10-15 19:46:34 -07:00
Chris Jerdonek 4fab8f0e06 Issue #16225: Add additional note to tutorial about changing sequence while looping. 2012-10-15 19:44:47 -07:00
Ezio Melotti 5c3283e43a Merge __next__ method link fixes with 3.3. 2012-10-12 13:46:37 +03:00
Ezio Melotti 1dd7c30419 Merge __next__ method link fixes with 3.2. 2012-10-12 13:45:38 +03:00
Ezio Melotti 7fa822275b Fix links to the __next__ method. 2012-10-12 13:42:08 +03:00
Ezio Melotti f79774bb92 Merge link additions/fixes with 3.3. 2012-10-12 11:02:39 +03:00
Ezio Melotti a6229e6ebd Fix and add more links. 2012-10-12 10:59:14 +03:00
Georg Brandl 08a9012352 Bump version to 3.4.0 alpha 0. 2012-09-29 09:34:13 +02:00
Chris Jerdonek 18581efe36 Close issue #16073: merge fix from 3.2. 2012-09-28 07:24:24 -07:00
Chris Jerdonek fd448daf77 Close issue #16073: fix map() example in list comprehension documentation.
Thanks for the e-mail report to docs@.
2012-09-28 07:07:12 -07:00
Chris Jerdonek dbe508870f Issue #16015: Merge and update from 3.2. 2012-09-25 04:33:24 -07:00
Chris Jerdonek df12f2bbb6 Issue #16015: Make welcome message more realistic in tutorial example. 2012-09-25 04:20:29 -07:00
Chris Jerdonek 9118a79c7c Issue #16015: Merge fix from 3.2. 2012-09-24 19:31:09 -07:00
Chris Jerdonek 9bb56a66c5 Issue #16015: Fix NameError doctest example in tutorial introduction. 2012-09-24 19:28:59 -07:00
Ezio Melotti f8a2865482 #16019, #16020: merge with 3.2. 2012-09-24 17:31:37 +03:00
Ezio Melotti 8618fb6a65 #16019, #16020: fix syntax highlight. 2012-09-24 17:30:39 +03:00
Ezio Melotti 5799a2d8c3 #16017: merge with 3.2. 2012-09-24 17:08:05 +03:00
Ezio Melotti c926c59d80 #16017: capitalize URLs. 2012-09-24 17:07:39 +03:00
Eli Bendersky 8c601b0b85 Merge 3.2: tutorial typo fix 2012-08-18 09:50:32 +03:00
Eli Bendersky 31a11902b3 tutorial typo fix 2012-08-18 09:50:09 +03:00
Sandro Tosi 488cc36123 merge with 3.2 2012-08-14 19:52:04 +02:00
Sandro Tosi a17ef14632 fix typo 2012-08-14 19:51:43 +02:00
Senthil Kumaran b2d8502485 merge from 3.2
Issue #15630: Add an example for "continue" statement in the tutorial. Patch by
Daniel Ellis.
2012-08-12 12:13:38 -07:00
Senthil Kumaran 1ef9caa2a1 Issue #15630: Add an example for "continue" statement in the tutorial. Patch by
Daniel Ellis.
2012-08-12 12:01:47 -07:00
Sandro Tosi 131160c5cc merge with 3.2 2012-08-12 10:25:10 +02:00
Sandro Tosi 0a90a82b8a zip() returns an iterator, make a list() of it; thanks to Martin from docs@ 2012-08-12 10:24:50 +02:00
Antoine Pitrou b79be95dac Issue #15444: Use proper spelling for non-ASCII contributor names.
Patch by Serhiy Storchaka.
2012-08-11 16:54:27 +02:00
Antoine Pitrou fbd4f80979 Issue #15444: Use proper spelling for non-ASCII contributor names.
Patch by Serhiy Storchaka.
2012-08-11 16:51:50 +02:00
Sandro Tosi ba5010a649 merge with 3.2 2012-08-04 19:42:46 +02:00
Sandro Tosi da9df92068 add missing period; thanks to Gaston Fiore from docs@ 2012-08-04 19:42:24 +02:00
Ezio Melotti 5b1406fbce #14840: merge with 3.2. 2012-06-17 14:12:42 +02:00
Ezio Melotti f90ea1f0a0 #14840: Add a bit on the difference between tuples and lists. Initial patch by Zachary Ware. 2012-06-17 14:10:59 +02:00
Nick Coghlan cbc203e655 Merge from 3.2 2012-06-07 22:42:29 +10:00
Nick Coghlan a3a164a03c Nudge readers towards a more accurate mental model for loop else clauses 2012-06-07 22:41:34 +10:00
Senthil Kumaran 065dedaf47 Fix closes Issue: 14217 - 3.2 branch 2012-03-08 20:56:52 -08:00
Senthil Kumaran 74d5657c80 Fix closes Issue: 14217 - Appropriate sphinx directive for output. Patch by Tshepang Lekhonkhobe 2012-03-08 20:54:34 -08:00
Sandro Tosi 82138b8a84 Issue #11948: merge with 3.2 2012-01-19 11:29:48 +01:00
Sandro Tosi f0229aa51c Issue #11948: clarify modules search path 2012-01-19 11:29:26 +01:00
Terry Jan Reedy ea868d32a1 Minor correction. #11418 2012-01-11 14:54:34 -05:00
Georg Brandl 1532c8f9a7 I do not think we will ever have auto-indent at the prompt, that is for IPython and the like. 2011-12-25 19:03:07 +01:00
Terry Jan Reedy 982c91e4c9 Merge with 3.2 2012-01-11 14:56:22 -05:00
Georg Brandl 1e66f56d09 merge with 3.2 2011-12-25 19:03:22 +01:00
Ezio Melotti ec51cf159f #6570: merge with 3.2. 2011-12-13 15:53:47 +02:00
Ezio Melotti 7b7e39a61f #6570: clarify tutorial section about keyword arguments. 2011-12-13 15:49:22 +02:00
Ezio Melotti d31d57e272 #13549: merge with 3.2. 2011-12-13 15:38:13 +02:00
Ezio Melotti 91621e2c16 #13549: improve tutorial section about listcomps. 2011-12-13 15:36:19 +02:00
Sandro Tosi d856bc0582 merge with 3.2 2011-10-31 17:16:03 +01:00
Sandro Tosi 69e59a17dd remove confusing paragraph (as part of r87523); thanks to AJ Hill from docs@ 2011-10-31 17:15:39 +01:00
Ezio Melotti f10644983e Merge with 3.2. 2011-10-19 11:06:26 +03:00
Ezio Melotti e130a52d8a Remove duplication. 2011-10-19 10:58:56 +03:00
Georg Brandl 388349add2 Closes #12192: Document that mutating list methods do not return the instance (original patch by Mike Hoy). 2011-10-08 18:32:40 +02:00
Éric Araujo 19272beec9 Branch merge 2011-08-09 18:01:52 +02:00
Éric Araujo da3f4ae34b Branch merge 2011-08-09 18:01:38 +02:00
Georg Brandl 96598afac4 Merge with 3.2. 2011-08-08 21:45:24 +02:00
Georg Brandl bdbdfb1978 Confirm that the prime example is actually correct. We get so many complaints about a "buggy example" on docs@python, let us hope this cuts them in half at least. 2011-08-08 21:45:13 +02:00
Éric Araujo 7dc76fdeb1 Merge doc changes from 3.2 (#8617, #10745).
In the install and library docs, I changed the text to refer to
packaging instead of distutils.  I also checked that the documented
paths correctly reflect what’s really defined in sysconfig; the main
difference with paths defined in distutils.install is that include
directories don’t end with the distribution name anymore (i.e. distutils
uses include/python3.3/spam, sysconfig include/python3.3), I have no
idea why.
2011-08-06 16:58:15 +02:00