Skip to content

Commit 856f902

Browse files
committed
update
1 parent 58fe785 commit 856f902

File tree

428 files changed

+14421
-3927
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

428 files changed

+14421
-3927
lines changed

DOCS/_static/index.md

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
\_static
2+
========
3+
4+
<table><thead><tr class="header"><th></th><th>Name</th><th>Size</th><th>Modified</th><th></th></tr></thead><tbody><tr class="odd"><td></td><td><span class="goup">..</span></td><td>—</td><td>—</td><td></td></tr><tr class="even"><td></td><td><span class="name">basic.css</span></td><td>11 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="odd"><td></td><td><span class="name">classic.css</span></td><td>4 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="even"><td></td><td><span class="name">copybutton.js</span></td><td>2 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="odd"><td></td><td><span class="name">default.css</span></td><td>28 bytes</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="even"><td></td><td><span class="name">doctools.js</span></td><td>9 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="odd"><td></td><td><span class="name">documentation_options.js</span></td><td>323 bytes</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="even"><td></td><td><span class="name">file.png</span></td><td>286 bytes</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="odd"><td></td><td><span class="name">jquery.js</span></td><td>161 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="even"><td></td><td><span class="name">language_data.js</span></td><td>11 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="odd"><td></td><td><span class="name">py.png</span></td><td>695 bytes</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="even"><td></td><td><span class="name">pydoctheme.css</span></td><td>2 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="odd"><td></td><td><span class="name">pygments.css</span></td><td>4 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="even"><td></td><td><span class="name">right.html</span></td><td>2 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="odd"><td></td><td><span class="name">right.md</span></td><td>1 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="even"><td></td><td><span class="name">sidebar.js</span></td><td>6 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="odd"><td></td><td><span class="name">switchers.js</span></td><td>6 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="even"><td></td><td><span class="name">underscore.js</span></td><td>17 KB</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr></tbody></table>

DOCS/index.md

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
DOCS
2+
====
3+
4+
<table><thead><tr class="header"><th></th><th>Name</th><th>Size</th><th>Modified</th><th></th></tr></thead><tbody><tr class="odd"><td></td><td><span class="goup">..</span></td><td>—</td><td>—</td><td></td></tr><tr class="even"><td></td><td><span class="name">_static</span></td><td>—</td><td>Mon Jul 26 22:37:18 2021</td><td></td></tr><tr class="odd"><td></td><td><span class="name">tutorial</span></td><td>—</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="even"><td></td><td><span class="name">right.html</span></td><td>890 bytes</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr><tr class="odd"><td></td><td><span class="name">right.md</span></td><td>123 bytes</td><td>Mon Jul 26 22:29:09 2021</td><td></td></tr></tbody></table>

DOCS/tutorial/appendix.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ <h3 id="navigation">Navigation</h3>
6363
<a href="https://docs.python.org/3/index.html">3.9.5 Documentation</a> »
6464
</li>
6565
<li><a href="index.html">The Python Tutorial</a> »</li>
66-
<li><div class="line-block"></div></li>
66+
<li></li>
6767
</ul>
6868
<p><span id="tut-appendix"></span></p>
6969
<h1 id="appendix">
@@ -376,7 +376,7 @@ <h3 id="navigation-1">Navigation</h3>
376376
<a href="https://docs.python.org/3/index.html">3.9.5 Documentation</a> »
377377
</li>
378378
<li><a href="index.html">The Python Tutorial</a> »</li>
379-
<li><div class="line-block"></div></li>
379+
<li></li>
380380
</ul>
381381
<p>
382382
©

DOCS/tutorial/appendix.md

+31-29
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,24 @@
11
### Navigation
22

3-
- [index](https://docs.python.org/3/genindex.html "General Index")
4-
- [modules](https://docs.python.org/3/py-modindex.html "Python Module Index") |
5-
- [next](https://docs.python.org/3/using/index.html "Python Setup and Usage") |
6-
- [previous](floatingpoint.html "15. Floating Point Arithmetic: Issues and Limitations") |
7-
- ![](../_static/py.png)
8-
- [Python](https://www.python.org/) »
9-
- [3.9.5 Documentation](https://docs.python.org/3/index.html) »
10-
- [The Python Tutorial](index.html) »
11-
-
3+
- [index](https://docs.python.org/3/genindex.html "General Index")
4+
- [modules](https://docs.python.org/3/py-modindex.html "Python Module Index") |
5+
- [next](https://docs.python.org/3/using/index.html "Python Setup and Usage") |
6+
- [previous](floatingpoint.html "15. Floating Point Arithmetic: Issues and Limitations") |
7+
- ![](../_static/py.png)
8+
- [Python](https://www.python.org/) »
9+
- [3.9.5 Documentation](https://docs.python.org/3/index.html) »
10+
- [The Python Tutorial](index.html) »
11+
-
1212

1313
<span id="tut-appendix"></span>
1414

15-
# <span class="section-number">16. </span>Appendix<a href="#appendix" class="headerlink" title="Permalink to this headline">¶</a>
15+
<span class="section-number">16. </span>Appendix<a href="#appendix" class="headerlink" title="Permalink to this headline">¶</a>
16+
===============================================================================================================================
1617

1718
<span id="tut-interac"></span>
1819

19-
## <span class="section-number">16.1. </span>Interactive Mode<a href="#interactive-mode" class="headerlink" title="Permalink to this headline">¶</a>
20+
<span class="section-number">16.1. </span>Interactive Mode<a href="#interactive-mode" class="headerlink" title="Permalink to this headline">¶</a>
21+
-------------------------------------------------------------------------------------------------------------------------------------------------
2022

2123
<span id="tut-error"></span>
2224

@@ -50,7 +52,7 @@ When you use Python interactively, it is frequently handy to have some standard
5052

5153
This file is only read in interactive sessions, not when Python reads commands from a script, and not when `/dev/tty` is given as the explicit source of commands (which otherwise behaves like an interactive session). It is executed in the same namespace where interactive commands are executed, so that objects that it defines or imports can be used without qualification in the interactive session. You can also change the prompts `sys.ps1` and `sys.ps2` in this file.
5254

53-
If you want to read an additional start-up file from the current directory, you can program this in the global start-up file using code like `if os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())`. If you want to use the startup file in a script, you must do this explicitly in the script:
55+
If you want to read an additional start-up file from the current directory, you can program this in the global start-up file using code like `if os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())`. If you want to use the startup file in a script, you must do this explicitly in the script:
5456

5557
import os
5658
filename = os.environ.get('PYTHONSTARTUP')
@@ -80,12 +82,12 @@ A problem with the GNU Readline package may prevent this.
8082

8183
### [Table of Contents](https://docs.python.org/3/contents.html)
8284

83-
- <a href="#" class="reference internal">16. Appendix</a>
84-
- <a href="#interactive-mode" class="reference internal">16.1. Interactive Mode</a>
85-
- <a href="#error-handling" class="reference internal">16.1.1. Error Handling</a>
86-
- <a href="#executable-python-scripts" class="reference internal">16.1.2. Executable Python Scripts</a>
87-
- <a href="#the-interactive-startup-file" class="reference internal">16.1.3. The Interactive Startup File</a>
88-
- <a href="#the-customization-modules" class="reference internal">16.1.4. The Customization Modules</a>
85+
- <a href="#" class="reference internal">16. Appendix</a>
86+
- <a href="#interactive-mode" class="reference internal">16.1. Interactive Mode</a>
87+
- <a href="#error-handling" class="reference internal">16.1.1. Error Handling</a>
88+
- <a href="#executable-python-scripts" class="reference internal">16.1.2. Executable Python Scripts</a>
89+
- <a href="#the-interactive-startup-file" class="reference internal">16.1.3. The Interactive Startup File</a>
90+
- <a href="#the-customization-modules" class="reference internal">16.1.4. The Customization Modules</a>
8991

9092
#### Previous topic
9193

@@ -97,20 +99,20 @@ A problem with the GNU Readline package may prevent this.
9799

98100
### This Page
99101

100-
- [Report a Bug](https://docs.python.org/3/bugs.html)
101-
- [Show Source](https://github.com/python/cpython/blob/3.9/Doc/tutorial/appendix.rst)
102+
- [Report a Bug](https://docs.python.org/3/bugs.html)
103+
- [Show Source](https://github.com/python/cpython/blob/3.9/Doc/tutorial/appendix.rst)
102104

103105
### Navigation
104106

105-
- [index](https://docs.python.org/3/genindex.html "General Index")
106-
- [modules](https://docs.python.org/3/py-modindex.html "Python Module Index") |
107-
- [next](https://docs.python.org/3/using/index.html "Python Setup and Usage") |
108-
- [previous](floatingpoint.html "15. Floating Point Arithmetic: Issues and Limitations") |
109-
- ![](../_static/py.png)
110-
- [Python](https://www.python.org/) »
111-
- [3.9.5 Documentation](https://docs.python.org/3/index.html) »
112-
- [The Python Tutorial](index.html) »
113-
-
107+
- [index](https://docs.python.org/3/genindex.html "General Index")
108+
- [modules](https://docs.python.org/3/py-modindex.html "Python Module Index") |
109+
- [next](https://docs.python.org/3/using/index.html "Python Setup and Usage") |
110+
- [previous](floatingpoint.html "15. Floating Point Arithmetic: Issues and Limitations") |
111+
- ![](../_static/py.png)
112+
- [Python](https://www.python.org/) »
113+
- [3.9.5 Documentation](https://docs.python.org/3/index.html) »
114+
- [The Python Tutorial](index.html) »
115+
-
114116

115117
© [Copyright](https://docs.python.org/3/copyright.html) 2001-2021, Python Software Foundation.
116118
The Python Software Foundation is a non-profit corporation. [Please donate.](https://www.python.org/psf/donations/)

DOCS/tutorial/appetite.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ <h3 id="navigation">Navigation</h3>
5454
<a href="https://docs.python.org/3/index.html">3.9.5 Documentation</a> »
5555
</li>
5656
<li><a href="index.html">The Python Tutorial</a> »</li>
57-
<li><div class="line-block"></div></li>
57+
<li></li>
5858
</ul>
5959
<p><span id="tut-intro"></span></p>
6060
<h1 id="whetting-your-appetite">
@@ -214,7 +214,7 @@ <h3 id="navigation-1">Navigation</h3>
214214
<a href="https://docs.python.org/3/index.html">3.9.5 Documentation</a> »
215215
</li>
216216
<li><a href="index.html">The Python Tutorial</a> »</li>
217-
<li><div class="line-block"></div></li>
217+
<li></li>
218218
</ul>
219219
<p>
220220
©

DOCS/tutorial/appetite.md

+27-26
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,19 @@
11
### Navigation
22

3-
- [index](https://docs.python.org/3/genindex.html "General Index")
4-
- [modules](https://docs.python.org/3/py-modindex.html "Python Module Index") |
5-
- [next](interpreter.html "2. Using the Python Interpreter") |
6-
- [previous](index.html "The Python Tutorial") |
7-
- ![](../_static/py.png)
8-
- [Python](https://www.python.org/) »
9-
- [3.9.5 Documentation](https://docs.python.org/3/index.html) »
10-
- [The Python Tutorial](index.html) »
11-
-
3+
- [index](https://docs.python.org/3/genindex.html "General Index")
4+
- [modules](https://docs.python.org/3/py-modindex.html "Python Module Index") |
5+
- [next](interpreter.html "2. Using the Python Interpreter") |
6+
- [previous](index.html "The Python Tutorial") |
7+
- ![](../_static/py.png)
8+
- [Python](https://www.python.org/) »
9+
- [3.9.5 Documentation](https://docs.python.org/3/index.html) »
10+
- [The Python Tutorial](index.html) »
11+
-
1212

1313
<span id="tut-intro"></span>
1414

15-
# <span class="section-number">1. </span>Whetting Your Appetite<a href="#whetting-your-appetite" class="headerlink" title="Permalink to this headline">¶</a>
15+
<span class="section-number">1. </span>Whetting Your Appetite<a href="#whetting-your-appetite" class="headerlink" title="Permalink to this headline">¶</a>
16+
==========================================================================================================================================================
1617

1718
If you do much work on computers, eventually you find that there’s some task you’d like to automate. For example, you may wish to perform a search-and-replace over a large number of text files, or rename and rearrange a bunch of photo files in a complicated way. Perhaps you’d like to write a small custom database, or a specialized GUI application, or a simple game.
1819

@@ -22,21 +23,21 @@ Python is just the language for you.
2223

2324
You could write a Unix shell script or Windows batch files for some of these tasks, but shell scripts are best at moving around files and changing text data, not well-suited for GUI applications or games. You could write a C/C++/Java program, but it can take a lot of development time to get even a first-draft program. Python is simpler to use, available on Windows, Mac OS X, and Unix operating systems, and will help you get the job done more quickly.
2425

25-
Python is simple to use, but it is a real programming language, offering much more structure and support for large programs than shell scripts or batch files can offer. On the other hand, Python also offers much more error checking than C, and, being a _very-high-level language_, it has high-level data types built in, such as flexible arrays and dictionaries. Because of its more general data types Python is applicable to a much larger problem domain than Awk or even Perl, yet many things are at least as easy in Python as in those languages.
26+
Python is simple to use, but it is a real programming language, offering much more structure and support for large programs than shell scripts or batch files can offer. On the other hand, Python also offers much more error checking than C, and, being a *very-high-level language*, it has high-level data types built in, such as flexible arrays and dictionaries. Because of its more general data types Python is applicable to a much larger problem domain than Awk or even Perl, yet many things are at least as easy in Python as in those languages.
2627

2728
Python allows you to split your program into modules that can be reused in other Python programs. It comes with a large collection of standard modules that you can use as the basis of your programs — or as examples to start learning to program in Python. Some of these modules provide things like file I/O, system calls, sockets, and even interfaces to graphical user interface toolkits like Tk.
2829

2930
Python is an interpreted language, which can save you considerable time during program development because no compilation and linking is necessary. The interpreter can be used interactively, which makes it easy to experiment with features of the language, to write throw-away programs, or to test functions during bottom-up program development. It is also a handy desk calculator.
3031

3132
Python enables programs to be written compactly and readably. Programs written in Python are typically much shorter than equivalent C, C++, or Java programs, for several reasons:
3233

33-
- the high-level data types allow you to express complex operations in a single statement;
34+
- the high-level data types allow you to express complex operations in a single statement;
3435

35-
- statement grouping is done by indentation instead of beginning and ending brackets;
36+
- statement grouping is done by indentation instead of beginning and ending brackets;
3637

37-
- no variable or argument declarations are necessary.
38+
- no variable or argument declarations are necessary.
3839

39-
Python is _extensible_: if you know how to program in C it is easy to add a new built-in function or module to the interpreter, either to perform critical operations at maximum speed, or to link Python programs to libraries that may only be available in binary form (such as a vendor-specific graphics library). Once you are really hooked, you can link the Python interpreter into an application written in C and use it as an extension or command language for that application.
40+
Python is *extensible*: if you know how to program in C it is easy to add a new built-in function or module to the interpreter, either to perform critical operations at maximum speed, or to link Python programs to libraries that may only be available in binary form (such as a vendor-specific graphics library). Once you are really hooked, you can link the Python interpreter into an application written in C and use it as an extension or command language for that application.
4041

4142
By the way, the language is named after the BBC show “Monty Python’s Flying Circus” and has nothing to do with reptiles. Making references to Monty Python skits in documentation is not only allowed, it is encouraged!
4243

@@ -56,20 +57,20 @@ The rest of the tutorial introduces various features of the Python language and
5657

5758
### This Page
5859

59-
- [Report a Bug](https://docs.python.org/3/bugs.html)
60-
- [Show Source](https://github.com/python/cpython/blob/3.9/Doc/tutorial/appetite.rst)
60+
- [Report a Bug](https://docs.python.org/3/bugs.html)
61+
- [Show Source](https://github.com/python/cpython/blob/3.9/Doc/tutorial/appetite.rst)
6162

6263
### Navigation
6364

64-
- [index](https://docs.python.org/3/genindex.html "General Index")
65-
- [modules](https://docs.python.org/3/py-modindex.html "Python Module Index") |
66-
- [next](interpreter.html "2. Using the Python Interpreter") |
67-
- [previous](index.html "The Python Tutorial") |
68-
- ![](../_static/py.png)
69-
- [Python](https://www.python.org/) »
70-
- [3.9.5 Documentation](https://docs.python.org/3/index.html) »
71-
- [The Python Tutorial](index.html) »
72-
-
65+
- [index](https://docs.python.org/3/genindex.html "General Index")
66+
- [modules](https://docs.python.org/3/py-modindex.html "Python Module Index") |
67+
- [next](interpreter.html "2. Using the Python Interpreter") |
68+
- [previous](index.html "The Python Tutorial") |
69+
- ![](../_static/py.png)
70+
- [Python](https://www.python.org/) »
71+
- [3.9.5 Documentation](https://docs.python.org/3/index.html) »
72+
- [The Python Tutorial](index.html) »
73+
-
7374

7475
© [Copyright](https://docs.python.org/3/copyright.html) 2001-2021, Python Software Foundation.
7576
The Python Software Foundation is a non-profit corporation. [Please donate.](https://www.python.org/psf/donations/)

0 commit comments

Comments
 (0)