Raymond Hettinger
87fe473edc
merge
2016-08-12 09:44:18 -07:00
Raymond Hettinger
7f65af3d2d
Issue 27719: Remove a doc example that is not applicable in Python 3
2016-08-12 09:43:59 -07:00
Zachary Ware
c17dd50957
Closes #27206 : Merge with 3.5
2016-08-09 17:45:15 -05:00
Zachary Ware
c483a01a8f
Issue #27206 : Fix doctests in Doc/tutorial.
...
Patch by Jelle Zijlstra.
2016-08-09 17:44:52 -05:00
Martin Panter
6a09315ff0
Issue #26462 : Merge code block fixes from 3.5
2016-07-29 01:49:37 +00:00
Martin Panter
1050d2d0c7
Issue #26462 : Doc: reduce literal_block warnings, fix syntax highlighting.
...
Patch by Julien Palard.
2016-07-26 11:18:21 +02:00
Brett Cannon
15552c39e0
Issue #27285 : Document the deprecation of the pyvenv script.
...
As part of the update, the documentation was updated to normalize
around the term "virtual environment" instead of relying too heavily
on "venv" for the same meaning and leading to inconsistent usage of
either.
Thanks to Steve Piercy for the patch.
2016-07-08 10:46:21 -07:00
Martin Panter
2fec611a70
Issue #24314 : Merge doc links from 3.5
2016-06-18 08:20:22 +00:00
Martin Panter
bae5d81f5d
Issue #24314 : Fix doc links for general attributes like __name__, __dict__
2016-06-18 03:57:31 +00:00
Berker Peksag
0a5120e457
Issue #23116 : Improve ask_ok() example in the Python tutorial
2016-06-02 11:31:19 -07:00
Berker Peksag
9c27c18c65
Issue #23116 : Merge from 3.5
2016-06-02 11:31:51 -07:00
Berker Peksag
c5f4036e6c
Issue #27178 : Fix markup in tutorial
...
Patch by Nathan Harold.
2016-06-01 14:38:18 -07:00
Berker Peksag
ef1179e451
Issue #27174 : Merge from 3.5
2016-06-01 09:53:05 -07:00
Berker Peksag
93818c752d
Issue #27174 : Update IPython URL in tutorial
2016-06-01 09:52:35 -07:00
Berker Peksag
12a8a8a0db
Merge from 3.5
2016-06-01 09:36:40 -07:00
Berker Peksag
8e937f80c9
Fix typo in Python tutorial
2016-06-01 09:36:14 -07:00
Serhiy Storchaka
c499f30286
Issue #23921 : Standardized documentation whitespace formatting.
...
Original patch by James Edwards.
2016-05-10 12:01:56 +03:00
Serhiy Storchaka
dba903993a
Issue #23921 : Standardized documentation whitespace formatting.
...
Original patch by James Edwards.
2016-05-10 12:01:23 +03:00
Serhiy Storchaka
1acbf853c8
Issue #26736 : Used HTTPS for external links in the documentation if possible.
2016-05-07 10:49:58 +03:00
Serhiy Storchaka
6dff0205b7
Issue #26736 : Used HTTPS for external links in the documentation if possible.
2016-05-07 10:49:07 +03:00
Serhiy Storchaka
b6a9c9761c
Issue #26778 : Fixed "a/an/and" typos in code comment, documentation and error
...
messages.
2016-04-17 09:39:28 +03:00
Serhiy Storchaka
6a7b3a77b4
Issue #26778 : Fixed "a/an/and" typos in code comment and documentation.
2016-04-17 08:32:47 +03:00
Georg Brandl
2d43bc2fc2
merge with 3.5
2016-02-22 14:53:03 +01:00
Georg Brandl
f1d371bde9
Update example; str(float) changed so there is difference now.
2016-02-22 14:52:55 +01:00
Georg Brandl
40383c8f10
Minor clarification in tutorial.
2016-02-15 17:50:33 +01:00
Martin Panter
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
Martin Panter
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
Martin Panter
46988d3659
Merge string formatting doc fixes from 3.5
2016-02-08 01:49:35 +00:00
Senthil Kumaran
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
Senthil Kumaran
80538e9dfe
Issue26135 - In the tutorial section on modules, reference importlib.reload instead of imp.reload.
2016-01-16 18:43:24 -08:00
Ezio Melotti
2b06558769
#26001 : merge with 3.5.
2016-01-12 11:27:58 +02:00
Ezio Melotti
397bb2486a
#26001 : mention in the tutorial that files in binary mode expect bytes, not str.
2016-01-12 11:27:30 +02:00
Martin Panter
e56a919100
Issue #25523 : Merge a-to-an corrections from 3.5
2015-11-02 04:27:17 +00:00
Martin Panter
2eb819f7a8
Issue #25523 : Merge "a" to "an" fixes from 3.4 into 3.5
2015-11-02 04:04:57 +00:00
Martin Panter
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
Serhiy Storchaka
233cdb3e9c
Marked keystrokes with the :kbd: role.
...
Fixed the case of the "Ctrl-" prefixes.
2015-09-12 17:46:56 +03:00
Serhiy Storchaka
153627c111
Marked keystrokes with the :kbd: role.
...
Fixed the case of the "Ctrl-" prefixes.
2015-09-12 17:46:20 +03:00
Serhiy Storchaka
0424eaf753
Marked keystrokes with the :kbd: role.
...
Fixed the case of the "Ctrl-" prefixes.
2015-09-12 17:45:25 +03:00
Raymond Hettinger
799b05b052
merge
2015-09-01 02:33:20 -07:00
Raymond Hettinger
502bf511b3
Improve tutorial suggestion for looping techniques
2015-09-01 02:33:02 -07:00
Jason R. Coombs
ada5578f95
Merge with 3.5 for Issue #24729
2015-07-29 14:29:47 -04:00
Jason R. Coombs
0598da39ec
Merge with 3.4 for Issue #24729
2015-07-29 14:29:26 -04:00
Jason R. Coombs
842c07414e
Issue #24729 : Correct reference to open function.
2015-07-29 14:04:36 -04:00
Alessandro Cucci
d8de44b6b3
Issue #24729 : Update tutorial to match implementation.
2015-07-28 21:00:10 +02:00
Tal Einat
8203ba99cc
Merge from 3.5
2015-06-09 18:42:36 +03:00
Tal Einat
86a60bfb08
Merge from 3.4
2015-06-09 18:42:18 +03:00
Tal Einat
f330d53691
#23891 : correctly refer to PyPI as "Python Package Index"
2015-06-09 18:40:16 +03:00
Andrew Kuchling
81a612c859
Merge from 3.5
2015-06-08 18:24:46 -04:00
Andrew Kuchling
6b84335ada
Merge from 3.4
2015-06-08 18:19:51 -04:00
Andrew Kuchling
d00407115d
#23891 : remove extra words
2015-06-08 18:17:06 -04:00
Andrew Kuchling
3ae067d832
Merge from 3.5
2015-06-08 17:41:39 -04:00
Andrew Kuchling
21fd5a92de
Merge from 3.4
2015-06-08 17:40:18 -04:00
Andrew Kuchling
dd15b36c90
#23891 : add a section to the Tutorial describing virtual environments and pip
2015-06-08 17:35:45 -04:00
Andrew Kuchling
1f49f8303a
Merge from 3.5
2015-06-08 17:19:05 -04:00
Andrew Kuchling
20f628ee08
Merge from 3.4
2015-06-08 17:14:13 -04:00
Andrew Kuchling
4a75174fba
Add link to pyvideoorg
2015-06-07 03:00:58 -04:00
Andrew Kuchling
ecacfd80e3
#23891 : rework discussion of python-list a bit
2015-06-06 20:25:21 -04:00
Yury Selivanov
7aa5341164
Reverting my previous commit.
...
Something went horribly wrong when I was doing `hg rebase`.
2015-05-30 10:57:56 -04:00
Ned Deily
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
Serhiy Storchaka
e6efbdc947
Remove UTF-8 BOMs.
2015-05-25 12:29:53 +03:00
Serhiy Storchaka
410d77f230
Remove UTF-8 BOMs.
2015-05-25 12:27:39 +03:00
Brett Cannon
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
Zachary Ware
3f103462fb
Closes #23932 : Merge with 3.4
2015-04-13 11:32:01 -05:00
Zachary Ware
f3b990e48c
Issue #23932 : Update the tutorial section on function annotations.
...
Patch by Juti Noppornpitak.
2015-04-13 11:30:47 -05:00
Berker Peksag
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
Berker Peksag
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
Andrew Kuchling
d71b170a4d
#23891 : describe a few more modules in the tutorial
2015-04-09 22:20:01 -04:00
Berker Peksag
b820d0defc
Issue #23286 : Fix typo in the tutorial.
...
Patch by Mayank Tripathi.
2015-01-27 02:52:40 +02:00
Berker Peksag
b68c420d8a
Issue #23286 : Fix typo in the tutorial.
...
Patch by Mayank Tripathi.
2015-01-27 02:52:14 +02:00
Serhiy Storchaka
d3faf43f9b
Issue #23181 : More "codepoint" -> "code point".
2015-01-18 11:28:37 +02:00
Georg Brandl
3be472b5f7
Closes #23181 : codepoint -> code point
2015-01-14 08:26:30 +01:00
Berker Peksag
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
Berker Peksag
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
Berker Peksag
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
Berker Peksag
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
Raymond Hettinger
ffd842e1d6
Issue #22824 : Updated reprlib output format for sets to use set literals.
2014-11-09 22:30:36 -08:00
Georg Brandl
fe98180bce
merge with 3.4
2014-10-31 09:29:48 +01:00
Georg Brandl
f0d2ed73ac
minor grammar fixes (from docs@python.org)
2014-10-31 09:29:38 +01:00
Georg Brandl
6b4c847c4f
Doc: fix default role usage (except in unittest mock docs)
2014-10-30 22:26:26 +01:00
Georg Brandl
93a56cdc37
Doc: fix default role usage (except in unittest mock docs)
2014-10-30 22:25:41 +01:00
Georg Brandl
794e9bf1fe
merge with 3.4
2014-10-29 10:27:06 +01:00
Georg Brandl
525d355984
Fixing broken links in doc, part 3: the rest
2014-10-29 10:26:56 +01:00
Georg Brandl
cadc3fdcb5
Merge with 3.4
2014-10-29 08:37:29 +01:00
Georg Brandl
e73778c1ac
Use https:// URLs when referring to python.org hosts.
2014-10-29 08:36:35 +01:00
R David Murray
bbf4ae51e4
Merge #21739 : mention subtle difference between loops and listcomps in tutorial.
2014-09-30 21:26:24 -04:00
R David Murray
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
Senthil Kumaran
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
Senthil Kumaran
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
Ezio Melotti
7d02a98f78
#22170 : merge with 3.4.
2014-08-08 17:24:06 +03:00
Ezio Melotti
79a1ffde9b
#22170 : avoid printing newlines twice in tutorial example.
2014-08-08 17:23:32 +03:00
Raymond Hettinger
c03dc0f164
merge
2014-06-24 13:03:54 -07:00
Raymond Hettinger
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
Raymond Hettinger
07e048519b
Issue 21575: Show list.sort() arguments in the tutorial.
2014-05-26 18:44:04 -07:00
Terry Jan Reedy
a52ecc0a02
Merge with 3.4
2014-05-23 00:34:38 -04:00
Terry Jan Reedy
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
Raymond Hettinger
53260eaa56
merge
2014-05-22 23:37:31 +01:00
Raymond Hettinger
bd46e48381
Issue 21554: Repair an out-of-date tutorial example to reflect changes in shutil.
2014-05-22 23:37:09 +01:00
R David Murray
fc1020d396
#20874 : reflow paragraph.
2014-04-15 20:26:54 -04:00
R David Murray
0e0e391fa3
#20874 : update tutorial wording: sophisticated line editing is now standard.
...
Patch by Rafael Mejia.
2014-04-15 20:25:18 -04:00
R David Murray
1b28088fd3
Merge #20874 fix.
2014-04-15 20:30:00 -04:00
Andrew Svetlov
d6ee27895a
Merge 3.4: Get rid of deprecated IOError in the doc
2014-04-01 01:14:27 +03:00
Andrew Svetlov
08af00047b
Get rid of deprecated IOError in the doc
2014-04-01 01:13:30 +03:00
Raymond Hettinger
9c5e98ff29
merge
2014-03-28 16:39:45 -07:00
Raymond Hettinger
4ab532bbfe
Issue 21014: Use booleans instead of 0 and 1 in examples.
2014-03-28 16:39:25 -07:00
Georg Brandl
60fa3533eb
merge with 3.4
2014-03-23 23:04:45 +01:00
Georg Brandl
553e108fce
tutorial: no "linux2" sys.platform on 3.x (thanks Arfrever)
2014-03-23 23:03:59 +01:00
Georg Brandl
3fa7ea1348
merge with 3.4
2014-03-22 20:39:08 +01:00
Georg Brandl
75c5ab49ed
Closes #20975 : make date in the interpreter banner a little more consistent
2014-03-22 20:38:11 +01:00
Larry Hastings
f5002bd6ac
Version bump to 3.5, step 2.
2014-03-16 23:05:59 -07:00
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