Deal with IOError due to (EPIPE) [v2]

* https://github.com/avocado-framework/avocado:
  Adding more release notes versions
  Organize release notes
  Improve documentation index

By ignoring the exception, and preventing Avocado from crashing.
Since the actions inside the block that may trigger an IOError are the
writes to stdout and stderr, we can be pretty confident that there
will be no adverse effects.

Reference: https://trello.com/c/sztjbAXySigned-off-by: NCleber Rosa <crosa@redhat.com>

Another batch of release notes.
Signed-off-by: NAmador Pahim <apahim@redhat.com>

Let's create a release_notes directory and an dedicated index file.
Signed-off-by: NAmador Pahim <apahim@redhat.com>

Add captions to separate sections in readthedocs left menu.
Remove the heads as we are now using captions.
Fix anchors.
Signed-off-by: NAmador Pahim <apahim@redhat.com>

This reverts commit a82f2acf.

With this option, a test that ends with a 'bad' status will make
the job to be interrupted.
Signed-off-by: NAmador Pahim <apahim@redhat.com>

Including the release notes in our docs.
Signed-off-by: NAmador Pahim <apahim@redhat.com>

examples: Add `make spell` to testplan

Support for spell checking had been added to avocado recently, let's
make that mandatory step of manual testplan.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

Now users can execute 'avocado run --replay latest' to have the latest
job replayed. No need to remember the job id.

Reference: https://trello.com/c/C0YCTT6dSigned-off-by: NAmador Pahim <apahim@redhat.com>

The runner uses multiplexer to modify the test-template, which is not
really clean. It should only as for variants and the runner itself
should be responsible for adjusting the template which is exactly what
this patch does.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

* https://github.com/avocado-framework/avocado:
  Add spell checker as Makefile target.
  Yet another spellcheck.

This patch adds the `make spell` command so developers can easily
check the spelling on docstrings and comments. False positives
words should be added to spell.ignore file.
Signed-off-by: NAmador Pahim <apahim@redhat.com>

Signed-off-by: NAmador Pahim <apahim@redhat.com>

* https://github.com/avocado-framework/avocado:
  Massive spelling correction

Signed-off-by: NAmador Pahim <apahim@redhat.com>

* https://github.com/avocado-framework/avocado:
  avocado/core/tree.py: replace get_ascii() for tree_view()

* https://github.com/avocado-framework/avocado:
  Multiplex doc: try to be clearer about mandatory space and colon

We have a warning about the mandatory space when using the `!include
:` construct.  Since the warning has an exclamation mark (for
punctuation purposes) it can make it a bit confusing since the
example given begins with an exclamation mark (for syntactic
purposes).

Also, in reStructured Text markup, double underscores do not add
emphasis, as it seems to be the original intention.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Commit 19cb82ce removed the `get_ascii()` method and added the utility
function `tree_view()`.  But there is a leftover using the old method.
Let's replace them.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Signed-off-by: NCleber Rosa <crosa@redhat.com>

selftests: Few pre-release unittest fixes

The superusers default permission is 0o644 while other users is 0o664.
This is not handled by zipfile yet so adjust the unittest for now and
see what we can do about this in our utils.archive later.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

This test requires mkfs binary in order to run, while it's not really
essential for avocado testing. Let's skip it when it's not available.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

selftests: Few pre-release unittest fixes

This test requires mkfs binary in order to run, while it's not really
essential for avocado testing. Let's skip it when it's not available.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

The superusers default permission is 0o644 while other users is 0o664.
This is not handled by zipfile yet so adjust the unittest for now and
see what we can do about this in our utils.archive later.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

Use the stacktrace.str_unpickable_objects to get more information on why
the status was not send through queue.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

The stacktrace.str_unpickable_object() walks the object and tries to
identify all the pieces which are unpickable and reports them in a human
readable form.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

contrib: Add run-kvm-unit-test script [v2]

This script runs kvm-unit-test tests as individual tests in avocado.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>