Skip to content

Commit 47ae5cb

Browse files
committed
update
1 parent b0e91de commit 47ae5cb

File tree

427 files changed

+22173
-12757
lines changed

Some content is hidden

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

427 files changed

+22173
-12757
lines changed

DOCS/_static/right.md

-2
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,6 @@
22

33
[<Go Back>](../right.html)
44

5-
6-
75
<table><thead><tr class="header"><th><strong>File</strong></th><th><strong>File</strong></th><th><strong>File</strong></th><th><strong>File</strong></th></tr></thead><tbody><tr class="odd"><td><a href="basic.css">basic.css</a> </td><td><a href="pygments.css">pygments.css</a> </td><td><a href="jquery.js">jquery.js</a> </td><td><a href="underscore.js">underscore.js</a> </td></tr><tr class="even"><td><a href="classic.css">classic.css</a> </td><td><a href="copybutton.js">copybutton.js</a> </td><td><a href="language_data.js">language_data.js</a> </td><td><a href="file.png">file.png</a> </td></tr><tr class="odd"><td><a href="default.css">default.css</a> </td><td><a href="doctools.js">doctools.js</a> </td><td><a href="sidebar.js">sidebar.js</a> </td><td><a href="py.png">py.png</a> </td></tr><tr class="even"><td><a href="pydoctheme.css">pydoctheme.css</a> </td><td><a href="documentation_options.js">documenta...ons.js</a> </td><td><a href="switchers.js">switchers.js</a> </td><td></td></tr></tbody></table>
86

97
Folders: 1

DOCS/right.md

+3-5
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,8 @@
22

33
[&lt;Go Back&gt;](../right.html)
44

5-
 [tutorial](tutorial/right.html)
5+
[tutorial](tutorial/right.html)
66

7-
 [\_static](_static/right.html)
7+
[\_static](_static/right.html)
88

9-
10-
11-
Folders: 3
9+
Folders: 3

DOCS/tutorial/appendix.md

+32-38
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,22 @@
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-
-
12-
13-
|
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+
- |
1412

1513
<span id="tut-appendix"></span>
1614

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

2017
<span id="tut-interac"></span>
2118

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

2521
<span id="tut-error"></span>
2622

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

5551
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.
5652

57-
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:
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:
5854

5955
import os
6056
filename = os.environ.get('PYTHONSTARTUP')
@@ -79,17 +75,17 @@ Now you can create a file named `usercustomize.py` in that directory and put any
7975

8076
Footnotes
8177

82-
<span class="brackets"><a href="#id1" class="fn-backref">1</a></span>
78+
<span class="brackets"><a href="#id1" class="fn-backref">1</a></span>
8379
A problem with the GNU Readline package may prevent this.
8480

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

87-
- <a href="#" class="reference internal">16. Appendix</a>
88-
- <a href="#interactive-mode" class="reference internal">16.1. Interactive Mode</a>
89-
- <a href="#error-handling" class="reference internal">16.1.1. Error Handling</a>
90-
- <a href="#executable-python-scripts" class="reference internal">16.1.2. Executable Python Scripts</a>
91-
- <a href="#the-interactive-startup-file" class="reference internal">16.1.3. The Interactive Startup File</a>
92-
- <a href="#the-customization-modules" class="reference internal">16.1.4. The Customization Modules</a>
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>
9389

9490
#### Previous topic
9591

@@ -101,25 +97,23 @@ A problem with the GNU Readline package may prevent this.
10197

10298
### This Page
10399

104-
- [Report a Bug](https://docs.python.org/3/bugs.html)
105-
- [Show Source](https://github.com/python/cpython/blob/3.9/Doc/tutorial/appendix.rst)
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)
106102

107103
### Navigation
108104

109-
- [index](https://docs.python.org/3/genindex.html "General Index")
110-
- [modules](https://docs.python.org/3/py-modindex.html "Python Module Index") |
111-
- [next](https://docs.python.org/3/using/index.html "Python Setup and Usage") |
112-
- [previous](floatingpoint.html "15. Floating Point Arithmetic: Issues and Limitations") |
113-
- ![](../_static/py.png)
114-
- [Python](https://www.python.org/) »
115-
- [3.9.5 Documentation](https://docs.python.org/3/index.html) »
116-
- [The Python Tutorial](index.html) »
117-
-
118-
119-
|
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+
- |
120114

121115
© [Copyright](https://docs.python.org/3/copyright.html) 2001-2021, Python Software Foundation.
122-
The Python Software Foundation is a non-profit corporation. [Please donate.](https://www.python.org/psf/donations/)
123-
116+
The Python Software Foundation is a non-profit corporation. [Please donate.](https://www.python.org/psf/donations/)
117+
124118
Last updated on May 30, 2021. [Found a bug](https://docs.python.org/3/bugs.html)?
125119
Created using [Sphinx](https://www.sphinx-doc.org/) 2.4.4.

DOCS/tutorial/appetite.md

+28-33
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,18 @@
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-
-
12-
13-
|
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+
- |
1412

1513
<span id="tut-intro"></span>
1614

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

2017
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.
2118

@@ -25,21 +22,21 @@ Python is just the language for you.
2522

2623
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.
2724

28-
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.
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.
2926

3027
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.
3128

3229
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.
3330

3431
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:
3532

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

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

40-
- no variable or argument declarations are necessary.
37+
- no variable or argument declarations are necessary.
4138

42-
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.
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.
4340

4441
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!
4542

@@ -59,25 +56,23 @@ The rest of the tutorial introduces various features of the Python language and
5956

6057
### This Page
6158

62-
- [Report a Bug](https://docs.python.org/3/bugs.html)
63-
- [Show Source](https://github.com/python/cpython/blob/3.9/Doc/tutorial/appetite.rst)
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)
6461

6562
### Navigation
6663

67-
- [index](https://docs.python.org/3/genindex.html "General Index")
68-
- [modules](https://docs.python.org/3/py-modindex.html "Python Module Index") |
69-
- [next](interpreter.html "2. Using the Python Interpreter") |
70-
- [previous](index.html "The Python Tutorial") |
71-
- ![](../_static/py.png)
72-
- [Python](https://www.python.org/) »
73-
- [3.9.5 Documentation](https://docs.python.org/3/index.html) »
74-
- [The Python Tutorial](index.html) »
75-
-
76-
77-
|
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+
- |
7873

7974
© [Copyright](https://docs.python.org/3/copyright.html) 2001-2021, Python Software Foundation.
80-
The Python Software Foundation is a non-profit corporation. [Please donate.](https://www.python.org/psf/donations/)
81-
75+
The Python Software Foundation is a non-profit corporation. [Please donate.](https://www.python.org/psf/donations/)
76+
8277
Last updated on May 30, 2021. [Found a bug](https://docs.python.org/3/bugs.html)?
8378
Created using [Sphinx](https://www.sphinx-doc.org/) 2.4.4.

0 commit comments

Comments
 (0)