<feed xmlns='http://www.w3.org/2005/Atom'>
<title>delta/python-packages/sphinx-git.git/tests/test_ext_napoleon_docstring.py, branch v2.0.0</title>
<subtitle>github.com: sphinx-doc/sphinx.git
</subtitle>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/'/>
<entry>
<title>Python-3-only clean ups discovered by pyupgrade</title>
<updated>2019-03-18T16:09:48+00:00</updated>
<author>
<name>Jon Dufresne</name>
<email>jon.dufresne@gmail.com</email>
</author>
<published>2019-03-17T19:49:36+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=22afc77c488e85ccd51303a223f450705b30217b'/>
<id>22afc77c488e85ccd51303a223f450705b30217b</id>
<content type='text'>
https://github.com/asottile/pyupgrade

&gt; A tool to automatically upgrade syntax for newer versions of the
&gt; language.

- Drop u str prefix
- Drop base object inheritance
- Drop args to super()
- Use set literals
- Use dict comprehension
- Use set comprehension
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
https://github.com/asottile/pyupgrade

&gt; A tool to automatically upgrade syntax for newer versions of the
&gt; language.

- Drop u str prefix
- Drop base object inheritance
- Drop args to super()
- Use set literals
- Use dict comprehension
- Use set comprehension
</pre>
</div>
</content>
</entry>
<entry>
<title>Fix #6140: Use unittest.mock instead of mock</title>
<updated>2019-03-09T06:16:04+00:00</updated>
<author>
<name>Takeshi KOMIYA</name>
<email>i.tkomiya@gmail.com</email>
</author>
<published>2019-03-07T14:35:36+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=65970a3033cab10da15342969ba023be76e904ea'/>
<id>65970a3033cab10da15342969ba023be76e904ea</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Merge branch '1.8'</title>
<updated>2019-01-02T07:16:25+00:00</updated>
<author>
<name>Takeshi KOMIYA</name>
<email>i.tkomiya@gmail.com</email>
</author>
<published>2019-01-02T07:16:25+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=76e9f57c2e4457dec11d258435b7a6c6ec5de005'/>
<id>76e9f57c2e4457dec11d258435b7a6c6ec5de005</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>A happy new year!</title>
<updated>2019-01-02T07:00:30+00:00</updated>
<author>
<name>Takeshi KOMIYA</name>
<email>i.tkomiya@gmail.com</email>
</author>
<published>2019-01-02T07:00:30+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=1b1ebd2c7539ebf6a1dfa1ea247e659f98fa9eaf'/>
<id>1b1ebd2c7539ebf6a1dfa1ea247e659f98fa9eaf</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Remove unnecessary encoding cookie from Python source files</title>
<updated>2018-12-16T20:22:12+00:00</updated>
<author>
<name>Jon Dufresne</name>
<email>jon.dufresne@gmail.com</email>
</author>
<published>2018-12-16T20:01:04+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=bade33c7e490655c3f5b46d374129294f70449aa'/>
<id>bade33c7e490655c3f5b46d374129294f70449aa</id>
<content type='text'>
In Python 3, the default encoding of source files is utf-8. The encoding
cookie is now unnecessary and redundant so remove it. For more details,
see the docs:

https://docs.python.org/3/howto/unicode.html#the-string-type

&gt; The default encoding for Python source code is UTF-8, so you can
&gt; simply include a Unicode character in a string literal ...

Includes a fix for the flake8 header checks to stop expecting an
encoding cookie.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
In Python 3, the default encoding of source files is utf-8. The encoding
cookie is now unnecessary and redundant so remove it. For more details,
see the docs:

https://docs.python.org/3/howto/unicode.html#the-string-type

&gt; The default encoding for Python source code is UTF-8, so you can
&gt; simply include a Unicode character in a string literal ...

Includes a fix for the flake8 header checks to stop expecting an
encoding cookie.
</pre>
</div>
</content>
</entry>
<entry>
<title>Fixes #5426: [Napoleon] Better handling of inline attributes (#5470)</title>
<updated>2018-09-23T13:26:17+00:00</updated>
<author>
<name>Rob Ruana</name>
<email>robruana@magfest.org</email>
</author>
<published>2018-09-23T13:26:17+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=e547a6a0d26d2d7fa4bb45103e68a61d815b0efe'/>
<id>e547a6a0d26d2d7fa4bb45103e68a61d815b0efe</id>
<content type='text'>
* Fixes #5426: [Napoleon] Better handling of inline attributes

* Removes uneeded NOQA comments

* Fixes imports
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
* Fixes #5426: [Napoleon] Better handling of inline attributes

* Removes uneeded NOQA comments

* Fixes imports
</pre>
</div>
</content>
</entry>
<entry>
<title>Rendering of exceptions by napoleon. (#4046)</title>
<updated>2018-09-23T12:31:27+00:00</updated>
<author>
<name>Antony Lee</name>
<email>anntzer.lee@gmail.com</email>
</author>
<published>2018-09-23T12:31:27+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=dbb7c382206fed66b43b32dfd8e48dba0ac562b8'/>
<id>dbb7c382206fed66b43b32dfd8e48dba0ac562b8</id>
<content type='text'>
This lets napoleon render exceptions using the standard info field
syntax
```
:raises FooException: Some condition.
```
rather than the nonstandard
```
:raises: :exc:`FooException` -- Some condition.
```

Note that the previous approach was more forgiving if an explanatory
text was given in the Raises section without an actual exception class:
```
Raises
------
If something occurs.
```
would be rendered as
```
:raises: *If something occurs*
```
which is OK-ish but is now rendered as
```
:raises If something occurs.:
```
which is somewhat more nonsensical.

However neither the Google style guide nor numpydoc actually support
this form (they always have both the type and the description) so I
think the change is reasonable.</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
This lets napoleon render exceptions using the standard info field
syntax
```
:raises FooException: Some condition.
```
rather than the nonstandard
```
:raises: :exc:`FooException` -- Some condition.
```

Note that the previous approach was more forgiving if an explanatory
text was given in the Raises section without an actual exception class:
```
Raises
------
If something occurs.
```
would be rendered as
```
:raises: *If something occurs*
```
which is OK-ish but is now rendered as
```
:raises If something occurs.:
```
which is somewhat more nonsensical.

However neither the Google style guide nor numpydoc actually support
this form (they always have both the type and the description) so I
think the change is reasonable.</pre>
</div>
</content>
</entry>
<entry>
<title>Fix flake8 violations</title>
<updated>2018-02-19T15:08:44+00:00</updated>
<author>
<name>Takeshi KOMIYA</name>
<email>i.tkomiya@gmail.com</email>
</author>
<published>2018-02-19T15:08:44+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=4073d4e85032e6054f154d8a81e75fb16ce43006'/>
<id>4073d4e85032e6054f154d8a81e75fb16ce43006</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Merge branch '1.7'</title>
<updated>2018-02-19T15:02:57+00:00</updated>
<author>
<name>Takeshi KOMIYA</name>
<email>i.tkomiya@gmail.com</email>
</author>
<published>2018-02-19T15:02:57+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=938ba386ed84f7fd3a106233ce52c52be5553dc7'/>
<id>938ba386ed84f7fd3a106233ce52c52be5553dc7</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Fix flake8 violations</title>
<updated>2018-02-19T14:20:56+00:00</updated>
<author>
<name>Takeshi KOMIYA</name>
<email>i.tkomiya@gmail.com</email>
</author>
<published>2018-02-19T13:39:14+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=f7027049b1cc02797ee063ef63c6b353a1ce31ca'/>
<id>f7027049b1cc02797ee063ef63c6b353a1ce31ca</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
</feed>
