[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <alpine.LFD.0.999.0708271009270.25853@woody.linux-foundation.org>
Date:	Mon, 27 Aug 2007 10:20:49 -0700 (PDT)
From:	Linus Torvalds <torvalds@...ux-foundation.org>
To:	Hugh Dickins <hugh@...itas.com>
cc:	Andrew Morton <akpm@...ux-foundation.org>,
	Len Brown <len.brown@...el.com>, Andi Kleen <ak@...e.de>,
	Rusty Russell <rusty@...tcorp.com.au>,
	linux-kernel@...r.kernel.org
Subject: Re: [PATCH] fix maxcpus=N parsing
On Mon, 27 Aug 2007, Hugh Dickins wrote:
>
> Fix 61ec7567db103d537329b0db9a887db570431ff4: maxcpus=N is now having no
> ...
On a totally unrelated issue:
While looking at the history in gitk and gitweb etc shows these commit 
ID's as nice hyperlinks, I really think it's nicer for everybody if the 
commit is also described with its "headline", so that non-git users (or 
even git users, when just using "git log" or similar) at least can grep or 
google for it.
So when writing descriptions, I would prefer it if people wrote them 
something like
   Commit 61ec7567db103d537329b0db9a887db570431ff4 ('ACPI: boot correctly 
   with "nosmp" or "maxcpus=0"') broke maxcpus parsing on x86[-64] ...
so that it gets both the exact commit naming and the nice hyperlinks where 
appropriate *and* it ends up being more useful even without the links.
Yes, it's redundant information, but since we have the useful one-line 
descriptions, it's generally a good idea. And I really do think that it 
tends to make the explanations read better too.
For example, in this example, I think it really made it more clear what 
kind of change had caused the breakage. Maybe that's not always true, but 
I suspect it's true most of the time.
I'll fix it up manually (I often do), but I thought I'd just mention this 
stylistic issue.
		Linus
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/
Powered by blists - more mailing lists
 
