Merge branch 'master' into whichwhich

This commit is contained in:
Anthony Scopatz 2016-05-17 11:47:06 -04:00
commit 086078b098
5 changed files with 16 additions and 11 deletions

4
.gitattributes vendored
View file

@ -1,4 +1,4 @@
tests/histories/*.json text eol=lf
# Set the default behavior, in case people don't have core.autocrlf set.
* text=auto
tests/histories/*.json text eol=lf

View file

@ -69,3 +69,4 @@ For those of you who want the gritty details.
:maxdepth: 1
mplhooks

View file

@ -51,7 +51,7 @@ is open to interpretation.
``"""triple double quotes"""`` for docstrings. Double quotes are allowed to
prevent single quote escaping, e.g. ``"Y'all c'mon o'er here!"``
* We use sphinx with the numpydoc extension to autogenerate API documentation. Follow
the numpydoc standard for docstrings `described here <https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt>`_.
the `numpydoc`_ standard for docstrings.
* Simple functions should have simple docstrings.
* Lines should be at most 80 characters long. The 72 and 79 character
recommendations from PEP8 are not required here.
@ -148,7 +148,7 @@ Docstrings
No matter what language you are writing in, you should always have
documentation strings along with you code. This is so important that it is
part of the style guide. When writing in Python, your docstrings should be
in reStructured Text using the numpydoc format.
in reStructured Text using the `numpydoc`_ format.
------------------------
Auto-Documentation Hooks
@ -346,4 +346,5 @@ Document History
Portions of this page have been forked from the PyNE documentation,
Copyright 2011-2015, the PyNE Development Team. All rights reserved.
.. _PEP8: http://www.python.org/dev/peps/pep-0008/
.. _PEP8: https://www.python.org/dev/peps/pep-0008/
.. _numpydoc: https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt

3
requirements-docs.txt Normal file
View file

@ -0,0 +1,3 @@
cloud_sptheme
numpydoc==0.5
Sphinx

View file

@ -353,9 +353,9 @@ DEFAULT_DOCS = {
'Whether or not to suppress directory stack manipulation output.'),
'RAISE_SUBPROC_ERROR': VarDocs(
'Whether or not to raise an error if a subprocess (captured or '
'uncaptured) returns a non-zero exit status, which indicates failure.'
'uncaptured) returns a non-zero exit status, which indicates failure. '
'This is most useful in xonsh scripts or modules where failures '
'should cause an end to execution. This is less useful at a terminal.'
'should cause an end to execution. This is less useful at a terminal. '
'The error that is raised is a subprocess.CalledProcessError.'),
'RIGHT_PROMPT': VarDocs('Template string for right-aligned text '
'at the prompt. This may be parameterized in the same way as '