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
fcb6db50d3
merge from 3.4
...
Issue25917 : Fix howto links in docs. Point the reference documentation instead of wiki.
2016-01-01 23:26:53 -08:00
d03d1d45f5
Issue25917 : Fix howto links in docs. Point the reference documentation instead of wiki.
2016-01-01 23:25:58 -08:00
762d5ea875
Issue #12484 : Remove a mention of Py_InitModule() and _PyImport_FixupExtension().
...
Thanks to Alejandro Santos for the bug report and Anish Shah for the
patch.
2015-12-27 12:24:06 -08: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
b395188088
actually link to the version attributes documentation
2015-10-11 23:03:22 -07:00
0071b3dfcb
don't mention Python 2.2 ( closes #25375 )
2015-10-10 23:23:55 -07:00
0424eaf753
Marked keystrokes with the :kbd: role.
...
Fixed the case of the "Ctrl-" prefixes.
2015-09-12 17:45:25 +03:00
7f02d6d0d9
Issue #23406 : Clarify documentation on multiplying a sequence
...
Patch from Matheus Vieira Portela.
2015-09-07 02:08:55 +00:00
bd4dd54737
Issue #23589 : Remove duplicate sentence from the FAQ. Patch by Yongzhi Pan.
2015-07-30 06:14:32 +12:00
03863d2b29
Fixed documentation of functions with const char* arguments.
2015-06-21 17:11:21 +03:00
72c24002b3
Issue 24304: Fix broken license link in FAQ.
2015-05-27 15:37:00 -07:00
d986563a06
Issue #22155 : Add File Handlers subsection with createfilehandler to tkinter
...
doc. Remove obsolete example from FAQ. Patch by Martin Panter.
2015-05-17 14:49:26 -04: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
b7354a65ce
Fixing broken links in doc, part 4: some more breaks and redirects
2014-10-29 10:57:37 +01:00
77fe77d4af
Fixing broken links in doc, part 1: faq/
2014-10-29 09:24:54 +01:00
5e722f698e
Remove now-dead link to IDLE debugger doc and add PyCharm to the commercial IDEs.
2014-10-29 08:55:14 +01:00
485922ea1f
Update "where is python.org hosted" FAQ.
2014-10-29 08:52:43 +01:00
e73778c1ac
Use https:// URLs when referring to python.org hosts.
2014-10-29 08:36:35 +01:00
9205e9ebdc
Closes #16155 : fix a few errors in doctest output of the FAQ pages.
2014-10-06 17:51:09 +02:00
a94ad1e508
Closes #10031 : overhaul the "imports" section of the programming FAQ.
...
Remove the advice to never use relative imports; it is a leftover from 2.x implicit relative imports.
Remove the advice to locally import modules in __init__, it is a strange practice.
Remove the advice to use "from ... import *" with some modules.
2014-10-06 16:02:09 +02:00
12dc0d96e0
#20135 : FAQ entry for list mutation. (See also 6375bf34fff6.)
...
I accidentally committed this in 6375bf34fff6; this changeset addresses the
last review comments on the patch.
This is a perennial question and something someone opens a ticket for probably
every other month or so, so I'm surprised we didn't already have a FAQ entry
for it.
The original patch was written by M. Votz, refined first by Ezio Melotti and
further refined by me.
2014-09-29 10:17:28 -04:00
623ae29469
#10510 : Fix bug in forward port of 2.7 distutils patch.
...
Pointed out by Arfrever.
2014-09-28 11:01:11 -04:00
9c1dba2758
Revert #22251
2014-09-28 00:00:58 +03:00
3749404ba5
Issue #22251 : Fix ReST markup to avoid errors building docs.
2014-09-27 23:21:35 +03:00
6d46dff5b5
y2k compliance, lol ( closes #22380 )
2014-09-10 17:13:06 -04:00
29020b155a
Issue #22320 : Fix broken link in the General Python FAQ.
...
Original patch by Josh Lynn.
2014-09-01 00:06:18 -07:00
e4aad5ab32
#18034 : update FAQ to suggest importlib.import_module instead of __import__. Patch by Wouter van Heyst.
2014-08-04 19:34:29 +03:00
898eb82696
#20135 : move FAQ about mutable default arguments to the programming FAQs page.
2014-07-06 20:53:27 +03:00
04d8a245f1
Fix faq example with division.
2014-04-14 07:52:53 -04:00
fc9a4d828e
Fix text about int() with octal numbers. Closes #21212 .
2014-04-14 07:41:52 -04:00
ecd9e8ac67
Remove references to the obsolete Mac Carbon modules in the GUI
...
section of the FAQ.
2014-04-12 09:32:04 -07:00
2f31b4b577
Fix typos in Doc/faq/extending. Found by cocoatomo on docs@.
2014-03-20 10:16:09 -05:00
3732ed2414
Merge in all documentation changes since branching 3.4.0rc1.
2014-03-15 21:13:56 -07:00
ce8d153b02
merge 3.3
2014-01-25 13:27:53 -05:00
714d7ffd0d
update sphinx url
2014-01-25 13:27:06 -05:00
039a02c64e
linkify
2014-01-25 13:26:18 -05:00
e4e7199c50
merge 3.3
2014-01-25 00:00:28 -05:00
f580d5b6f7
update hosting faq
2014-01-24 23:59:57 -05:00
77007344d9
Issue #20266 : Merge with 3.3
2014-01-17 09:00:36 -06:00
9fc0e9955d
Issue #20266 : Update parts of the Windows FAQ
2014-01-17 08:59:44 -06:00
f47036c130
Removed spaces before colons and semicolons.
2013-12-24 11:04:36 +02:00
89e84e7523
Removed spaces before colons and semicolons.
2013-12-24 11:05:24 +02:00
2a6145290b
Removed spaces before commas and periods.
2013-12-23 18:21:57 +02:00
a4d170d985
Removed spaces before commas and periods.
2013-12-23 18:20:51 +02:00
18701160cc
Merge: #18036 : update .pyc FAQ entry in light of PEP 3147.
2013-12-13 12:30:29 -05:00
d913d9d54e
#18036 : update .pyc FAQ entry in light of PEP 3147.
...
Initial patch by Phil Connell.
2013-12-13 12:29:29 -05:00
5143ce5a01
merge 3.3 ( #19805 )
2013-11-26 23:05:37 -06:00
b152e177ef
recommend OrderedDict for this FAQ ( closes #19805 )
2013-11-26 23:05:25 -06:00
98b28fddd8
Issue #18758 : Fixed and improved cross-references.
2013-10-13 23:12:09 +03:00
bfdcd436f0
Issue #18758 : Fixed and improved cross-references.
2013-10-13 23:09:14 +03:00
42840f017d
merge with 3.3
2013-10-12 18:15:21 +02:00
d8ede4fddd
Closes #13203 : add a FAQ section about seemingly duplicate id()s.
2013-10-12 18:14:25 +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
2f72aed1b4
Merge: Tweak programming faq examples so that it (mostly) passes doctest.
2013-06-19 16:59:22 -04:00
fdf9503038
Tweak programming faq examples so that it (mostly) passes doctest.
...
The exception is the import related questions at the end, which
need to be rewritten anyway.
2013-06-19 16:58:26 -04:00
4f422e3414
Issue #17177 : Update the programming FAQ to use importlib
2013-06-14 22:49:00 -04:00
7dc4c03344
#18126 : merge with 3.3.
2013-06-09 01:05:16 +03:00
c1f5839412
#18126 : update NumPy links in the documentation. Patch by Yury V. Zaytsev.
2013-06-09 01:04:21 +03:00
95ae99205e
#17973 : fix technical inaccuracy in faq entry (it now passes doctest).
2013-05-21 11:44:41 -04:00
bcf06d364d
#17973 : Add FAQ entry for ([],)[0] += [1] both extending and raising.
...
This has come up often enough now on the tracker that it deserves a FAQ entry.
2013-05-20 10:32:46 -04:00
b3a579223e
merge #17973 : fix technical inaccuracy in faq entry (it now passes doctest).
2013-05-21 11:45:09 -04:00
63f72908a1
Merge #17973 : Add FAQ entry for ([],)[0] += [1] both extending and raising.
2013-05-20 10:33:27 -04:00
9def20566a
merge with 3.3
2013-04-14 10:31:24 +02:00
7b8c1324d7
Closes #17726 : small clarification in design FAQ.
2013-04-14 10:31:06 +02:00
1bab7134a8
Merge with 3.3.
2013-03-28 13:28:55 +01:00
44ea77bd81
Closes #4159 : add LaTeX tabular column specifications to tables that otherwise are cut off or have overlapping text.
2013-03-28 13:28:44 +01:00
d4296fc19c
cleanup references to PyString_ APIs in the 3.x docs.
2013-03-22 13:49:53 -07:00
bcd2aa6d06
cleanup references to PyString_ APIs from 2.x in the 3.3 docs.
2013-03-22 13:49:26 -07:00
4b52ae8f97
Clean up references to the no longer existing PyString_ APIs in our docs.
2013-03-22 13:43:30 -07:00
a2f959169a
#16862 : merge with 3.3.
2013-01-05 07:38:52 +02:00
9f6a239cf1
#16862 : merge with 3.2.
2013-01-05 07:38:37 +02:00
7449231eca
#16862 : remove outdated statements about Stackless.
2013-01-05 07:37:47 +02:00
9beeefbb45
Cleanup a few minor things.
2013-01-05 07:36:54 +02:00
0ae3525e85
Merge example fix with 3.3.
2013-01-05 06:54:38 +02:00
87b83dd18c
Merge example fix with 3.2.
2013-01-05 06:54:23 +02:00
19cdee891e
Fix example by making the exception inherit from Exception.
2013-01-05 06:53:27 +02:00
d05d3cc4eb
#13094 : merge with 3.3.
2013-01-05 00:51:40 +02:00
7d48669085
#13094 : merge with 3.2.
2013-01-05 00:51:20 +02:00
cad8b0ff8e
#13094 : add Programming FAQ entry about the behavior of closures.
2013-01-05 00:50:46 +02:00
c475278a94
Merge from 3.3: add links and index entries for "argument" and "parameter."
...
This adds to the work done for issue #15990 (i.e. f44b8d69e5fc and the
commits referenced there).
2012-12-25 14:59:46 -08:00
32bbc1c396
Merge from 3.2: add links and index entries for "argument" and "parameter."
...
This adds to the work done for issue #15990 (i.e. f44b8d69e5fc and the
commits referenced there).
2012-12-25 14:57:54 -08:00
b43099464a
Add additional links and index entries for "argument" and "parameter".
...
This adds to the work done for issue #15990 (i.e. f44b8d69e5fc and the
commits referenced there).
2012-12-25 14:54:44 -08:00
8a045cb93b
Add versionchanged tag to faq (useless btw because changed text is commented out)
2012-12-19 13:45:30 +02:00
5f11a00056
Mention OSError instead of IOError in the docs.
2012-12-18 23:16:44 +02:00
08133c2e8e
Merge 3.2
2012-12-17 00:04:30 -06:00
655b0c462f
Fix #14901 . Update the Windows FAQ.
...
Patch by Ashish Nitin Patil.
2012-12-16 23:58:09 -06:00
d97c71feda
Merge from 3.2: improve argument/parameter documentation (issue #15990 ).
2012-11-28 02:37:42 -08:00
c2a7fd60e1
Improve argument/parameter documentation (issue #15990 ).
...
This commit adds "parameter" to the glossary, improves and consolidates the
"argument" glossary entry, and adds a question to the FAQ on the difference
between arguments and parameters.
2012-11-28 02:29:33 -08:00
fe08756743
Merge from 3.2: improve FAQ link in documentation (for issue #16435 ).
2012-11-09 17:53:14 -08:00
4ed4b1c7fe
Improve FAQ link in documentation (for issue #16435 ).
2012-11-09 17:52:30 -08:00
d285029ee8
Merge from 3.2: remove unneeded "Release" and "Date" markers from index pages.
2012-10-28 11:10:24 -07:00
8b7f9f581d
Remove unneeded "Release" and "Date" markers from doc index pages.
2012-10-28 11:08:26 -07:00
fe6e7e6b30
Merge the quotes/backslashes fixes with 3.2.
2012-09-20 09:47:41 +03:00
694f2331c6
Fix a few quotes/backslashes.
2012-09-20 09:47:03 +03:00
3539afd5c9
Update pydoc topics and fix new suspicious markup.
2012-05-30 22:03:20 +02:00
a9d9d17f8b
Issue #14245 : Merge changes from 3.2.
2012-05-13 21:02:22 +01:00
ba3b0d84bd
Issue #14245 : Improve floating-point entry in FAQ. Thanks Zbyszek Jędrzejewski-Szmek for some of the wording.
2012-05-13 21:00:35 +01:00
faedde3e1f
#14770 : merge with 3.2.
2012-05-13 20:17:40 +03:00
b35480e1d2
#14770 : improve the library FAQ.
2012-05-13 20:14:04 +03:00
b2eeced5ea
Removed outdated statement about pickle's and marshal's relative performance.
2012-05-10 15:18:40 +02:00
cc6c673a69
Removed outdated statement about pickle's and marshal's relative performance.
2012-05-10 15:18:20 +02:00
2ba1428911
merge with 3.2
2012-03-17 16:58:12 +01:00
12c3cd7c1f
Closes #14306 : clarify expensiveness of try-except and update code snippet
2012-03-17 16:58:05 +01:00
30162be9e4
merge with 3.2
2012-03-14 22:42:49 +01:00
300a691026
Closes #14305 : fix typo.
2012-03-14 22:40:08 +01:00
b20a019d46
Closes #14298 : update section about dict implementation.
2012-03-14 07:50:17 +01:00
a9d2b64206
Merge fixes for #13193 and FAQ from 3.2
2012-02-12 04:58:46 +01:00
01a2215727
Update mention of Subversion in the FAQ.
...
If I grepped correctly, this was the last outdated place.
2012-02-12 04:49:45 +01:00
a9e9abb8ef
Issue #13528 : rework the performance question in the programming FAQ
2011-12-09 23:11:16 +01:00
432259feea
Issue #13528 : rework the performance question in the programming FAQ
2011-12-09 23:10:31 +01:00
6da394cfe7
Remove obsolete references to bsddb
2011-12-05 00:41:51 +01:00
ae44b7a099
Remove obsolete references to bsddb
2011-12-05 00:41:19 +01:00
090d8132b5
Merge from 3.2
2011-12-03 23:10:12 +01:00
dec0f21efc
Streamline mention of sorted()
2011-12-03 23:08:57 +01:00
c561a9adac
Break down and refine memory management question
2011-12-03 23:06:50 +01:00
17bd792cd3
Reformulate answer, and remove off-topic discussion of bytecode in a question about compiling to C.
2011-12-03 22:56:02 +01:00
61fed9ccd3
Merge from 3.2
2011-12-03 22:40:23 +01:00
cc809a286a
Fix compatibility statement.
2011-12-03 22:39:13 +01:00
748799a0a6
Remove outdated question (the bsddb module isn't included anymore)
2011-12-03 22:37:14 +01:00
d4ddec5988
Refine FAQ entry for catching stdout
2011-12-03 22:35:31 +01:00
48383bfc67
Advocate PyTuple_Pack instead of manual building of tuples
2011-12-03 22:30:19 +01:00
b6032f55d2
Remove outdated FAQ content
2011-12-03 22:26:01 +01:00
f35204055e
Remove outdate FAQ content
2011-12-03 22:19:55 +01:00
3cb369dd0a
Streamline FAQ entry about the ternary operator, and suggest using io.StringIO for a mutable unicode container.
2011-12-03 22:11:45 +01:00
c5b266efb5
Streamline FAQ entry about the ternary operator, and suggest using io.StringIO for a mutable unicode container.
2011-12-03 22:11:11 +01:00
73080b8d18
Remove references to psyco, which is mostly unmaintained and doesn't work with Python 3.
2011-12-03 21:25:17 +01:00
9cb41dfbaa
Remove references to psyco, which is mostly unmaintained and doesn't work with Python 3.
2011-12-03 21:21:36 +01:00
7dc0047d53
Merge doc fixes from 3.2
2011-12-03 21:07:50 +01:00
7462e87134
Mention the new GTK+ 3 bindings.
2011-12-03 20:59:24 +01:00
e333d00d3a
Clarify concatenation behaviour of immutable strings, and remove explicit
...
mention of the CPython optimization hack.
2011-11-25 16:34:23 +01:00
fd9ebd4a36
Clarify concatenation behaviour of immutable strings, and remove explicit
...
mention of the CPython optimization hack.
2011-11-25 16:33:53 +01:00
9be57231dd
Update dead references from py.org/dev/faq to the devguide ( #13176 )
2011-10-14 17:37:45 +02:00
26358cc403
Remove obsolete FAQ.
2011-10-23 23:42:51 +03:00
ab7e2a4454
Merge 3.2
2011-10-14 17:38:10 +02:00
b8edbdf4b9
Merge doc changes from 3.2.
...
rstlint complains about packaging docs but I’m working on those in
another patch.
2011-09-01 05:57:12 +02:00
7af8ebb6ce
Adapt/remove mentions of functions gone in 3.x
2011-09-01 03:20:13 +02:00
37b5f9eebc
Fix some misuses of Sphinx roles and one typo
2011-09-01 03:19:30 +02:00
2bb371b2bf
Merge 3.2.
2011-08-25 11:52:39 +02:00
e1eef41a18
Close #12838 : fix range() call.
2011-08-25 11:52:26 +02:00
8ed41a8e5c
Replace links to the old dev doc with links to the new devguide.
2011-02-26 14:57:23 +00:00
7095721d3e
Mention asyncore and Twisted in the library FAQ.
2011-02-05 11:24:15 +00:00
11480b6fe3
Mention concurrent.futures and update answers about the GIL.
2011-02-05 11:18:34 +00:00
f7005243e5
Update test of "why is Python installed" FAQ.
2011-02-05 11:04:01 +00:00
09264b66f2
Mention Cython and remove obsolete alternatives
2011-02-05 10:57:17 +00:00
eb50ba5ab7
Update info in the GUI FAQ
2011-02-05 10:43:57 +00:00
4d0d471a80
Merge branches/pep-0384.
2010-12-03 20:14:31 +00:00
fc9794a8fc
Make file names consistent.
2010-10-17 10:15:50 +00:00
4985ff2e61
#9086 : correct wrong terminology about linking with pythonXY.dll.
2010-10-17 10:14:38 +00:00
Martin Panter
Senthil Kumaran
Brett Cannon
Benjamin Peterson
Serhiy Storchaka
Martin Panter
Robert Collins
Ned Deily
Terry Jan Reedy
Berker Peksag
Georg Brandl
R David Murray
Ezio Melotti
Eric V. Smith
Zachary Ware
Larry Hastings
Gregory P. Smith
Chris Jerdonek
Andrew Svetlov
Brian Curtin
Mark Dickinson
Antoine Pitrou
Éric Araujo
Martin v. Löwis