doc: minor copy-edits

Author: bluetech

doc/basics.rst

@@ -6,7 +6,7 @@ execnet ad-hoc instantiates local and remote Python interpreters.
 Each interpreter is accessible through a **Gateway** which manages
 code and data communication.  **Channels** allow to exchange
 data between the local and the remote end.  **Groups**
-help to manage creation and termination of sub interpreters.
+help to manage creation and termination of sub-interpreters.
 
 .. image:: _static/basic1.png
 
@@ -26,10 +26,10 @@ Here is an example which instantiates a simple Python subprocess::
 
     >>> gateway = execnet.makegateway()
 
-gateways allow to `remote execute code`_ and
+Gateways allow to `remote execute code`_ and
 `exchange data`_ bidirectionally.
 
-examples for valid gateway specifications
+Examples for valid gateway specifications
 -------------------------------------------
 
 * ``ssh=wyvern//python=python3.3//chdir=mycache`` specifies a Python3.3
@@ -82,15 +82,15 @@ in the instantiated subprocess-interpreter:
 .. automethod:: Gateway.remote_exec(source)
 
 It is allowed to pass a module object as source code
-in which case it's source code will be obtained and
+in which case its source code will be obtained and
 get sent for remote execution.  ``remote_exec`` returns
 a channel object whose symmetric counterpart channel
 is available to the remotely executing source.
 
 
 .. method:: Gateway.reconfigure([py2str_as_py3str=True, py3str_as_py2str=False])
 
-    reconfigures the string-coercion behaviour of the gateway
+    Reconfigures the string-coercion behaviour of the gateway
 
 .. _`Channel`:
 .. _`channel-api`:
@@ -167,7 +167,7 @@ you can execute this little test file::
 How to execute in the main thread
 ------------------------------------------------
 
-When the remote side of a gateway uses the 'thread' model, execution
+When the remote side of a gateway uses the "thread" model, execution
 will preferably run in the main thread.  This allows GUI loops
 or other code to behave correctly.  If you, however, start multiple
 executions concurrently, they will run in non-main threads.
@@ -220,7 +220,7 @@ configure a tracing mechanism:
 .. _`dumps/loads`:
 .. _`dumps/loads API`:
 
-cross-interpreter serialization of python objects
+Cross-interpreter serialization of Python objects
 =======================================================
 
 .. versionadded:: 1.1

doc/example/test_debug.rst

@@ -1,5 +1,5 @@
 
-Debugging execnet / Wire messages
+Debugging execnet / wire messages
 ===============================================================
 
 By setting the environment variable ``EXECNET_DEBUG`` you can

doc/example/test_group.rst

@@ -5,7 +5,7 @@ Usings Groups for managing multiple gateways
 ------------------------------------------------------
 
 Use ``execnet.Group`` to manage membership and lifetime of
-of multiple gateways::
+multiple gateways::
 
     >>> import execnet
     >>> group = execnet.Group(['popen'] * 2)
@@ -25,7 +25,7 @@ of multiple gateways::
     >>> group
     <Group []>
 
-Assigning Gateway IDs
+Assigning gateway IDs
 ------------------------------------------------------
 
 All gateways are created as part of a group and receive
@@ -66,12 +66,12 @@ you actually use the ``execnet.default_group``::
     >>> execnet.default_group.defaultspec # used for empty makegateway() calls
     'popen'
 
-Robust Termination of ssh/popen processes
+Robust termination of SSH/popen processes
 -----------------------------------------------
 
 Use ``group.terminate(timeout)`` if you want to terminate
-member gateways and ensure that no local sub processes remain
-you can specify a ``timeout`` after which an attempt at killing
+member gateways and ensure that no local subprocesses remain.
+You can specify a ``timeout`` after which an attempt at killing
 the related process is made::
 
     >>> import execnet
@@ -86,7 +86,7 @@ the related process is made::
 
 execnet aims to provide totally robust termination so if
 you have left-over processes or other termination issues
-please :doc:`report them <../support>`.  thanks!
+please :doc:`report them <../support>`.  Thanks!
 
 
 Using Groups to manage a certain type of gateway

doc/example/test_info.rst

@@ -1,5 +1,5 @@
-basic local and remote communication
-=========================================
+Basic local and remote communication
+====================================
 
 Execute source code in subprocess, communicate through a channel
 -------------------------------------------------------------------
@@ -25,8 +25,8 @@ messages between two processes.
 
 .. _`share-nothing model`: http://en.wikipedia.org/wiki/Shared_nothing_architecture
 
-remote-exec a function (avoiding inlined source part I)
--------------------------------------------------------------------
+Remote-exec a function (avoiding inlined source part I)
+-------------------------------------------------------
 
 You can send and remote execute parametrized pure functions like this:
 
@@ -49,8 +49,8 @@ Notes:
   between the nodes).
 
 
-remote-exec a module (avoiding inlined source part II)
---------------------------------------------------------------
+Remote-exec a module (avoiding inlined source part II)
+------------------------------------------------------
 
 You can pass a module object to ``remote_exec`` in which case
 its source code will be sent.  No dependencies will be transferred
@@ -86,8 +86,8 @@ A local subprocess gateway has the same working directory as the instantiatior::
 
 "ssh" gateways default to the login home directory.
 
-Get information from remote ssh account
---------------------------------------------
+Get information from remote SSH account
+---------------------------------------
 
 Use simple execution to obtain information from remote environments::
 
@@ -143,7 +143,7 @@ and use it to transfer information::
 
 
 
-a simple command loop pattern
+A simple command loop pattern
 --------------------------------------------------------------
 
 If you want the remote side to serve a number
@@ -189,6 +189,6 @@ itself into the remote socket endpoint::
     gw = execnet.makegateway("socket=TARGET-IP:8888")
 
 That's it, you can now use the gateway object just like
-a popen- or ssh-based one.
+a popen- or SSH-based one.
 
 .. include:: test_ssh_fileserver.rst

doc/example/test_multi.rst

@@ -1,4 +1,4 @@
-advanced (multi) channel communication
+Advanced (multi) channel communication
 =====================================================
 
 MultiChannel: container for multiple channels
@@ -19,7 +19,7 @@ Use ``execnet.MultiChannel`` to work with multiple channels::
     >>> sum(mch.receive_each())
     3
 
-receive results from sub processes with a Queue
+Receive results from sub processes with a Queue
 -----------------------------------------------------
 
 Use ``MultiChannel.make_receive_queue()`` to get a queue
@@ -52,7 +52,7 @@ data immediately and without blocking execution::
 Note that the callback function will be executed in the
 receiver thread and should not block or run for too long.
 
-robustly receive results and termination notification
+Robustly receive results and termination notification
 -----------------------------------------------------
 
 Use ``MultiChannel.make_receive_queue(endmarker)`` to specify
@@ -76,7 +76,7 @@ is blocked in execution and is terminated/killed::
 
 
 
-saturate multiple Hosts and CPUs with tasks to process
+Saturate multiple Hosts and CPUs with tasks to process
 --------------------------------------------------------
 
 If you have multiple CPUs or hosts you can create as many

doc/example/test_proxy.rst

@@ -1,10 +1,10 @@
-Managing Proxied gateways
+Managing proxied gateways
 ==========================
 
-Simple Proxying
+Simple proxying
 ----------------
 
-Using the via arg of specs we can create a gateway
+Using the ``via`` arg of specs we can create a gateway
 whose io is created on a remote gateway and proxied to the master.
 
 The simplest use case, is where one creates one master process

doc/example/test_ssh_fileserver.rst

@@ -1,4 +1,3 @@
-
 Receive file contents from remote SSH account
 -----------------------------------------------------
 

doc/implnotes.rst

@@ -1,8 +1,7 @@
-
 gateway_base.py
 ----------------------
 
-the code of this module is sent to the "other side"
+The code of this module is sent to the "other side"
 as a means of bootstrapping a Gateway object
 capable of receiving and executing code,
 and routing data through channels.

doc/index.rst

@@ -1,5 +1,3 @@
-
-
 .. image:: _static/pythonring.png
    :align: right
 
@@ -17,9 +15,9 @@ communication for distributing execution across many Python interpreters
 across version, platform and network barriers.  It has
 a minimal and fast API targeting the following uses:
 
-* distribute tasks to (many) local or remote CPUs
-* write and deploy hybrid multi-process applications
-* write scripts to administer multiple environments
+* Distribute tasks to (many) local or remote CPUs
+* Write and deploy hybrid multi-process applications
+* Write scripts to administer multiple environments
 
 .. _`channel-send/receive`: http://en.wikipedia.org/wiki/Channel_(programming)
 .. _`share-nothing model`: http://en.wikipedia.org/wiki/Shared_nothing_architecture
@@ -30,25 +28,25 @@ a minimal and fast API targeting the following uses:
 Features
 ------------------
 
-* automatic bootstrapping: no manual remote installation.
+* Automatic bootstrapping: no manual remote installation.
 
-* safe and simple serialization of python builtin
+* Safe and simple serialization of Python builtin
   types for sending/receiving structured data messages.
   (New in 1.1) execnet offers a new :ref:`dumps/loads <dumps/loads>`
   API which allows cross-interpreter compatible serialization
   of Python builtin types.
 
-* flexible communication: synchronous send/receive as well as
+* Flexible communication: synchronous send/receive as well as
   callback/queue mechanisms supported
 
-* easy creation, handling and termination of multiple processes
+* Easy creation, handling and termination of multiple processes
 
-* well tested interactions between CPython 2.5-2.7, CPython-3.3, Jython 2.5.1
+* Well tested interactions between CPython 2.5-2.7, CPython-3.3, Jython 2.5.1
   and PyPy interpreters.
 
-* fully interoperable between Windows and Unix-ish systems.
+* Fully interoperable between Windows and Unix-ish systems.
 
-* many tested :doc:`examples`
+* Many tested :doc:`examples`
 
 Known uses
 -------------------
@@ -64,7 +62,7 @@ Known uses
 * Ronny Pfannschmidt uses it for his `anyvc`_ VCS-abstraction project
   to bridge the Python2/Python3 version gap.
 
-* sysadmins and developers are using it for ad-hoc custom scripting
+* Sysadmins and developers are using it for ad-hoc custom scripting
 
 .. _`quora`: http://quora.com
 .. _`connecting CPython and PyPy`: http://www.quora.com/Quora-Infrastructure/Did-Quoras-switch-to-PyPy-result-in-increased-memory-consumption
@@ -87,7 +85,6 @@ used as backend of the popular `pytest-xdist <https://github.com/pytest-dev/pyte
 since version 1.2.
 
 .. _`basic API`: basics.html
-.. _`actively developed`: https://github.com/pytest-dev/execnet
 .. _`Holger Krekel`: http://twitter.com/hpk42
 
 .. toctree::

doc/support.rst

@@ -4,10 +4,10 @@ Contact and Support channels
 If you have interest, questions, issues or suggestions you
 are welcome to:
 
-* join `execnet-dev`_ for general discussions
-* join `execnet-commit`_ to be notified of changes
-* clone the `github repository`_ and submit patches
-* hang out on the #pytest channel on `irc.libera.chat <ircs://irc.libera.chat/#pytest>`_
+* Join `execnet-dev`_ for general discussions
+* Join `execnet-commit`_ to be notified of changes
+* Clone the `github repository`_ and submit patches
+* Hang out on the #pytest channel on `irc.libera.chat <ircs://irc.libera.chat/#pytest>`_
   (using an IRC client, via `webchat <https://web.libera.chat/#pytest>`_,
   or `via Matrix <https://matrix.to/#/%23pytest:libera.chat>`_).