Commit Graph

212 Commits

Author SHA1 Message Date
Georg Brandl e73778c1ac Use https:// URLs when referring to python.org hosts. 2014-10-29 08:36:35 +01:00
Georg Brandl 9205e9ebdc Closes #16155: fix a few errors in doctest output of the FAQ pages. 2014-10-06 17:51:09 +02:00
Georg Brandl 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
R David Murray 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
R David Murray 623ae29469 #10510: Fix bug in forward port of 2.7 distutils patch.
Pointed out by Arfrever.
2014-09-28 11:01:11 -04:00
Berker Peksag 9c1dba2758 Revert #22251 2014-09-28 00:00:58 +03:00
Berker Peksag 3749404ba5 Issue #22251: Fix ReST markup to avoid errors building docs. 2014-09-27 23:21:35 +03:00
Benjamin Peterson 6d46dff5b5 y2k compliance, lol (closes #22380) 2014-09-10 17:13:06 -04:00
Ned Deily 29020b155a Issue #22320: Fix broken link in the General Python FAQ.
Original patch by Josh Lynn.
2014-09-01 00:06:18 -07:00
Ezio Melotti 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
Ezio Melotti 898eb82696 #20135: move FAQ about mutable default arguments to the programming FAQs page. 2014-07-06 20:53:27 +03:00
Eric V. Smith 04d8a245f1 Fix faq example with division. 2014-04-14 07:52:53 -04:00
Eric V. Smith fc9a4d828e Fix text about int() with octal numbers. Closes #21212. 2014-04-14 07:41:52 -04:00
Ned Deily ecd9e8ac67 Remove references to the obsolete Mac Carbon modules in the GUI
section of the FAQ.
2014-04-12 09:32:04 -07:00
Zachary Ware 2f31b4b577 Fix typos in Doc/faq/extending. Found by cocoatomo on docs@. 2014-03-20 10:16:09 -05:00
Larry Hastings 3732ed2414 Merge in all documentation changes since branching 3.4.0rc1. 2014-03-15 21:13:56 -07:00
Benjamin Peterson ce8d153b02 merge 3.3 2014-01-25 13:27:53 -05:00
Benjamin Peterson 714d7ffd0d update sphinx url 2014-01-25 13:27:06 -05:00
Benjamin Peterson 039a02c64e linkify 2014-01-25 13:26:18 -05:00
Benjamin Peterson e4e7199c50 merge 3.3 2014-01-25 00:00:28 -05:00
Benjamin Peterson f580d5b6f7 update hosting faq 2014-01-24 23:59:57 -05:00
Zachary Ware 77007344d9 Issue #20266: Merge with 3.3 2014-01-17 09:00:36 -06:00
Zachary Ware 9fc0e9955d Issue #20266: Update parts of the Windows FAQ 2014-01-17 08:59:44 -06:00
Serhiy Storchaka f47036c130 Removed spaces before colons and semicolons. 2013-12-24 11:04:36 +02:00
Serhiy Storchaka 89e84e7523 Removed spaces before colons and semicolons. 2013-12-24 11:05:24 +02:00
Serhiy Storchaka 2a6145290b Removed spaces before commas and periods. 2013-12-23 18:21:57 +02:00
Serhiy Storchaka a4d170d985 Removed spaces before commas and periods. 2013-12-23 18:20:51 +02:00
R David Murray 18701160cc Merge: #18036: update .pyc FAQ entry in light of PEP 3147. 2013-12-13 12:30:29 -05:00
R David Murray d913d9d54e #18036: update .pyc FAQ entry in light of PEP 3147.
Initial patch by Phil Connell.
2013-12-13 12:29:29 -05:00
Benjamin Peterson 5143ce5a01 merge 3.3 (#19805) 2013-11-26 23:05:37 -06:00
Benjamin Peterson b152e177ef recommend OrderedDict for this FAQ (closes #19805) 2013-11-26 23:05:25 -06:00
Serhiy Storchaka 98b28fddd8 Issue #18758: Fixed and improved cross-references. 2013-10-13 23:12:09 +03:00
Serhiy Storchaka bfdcd436f0 Issue #18758: Fixed and improved cross-references. 2013-10-13 23:09:14 +03:00
Georg Brandl 42840f017d merge with 3.3 2013-10-12 18:15:21 +02:00
Georg Brandl d8ede4fddd Closes #13203: add a FAQ section about seemingly duplicate id()s. 2013-10-12 18:14:25 +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
R David Murray 2f72aed1b4 Merge: Tweak programming faq examples so that it (mostly) passes doctest. 2013-06-19 16:59:22 -04:00
R David Murray 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
Brett Cannon 4f422e3414 Issue #17177: Update the programming FAQ to use importlib 2013-06-14 22:49:00 -04:00
Ezio Melotti 7dc4c03344 #18126: merge with 3.3. 2013-06-09 01:05:16 +03:00
Ezio Melotti c1f5839412 #18126: update NumPy links in the documentation. Patch by Yury V. Zaytsev. 2013-06-09 01:04:21 +03:00
R David Murray 95ae99205e #17973: fix technical inaccuracy in faq entry (it now passes doctest). 2013-05-21 11:44:41 -04:00
R David Murray 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
R David Murray b3a579223e merge #17973: fix technical inaccuracy in faq entry (it now passes doctest). 2013-05-21 11:45:09 -04:00
R David Murray 63f72908a1 Merge #17973: Add FAQ entry for ([],)[0] += [1] both extending and raising. 2013-05-20 10:33:27 -04:00
Georg Brandl 9def20566a merge with 3.3 2013-04-14 10:31:24 +02:00
Georg Brandl 7b8c1324d7 Closes #17726: small clarification in design FAQ. 2013-04-14 10:31:06 +02:00
Georg Brandl 1bab7134a8 Merge with 3.3. 2013-03-28 13:28:55 +01:00
Georg Brandl 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
Gregory P. Smith d4296fc19c cleanup references to PyString_ APIs in the 3.x docs. 2013-03-22 13:49:53 -07:00
Gregory P. Smith bcd2aa6d06 cleanup references to PyString_ APIs from 2.x in the 3.3 docs. 2013-03-22 13:49:26 -07:00
Gregory P. Smith 4b52ae8f97 Clean up references to the no longer existing PyString_ APIs in our docs. 2013-03-22 13:43:30 -07:00
Ezio Melotti a2f959169a #16862: merge with 3.3. 2013-01-05 07:38:52 +02:00
Ezio Melotti 9f6a239cf1 #16862: merge with 3.2. 2013-01-05 07:38:37 +02:00
Ezio Melotti 7449231eca #16862: remove outdated statements about Stackless. 2013-01-05 07:37:47 +02:00
Ezio Melotti 9beeefbb45 Cleanup a few minor things. 2013-01-05 07:36:54 +02:00
Ezio Melotti 0ae3525e85 Merge example fix with 3.3. 2013-01-05 06:54:38 +02:00
Ezio Melotti 87b83dd18c Merge example fix with 3.2. 2013-01-05 06:54:23 +02:00
Ezio Melotti 19cdee891e Fix example by making the exception inherit from Exception. 2013-01-05 06:53:27 +02:00
Ezio Melotti d05d3cc4eb #13094: merge with 3.3. 2013-01-05 00:51:40 +02:00
Ezio Melotti 7d48669085 #13094: merge with 3.2. 2013-01-05 00:51:20 +02:00
Ezio Melotti cad8b0ff8e #13094: add Programming FAQ entry about the behavior of closures. 2013-01-05 00:50:46 +02:00
Chris Jerdonek 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
Chris Jerdonek 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
Chris Jerdonek 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
Andrew Svetlov 8a045cb93b Add versionchanged tag to faq (useless btw because changed text is commented out) 2012-12-19 13:45:30 +02:00
Andrew Svetlov 5f11a00056 Mention OSError instead of IOError in the docs. 2012-12-18 23:16:44 +02:00
Brian Curtin 08133c2e8e Merge 3.2 2012-12-17 00:04:30 -06:00
Brian Curtin 655b0c462f Fix #14901. Update the Windows FAQ.
Patch by Ashish Nitin Patil.
2012-12-16 23:58:09 -06:00
Chris Jerdonek d97c71feda Merge from 3.2: improve argument/parameter documentation (issue #15990). 2012-11-28 02:37:42 -08:00
Chris Jerdonek 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
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
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 fe6e7e6b30 Merge the quotes/backslashes fixes with 3.2. 2012-09-20 09:47:41 +03:00
Ezio Melotti 694f2331c6 Fix a few quotes/backslashes. 2012-09-20 09:47:03 +03:00
Georg Brandl 3539afd5c9 Update pydoc topics and fix new suspicious markup. 2012-05-30 22:03:20 +02:00
Mark Dickinson a9d9d17f8b Issue #14245: Merge changes from 3.2. 2012-05-13 21:02:22 +01:00
Mark Dickinson 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
Ezio Melotti faedde3e1f #14770: merge with 3.2. 2012-05-13 20:17:40 +03:00
Ezio Melotti b35480e1d2 #14770: improve the library FAQ. 2012-05-13 20:14:04 +03:00
Antoine Pitrou b2eeced5ea Removed outdated statement about pickle's and marshal's relative performance. 2012-05-10 15:18:40 +02:00
Antoine Pitrou cc6c673a69 Removed outdated statement about pickle's and marshal's relative performance. 2012-05-10 15:18:20 +02:00
Georg Brandl 2ba1428911 merge with 3.2 2012-03-17 16:58:12 +01:00
Georg Brandl 12c3cd7c1f Closes #14306: clarify expensiveness of try-except and update code snippet 2012-03-17 16:58:05 +01:00
Georg Brandl 30162be9e4 merge with 3.2 2012-03-14 22:42:49 +01:00
Georg Brandl 300a691026 Closes #14305: fix typo. 2012-03-14 22:40:08 +01:00
Georg Brandl b20a019d46 Closes #14298: update section about dict implementation. 2012-03-14 07:50:17 +01:00
Éric Araujo a9d2b64206 Merge fixes for #13193 and FAQ from 3.2 2012-02-12 04:58:46 +01:00
Éric Araujo 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
Antoine Pitrou a9e9abb8ef Issue #13528: rework the performance question in the programming FAQ 2011-12-09 23:11:16 +01:00
Antoine Pitrou 432259feea Issue #13528: rework the performance question in the programming FAQ 2011-12-09 23:10:31 +01:00
Antoine Pitrou 6da394cfe7 Remove obsolete references to bsddb 2011-12-05 00:41:51 +01:00
Antoine Pitrou ae44b7a099 Remove obsolete references to bsddb 2011-12-05 00:41:19 +01:00
Antoine Pitrou 090d8132b5 Merge from 3.2 2011-12-03 23:10:12 +01:00
Antoine Pitrou dec0f21efc Streamline mention of sorted() 2011-12-03 23:08:57 +01:00
Antoine Pitrou c561a9adac Break down and refine memory management question 2011-12-03 23:06:50 +01:00
Antoine Pitrou 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