<feed xmlns='http://www.w3.org/2005/Atom'>
<title>linux/Documentation/CodingStyle, branch v3.9</title>
<subtitle>Linux kernel source tree</subtitle>
<id>https://git.amat.us/linux/atom/Documentation/CodingStyle?h=v3.9</id>
<link rel='self' href='https://git.amat.us/linux/atom/Documentation/CodingStyle?h=v3.9'/>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/'/>
<updated>2013-01-11T19:38:03Z</updated>
<entry>
<title>Documentation: remove depends on CONFIG_EXPERIMENTAL</title>
<updated>2013-01-11T19:38:03Z</updated>
<author>
<name>Kees Cook</name>
<email>keescook@chromium.org</email>
</author>
<published>2012-10-02T18:16:15Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=0335cb469ad4ab3072a4246ceb0573483fcee5bf'/>
<id>urn:sha1:0335cb469ad4ab3072a4246ceb0573483fcee5bf</id>
<content type='text'>
The CONFIG_EXPERIMENTAL config item has not carried much meaning for a
while now and is almost always enabled by default. As agreed during the
Linux kernel summit, remove it from any "depends on" lines in Kconfigs.

CC: Rob Landley &lt;rob@landley.net&gt;
CC: Jiri Kosina &lt;jkosina@suse.cz&gt;
CC: Masanari Iida &lt;standby24x7@gmail.com&gt;
CC: Jason Wessel &lt;jason.wessel@windriver.com&gt;
CC: Richard L Maliszewski &lt;richard.l.maliszewski@intel.com&gt;
CC: Gang Wei &lt;gang.wei@intel.com&gt;
CC: Shane Wang &lt;shane.wang@intel.com&gt;
CC: Harry Wei &lt;harryxiyou@gmail.com&gt;
Signed-off-by: Kees Cook &lt;keescook@chromium.org&gt;
Acked-by: Jason Wessel &lt;jason.wessel@windriver.com&gt;
</content>
</entry>
<entry>
<title>CodingStyle: add networking specific block comment style</title>
<updated>2012-10-05T18:04:59Z</updated>
<author>
<name>Joe Perches</name>
<email>joe@perches.com</email>
</author>
<published>2012-10-05T00:13:36Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=c4ff1b5f8bf09d77d7329cbff224f0237646c90e'/>
<id>urn:sha1:c4ff1b5f8bf09d77d7329cbff224f0237646c90e</id>
<content type='text'>
The block comment style in net/ and drivers/net is non-standard.
Document it.

Signed-off-by: Joe Perches &lt;joe@perches.com&gt;
Cc: "Allan, Bruce W" &lt;bruce.w.allan@intel.com&gt;
Cc: Andy Whitcroft &lt;apw@canonical.com&gt;
Cc: David Miller &lt;davem@davemloft.net&gt;
Signed-off-by: Andrew Morton &lt;akpm@linux-foundation.org&gt;
Signed-off-by: Linus Torvalds &lt;torvalds@linux-foundation.org&gt;
</content>
</entry>
<entry>
<title>CodingStyle: add kmalloc_array() to memory allocators</title>
<updated>2012-06-01T00:49:26Z</updated>
<author>
<name>Xi Wang</name>
<email>xi.wang@gmail.com</email>
</author>
<published>2012-05-31T23:26:04Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=15837294d4ce717f69942f7366e99d4d1d3d9923'/>
<id>urn:sha1:15837294d4ce717f69942f7366e99d4d1d3d9923</id>
<content type='text'>
Add the new kmalloc_array() to the list of general-purpose memory
allocators in chapter 14.

Signed-off-by: Xi Wang &lt;xi.wang@gmail.com&gt;
Acked-by: Jesper Juhl &lt;jj@chaosbits.net&gt;
Acked-by: Pekka Enberg &lt;penberg@kernel.org&gt;
Signed-off-by: Andrew Morton &lt;akpm@linux-foundation.org&gt;
Signed-off-by: Linus Torvalds &lt;torvalds@linux-foundation.org&gt;
</content>
</entry>
<entry>
<title>Documentation: CodingStyle: add inline assembly guidelines</title>
<updated>2012-03-30T23:03:15Z</updated>
<author>
<name>Josh Triplett</name>
<email>josh@joshtriplett.org</email>
</author>
<published>2012-03-30T20:37:10Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=9a7c48b7c3d58835b3a91d86c55e0ae77d15ddd5'/>
<id>urn:sha1:9a7c48b7c3d58835b3a91d86c55e0ae77d15ddd5</id>
<content type='text'>
Signed-off-by: Josh Triplett &lt;josh@joshtriplett.org&gt;
Signed-off-by: Randy Dunlap &lt;rdunlap@xenotime.net&gt;
Signed-off-by: Linus Torvalds &lt;torvalds@linux-foundation.org&gt;
</content>
</entry>
<entry>
<title>Documentation: update CodingStyle use of braces</title>
<updated>2011-11-04T19:01:47Z</updated>
<author>
<name>Antonio Ospite</name>
<email>ospite@studenti.unina.it</email>
</author>
<published>2011-11-04T18:22:19Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=b218ab0a5af943441e1daa7dc811874ecd409229'/>
<id>urn:sha1:b218ab0a5af943441e1daa7dc811874ecd409229</id>
<content type='text'>
After commit 38829dc9d7b4 ("Documentation/CodingStyle: flesh out if-else
examples") highlight that if _only_one_ branch of a conditional
statement is a single statement, then braces are to be used on both
branches.

Signed-off-by: Antonio Ospite &lt;ospite@studenti.unina.it&gt;
Signed-off-by: Randy Dunlap &lt;rdunlap@xenotime.net&gt;
Signed-off-by: Linus Torvalds &lt;torvalds@linux-foundation.org&gt;
</content>
</entry>
<entry>
<title>CodingStyle: Document the exception of not splitting user-visible strings, for grepping</title>
<updated>2011-08-06T18:59:07Z</updated>
<author>
<name>Josh Triplett</name>
<email>josh@joshtriplett.org</email>
</author>
<published>2011-08-03T19:19:07Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=6f76b6fcaa6025bc9b2c00e055c7ccd39730568d'/>
<id>urn:sha1:6f76b6fcaa6025bc9b2c00e055c7ccd39730568d</id>
<content type='text'>
Patch reviewers now recommend not splitting long user-visible strings,
such as printk messages, even if they exceed 80 columns.  This avoids
breaking grep.  However, that recommendation did not actually appear
anywhere in Documentation/CodingStyle.

See, for example, the thread at
  http://news.gmane.org/find-root.php?message_id=%3c1312215262.11635.15.camel%40Joe%2dLaptop%3e

Signed-off-by: Josh Triplett &lt;josh@joshtriplett.org&gt;
Signed-off-by: Linus Torvalds &lt;torvalds@linux-foundation.org&gt;
</content>
</entry>
<entry>
<title>Documentation: update CodingStyle memory allocators</title>
<updated>2011-07-06T20:17:51Z</updated>
<author>
<name>Jesper Juhl</name>
<email>jj@chaosbits.net</email>
</author>
<published>2011-07-06T18:27:17Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=316b3799880c55bb20f6d2db904245eccc30e25f'/>
<id>urn:sha1:316b3799880c55bb20f6d2db904245eccc30e25f</id>
<content type='text'>
The list of available general purpose memory allocators in
Documentation/CodingStyle chapter 14 is incomplete. This patch adds
the missing vzalloc() to the list.

Signed-off-by: Jesper Juhl &lt;jj@chaosbits.net&gt;
Signed-off-by: Randy Dunlap &lt;randy.dunlap@oracle.com&gt;
Signed-off-by: Linus Torvalds &lt;torvalds@linux-foundation.org&gt;
</content>
</entry>
<entry>
<title>Documentation/CodingStyle: flesh out if-else examples</title>
<updated>2011-03-23T00:44:16Z</updated>
<author>
<name>Harry Wei</name>
<email>jiaweiwei.xiyou@gmail.com</email>
</author>
<published>2011-03-22T23:35:01Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=38829dc9d7b46b195ab99d62c8c53c21a7adc36b'/>
<id>urn:sha1:38829dc9d7b46b195ab99d62c8c53c21a7adc36b</id>
<content type='text'>
There is a missing case for "Chapter 3: Placing Braces and Spaces".  We
often know we should not use braces where a single statement.  The first
case is:

	if (condition)
		action();

Another case is:

	if (condition)
		do_this();
	else
		do_that();

However, I can not find a description of the second case.

Signed-off-by: Harry Wei &lt;harryxiyou@gmail.com&gt;
Cc: Randy Dunlap &lt;randy.dunlap@oracle.com&gt;
Signed-off-by: Andrew Morton &lt;akpm@linux-foundation.org&gt;
Signed-off-by: Linus Torvalds &lt;torvalds@linux-foundation.org&gt;
</content>
</entry>
<entry>
<title>Documentation: update header filename in CodingStyle</title>
<updated>2011-03-16T17:47:03Z</updated>
<author>
<name>Roland Kammerer</name>
<email>dev.rck@gmail.com</email>
</author>
<published>2011-03-15T23:11:52Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=aa4862c38b179646cea73adae41e0078ba05bb60'/>
<id>urn:sha1:aa4862c38b179646cea73adae41e0078ba05bb60</id>
<content type='text'>
pr_info() and pr_debug() are in linux/printk.h, not linux/kernel.h.
Last updated is unnecessary, we have git for that.

Signed-off-by: Roland Kammerer &lt;dev.rck@gmail.com&gt;
Signed-off-by: Randy Dunlap &lt;randy.dunlap@oracle.com&gt;
Acked-by: Harry Wei &lt;harryxiyou@gmail.com&gt;
Signed-off-by: Linus Torvalds &lt;torvalds@linux-foundation.org&gt;
</content>
</entry>
<entry>
<title>trivial: fix typo milisecond/millisecond for documentation and source comments.</title>
<updated>2009-06-12T16:01:46Z</updated>
<author>
<name>Martin Olsson</name>
<email>martin@minimum.se</email>
</author>
<published>2009-04-23T09:37:37Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=19af5cdb7c79ff5ec96a99893ffb7f894f4a3dc1'/>
<id>urn:sha1:19af5cdb7c79ff5ec96a99893ffb7f894f4a3dc1</id>
<content type='text'>
Signed-off-by: Martin Olsson &lt;martin@minimum.se&gt;
Signed-off-by: Jiri Kosina &lt;jkosina@suse.cz&gt;
</content>
</entry>
</feed>
