40383c8f10
Minor clarification in tutorial.
2016-02-15 17:50:33 +01:00
bc1ee460dc
Issue #25179 : Documentation for formatted string literals aka f-strings
...
Some of the inspiration and wording is taken from the text of PEP 498 by Eric
V. Smith, and the existing str.format() documentation.
2016-02-13 00:41:37 +00:00
d5db14794b
Issue #25179 : Preparatory cleanup of existing docs on string formatting
...
* Various sections were pointing to the section on the string.Formatter
class, when the section on the common format string syntax is probably more
appropriate
* Fix references to various format() functions and methods
* Nested replacement fields may contain conversions and format specifiers,
and this is tested; see Issue #19729 for instance
2016-02-08 01:34:09 +00:00
46988d3659
Merge string formatting doc fixes from 3.5
2016-02-08 01:49:35 +00:00
a8a3a1b7e8
merge from 3.5
...
Issue26135 - In the tutorial section on modules, reference importlib.reload instead of imp.reload.
2016-01-16 18:43:57 -08:00
80538e9dfe
Issue26135 - In the tutorial section on modules, reference importlib.reload instead of imp.reload.
2016-01-16 18:43:24 -08:00
2b06558769
#26001 : merge with 3.5.
2016-01-12 11:27:58 +02:00
397bb2486a
#26001 : mention in the tutorial that files in binary mode expect bytes, not str.
2016-01-12 11:27:30 +02:00
e56a919100
Issue #25523 : Merge a-to-an corrections from 3.5
2015-11-02 04:27:17 +00:00
2eb819f7a8
Issue #25523 : Merge "a" to "an" fixes from 3.4 into 3.5
2015-11-02 04:04:57 +00:00
7462b64911
Issue #25523 : Correct "a" article to "an" article
...
This changes the main documentation, doc strings, source code comments, and a
couple error messages in the test suite. In some cases the word was removed
or edited some other way to fix the grammar.
2015-11-02 03:37:02 +00:00
233cdb3e9c
Marked keystrokes with the :kbd: role.
...
Fixed the case of the "Ctrl-" prefixes.
2015-09-12 17:46:56 +03:00
153627c111
Marked keystrokes with the :kbd: role.
...
Fixed the case of the "Ctrl-" prefixes.
2015-09-12 17:46:20 +03:00
0424eaf753
Marked keystrokes with the :kbd: role.
...
Fixed the case of the "Ctrl-" prefixes.
2015-09-12 17:45:25 +03:00
799b05b052
merge
2015-09-01 02:33:20 -07:00
502bf511b3
Improve tutorial suggestion for looping techniques
2015-09-01 02:33:02 -07:00
ada5578f95
Merge with 3.5 for Issue #24729
2015-07-29 14:29:47 -04:00
0598da39ec
Merge with 3.4 for Issue #24729
2015-07-29 14:29:26 -04:00
842c07414e
Issue #24729 : Correct reference to open function.
2015-07-29 14:04:36 -04:00
d8de44b6b3
Issue #24729 : Update tutorial to match implementation.
2015-07-28 21:00:10 +02:00
8203ba99cc
Merge from 3.5
2015-06-09 18:42:36 +03:00
86a60bfb08
Merge from 3.4
2015-06-09 18:42:18 +03:00
f330d53691
#23891 : correctly refer to PyPI as "Python Package Index"
2015-06-09 18:40:16 +03:00
81a612c859
Merge from 3.5
2015-06-08 18:24:46 -04:00
6b84335ada
Merge from 3.4
2015-06-08 18:19:51 -04:00
d00407115d
#23891 : remove extra words
2015-06-08 18:17:06 -04:00
3ae067d832
Merge from 3.5
2015-06-08 17:41:39 -04:00
21fd5a92de
Merge from 3.4
2015-06-08 17:40:18 -04:00
dd15b36c90
#23891 : add a section to the Tutorial describing virtual environments and pip
2015-06-08 17:35:45 -04:00
1f49f8303a
Merge from 3.5
2015-06-08 17:19:05 -04:00
20f628ee08
Merge from 3.4
2015-06-08 17:14:13 -04:00
4a75174fba
Add link to pyvideoorg
2015-06-07 03:00:58 -04:00
ecacfd80e3
#23891 : rework discussion of python-list a bit
2015-06-06 20:25:21 -04:00
7aa5341164
Reverting my previous commit.
...
Something went horribly wrong when I was doing `hg rebase`.
2015-05-30 10:57:56 -04:00
ffb40e5ec3
More version bumping to 3.6.
...
With the creation of the 3.5 branch earlier in the process,
it is necessary to do some of the version bumps now rather than at
final release time (for example, the equivalent of the 3.4->3.5 bumps
in f2bf12fa22c1). (Some of those changes have already been made, for
example in 30f5e7ec6afe.)
2015-05-27 22:00:46 -07:00
e6efbdc947
Remove UTF-8 BOMs.
2015-05-25 12:29:53 +03:00
410d77f230
Remove UTF-8 BOMs.
2015-05-25 12:27:39 +03:00
f299abdafa
Issue #23731 : Implement PEP 488.
...
The concept of .pyo files no longer exists. Now .pyc files have an
optional `opt-` tag which specifies if any extra optimizations beyond
the peepholer were applied.
2015-04-13 14:21:02 -04:00
3f103462fb
Closes #23932 : Merge with 3.4
2015-04-13 11:32:01 -05:00
f3b990e48c
Issue #23932 : Update the tutorial section on function annotations.
...
Patch by Juti Noppornpitak.
2015-04-13 11:30:47 -05:00
556e08e9b2
Issue #12955 : Change the urlopen() examples to use context managers where appropriate.
...
Patch by Martin Panter.
2015-04-12 13:53:33 +03:00
9575e1891f
Issue #12955 : Change the urlopen() examples to use context managers where appropriate.
...
Patch by Martin Panter.
2015-04-12 13:52:49 +03:00
d71b170a4d
#23891 : describe a few more modules in the tutorial
2015-04-09 22:20:01 -04:00
b820d0defc
Issue #23286 : Fix typo in the tutorial.
...
Patch by Mayank Tripathi.
2015-01-27 02:52:40 +02:00
b68c420d8a
Issue #23286 : Fix typo in the tutorial.
...
Patch by Mayank Tripathi.
2015-01-27 02:52:14 +02:00
d3faf43f9b
Issue #23181 : More "codepoint" -> "code point".
2015-01-18 11:28:37 +02:00
3be472b5f7
Closes #23181 : codepoint -> code point
2015-01-14 08:26:30 +01:00
64c8914048
Issue #23070 : Fix a comment in the tutorial.
...
"Python" has 6 characters, not 7.
Reported by Ross Burnett.
2014-12-17 14:57:13 +02:00
2338156fa4
Issue #23070 : Fix a comment in the tutorial.
...
"Python" has 6 characters, not 7.
Reported by Ross Burnett.
2014-12-17 14:56:47 +02:00
8b1cbd2b7c
Issue #12602 : Add missing cross-references to runpy and using/cmdline docs.
...
Patch by Éric Araujo.
2014-12-10 01:47:02 +02:00
0ecd7ba968
Issue #12602 : Add missing cross-references to runpy and using/cmdline docs.
...
Patch by Éric Araujo.
2014-12-10 01:47:50 +02:00
ffd842e1d6
Issue #22824 : Updated reprlib output format for sets to use set literals.
2014-11-09 22:30:36 -08:00
fe98180bce
merge with 3.4
2014-10-31 09:29:48 +01:00
f0d2ed73ac
minor grammar fixes (from docs@python.org)
2014-10-31 09:29:38 +01:00
6b4c847c4f
Doc: fix default role usage (except in unittest mock docs)
2014-10-30 22:26:26 +01:00
93a56cdc37
Doc: fix default role usage (except in unittest mock docs)
2014-10-30 22:25:41 +01:00
794e9bf1fe
merge with 3.4
2014-10-29 10:27:06 +01:00
525d355984
Fixing broken links in doc, part 3: the rest
2014-10-29 10:26:56 +01:00
cadc3fdcb5
Merge with 3.4
2014-10-29 08:37:29 +01:00
e73778c1ac
Use https:// URLs when referring to python.org hosts.
2014-10-29 08:36:35 +01:00
bbf4ae51e4
Merge #21739 : mention subtle difference between loops and listcomps in tutorial.
2014-09-30 21:26:24 -04:00
6bd68608ff
#21739 : mention subtle difference between loops and listcomps in tutorial.
...
We don't want to go into a full explanation of scopes at this point in the
tutorial, so we just mention that the loop creates or overwrites a persistent
variable while the listcomp doesn't. Not mentioning this would lead someone
to incorrectly assume loops and listcomps were *completely* equivalent, which
would confuse them later.
Original patch by Rose Ames, tweaked to remove the word 'scope'.
2014-09-30 21:25:38 -04:00
2f2920a17f
merge from 3.4
...
Issue #16827 : Make Interpreter introduction section of the tutorial more
focussed and move advanced section and customization information to a separate
file called appendix.
Patch credits: Jamayla Wiley, Ya-Ting Huang and James Brewer.
2014-09-18 21:37:26 +08:00
15e4833662
Issue #16827 : Make Interpreter introduction section of the tutorial more
...
focussed and move advanced section and customization information to a separate
file called appendix.
Patch credits: Jamayla Wiley, Ya-Ting Huang and James Brewer.
2014-09-18 21:30:28 +08:00
7d02a98f78
#22170 : merge with 3.4.
2014-08-08 17:24:06 +03:00
79a1ffde9b
#22170 : avoid printing newlines twice in tutorial example.
2014-08-08 17:23:32 +03:00
c03dc0f164
merge
2014-06-24 13:03:54 -07:00
04ba0bb80c
Issue #11974 : Add tutorial section on class and instance variables
...
(Based on a patch from Renee Chu.)
2014-06-23 18:08:01 -07:00
07e048519b
Issue 21575: Show list.sort() arguments in the tutorial.
2014-05-26 18:44:04 -07:00
a52ecc0a02
Merge with 3.4
2014-05-23 00:34:38 -04:00
e17de09101
Issue #21545 : Add .pop example and tweak comment about pure mutation methods.
...
Patch prepared by David Harrigan.
2014-05-23 00:34:12 -04:00
53260eaa56
merge
2014-05-22 23:37:31 +01:00
bd46e48381
Issue 21554: Repair an out-of-date tutorial example to reflect changes in shutil.
2014-05-22 23:37:09 +01:00
fc1020d396
#20874 : reflow paragraph.
2014-04-15 20:26:54 -04:00
0e0e391fa3
#20874 : update tutorial wording: sophisticated line editing is now standard.
...
Patch by Rafael Mejia.
2014-04-15 20:25:18 -04:00
1b28088fd3
Merge #20874 fix.
2014-04-15 20:30:00 -04:00
d6ee27895a
Merge 3.4: Get rid of deprecated IOError in the doc
2014-04-01 01:14:27 +03:00
08af00047b
Get rid of deprecated IOError in the doc
2014-04-01 01:13:30 +03:00
9c5e98ff29
merge
2014-03-28 16:39:45 -07:00
4ab532bbfe
Issue 21014: Use booleans instead of 0 and 1 in examples.
2014-03-28 16:39:25 -07:00
60fa3533eb
merge with 3.4
2014-03-23 23:04:45 +01:00
553e108fce
tutorial: no "linux2" sys.platform on 3.x (thanks Arfrever)
2014-03-23 23:03:59 +01:00
3fa7ea1348
merge with 3.4
2014-03-22 20:39:08 +01:00
75c5ab49ed
Closes #20975 : make date in the interpreter banner a little more consistent
2014-03-22 20:38:11 +01:00
f5002bd6ac
Version bump to 3.5, step 2.
2014-03-16 23:05:59 -07:00
3732ed2414
Merge in all documentation changes since branching 3.4.0rc1.
2014-03-15 21:13:56 -07:00
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
c5f5e625aa
#20740 : merge with 3.3.
2014-02-24 20:59:48 +02:00
6b532349d0
#20740 : desquarify 2.
2014-02-24 20:58:31 +02:00
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
ae376e5ddc
Merge from 3.3
2014-02-03 09:20:22 -05:00
3633da239e
Use different word
2014-02-03 09:04:02 -05:00
1bef5c6cc8
Merge typo fix.
2014-01-14 08:45:38 -06:00
26d5fab8c8
Fix typo. Found by David Pesta on docs@.
2014-01-14 08:44:49 -06:00
f6cb6c5e11
Merge typo fix.
2014-01-14 08:41:41 -06:00
2d13036769
Fix typo. Found by David Pesta on docs@.
2014-01-14 08:40:53 -06:00
710280b6d6
Issue #18840 : Introduce the json module in the tutorial, and deemphasize the pickle module.
2013-12-05 23:48:10 +01:00
dd799d2e32
Issue #18840 : Introduce the json module in the tutorial, and deemphasize the pickle module.
2013-12-05 23:46:32 +01:00
58b7166202
Merge indentation fix in doc example from 3.3.
2013-11-17 22:09:24 +02:00
e65cb190a6
Fix indentation in doc example.
2013-11-17 22:07:48 +02:00
325a1c2f37
Fix markup errors in the docs and amend suspicious ignores.
2013-10-27 09:16:01 +01:00
186729e812
merge with 3.3
2013-10-27 09:54:53 +01:00
b9e8712a54
merge with 3.3
2013-10-12 19:13:38 +02:00
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
3226d87747
Issue #19193 : Improved cross-references in the tutorial.
2013-10-09 09:55:21 +03:00
91aaeac050
Issue #19193 : Improved cross-references in the tutorial.
2013-10-09 09:54:46 +03:00
59e3b23161
merge with 3.3
2013-10-06 19:21:20 +02:00
ac39addd72
Fix typo in example file name. Found by John Bokma on docs@.
2013-10-06 19:21:14 +02:00
449709272f
merge with 3.3
2013-10-06 13:01:23 +02:00
a12b682033
Add missing list methods. Found by Leonardo Pereira on docs@.
2013-10-06 13:01:19 +02:00
9c45050300
merge with 3.3
2013-10-06 11:09:02 +02:00
22a1fd75cc
Fix wrong Python highlighting in directory hierarchy code block.
2013-10-06 11:08:24 +02:00
6930777c63
merge with 3.3
2013-10-06 10:28:48 +02:00
242e6a0bce
Use "lambda expression" as preferred to "lambda form".
2013-10-06 10:28:39 +02:00
ce28e2c24b
merge with 3.3
2013-10-06 10:22:54 +02:00
de5aff1bdc
Closes #18646 : improve lambda docs in tutorial. Original patch by Terry Reedy.
2013-10-06 10:22:45 +02:00
7cf231f695
merge with 3.3
2013-10-06 09:42:52 +02:00
a0ec296599
Remove newline in method that makes it possible to copy example to the interactive interpreter.
2013-10-06 09:42:46 +02:00
4f00dc570c
merge with 3.3
2013-10-06 09:17:07 +02:00
53bf15af47
Fix ZeroDivisionError message (reported by Pavel Fedotov on docs@)
2013-10-06 09:11:14 +02:00
bc47d7bb4f
Merge: #16273 : Fix tutorial discussion of seek/tell (opaque text-mode values).
2013-07-30 15:53:30 -04:00
1c4e443ea2
#16273 : Fix tutorial discussion of seek/tell (opaque text-mode values).
...
Patch by Sijin Joseph.
2013-07-30 15:51:57 -04:00
d95bb3f981
#18403 : merge with 3.3.
2013-07-08 17:53:32 +02:00
93dd6934ff
#18403 : fix an off-by-one typo noticed by Xue Fuqiao.
2013-07-08 17:52:54 +02:00
fef952a607
Issue #18079 : Fix a typo in the tutorial.
2013-05-28 12:49:34 +03:00
c1939b8f75
Issue #18031 : %-formatting isn't dead yet and might pull through.
2013-05-23 00:14:47 -07:00
86aecc360f
#14097 : improve the "introduction" page of the tutorial.
2013-05-20 08:12:32 +03:00
3801f632dc
Issue #18079 : Fix a typo in the tutorial.
2013-05-28 12:50:54 +03:00
8f34da3f5f
merge
2013-05-23 00:15:19 -07:00
93c6770c72
#14097 : merge with 3.3.
2013-05-20 08:14:14 +03:00
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
ca3f29413e
#15575 : Clarify tutorial description of when modules are executed.
2013-04-21 16:59:04 -04:00
25187e666b
#15575 : Clarify tutorial description of when modules are executed.
2013-04-21 16:58:36 -04:00
acfc454c10
#13510 : merge with 3.3.
2013-04-15 19:09:29 +03:00
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
015427e659
merge with 3.3
2013-04-14 11:55:44 +02:00
5e2954e083
Clarify that the function *definition* creates the function and the binding in the module globals.
2013-04-14 11:47:46 +02:00
671ddbe5a0
merge
2013-03-22 07:26:57 -07:00
8f35c891e7
Modernize unittest example
2013-03-22 07:26:18 -07:00
827b36bed8
Issue #8890 : Stop advertising an insecure use of /tmp in docs
2013-02-23 19:37:01 +01:00
3c75a48c86
Issue #8890 : Stop advertising an insecure use of /tmp in docs
2013-02-23 19:34:44 +01:00
9f74c6cf7d
Issue #8890 : Stop advertising an insecure use of /tmp in docs
2013-02-23 19:27:49 +01:00
668d2cc3d8
merge 3.3
2013-01-20 10:09:51 -05:00
648fa19745
end is a keyword argument
2013-01-20 10:09:44 -05:00
e7ce184fe8
merge 3.3
2013-01-20 10:05:28 -05:00
0781900068
expressions -> arguments
2013-01-20 10:05:13 -05:00
d9569fa90d
Drop double newlines printed in some file iteration examples.
...
Patch by Steven Kryskalla.
2012-12-08 17:59:58 +02:00
a7129d38ed
Drop double newlines printed in some file iteration examples.
...
Patch by Steven Kryskalla.
2012-12-08 17:59:23 +02:00
09974b4e9e
Drop double newlines printed in some file iteration examples.
...
Patch by Steven Kryskalla.
2012-12-08 17:59:03 +02:00
ac6ca3dc02
Merge updates about dir() with 3.3.
2012-11-17 12:56:29 +02:00
Georg Brandl
Martin Panter
Senthil Kumaran
Ezio Melotti
Serhiy Storchaka
Raymond Hettinger
Jason R. Coombs
Alessandro Cucci
Tal Einat
Andrew Kuchling
Yury Selivanov
Ned Deily
Brett Cannon
Zachary Ware
Berker Peksag
R David Murray
Terry Jan Reedy
Andrew Svetlov
Larry Hastings
Nick Coghlan
Antoine Pitrou
Petri Lehtinen
Benjamin Peterson