CINXE.COM

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>LKML: Linus Torvalds: Re: Kernel SCM saga..</title><link href="/css/message.css" rel="stylesheet" type="text/css" /><link href="/css/wrap.css" rel="alternate stylesheet" type="text/css" title="wrap" /><link href="/css/nowrap.css" rel="stylesheet" type="text/css" title="nowrap" /><link href="/favicon.ico" rel="shortcut icon" /><script src="/js/simple-calendar.js" type="text/javascript"></script><script src="/js/styleswitcher.js" type="text/javascript"></script><link rel="alternate" type="application/rss+xml" title="lkml.org : last 100 messages" href="/rss.php" /><link rel="alternate" type="application/rss+xml" title="lkml.org : last messages by Linus Torvalds" href="/groupie.php?aid=1" /><script> var _paq = window._paq = window._paq || []; /* tracker methods like "setCustomDimension" should be called before "trackPageView" */ _paq.push(["setDoNotTrack", true]); _paq.push(["disableCookies"]); _paq.push(['trackPageView']); _paq.push(['enableLinkTracking']); (function() { var u="//m.lkml.org/"; _paq.push(['setTrackerUrl', u+'matomo.php']); _paq.push(['setSiteId', '1']); var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s); })(); </script></head><body onload="es.jasper.simpleCalendar.init();" itemscope="itemscope" itemtype="http://schema.org/BlogPosting"><table border="0" cellpadding="0" cellspacing="0"><tr><td width="180" align="center"><a href="/"><img style="border:0;width:135px;height:32px" src="/images/toprowlk.gif" alt="lkml.org" /></a></td><td width="32">聽</td><td class="nb"><div><a class="nb" href="/lkml"> [lkml]</a> 聽 <a class="nb" href="/lkml/2005"> [2005]</a> 聽 <a class="nb" href="/lkml/2005/4"> [Apr]</a> 聽 <a class="nb" href="/lkml/2005/4/7"> [7]</a> 聽 <a class="nb" href="/lkml/last100"> [last100]</a> 聽 <a href="/rss.php"><img src="/images/rss-or.gif" border="0" alt="RSS Feed" /></a></div><div>Views: <a href="#" class="nowrap" onclick="setActiveStyleSheet('wrap');return false;">[wrap]</a><a href="#" class="wrap" onclick="setActiveStyleSheet('nowrap');return false;">[no wrap]</a> 聽 <a class="nb" href="/lkml/mheaders/2005/4/7/183" onclick="this.href='/lkml/headers'+'/2005/4/7/183';">[headers]</a>聽 <a href="/lkml/bounce/2005/4/7/183">[forward]</a>聽 </div></td><td width="32">聽</td></tr><tr><td valign="top"><div class="es-jasper-simpleCalendar" baseurl="/lkml/"></div><div class="threadlist">Messages in this thread</div><ul class="threadlist"><li class="root"><a href="/lkml/2005/4/6/121">First message in thread</a></li><li><a href="/lkml/2005/4/7/145">Linus Torvalds</a><ul><li><a href="/lkml/2005/4/7/172">Daniel Phillips</a><ul><li class="origin"><a href="/lkml/2005/4/7/186">Linus Torvalds</a><ul><li><a href="/lkml/2005/4/7/186">Chris Wedgwood</a></li><li><a href="/lkml/2005/4/7/193">Magnus Damm</a></li><li><a href="/lkml/2005/4/7/201">Daniel Phillips</a></li><li><a href="/lkml/2005/4/7/323">Jeff Garzik</a></li></ul></li><li><a href="/lkml/2005/4/7/224">Sam Ravnborg</a></li></ul></li><li><a href="/lkml/2005/4/7/272">Dave Airlie</a></li></ul></li></ul></td><td width="32" rowspan="2" class="c" valign="top"><img src="/images/icornerl.gif" width="32" height="32" alt="/" /></td><td class="c" rowspan="2" valign="top" style="padding-top: 1em"><table><tr><td><table><tr><td class="lp">Date</td><td class="rp" itemprop="datePublished">Thu, 7 Apr 2005 10:38:06 -0700 (PDT)</td></tr><tr><td class="lp">From</td><td class="rp" itemprop="author">Linus Torvalds <></td></tr><tr><td class="lp">Subject</td><td class="rp" itemprop="name">Re: Kernel SCM saga..</td></tr></table></td><td></td></tr></table><pre itemprop="articleBody"><br /><br />On Thu, 7 Apr 2005, Daniel Phillips wrote:<br />> <br />> In that case, a nice refinement is to put the sequence number at the end of <br />> the subject line so patch sequences don't interleave:<br /><br />No. That makes it unsortable, and also much harder to pick put which part <br />of the subject line is the explanation, and which part is just metadata <br />for me.<br /><br />So my prefernce is _overwhelmingly_ for the format that Andrew uses (which <br />is partly explained by the fact that I am used to it, but also by the fact <br />that I've asked for Andrew to make trivial changes to match my usage).<br /><br />That canonical format is:<br /><br /> Subject: [PATCH 001/123] [<area>:] <explanation><br /><br />together with the first line of the body being a<br /><br /> From: Original Author <origa@email.com><br /><br />followed by an empty line and then the body of the explanation.<br /><br />After the body of the explanation comes the "Signed-off-by:" lines, and <br />then a simple "---" line, and below that comes the diffstat of the patch <br />and then the patch itself.<br /><br />That's the "canonical email format", and it's that because my normal<br />scripts (in BK/tools, but now I'm working on making them more generic) <br />take input that way. It's very easy to sort the emails alphabetically by<br />subject line - pretty much any email reader will support that - since<br />because the sequence number is zero-padded, the numerical and alphabetic<br />sort is the same.<br /><br />If you send several sequences, you either send a simple explaining email<br />before the second sequence (hey, it's not like I'm a machine - I can use<br />my brains too, and in particular if the final number of patches in each<br />sequence is different, even if the sequences got re-ordered and are<br />overlapping, I can still just extract one from the other by selecting for<br />"/123] " in the subject line), or you modify the Subject: line subtly to<br />still sort uniquely and alphabetically in-order, ie the subject lines for<br />the second series might be<br /><br /> Subject: [PATCHv2 001/207] x86: fix eflags tracking<br /> ...<br /><br />All very unambiguous, and my scripts already remove everything inside the <br />brackets and will just replace it with "[PATCH]" in the final version.<br /><br /> Linus<br />-<br />To unsubscribe from this list: send the line "unsubscribe linux-kernel" in<br />the body of a message to majordomo@vger.kernel.org<br />More majordomo info at <a href="http://vger.kernel.org/majordomo-info.html">http://vger.kernel.org/majordomo-info.html</a><br />Please read the FAQ at <a href="http://www.tux.org/lkml/">http://www.tux.org/lkml/</a><br /><br /></pre></td><td width="32" rowspan="2" class="c" valign="top"><img src="/images/icornerr.gif" width="32" height="32" alt="\" /></td></tr><tr><td align="right" valign="bottom"> 聽 </td></tr><tr><td align="right" valign="bottom">聽</td><td class="c" valign="bottom" style="padding-bottom: 0px"><img src="/images/bcornerl.gif" width="32" height="32" alt="\" /></td><td class="c">聽</td><td class="c" valign="bottom" style="padding-bottom: 0px"><img src="/images/bcornerr.gif" width="32" height="32" alt="/" /></td></tr><tr><td align="right" valign="top" colspan="2"> 聽 </td><td class="lm">Last update: 2009-11-18 23:46 聽聽 [from the cache]<br />漏2003-2020 <a href="http://blog.jasper.es/"><span itemprop="editor">Jasper Spaans</span></a>|hosted at <a href="https://www.digitalocean.com/?refcode=9a8e99d24cf9">Digital Ocean</a> and my Meterkast|<a href="http://blog.jasper.es/categories.html#lkml-ref">Read the blog</a></td><td>聽</td></tr></table><script language="javascript" src="/js/styleswitcher.js" type="text/javascript"></script></body></html>