| 
									
										
										
										
											2008-05-03 20:52:18 +00:00
										 |  |  | {% extends "!layout.html" %} | 
					
						
							|  |  |  | {% block rootrellink %} | 
					
						
							| 
									
										
											  
											
												Merged revisions 67531-67532,67538,67553-67554,67556-67557,67571,67574-67575,67579-67580,67591,67597,67608,67631 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
  r67531 | georg.brandl | 2008-12-04 19:54:05 +0100 (Thu, 04 Dec 2008) | 2 lines
  Add reference to enumerate() to indices example.
........
  r67532 | georg.brandl | 2008-12-04 19:59:16 +0100 (Thu, 04 Dec 2008) | 2 lines
  Add another heapq example.
........
  r67538 | georg.brandl | 2008-12-04 22:28:16 +0100 (Thu, 04 Dec 2008) | 2 lines
  Clarification to avoid confusing output with file descriptors.
........
  r67553 | georg.brandl | 2008-12-05 08:49:49 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4408: document regex.groups.
........
  r67554 | georg.brandl | 2008-12-05 08:52:26 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4409: fix asterisks looking like footnotes.
........
  r67556 | georg.brandl | 2008-12-05 09:02:17 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4441: improve doc for os.open() flags.
........
  r67557 | georg.brandl | 2008-12-05 09:06:57 +0100 (Fri, 05 Dec 2008) | 2 lines
  Add an index entry for "subclassing immutable types".
........
  r67571 | georg.brandl | 2008-12-05 10:13:45 +0100 (Fri, 05 Dec 2008) | 2 lines
  Use markup.
........
  r67574 | georg.brandl | 2008-12-05 10:25:32 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4441 followup: Add link to open() docs for Windows.
........
  r67575 | georg.brandl | 2008-12-05 12:34:51 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4544: add `dedent` to textwrap.__all__.
........
  r67579 | georg.brandl | 2008-12-05 16:29:39 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4517: add "special method" glossary entry and clarify when __getattribute__ is bypassed.
........
  r67580 | georg.brandl | 2008-12-05 16:32:29 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4478: document that copyfile() can raise Error.
........
  r67591 | georg.brandl | 2008-12-05 19:00:06 +0100 (Fri, 05 Dec 2008) | 2 lines
  Followup to #4511: add link from decorator glossary entry to definition.
........
  r67597 | georg.brandl | 2008-12-05 20:03:19 +0100 (Fri, 05 Dec 2008) | 2 lines
  Remove confusing sentence part.
........
  r67608 | georg.brandl | 2008-12-06 12:57:12 +0100 (Sat, 06 Dec 2008) | 2 lines
  Follow-up to #4488: document PIPE and STDOUT properly.
........
  r67631 | georg.brandl | 2008-12-07 12:54:07 +0100 (Sun, 07 Dec 2008) | 2 lines
  Add link to the favicon to the docs.
........
											
										 
											2008-12-07 15:06:20 +00:00
										 |  |  |         <li><img src="{{ pathto('_static/py.png', 1) }}" alt="" | 
					
						
							|  |  |  |                  style="vertical-align: middle; margin-top: -1px"/></li> | 
					
						
							| 
									
										
										
										
											2014-10-29 08:36:15 +01:00
										 |  |  |         <li><a href="https://www.python.org/">Python</a>{{ reldelim1 }}</li> | 
					
						
							| 
									
										
										
										
											2012-10-27 22:09:16 +03:00
										 |  |  |         <li> | 
					
						
							| 
									
										
										
										
											2017-08-07 10:27:21 +02:00
										 |  |  |           {%- if switchers is defined %} | 
					
						
							|  |  |  |           <span class="language_switcher_placeholder">{{ language or 'en' }}</span> | 
					
						
							| 
									
										
										
										
											2012-10-27 22:09:16 +03:00
										 |  |  |           <span class="version_switcher_placeholder">{{ release }}</span> | 
					
						
							| 
									
										
										
										
											2016-01-22 18:00:05 +01:00
										 |  |  |           <a href="{{ pathto('index') }}">{% trans %}Documentation {% endtrans %}</a>{{ reldelim1 }} | 
					
						
							| 
									
										
										
										
											2012-10-27 22:09:16 +03:00
										 |  |  |           {%- else %} | 
					
						
							|  |  |  |           <a href="{{ pathto('index') }}">{{ shorttitle }}</a>{{ reldelim1 }} | 
					
						
							|  |  |  |           {%- endif %} | 
					
						
							|  |  |  |         </li> | 
					
						
							| 
									
										
											  
											
												Merged revisions 67531-67532,67538,67553-67554,67556-67557,67571,67574-67575,67579-67580,67591,67597,67608,67631 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
  r67531 | georg.brandl | 2008-12-04 19:54:05 +0100 (Thu, 04 Dec 2008) | 2 lines
  Add reference to enumerate() to indices example.
........
  r67532 | georg.brandl | 2008-12-04 19:59:16 +0100 (Thu, 04 Dec 2008) | 2 lines
  Add another heapq example.
........
  r67538 | georg.brandl | 2008-12-04 22:28:16 +0100 (Thu, 04 Dec 2008) | 2 lines
  Clarification to avoid confusing output with file descriptors.
........
  r67553 | georg.brandl | 2008-12-05 08:49:49 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4408: document regex.groups.
........
  r67554 | georg.brandl | 2008-12-05 08:52:26 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4409: fix asterisks looking like footnotes.
........
  r67556 | georg.brandl | 2008-12-05 09:02:17 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4441: improve doc for os.open() flags.
........
  r67557 | georg.brandl | 2008-12-05 09:06:57 +0100 (Fri, 05 Dec 2008) | 2 lines
  Add an index entry for "subclassing immutable types".
........
  r67571 | georg.brandl | 2008-12-05 10:13:45 +0100 (Fri, 05 Dec 2008) | 2 lines
  Use markup.
........
  r67574 | georg.brandl | 2008-12-05 10:25:32 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4441 followup: Add link to open() docs for Windows.
........
  r67575 | georg.brandl | 2008-12-05 12:34:51 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4544: add `dedent` to textwrap.__all__.
........
  r67579 | georg.brandl | 2008-12-05 16:29:39 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4517: add "special method" glossary entry and clarify when __getattribute__ is bypassed.
........
  r67580 | georg.brandl | 2008-12-05 16:32:29 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4478: document that copyfile() can raise Error.
........
  r67591 | georg.brandl | 2008-12-05 19:00:06 +0100 (Fri, 05 Dec 2008) | 2 lines
  Followup to #4511: add link from decorator glossary entry to definition.
........
  r67597 | georg.brandl | 2008-12-05 20:03:19 +0100 (Fri, 05 Dec 2008) | 2 lines
  Remove confusing sentence part.
........
  r67608 | georg.brandl | 2008-12-06 12:57:12 +0100 (Sat, 06 Dec 2008) | 2 lines
  Follow-up to #4488: document PIPE and STDOUT properly.
........
  r67631 | georg.brandl | 2008-12-07 12:54:07 +0100 (Sun, 07 Dec 2008) | 2 lines
  Add link to the favicon to the docs.
........
											
										 
											2008-12-07 15:06:20 +00:00
										 |  |  | {% endblock %} | 
					
						
							| 
									
										
										
										
											2016-09-09 13:11:27 -07:00
										 |  |  | {%- macro searchbox() %} | 
					
						
							|  |  |  | {# modified from sphinx/themes/basic/searchbox.html #} | 
					
						
							| 
									
										
										
										
											2016-09-22 17:07:56 -07:00
										 |  |  |     {%- if builder != "htmlhelp" %} | 
					
						
							| 
									
										
										
										
											2016-09-09 13:11:27 -07:00
										 |  |  |     <div class="inline-search" style="display: none" role="search"> | 
					
						
							|  |  |  |         <form class="inline-search" action="{{ pathto('search') }}" method="get"> | 
					
						
							|  |  |  |           <input placeholder="{{ _('Quick search') }}" type="text" name="q" /> | 
					
						
							|  |  |  |           <input type="submit" value="{{ _('Go') }}" /> | 
					
						
							|  |  |  |           <input type="hidden" name="check_keywords" value="yes" /> | 
					
						
							|  |  |  |           <input type="hidden" name="area" value="default" /> | 
					
						
							|  |  |  |         </form> | 
					
						
							|  |  |  |     </div> | 
					
						
							|  |  |  |     <script type="text/javascript">$('.inline-search').show(0);</script> | 
					
						
							| 
									
										
										
										
											2016-09-22 17:07:56 -07:00
										 |  |  |     {%- endif %} | 
					
						
							| 
									
										
										
										
											2016-09-09 13:11:27 -07:00
										 |  |  | {%- endmacro %} | 
					
						
							| 
									
										
										
										
											2014-03-25 10:12:47 +01:00
										 |  |  | {% block relbar1 %} {% if builder != 'qthelp' %} {{ relbar() }} {% endif %} {% endblock %} | 
					
						
							|  |  |  | {% block relbar2 %} {% if builder != 'qthelp' %} {{ relbar() }} {% endif %} {% endblock %} | 
					
						
							| 
									
										
										
										
											2016-09-09 13:11:27 -07:00
										 |  |  | {% block relbaritems %} | 
					
						
							| 
									
										
										
										
											2016-09-22 17:07:56 -07:00
										 |  |  |     {%- if pagename != "search" and builder != "singlehtml" and builder != "htmlhelp" %} | 
					
						
							| 
									
										
										
										
											2016-09-09 13:11:27 -07:00
										 |  |  |     <li class="right"> | 
					
						
							|  |  |  |         {{ searchbox() }} | 
					
						
							|  |  |  |         {{ reldelim2 }} | 
					
						
							|  |  |  |     </li> | 
					
						
							|  |  |  |     {%- endif %} | 
					
						
							|  |  |  | {% endblock %} | 
					
						
							| 
									
										
											  
											
												Merged revisions 67531-67532,67538,67553-67554,67556-67557,67571,67574-67575,67579-67580,67591,67597,67608,67631 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
  r67531 | georg.brandl | 2008-12-04 19:54:05 +0100 (Thu, 04 Dec 2008) | 2 lines
  Add reference to enumerate() to indices example.
........
  r67532 | georg.brandl | 2008-12-04 19:59:16 +0100 (Thu, 04 Dec 2008) | 2 lines
  Add another heapq example.
........
  r67538 | georg.brandl | 2008-12-04 22:28:16 +0100 (Thu, 04 Dec 2008) | 2 lines
  Clarification to avoid confusing output with file descriptors.
........
  r67553 | georg.brandl | 2008-12-05 08:49:49 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4408: document regex.groups.
........
  r67554 | georg.brandl | 2008-12-05 08:52:26 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4409: fix asterisks looking like footnotes.
........
  r67556 | georg.brandl | 2008-12-05 09:02:17 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4441: improve doc for os.open() flags.
........
  r67557 | georg.brandl | 2008-12-05 09:06:57 +0100 (Fri, 05 Dec 2008) | 2 lines
  Add an index entry for "subclassing immutable types".
........
  r67571 | georg.brandl | 2008-12-05 10:13:45 +0100 (Fri, 05 Dec 2008) | 2 lines
  Use markup.
........
  r67574 | georg.brandl | 2008-12-05 10:25:32 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4441 followup: Add link to open() docs for Windows.
........
  r67575 | georg.brandl | 2008-12-05 12:34:51 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4544: add `dedent` to textwrap.__all__.
........
  r67579 | georg.brandl | 2008-12-05 16:29:39 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4517: add "special method" glossary entry and clarify when __getattribute__ is bypassed.
........
  r67580 | georg.brandl | 2008-12-05 16:32:29 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4478: document that copyfile() can raise Error.
........
  r67591 | georg.brandl | 2008-12-05 19:00:06 +0100 (Fri, 05 Dec 2008) | 2 lines
  Followup to #4511: add link from decorator glossary entry to definition.
........
  r67597 | georg.brandl | 2008-12-05 20:03:19 +0100 (Fri, 05 Dec 2008) | 2 lines
  Remove confusing sentence part.
........
  r67608 | georg.brandl | 2008-12-06 12:57:12 +0100 (Sat, 06 Dec 2008) | 2 lines
  Follow-up to #4488: document PIPE and STDOUT properly.
........
  r67631 | georg.brandl | 2008-12-07 12:54:07 +0100 (Sun, 07 Dec 2008) | 2 lines
  Add link to the favicon to the docs.
........
											
										 
											2008-12-07 15:06:20 +00:00
										 |  |  | {% block extrahead %} | 
					
						
							|  |  |  |     <link rel="shortcut icon" type="image/png" href="{{ pathto('_static/py.png', 1) }}" /> | 
					
						
							| 
									
										
										
										
											2017-02-09 16:03:59 +01:00
										 |  |  |     <link rel="canonical" href="https://docs.python.org/3/{{pagename}}.html" /> | 
					
						
							| 
									
										
										
										
											2016-09-22 17:07:56 -07:00
										 |  |  |     {% if builder != "htmlhelp" %} | 
					
						
							| 
									
										
										
										
											2012-02-25 19:24:24 +02:00
										 |  |  |     {% if not embedded %}<script type="text/javascript" src="{{ pathto('_static/copybutton.js', 1) }}"></script>{% endif %} | 
					
						
							| 
									
										
										
										
											2017-08-07 10:27:21 +02:00
										 |  |  |     {% if switchers is defined and not embedded %}<script type="text/javascript" src="{{ pathto('_static/switchers.js', 1) }}"></script>{% endif %} | 
					
						
							| 
									
										
										
										
											2016-01-20 22:02:30 -08:00
										 |  |  |     {% if pagename == 'whatsnew/changelog' and not embedded %} | 
					
						
							| 
									
										
										
										
											2012-09-30 15:10:06 +02:00
										 |  |  |     <script type="text/javascript"> | 
					
						
							| 
									
										
										
										
											2012-10-02 01:43:42 +03:00
										 |  |  |       $(document).ready(function() { | 
					
						
							|  |  |  |           // add the search form and bind the events | 
					
						
							|  |  |  |           $('h1').after([ | 
					
						
							|  |  |  |             '<p>Filter entries by content:', | 
					
						
							|  |  |  |             '<input type="text" value="" id="searchbox" style="width: 50%">', | 
					
						
							|  |  |  |             '<input type="submit" id="searchbox-submit" value="Filter"></p>' | 
					
						
							|  |  |  |           ].join('\n')); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |           function dofilter() { | 
					
						
							|  |  |  |               try { | 
					
						
							|  |  |  |                   var query = new RegExp($('#searchbox').val(), 'i'); | 
					
						
							|  |  |  |               } | 
					
						
							|  |  |  |               catch (e) { | 
					
						
							|  |  |  |                   return; // not a valid regex (yet) | 
					
						
							|  |  |  |               } | 
					
						
							|  |  |  |               // find headers for the versions (What's new in Python X.Y.Z?) | 
					
						
							|  |  |  |               $('#changelog h2').each(function(index1, h2) { | 
					
						
							|  |  |  |                   var h2_parent = $(h2).parent(); | 
					
						
							|  |  |  |                   var sections_found = 0; | 
					
						
							|  |  |  |                   // find headers for the sections (Core, Library, etc.) | 
					
						
							|  |  |  |                   h2_parent.find('h3').each(function(index2, h3) { | 
					
						
							|  |  |  |                       var h3_parent = $(h3).parent(); | 
					
						
							|  |  |  |                       var entries_found = 0; | 
					
						
							|  |  |  |                       // find all the entries | 
					
						
							|  |  |  |                       h3_parent.find('li').each(function(index3, li) { | 
					
						
							|  |  |  |                           var li = $(li); | 
					
						
							|  |  |  |                           // check if the query matches the entry | 
					
						
							|  |  |  |                           if (query.test(li.text())) { | 
					
						
							|  |  |  |                               li.show(); | 
					
						
							|  |  |  |                               entries_found++; | 
					
						
							|  |  |  |                           } | 
					
						
							|  |  |  |                           else { | 
					
						
							|  |  |  |                               li.hide(); | 
					
						
							|  |  |  |                           } | 
					
						
							|  |  |  |                       }); | 
					
						
							|  |  |  |                       // if there are entries, show the section, otherwise hide it | 
					
						
							|  |  |  |                       if (entries_found > 0) { | 
					
						
							|  |  |  |                           h3_parent.show(); | 
					
						
							|  |  |  |                           sections_found++; | 
					
						
							|  |  |  |                       } | 
					
						
							|  |  |  |                       else { | 
					
						
							|  |  |  |                           h3_parent.hide(); | 
					
						
							|  |  |  |                       } | 
					
						
							|  |  |  |                   }); | 
					
						
							|  |  |  |                   if (sections_found > 0) | 
					
						
							|  |  |  |                       h2_parent.show(); | 
					
						
							|  |  |  |                   else | 
					
						
							|  |  |  |                       h2_parent.hide(); | 
					
						
							|  |  |  |               }); | 
					
						
							| 
									
										
										
										
											2012-09-30 15:10:06 +02:00
										 |  |  |           } | 
					
						
							| 
									
										
										
										
											2012-10-02 01:43:42 +03:00
										 |  |  |           $('#searchbox').keyup(dofilter); | 
					
						
							|  |  |  |           $('#searchbox-submit').click(dofilter); | 
					
						
							|  |  |  |       }); | 
					
						
							| 
									
										
										
										
											2012-09-30 15:10:06 +02:00
										 |  |  |     </script> | 
					
						
							|  |  |  |     {% endif %} | 
					
						
							| 
									
										
										
										
											2016-09-22 17:07:56 -07:00
										 |  |  |     {% endif %} | 
					
						
							| 
									
										
											  
											
												Merged revisions 67531-67532,67538,67553-67554,67556-67557,67571,67574-67575,67579-67580,67591,67597,67608,67631 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
  r67531 | georg.brandl | 2008-12-04 19:54:05 +0100 (Thu, 04 Dec 2008) | 2 lines
  Add reference to enumerate() to indices example.
........
  r67532 | georg.brandl | 2008-12-04 19:59:16 +0100 (Thu, 04 Dec 2008) | 2 lines
  Add another heapq example.
........
  r67538 | georg.brandl | 2008-12-04 22:28:16 +0100 (Thu, 04 Dec 2008) | 2 lines
  Clarification to avoid confusing output with file descriptors.
........
  r67553 | georg.brandl | 2008-12-05 08:49:49 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4408: document regex.groups.
........
  r67554 | georg.brandl | 2008-12-05 08:52:26 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4409: fix asterisks looking like footnotes.
........
  r67556 | georg.brandl | 2008-12-05 09:02:17 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4441: improve doc for os.open() flags.
........
  r67557 | georg.brandl | 2008-12-05 09:06:57 +0100 (Fri, 05 Dec 2008) | 2 lines
  Add an index entry for "subclassing immutable types".
........
  r67571 | georg.brandl | 2008-12-05 10:13:45 +0100 (Fri, 05 Dec 2008) | 2 lines
  Use markup.
........
  r67574 | georg.brandl | 2008-12-05 10:25:32 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4441 followup: Add link to open() docs for Windows.
........
  r67575 | georg.brandl | 2008-12-05 12:34:51 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4544: add `dedent` to textwrap.__all__.
........
  r67579 | georg.brandl | 2008-12-05 16:29:39 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4517: add "special method" glossary entry and clarify when __getattribute__ is bypassed.
........
  r67580 | georg.brandl | 2008-12-05 16:32:29 +0100 (Fri, 05 Dec 2008) | 2 lines
  #4478: document that copyfile() can raise Error.
........
  r67591 | georg.brandl | 2008-12-05 19:00:06 +0100 (Fri, 05 Dec 2008) | 2 lines
  Followup to #4511: add link from decorator glossary entry to definition.
........
  r67597 | georg.brandl | 2008-12-05 20:03:19 +0100 (Fri, 05 Dec 2008) | 2 lines
  Remove confusing sentence part.
........
  r67608 | georg.brandl | 2008-12-06 12:57:12 +0100 (Sat, 06 Dec 2008) | 2 lines
  Follow-up to #4488: document PIPE and STDOUT properly.
........
  r67631 | georg.brandl | 2008-12-07 12:54:07 +0100 (Sun, 07 Dec 2008) | 2 lines
  Add link to the favicon to the docs.
........
											
										 
											2008-12-07 15:06:20 +00:00
										 |  |  | {{ super() }} | 
					
						
							| 
									
										
										
										
											2008-05-03 20:52:18 +00:00
										 |  |  | {% endblock %} | 
					
						
							| 
									
										
										
										
											2009-08-04 20:25:54 +00:00
										 |  |  | {% block footer %} | 
					
						
							|  |  |  |     <div class="footer"> | 
					
						
							| 
									
										
										
										
											2016-01-22 18:00:05 +01:00
										 |  |  |     © <a href="{{ pathto('copyright') }}">{% trans %}Copyright{% endtrans %}</a> {{ copyright|e }}. | 
					
						
							| 
									
										
										
										
											2009-08-04 20:25:54 +00:00
										 |  |  |     <br /> | 
					
						
							| 
									
										
										
										
											2016-01-22 18:00:05 +01:00
										 |  |  |     {% trans %}The Python Software Foundation is a non-profit corporation.{% endtrans %} | 
					
						
							|  |  |  |     <a href="https://www.python.org/psf/donations/">{% trans %}Please donate.{% endtrans %}</a> | 
					
						
							| 
									
										
										
										
											2009-08-04 20:25:54 +00:00
										 |  |  |     <br /> | 
					
						
							| 
									
										
										
										
											2016-01-22 18:00:05 +01:00
										 |  |  |     {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %} | 
					
						
							|  |  |  |     {% trans pathto_bugs=pathto('bugs') %}<a href="{{ pathto_bugs }}">Found a bug</a>?{% endtrans %} | 
					
						
							| 
									
										
										
										
											2010-04-22 23:20:19 +00:00
										 |  |  |     <br /> | 
					
						
							| 
									
										
										
										
											2016-01-22 18:00:05 +01:00
										 |  |  |     {% trans sphinx_version=sphinx_version|e %}Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> {{ sphinx_version }}.{% endtrans %} | 
					
						
							| 
									
										
										
										
											2009-08-04 20:25:54 +00:00
										 |  |  |     </div> | 
					
						
							|  |  |  | {% endblock %} |