Skip to content

Commit 4da01ac

Browse files
author
Vincent Zee
committed
Corrected lines to be no longer than 78 characters
1 parent fd1a37c commit 4da01ac

2 files changed

Lines changed: 58 additions & 46 deletions

File tree

docs/dev/env.rst

Lines changed: 49 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -29,31 +29,33 @@ following lines::
2929

3030
With these settings, newlines are inserted after 79 characters and indentation
3131
is set to 4 spaces per tab. If you also use Vim for other languages, there is a
32-
handy plugin called indent_, which handles indentation settings for Python source
33-
files.
32+
handy plugin called indent_, which handles indentation settings for Python
33+
source files.
3434

35-
There is also a handy syntax plugin called syntax_ featuring some improvements over
36-
the syntax file included in Vim 6.1.
35+
There is also a handy syntax plugin called syntax_ featuring some improvements
36+
over the syntax file included in Vim 6.1.
3737

3838
These plugins supply you with a basic environment for developing in Python.
3939
To get the most out of Vim, you should continually check your code for syntax
4040
errors and PEP8 compliance. Luckily PEP8_ and Pyflakes_ will do this for you.
41-
If your Vim is compiled with :option:`+python` you can also utilize some very handy
42-
plugins to do these checks from within the editor.
41+
If your Vim is compiled with :option:`+python` you can also utilize some very
42+
handy plugins to do these checks from within the editor.
4343

4444
For PEP8 checking, install the vim-pep8_ plugin, and for pyflakes you can
45-
install vim-pyflakes_. Now you can map the functions ``Pep8()`` or ``Pyflakes()``
46-
to any hotkey or action you want in Vim. Both plugins will display errors at
47-
the bottom of the screen, and provide an easy way to jump to the corresponding
48-
line. It's very handy to call these functions whenever you save a file. In
49-
order to do this, add the following lines to your :file:`.vimrc`::
45+
install vim-pyflakes_. Now you can map the functions ``Pep8()`` or
46+
``Pyflakes()`` to any hotkey or action you want in Vim. Both plugins will
47+
display errors at the bottom of the screen, and provide an easy way to jump to
48+
the corresponding line. It's very handy to call these functions whenever you
49+
save a file. In order to do this, add the following lines to your
50+
:file:`.vimrc`::
5051

5152
autocmd BufWritePost *.py call Pyflakes()
5253
autocmd BufWritePost *.py call Pep8()
5354

5455
If you are already using syntastic_, you can set it to run Pyflakes on write
5556
and show errors and warnings in the quickfix window. An example configuration
56-
to do that which also shows status and warning messages in the statusbar would be::
57+
to do that which also shows status and warning messages in the statusbar would
58+
be::
5759

5860
set statusline+=%#warningmsg#
5961
set statusline+=%{SyntasticStatuslineFlag()}
@@ -112,8 +114,8 @@ TextMate
112114
--------
113115

114116
`TextMate <http://macromates.com/>`_ brings Apple's approach to operating
115-
systems into the world of text editors. By bridging UNIX underpinnings and GUI,
116-
TextMate cherry-picks the best of both worlds to the benefit of expert
117+
systems into the world of text editors. By bridging UNIX underpinnings and
118+
GUI, TextMate cherry-picks the best of both worlds to the benefit of expert
117119
scripters and novice users alike.
118120

119121
Sublime Text
@@ -124,18 +126,21 @@ Sublime Text
124126
extraordinary features and amazing performance.
125127

126128
Sublime Text has excellent support for editing Python code and uses Python for
127-
its plugin API. It also has a diverse variety of plugins, `some of which <https://github.com/SublimeLinter/SublimeLinter>`_
128-
allow for in-editor PEP8 checking and code "linting".
129+
its plugin API. It also has a diverse variety of plugins,
130+
`some of which <https://github.com/SublimeLinter/SublimeLinter>`_ allow for
131+
in-editor PEP8 checking and code "linting".
129132

130133
Atom
131134
----
132135

133136
`Atom <https://atom.io/>`_ is a hackable text editor for the 21st century,
134-
built on atom-shell, and based on everything we love about our favorite editors.
137+
built on atom-shell, and based on everything we love about our favorite
138+
editors.
135139

136-
Atom is web native (HTML, CSS, JS), focusing on modular design and easy plugin development.
137-
It comes with native package control and plethora of packages. Recommended for Python
138-
development is `Linter <https://github.com/AtomLinter/Linter>`_ combined with
140+
Atom is web native (HTML, CSS, JS), focusing on modular design and easy plugin
141+
development. It comes with native package control and plethora of packages.
142+
Recommended for Python development is
143+
`Linter <https://github.com/AtomLinter/Linter>`_ combined with
139144
`linter-flake8 <https://github.com/AtomLinter/linter-flake8>`_.
140145

141146

@@ -147,9 +152,10 @@ PyCharm / IntelliJ IDEA
147152

148153
`PyCharm <http://www.jetbrains.com/pycharm/>`_ is developed by JetBrains, also
149154
known for IntelliJ IDEA. Both share the same code base and most of PyCharm's
150-
features can be brought to IntelliJ with the free `Python Plug-In <http://plugins.intellij.net/plugin/?id=631>`_.
151-
There are two versions of PyCharm: Professional Edition (Free 30-day trial)
152-
and Community Edition(Apache 2.0 License) with fewer features.
155+
features can be brought to IntelliJ with the free
156+
`Python Plug-In <http://plugins.intellij.net/plugin/?id=631>`_. There are two
157+
versions of PyCharm: Professional Edition (Free 30-day trial) and Community
158+
Edition(Apache 2.0 License) with fewer features.
153159

154160

155161
Eclipse
@@ -172,9 +178,10 @@ Spyder
172178
------
173179

174180
`Spyder <http://code.google.com/p/spyderlib/>`_ is an IDE specifically geared
175-
toward working with scientific Python libraries (namely `Scipy <http://www.scipy.org/>`_).
176-
It includes integration with pyflakes_, `pylint <http://www.logilab.org/857>`_
177-
and `rope <http://rope.sourceforge.net/>`_.
181+
toward working with scientific Python libraries (namely
182+
`Scipy <http://www.scipy.org/>`_). It includes integration with pyflakes_,
183+
`pylint <http://www.logilab.org/857>`_ and
184+
`rope <http://rope.sourceforge.net/>`_.
178185

179186
Spyder is open-source (free), offers code completion, syntax highlighting,
180187
a class and function browser, and object inspection.
@@ -195,11 +202,13 @@ NINJA-IDE
195202

196203
`NINJA-IDE <http://www.ninja-ide.org/>`_ (from the recursive acronym: "Ninja-IDE
197204
Is Not Just Another IDE") is a cross-platform IDE, specially designed to build
198-
Python applications, and runs on Linux/X11, Mac OS X and Windows desktop operating
199-
systems. Installers for these platforms can be downloaded from the website.
205+
Python applications, and runs on Linux/X11, Mac OS X and Windows desktop
206+
operating systems. Installers for these platforms can be downloaded from the
207+
website.
200208

201-
NINJA-IDE is open-source software (GPLv3 licence) and is developed in Python and
202-
Qt. The source files can be downloaded from `GitHub <https://github.com/ninja-ide>`_.
209+
NINJA-IDE is open-source software (GPLv3 licence) and is developed
210+
in Python and Qt. The source files can be downloaded from
211+
`GitHub <https://github.com/ninja-ide>`_.
203212

204213

205214
Eric (The Eric Python IDE)
@@ -210,8 +219,8 @@ offering sourcecode autocompletion, syntax highlighting, support for version
210219
control systems, python 3 support, integrated web browser, python shell,
211220
integrated debugger and a flexible plug-in system. Written in python, it is
212221
based on the Qt gui toolkit, integrating the Scintilla editor control. Eric
213-
is an open-source software project (GPLv3 licence) with more than ten years of active
214-
development.
222+
is an open-source software project (GPLv3 licence) with more than ten years of
223+
active development.
215224

216225

217226
Interpreter Tools
@@ -221,15 +230,16 @@ Interpreter Tools
221230
Virtual Environments
222231
--------------------
223232

224-
A Virtual Environment is a tool to keep the dependencies required by different projects
225-
in separate places, by creating virtual Python environments for them. It solves the
226-
"Project X depends on version 1.x but, Project Y needs 4.x" dilemma, and keeps
227-
your global site-packages directory clean and manageable.
233+
A Virtual Environment is a tool to keep the dependencies required by different
234+
projects in separate places, by creating virtual Python environments for them.
235+
It solves the "Project X depends on version 1.x but, Project Y needs 4.x"
236+
dilemma, and keeps your global site-packages directory clean and manageable.
228237

229238
For example, you can work on a project which requires Django 1.3 while also
230239
maintaining a project which requires Django 1.0.
231240

232-
To start using and see more information: `Virtual Environments <http://github.com/kennethreitz/python-guide/blob/master/docs/dev/virtualenvs.rst>`_ docs.
241+
To start using and see more information:
242+
`Virtual Environments <http://github.com/kennethreitz/python-guide/blob/master/docs/dev/virtualenvs.rst>`_ docs.
233243

234244
Other Tools
235245
:::::::::::
@@ -273,7 +283,8 @@ BPython
273283
-------
274284

275285
`bpython <http://bpython-interpreter.org/>`_ is an alternative interface to the
276-
Python interpreter for Unix-like operating systems. It has the following features:
286+
Python interpreter for Unix-like operating systems. It has the following
287+
features:
277288

278289
* In-line syntax highlighting.
279290
* Readline-like autocomplete with suggestions displayed as you type.

docs/dev/virtualenvs.rst

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
Virtual Environments
22
====================
33

4-
A Virtual Environment is a tool to keep the dependencies required by different projects
5-
in separate places, by creating virtual Python environments for them. It solves the
6-
"Project X depends on version 1.x but, Project Y needs 4.x" dilemma, and keeps
7-
your global site-packages directory clean and manageable.
4+
A Virtual Environment is a tool to keep the dependencies required by different
5+
projects in separate places, by creating virtual Python environments for them.
6+
It solves the "Project X depends on version 1.x but, Project Y needs 4.x"
7+
dilemma, and keeps your global site-packages directory clean and manageable.
88

99
For example, you can work on a project which requires Django 1.3 while also
1010
maintaining a project which requires Django 1.0.
@@ -32,10 +32,11 @@ Basic Usage
3232
$ cd my_project_folder
3333
$ virtualenv venv
3434
35-
``virtualenv venv`` will create a folder in the current directory which will contain
36-
the Python executable files, and a copy of the ``pip`` library which you can use to
37-
install other packages. The name of the virtual environment (in this case, it was ``venv``)
38-
can be anything; omitting the name will place the files in the current directory instead.
35+
``virtualenv venv`` will create a folder in the current directory which will
36+
contain the Python executable files, and a copy of the ``pip`` library which you
37+
can use to install other packages. The name of the virtual environment (in this
38+
case, it was ``venv``) can be anything; omitting the name will place the files
39+
in the current directory instead.
3940

4041
This creates a copy of Python in whichever directory you ran the command in,
4142
placing it in a folder named :file:`venv`.

0 commit comments

Comments
 (0)