<feed xmlns='http://www.w3.org/2005/Atom'>
<title>kernel/git/stable/linux.git/Documentation/circular-buffers.txt, branch master</title>
<subtitle>Linux kernel stable tree</subtitle>
<id>https://git.rulkc.org/pub/scm/linux/kernel/git/stable/linux.git/atom?h=master</id>
<link rel='self' href='https://git.rulkc.org/pub/scm/linux/kernel/git/stable/linux.git/atom?h=master'/>
<link rel='alternate' type='text/html' href='https://git.rulkc.org/pub/scm/linux/kernel/git/stable/linux.git/'/>
<updated>2018-05-08T16:07:06+00:00</updated>
<entry>
<title>docs: core-api: add circular-buffers documentation</title>
<updated>2018-05-08T16:07:06+00:00</updated>
<author>
<name>Mauro Carvalho Chehab</name>
<email>mchehab+samsung@kernel.org</email>
</author>
<published>2018-05-07T09:35:43+00:00</published>
<link rel='alternate' type='text/html' href='https://git.rulkc.org/pub/scm/linux/kernel/git/stable/linux.git/commit/?id=d8a121e3d5a503152206bfa1d16d88074b121b2a'/>
<id>urn:sha1:d8a121e3d5a503152206bfa1d16d88074b121b2a</id>
<content type='text'>
The circular-buffers.txt is already in ReST format. So, move it to the
core-api guide, where it belongs.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+samsung@kernel.org&gt;
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;
</content>
</entry>
<entry>
<title>doc: De-emphasize smp_read_barrier_depends</title>
<updated>2017-12-05T19:57:53+00:00</updated>
<author>
<name>Paul E. McKenney</name>
<email>paulmck@linux.vnet.ibm.com</email>
</author>
<published>2017-11-27T17:20:40+00:00</published>
<link rel='alternate' type='text/html' href='https://git.rulkc.org/pub/scm/linux/kernel/git/stable/linux.git/commit/?id=9ad3c143d7d6942c66f27bc6c18f5df638f70aff'/>
<id>urn:sha1:9ad3c143d7d6942c66f27bc6c18f5df638f70aff</id>
<content type='text'>
This commit keeps only the historical and low-level discussion of
smp_read_barrier_depends().

Signed-off-by: Paul E. McKenney &lt;paulmck@linux.vnet.ibm.com&gt;
[ paulmck: Adjusted to allow for David Howells feedback on prior commit. ]
</content>
</entry>
<entry>
<title>circular-buffers.txt: standardize document format</title>
<updated>2017-07-14T19:51:29+00:00</updated>
<author>
<name>Mauro Carvalho Chehab</name>
<email>mchehab@s-opensource.com</email>
</author>
<published>2017-05-14T11:55:25+00:00</published>
<link rel='alternate' type='text/html' href='https://git.rulkc.org/pub/scm/linux/kernel/git/stable/linux.git/commit/?id=f1d8b71c5fefea29ef4ea856e2192c07446e0c98'/>
<id>urn:sha1:f1d8b71c5fefea29ef4ea856e2192c07446e0c98</id>
<content type='text'>
Each text file under Documentation follows a different
format. Some doesn't even have titles!

Change its representation to follow the adopted standard,
using ReST markups for it to be parseable by Sphinx:

- Mark titles with ReST notation;
- comment the contents table;
- Use :Author: tag for authorship;
- mark literal blocks as such;
- use valid numbered list markups;
- Don't capitalize titles.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@s-opensource.com&gt;
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;
</content>
</entry>
<entry>
<title>Documentation: circular-buffers: use READ_ONCE()</title>
<updated>2016-11-16T23:17:45+00:00</updated>
<author>
<name>Mark Rutland</name>
<email>mark.rutland@arm.com</email>
</author>
<published>2016-11-16T11:12:49+00:00</published>
<link rel='alternate' type='text/html' href='https://git.rulkc.org/pub/scm/linux/kernel/git/stable/linux.git/commit/?id=01e4644203b01fba5023784598f4d033e3bd3e28'/>
<id>urn:sha1:01e4644203b01fba5023784598f4d033e3bd3e28</id>
<content type='text'>
While the {READ,WRITE}_ONCE() macros should be used in preference to
ACCESS_ONCE(), the circular buffer documentation uses the latter
exclusively.

To point people in the right direction, and as a step towards the
eventual removal of ACCESS_ONCE(), update the documentation to use
READ_ONCE(), as ACCESS_ONCE() is only used in a reader context in the
circular buffer documentation.

Signed-off-by: Mark Rutland &lt;mark.rutland@arm.com&gt;
Acked-by: David Howells &lt;dhowells@redhat.com&gt;
Acked-by: Paul E. McKenney &lt;paulmck@linux.vnet.ibm.com&gt;
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;
</content>
</entry>
<entry>
<title>documentation: Update circular buffer for load-acquire/store-release</title>
<updated>2013-12-03T18:08:57+00:00</updated>
<author>
<name>Paul E. McKenney</name>
<email>paulmck@linux.vnet.ibm.com</email>
</author>
<published>2013-11-04T19:20:56+00:00</published>
<link rel='alternate' type='text/html' href='https://git.rulkc.org/pub/scm/linux/kernel/git/stable/linux.git/commit/?id=6c43c091bdc56b8cab888cfa6b0ee9effb5fc255'/>
<id>urn:sha1:6c43c091bdc56b8cab888cfa6b0ee9effb5fc255</id>
<content type='text'>
This commit replaces full barriers by targeted use of load-acquire and
store-release.

Signed-off-by: Paul E. McKenney &lt;paulmck@linux.vnet.ibm.com&gt;
[ paulmck: Restore comments as suggested by David Howells. ]
</content>
</entry>
<entry>
<title>documentation: Fix circular-buffer example.</title>
<updated>2013-12-03T18:08:56+00:00</updated>
<author>
<name>Paul E. McKenney</name>
<email>paulmck@linux.vnet.ibm.com</email>
</author>
<published>2013-11-02T17:17:52+00:00</published>
<link rel='alternate' type='text/html' href='https://git.rulkc.org/pub/scm/linux/kernel/git/stable/linux.git/commit/?id=9873552fc1b01ef9bddc9fec4c492d9fa8b27f51'/>
<id>urn:sha1:9873552fc1b01ef9bddc9fec4c492d9fa8b27f51</id>
<content type='text'>
The code sample in Documentation/circular-buffers.txt appears to have a
few ordering bugs.  This patch therefore applies the needed fixes.

Reported-by: Lech Fomicki &lt;lfomicki@poczta.fm&gt;
Signed-off-by: Paul E. McKenney &lt;paulmck@linux.vnet.ibm.com&gt;
</content>
</entry>
<entry>
<title>Document Linux's circular buffering capabilities</title>
<updated>2010-03-24T23:31:22+00:00</updated>
<author>
<name>David Howells</name>
<email>dhowells@redhat.com</email>
</author>
<published>2010-03-24T09:43:00+00:00</published>
<link rel='alternate' type='text/html' href='https://git.rulkc.org/pub/scm/linux/kernel/git/stable/linux.git/commit/?id=90fddabf5818367c6bd1fe1b256a10e01827862f'/>
<id>urn:sha1:90fddabf5818367c6bd1fe1b256a10e01827862f</id>
<content type='text'>
Document the circular buffering capabilities available in Linux.

Signed-off-by: David Howells &lt;dhowells@redhat.com&gt;
Signed-off-by: Paul E. McKenney &lt;paulmck@linux.vnet.ibm.com&gt;
Reviewed-by: Randy Dunlap &lt;rdunlap@xenotime.net&gt;
Reviewed-by: Stefan Richter &lt;stefanr@s5r6.in-berlin.de&gt;
Signed-off-by: Linus Torvalds &lt;torvalds@linux-foundation.org&gt;
</content>
</entry>
</feed>
