docs August 2010

docs@python.org

21 participants
214 discussions

[issue1398781] Example in section 5.3 "Pure Embedding" doesn't work.
by Mark Lawrence 26 Aug '10

26 Aug '10

Changes by Mark Lawrence <breamoreboy(a)yahoo.co.uk>: ---------- assignee: georg.brandl -> docs@python nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1398781> _______________________________________

1 0

[issue1397474] timeit execution enviroment
by Mark Lawrence 26 Aug '10

26 Aug '10

Changes by Mark Lawrence <breamoreboy(a)yahoo.co.uk>: ---------- assignee: -> docs@python nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1397474> _______________________________________

1 0

[issue9681] small typo in online documentation
by Georg Brandl 26 Aug '10

26 Aug '10

Georg Brandl <georg(a)python.org> added the comment: Fixed in r84327. ---------- nosy: +georg.brandl resolution: -> fixed status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9681> _______________________________________

1 0

[issue9689] threading.Timer poorly documented
by Georg Brandl 26 Aug '10

26 Aug '10

Georg Brandl <georg(a)python.org> added the comment: Fixed in r84326. ---------- nosy: +georg.brandl resolution: -> fixed status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9689> _______________________________________

1 0

[issue9689] threading.Timer poorly documented
by R. David Murray 26 Aug '10

26 Aug '10

Changes by R. David Murray <rdmurray(a)bitdance.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python type: feature request -> behavior versions: +Python 3.1, Python 3.2 -Python 2.5, Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9689> _______________________________________

1 0

Documentation Search Hard to Use
by Jason Kotenko 26 Aug '10

26 Aug '10

Hi, I have an improvement suggestion, which you may or may not agree with. I personally find the search function on the docs.python.org site to pretty difficult to use effectively. If you do a search, it appears that you get results first from method/class/package/etc names, ordered lexicographically, then you get a section of fulltext search results, also ordered lexicographically, then finally a section of fulltext results from various HowTo's and FAQs. There is no indication of the change between these sections, this is just from observation. My issue is that I have no way of picking out which results are the most relevant. If I use a search term like xml for instance, I first get every keyword result from the names of things like classes/packages/methods, which is a lot of things. Even down in the fulltext results, I have no indication of relevance, everything is ordered by lexicography, which means that items in Chapter 1 come first, then Chapter 10-19, then Chapter 2, then Chapter 20-29, ... , and on and on. Same with the FAQ/HowTo results. I'm wondering if there is a reason for using results such as these and not a more typical relevance based search? In fact you could still list the names of things at the top, put a divider, and do relevance on the fulltext entries, if you still want the name based things. I have a Xapian powered search on a site I manage that does it quite capably and with lightning speed. As it stands now, I use the index to find things if I know what they are called, and otherwise have to open a new tab and use Google. However, if I'm looking for docs just on Python 3.x for instance, the query "xml site:docs.python.org/py3k" yields only one result (I wonder, is robots.txt set up to not index it?). So that means I'm more likely to do "xml site:docs.python.org" and then click the link and change the path to say "py3k" after the domain. I know you guys probably have a lot to do - is there any way I can assist in this area? Thanks, Jason

1 0

Something to be added to cgi module doc
by Serguei G. Poltorak 25 Aug '10

25 Aug '10

Dear python documentation maintainer, I would like to submit a small text to the cgi module documentation to help other users use this module with BaseHTTPServer.HTTPServer. The current documentation (http://docs.python.org/library/cgi.html) shortly describes the usage of this module as a CGI under Apache. It does not covers at all the usage of cgi with BaseHTTPServer module. I've passed about an hour reading cgi.py sources to make it work, so I would like to share my knowledge with others. Be so kind to include (mangled by you) the following text: --------------------------------- Running with no parameters FieldStorage will read sys.stdin and use os.environ as environment variable. To use this module with BaseHTTPServer you must initialize FieldStorage with the rfile coming from WebHandler, pass headers as is and construct your ow environ to inform FieldStorage about the method used and the query string. Example for do_POST() function: form = cgi.FieldStorage(fp=self.rfile, headers=self.headers.dict, environ={"REQUEST_METHOD": "POST", "QUERY_STRING": self.path}) See "print cgi.FieldStorage.__doc__" for more information on FieldStorage() parameters. To upload files use enctype="multipart/form-data" . For example: <form method="post" action="/my/url/to/python/script" enctype="multipart/form-data"> <input type="file" name="filename"/> <input type="hidden" name="additional params" value="123"/> <input type="submit"/> </form> --------------------------------- Thank you for your great work! Sincerely yours, Poltorak Sergeui

1 0

[issue9681] small typo in online documentation
by R. David Murray 25 Aug '10

25 Aug '10

Changes by R. David Murray <rdmurray(a)bitdance.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python type: -> behavior _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9681> _______________________________________

1 0

[issue4966] Improving Lib Doc Sequence Types Section
by Terry J. Reedy 25 Aug '10

25 Aug '10

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: Please go ahead. I will gladly review anything you do. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue4966> _______________________________________

1 0

[issue9254] __import__ docstring should recommend importlib.import_module()
by Éric Araujo 25 Aug '10

25 Aug '10

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- versions: +Python 2.7, Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9254> _______________________________________

1 0

← Newer
1
...
6
7
8
9
10
11
12
...
22
Older →

Jump to page:

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

docs August 2010