Home » Mailing list archives » linux-kernel » 2007 » September » 29

Re: [PATCH] 0/3 coding standards documentation/code updates

!MAILaRCHIVE_VOTE_RePLACE
Previous message: [thread] [date] [author]
Next message: [thread] [date] [author]
[view in full thread]
From: J. Bruce Fields <bfields@...>
To: Linus Torvalds <torvalds@...>
Cc: Erez Zadok <ezk@...>, <akpm@...>, <linux-kernel@...>
Subject: Re: [PATCH] 0/3 coding standards documentation/code updates
Date: Saturday, September 29, 2007 - 3:56 pm

On Sat, Sep 29, 2007 at 11:18:05AM -0700, Linus Torvalds wrote:

It'd be nice to split the current CodingStyle into two documents:

	- A shorter CodingStyle that gives the spirit of the style
	  (short functions, minimal nesting, logic as straightforward as
	  possible, etc.), and addresses the most commonly repeated
	  mistakes, without so much detail that people's eyes glaze
	  over.  You want to be able to recommend it to your students
	  (or whoever) in reasonable confidence that they'll actually
	  read it and have fun (leave the jokes in!).  Currently I'm
	  suspicious that it's becoming something that everybody
	  recommends but noone bothers to sit down and read anymore
	  unless they're working on it.

	- A CodingStyleReference that's just a long dry list of rules,
	  organized to make it easy to look up an individual rule when
	  needed.  That'd also take the pressure of CodingStyle to
	  accept every new detail.

It'd be a start just to revert CodingStyle to its original content and
move the rest to CodingStyleReference.  But someone would want to skim
through the CodingStyle history for any legimate corrections that we
want to keep.

--b.
-
Previous message: [thread] [date] [author]
Next message: [thread] [date] [author]
Messages in current thread:
[PATCH] 0/3 coding standards documentation/code updates, Erez Zadok, (Fri Sep 28, 5:31 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, Linus Torvalds, (Sat Sep 29, 2:18 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, , (Sat Sep 29, 10:24 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, Al Viro, (Sat Sep 29, 11:27 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, , (Sat Sep 29, 11:39 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, Linus Torvalds, (Sat Sep 29, 11:00 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, , (Sat Sep 29, 11:29 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, Theodore Tso, (Sun Sep 30, 1:57 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, Linus Torvalds, (Sat Sep 29, 11:35 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates , Erez Zadok, (Sat Sep 29, 8:23 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates , Linus Torvalds, (Sat Sep 29, 8:49 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates , Erez Zadok, (Sun Sep 30, 12:01 am)
Re: [PATCH] 0/3 coding standards documentation/code updates, Mark Lord, (Sun Sep 30, 1:40 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, Randy Dunlap, (Sun Sep 30, 1:59 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, Robert P. J. Day, (Sat Sep 29, 5:56 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, J. Bruce Fields, (Sat Sep 29, 3:56 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, Theodore Tso, (Sat Sep 29, 10:06 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates , Erez Zadok, (Sat Sep 29, 11:28 pm)
Re: [PATCH] 0/3 coding standards documentation/code updates, Randy Dunlap, (Sat Sep 29, 4:14 pm)
[PATCH 1/3] CodingStyle updates, Erez Zadok, (Fri Sep 28, 5:32 pm)
Re: [PATCH 1/3] CodingStyle updates, Randy Dunlap, (Sat Sep 29, 2:01 pm)
Re: [PATCH 1/3] CodingStyle updates, Sam Ravnborg, (Sat Sep 29, 2:29 pm)
[OT] kbuild syntax extension for ccflags and asflags (was: [..., Ingo Oeser, (Sat Sep 29, 4:21 pm)
Re: [OT] kbuild syntax extension for ccflags and asflags (wa..., Sam Ravnborg, (Sat Sep 29, 4:24 pm)
Re: [PATCH 1/3] CodingStyle updates, Scott Preece, (Sat Sep 29, 11:59 am)
Re: [PATCH 1/3] CodingStyle updates, Shawn Bohrer, (Sat Sep 29, 10:43 am)
Re: [PATCH 1/3] CodingStyle updates, Randy Dunlap, (Fri Sep 28, 5:46 pm)
[PATCH 3/3] New script to check coding-style compliance on m..., Erez Zadok, (Fri Sep 28, 5:32 pm)
Re: [PATCH 3/3] New script to check coding-style compliance ..., Sam Ravnborg, (Sat Sep 29, 6:10 am)
[PATCH 2/3] Update usage string for checkpatch.pl, Erez Zadok, (Fri Sep 28, 5:32 pm)