<feed xmlns='http://www.w3.org/2005/Atom'>
<title>linux/Documentation/CodingStyle, branch v3.2.41</title>
<subtitle>Linux kernel source tree</subtitle>
<id>https://git.amat.us/linux/atom/Documentation/CodingStyle?h=v3.2.41</id>
<link rel='self' href='https://git.amat.us/linux/atom/Documentation/CodingStyle?h=v3.2.41'/>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/'/>
<updated>2011-11-04T19:01:47Z</updated>
<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>
<entry>
<title>fix emacs indenting howto filename expansion</title>
<updated>2009-01-30T02:19:29Z</updated>
<author>
<name>Dan Carpenter</name>
<email>error27@gmail.com</email>
</author>
<published>2009-01-30T00:28:28Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=70221395ba980392ba98c1d78f6c9f77be03df9e'/>
<id>urn:sha1:70221395ba980392ba98c1d78f6c9f77be03df9e</id>
<content type='text'>
I don't think emacs understands tilde expansion, so use
"expand-file-name" to do that.

Signed-off-by: Dan Carpenter &lt;error27@gmail.com&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: update CodingStyle tips for Emacs users</title>
<updated>2009-01-30T02:19:29Z</updated>
<author>
<name>Teemu Likonen</name>
<email>tlikonen@iki.fi</email>
</author>
<published>2009-01-30T00:28:16Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=0acbc6c651911dc9ffb4f59b34306bc1ccb751e5'/>
<id>urn:sha1:0acbc6c651911dc9ffb4f59b34306bc1ccb751e5</id>
<content type='text'>
With the previous Emacs tips example the kernel style was made available
for files in the kernel-tree only. This patch updates the tip to add a
separate cc-mode indent style ("linux-tabs-only"). This makes it easy to
switch between different indent styles and also makes the kernel style
easily available for any filetype mode (c++, awk, ...) that is managed
by the Emacs cc-mode.

Signed-off-by: Teemu Likonen &lt;tlikonen@iki.fi&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: update CodingStyle tips for Emacs users</title>
<updated>2008-07-25T17:53:29Z</updated>
<author>
<name>Johannes Weiner</name>
<email>hannes@saeurebad.de</email>
</author>
<published>2008-07-25T08:45:51Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=a7f371e54fac49ff62bb640d4a7276fca01527e8'/>
<id>urn:sha1:a7f371e54fac49ff62bb640d4a7276fca01527e8</id>
<content type='text'>
Describe a setup that integrates better with Emacs' cc-mode and also fixes
up the alignment of continuation lines to really only use tabs.

Signed-off-by: Johannes Weiner &lt;hannes@saeurebad.de&gt;
Cc: Jonathan Corbet &lt;corbet@lwn.net&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>CodingStyle: relax the 80-cole rule</title>
<updated>2007-10-17T15:42:55Z</updated>
<author>
<name>Alan Cox</name>
<email>alan@lxorguk.ukuu.org.uk</email>
</author>
<published>2007-10-17T06:27:33Z</published>
<link rel='alternate' type='text/html' href='https://git.amat.us/linux/commit/?id=dff4982f5cd4e30e2a140a3bca95d8814115bf5b'/>
<id>urn:sha1:dff4982f5cd4e30e2a140a3bca95d8814115bf5b</id>
<content type='text'>
I would suggest this change to make CodingStyle properly reflect the style
used by the kernel, rather than the current wording which is wishful
thinking and misleading, and comes from the same school of thought that
gets off on prescriptive grammar, latin and comp.std.c

Signed-off-by: Alan Cox &lt;alan@redhat.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>
</feed>
