Skip to content

Commit eb79ed9

Browse files
committed
Cleaned up the english a bit
1 parent 88df06e commit eb79ed9

File tree

8 files changed

+70
-70
lines changed

8 files changed

+70
-70
lines changed

Chapter1/Chapter1_Introduction.ipynb

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -28,13 +28,13 @@
2828
"---------------\n",
2929
"Python has a clear and concise syntax, which favors the readability of source code, and makes the language more productive.\n",
3030
"\n",
31-
"The language includes several high-level structures (lists, dictionaries, date / time, complex numbers and others) and a vast collection of modules ready for use, plus third-party frameworks that can be added. It also has features found in other modern languages, such as generators, introspection, persistence, metaclasses and unity tests. Multiparadigm, the language supports modular, functional, and object-oriented programming. Even the basic types in Python are objects. The language is interpreted through bytecode by the Python virtual machine, making the code portable. This makes it possible to build applications on one platform and run on other systems or run direct from the source.\n",
31+
"The language includes several high-level structures (lists, dictionaries, date / time, complex numbers and others) and a vast collection of modules ready for use, plus third-party frameworks that can be added. It also has features found in other modern languages, such as generators, introspection, persistence, metaclasses and unity tests. Multiparadigm, the language supports modular, functional, and object-oriented programming. Even the basic types in Python are objects. The language is interpreted through bytecode by the Python virtual machine, making the code portable. This makes it possible to build applications on one platform and run them on other systems or direct from the source.\n",
3232
"\n",
33-
"Python is an open source software (with license compatible with the *General Public License (GPL)*, but less restrictive, allowing Python to be even incorporated into proprietary products). The language specification is maintained by [Python Software Foundation](http://www.python.org/psf/) (PSF).\n",
33+
"Python is open source software (with license compatible with the *General Public License (GPL)*, but less restrictive, allowing Python to be even incorporated into proprietary products). The language specification is maintained by the [Python Software Foundation](http://www.python.org/psf/) (PSF).\n",
3434
"\n",
35-
"Besides being used as the main language in the development of systems, Python is also used as a *script* language in various software, enabling you to automate tasks and add new features, among them: LibreOffice.org, PostgreSQL, Blender, GIMP and Inkscape.\n",
35+
"Besides being used as the main language in the development of systems, Python is also used as a *scripting* language in various pieces of software, enabling you to automate tasks and add new features, among them: LibreOffice.org, PostgreSQL, Blender, GIMP and Inkscape.\n",
3636
"\n",
37-
"It is possible to integrate Python with other languages such as C and Fortran languages. In general terms, the language has many similarities with other dynamic languages such as Perl and Ruby.\n",
37+
"It is possible to integrate Python with other languages such as C and Fortran. In general terms, the language has many similarities with other dynamic languages such as Perl and Ruby.\n",
3838
"\n",
3939
"History\n",
4040
"---------\n",
@@ -102,7 +102,7 @@
102102
"\n",
103103
"`python apl.py`\n",
104104
"\n",
105-
"Thus `apl.py` will run. On Windows, the file extensions\u00a0\".py\", \". pyw\", \". pyc\" and \". pyo\" are associated with the Python automatically during installation, then just click on the file to run. The \". pyw\" files run with an alternate version of the interpreter that does not open the console window.\n",
105+
"Thus `apl.py` will run. On Windows, the file extensions\u00a0\".py\", \". pyw\", \". pyc\" and \". pyo\" are associated with Python automatically during installation, so just click a the file to run it. The \". pyw\" files run with an alternate version of the interpreter that does not open the console window.\n",
106106
"\n",
107107
"Dynamic Typing\n",
108108
"----------------\n",
@@ -116,9 +116,9 @@
116116
"\n",
117117
"![Compilation, interpretation and packing](files/bpyfd_diags1.png)\n",
118118
"\n",
119-
"By default, the parser compiles the code and stores the bytecode on disk, so the next time you run it, there is no need to recompile the program, reducing the load time on execution. If the source files are changed, the interpreter will be responsible for regenerating the bytecode automatically, even using the *interactive shell*. When a program or a module is invoked, the interpreter performs the analysis of the code, converting to symbols, compiles (if there is no updated bytecode on disk) and runs it on Python virtual machine.\n",
119+
"By default, the parser compiles the code and stores the bytecode on disk, so the next time you run it, there is no need to recompile the program, reducing the load time of execution. If the source files are changed, the interpreter will be responsible for regenerating the bytecode automatically, even using the *interactive shell*. When a program or a module is invoked, the interpreter performs the analysis of the code, converts to symbols, compiles (if there is no updated bytecode on disk) and runs it in the Python virtual machine.\n",
120120
"\n",
121-
"The bytecode is stored in files with extension \". pyc\" (normal bytecode) or \". pyo\" (optimized bytecode). The bytecode can also be packaged along with an executable interpreter, to facilitate the distribution of the application, eliminating the need to install Python on each computer.\n",
121+
"The bytecode is stored in files with the extension \". pyc\" (normal bytecode) or \". pyo\" (optimized bytecode). The bytecode can also be packaged along with an executable interpreter, to facilitate the distribution of the application, eliminating the need to install Python on each computer.\n",
122122
"\n",
123123
"Interactive Mode\n",
124124
"----------------\n",
@@ -135,16 +135,16 @@
135135
"\n",
136136
"On Windows, the interactive mode is also available via the icon \"Python (command line)\".\n",
137137
"\n",
138-
"The interactive mode is a distinguishing feature of the language, as it is possible to test and modify code snippets code before inclusion in programs, to extract and convert data or even analyze the state of the objects in memory, among other possibilities.\n",
138+
"The interactive mode is a distinguishing feature of the language, as it is possible to test and modify code snippets before inclusion in programs, to extract and convert data or even analyze the state of the objects in memory, among other possibilities.\n",
139139
"\n",
140-
"Besides traditional interactive mode of Python, there are other programs that act as alternatives to more sophisticated interfaces (such as <span class=\"note\" title=\"PyCrust is part of wxPython project (http://www.wxpython.org/\">PyCrust</span>):\n",
140+
"Besides the traditional interactive mode of Python, there are other programs that act as alternatives to more sophisticated interfaces (such as <span class=\"note\" title=\"PyCrust is part of wxPython project (http://www.wxpython.org/\">PyCrust</span>):\n",
141141
"![PyCrust](files/pycrust.png)\n",
142142
"\n",
143143
"Tools\n",
144144
"-----------\n",
145145
"There are many development tools for Python, such as IDEs, editors and shells (that take advantage of the interactive capabilities of Python).\n",
146146
"\n",
147-
"*Integrated Development Environments* (IDEs) are software packages that integrate various development tools in an environment consistent with the goal of increasing developer productivity. Generally, IDEs include such features as syntax highlight (colorized source code according to the syntax of the language), source browsers, integrated shell and *code completion* (the editor presents possible ways to complete the text it can identify while typing).\n",
147+
"*Integrated Development Environments* (IDEs) are software packages that integrate various development tools in an environment consistent with the goal of increasing developer productivity. Generally, IDEs include such features as syntax highlighting (colorized source code according to the syntax of the language), source browsers, integrated shell and *code completion* (the editor presents possible ways to complete the text it can identify while typing).\n",
148148
"Among Python IDEs, there are:\n",
149149
"\n",
150150
"+ [PyScripter](http://code.google.com/p/pyscripter/)\n",
@@ -156,14 +156,14 @@
156156
"\n",
157157
"There are also text editors specialized in programming code, which have features like syntax colorization, export to other formats and convert text encoding.\n",
158158
"\n",
159-
"These editors support multiple programming languages\u200b\u200b, among them Python:\n",
159+
"These editors support multiple programming languages\u200b\u200b, Python among them:\n",
160160
"\n",
161161
"+ [SciTE](http://www.scintilla.org/SciTE.html)\n",
162162
"+ [Notepad++](http://notepad-plus.sourceforge.net/br/site.htm)\n",
163163
"\n",
164164
"*Shell* is the name given to interactive environments for executing commands that can be used to test small pieces of code and for activities like data crunching (extraction of information of interest in masses of data and subsequent translation to other formats).\n",
165165
"\n",
166-
"Beyond standard Python *Shell*, there are others available:\n",
166+
"Beyond the standard Python *Shell*, there are others available:\n",
167167
"\n",
168168
"+ PyCrust \n",
169169
"+ IPython \n",
@@ -177,7 +177,7 @@
177177
"\n",
178178
"*Frameworks* are collections of software components (libraries, utilities and others) that have been designed to be used by other systems.\n",
179179
"\n",
180-
"Some of the most known *frameworks* availbles:\n",
180+
"Some of the most known *frameworks* availble are:\n",
181181
"\n",
182182
"+ Web: Django, TurboGears, Zope and web2py.\n",
183183
"+ Graphic interface: wxPython, PyGTK and PyQt.\n",
@@ -189,9 +189,9 @@
189189
"\n",
190190
"Culture\n",
191191
"-------\n",
192-
"The name Python was taken by Guido van Rossum from british TV program *Monty Python Flying Circus*, and there are many references to the show in language documentation. For instance, Python oficial package repository was called Cheese Shop, the name of one of the frames of the programa. Currently, the repository name is [Python Package Index](http://pypi.python.org/pypi) (PYPI).\n",
192+
"The name Python was taken by Guido van Rossum from british TV program *Monty Python's Flying Circus*, and there are many references to the show in its documentation. For instance, Python's oficial package repository was called Cheese Shop, the name of one of the frames of the program. Currently, the repository name is [Python Package Index](http://pypi.python.org/pypi) (PYPI).\n",
193193
"\n",
194-
"The goals of the project were summarized by Tim Peters in a text called *Zen of Python* , which is available in Python itself using the command:"
194+
"The goals of the project was summarized by Tim Peters in a text called *Zen of Python*, which is available in Python itself using the command:"
195195
]
196196
},
197197
{
@@ -241,7 +241,7 @@
241241
"\n",
242242
"Proposals for improving the language are called PEPs *(Python Enhancement Proposals)*, which also serve as a reference for new features to be implemented in the language.\n",
243243
"\n",
244-
"In addition to the official website, other good source of information about language is: [Python Cookbook](http://aspn.activestate.com/ASPN/Python/Cookbook/) site that stores \"recipes\": small portions of code to accomplish specific tasks."
244+
"In addition to the official website, other good source of information about the language are: [Python Cookbook](http://aspn.activestate.com/ASPN/Python/Cookbook/) site that stores \"recipes\": small portions of code to accomplish specific tasks."
245245
]
246246
},
247247
{

Chapter2/Chapter2_Syntax.ipynb

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,13 @@
1919
"Chapter 2: Syntax\n",
2020
"===================\n",
2121
"___________________\n",
22-
"A program written in Python consists of lines, which may continue in the following lines, by using the backslash character (`\\`) at the end of the line or parentheses, brackets or braces in expressions that use such characters.\n",
22+
"A program written in Python consists of lines, which may continue on the following lines, by using the backslash character (`\\`) at the end of the line or parentheses, brackets or braces in expressions that use such characters.\n",
2323
"\n",
2424
"The character `#` marks the beginning of a comment. Any text after the `#` will be ignored until the end of the line, with the exception of functional comments.\n",
2525
"\n",
26-
"Functional comments are used for:\n",
26+
"Functional comments are used to:\n",
2727
"\n",
28-
"+ change the encoding of the source file of the program by adding a comment with the text `# - * - coding: <encoding> - # -` at the beginning of the file, in which `<encoding> ` is the file encoding (usually latin1 or utf-8). Change encoding is required to support characters that are not part of the English language, in the source code of the program.\n",
28+
"+ change the encoding of the source file of the program by adding a comment with the text `# - * - coding: <encoding> - # -` at the beginning of the file, in which `<encoding> ` is the file encoding (usually latin1 or utf-8). Changing encoding is required to support characters that are not part of the English language, in the source code of the program.\n",
2929
"+ define the interpreter that will be used to run the program on UNIX systems, through a comment starting with `#!` at the beginning of the file, which indicates the path to the interpreter (usually the comment line will be something like` #! / usr / bin / env python` ).\n",
3030
"\n",
3131
"Example of functional comments:"
@@ -96,15 +96,15 @@
9696
"cell_type": "markdown",
9797
"metadata": {},
9898
"source": [
99-
"The command `print` inserts spaces between expressions that are received as a parameter, and a newline character at the end, unless he receives a comma at the end of the parameter list.\n",
99+
"The command `print` inserts spaces between expressions that are received as a parameter, and a newline character at the end, unless it receives a comma at the end of the parameter list.\n",
100100
"\n",
101101
"Blocks\n",
102102
"------\n",
103-
"In Python, code blocks are defined by the use of indentation, which should be constant in the code block, but it is considered good practice to maintain consistency throughout the project and avoid mixing tabs and <span class = \"note\" title = \"The official recommendation coding style (http://www.python.org/dev/peps/pep-0008/) is to use four spaces for indentation and this convention is widely accepted by developers.\">spaces</ span >.\n",
103+
"In Python, code blocks are defined by the use of indentation, which should be constant in the code block, but it is considered good practice to maintain consistency throughout the project and avoid mixing tabs and <span class = \"note\" title = \"The official recommendation coding style (http://www.python.org/dev/peps/pep-0008/) is to use four spaces for indentation and this convention is widely accepted by developers.\">spaces</span>.\n",
104104
"\n",
105105
"The line before the block always ends with a colon (:) and is a control structure of the language or a statement of a new structure (a function, for example).\n",
106106
"\n",
107-
"![Estrutura de um programa](files/bpyfd_diags2.png)\n",
107+
"![Program structure](files/bpyfd_diags2.png)\n",
108108
"\n",
109109
"Example:"
110110
]

Chapter3/Chapter3_Control_flow.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@
3838
"+ `<code block>`: sequence of command lines.\n",
3939
"+ The clauses `elif` and `else` are optional and\u00a0 several `elifs` for the `if` may be used but only\u00a0 one `else` at the end.\n",
4040
"+ Parentheses are only required to avoid ambiguity.\n",
41-
"Exemplo:"
41+
"Example:"
4242
]
4343
},
4444
{

Chapter4/Chapter4_Loops.ipynb

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,11 +23,11 @@
2323
"\n",
2424
"For\n",
2525
"---\n",
26-
"It is the repetition structure most often used in the Python. The statement accepts not only static\u00a0sequences, but also sequences generated by iterators. Iterators are structures that allow iterations, ie access to items of a collection of elements, sequentially.\n",
26+
"It is the repetition structure most often used in Python. The statement accepts not only static\u00a0sequences, but also sequences generated by iterators. Iterators are structures that allow iterations, i.e. access to items of a collection of elements, sequentially.\n",
2727
"\n",
2828
"![Loop Example](files/bpyfd_diags3.png)\n",
2929
"\n",
30-
"During the execution of a *for* loop , the reference points to an element in the sequence. At each iteration, the reference is updated, in order to the *for* code block to process the corresponding element.\n",
30+
"During the execution of a *for* loop, the reference points to an element in the sequence. At each iteration, the reference is updated, in order for the *for* code block to process the corresponding element.\n",
3131
"\n",
3232
"The clause *break*\u00a0stops the loop and *continue* passes it to the next iteration. The code inside the `else` is executed at the end of the loop, except if the loop has been interrupted by *break*.\n",
3333
"\n",

0 commit comments

Comments
 (0)