[<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