From: Linus Torvalds <torvalds@linux-foundation.org>
Date: Tue, 06 Feb 2007 17:24:51 GMT
Subject: Re: git-fast-import
Message-ID: <Pine.LNX.4.64.0702060921260.8424@woody.linux-foundation.org>
In-Reply-To: <20070206164441.GA4949@spearce.org>



On Tue, 6 Feb 2007, Shawn O. Pearce wrote:
> 
> What about this language?
> 
> 	The time of the change is specified by `<time>` as the number of
> 	seconds since the UNIX epoc (midnight, Jan 1, 1970, UTC) and is
> 	written in base-10 notation using US-ASCII digits.  The committer's
> 	timezone is specified by `<tz>` as a positive or negative offset
> 	from UTC.  For example EST (which is typically 5 hours behind GMT)
> 	would be expressed in `<tz>` by ``-0500'' while GMT is ``+0000''.

I doubt it would confuse anybody. Although usually we'd not say

	"in base-10 notation using US-ASCII digits"

the normal way to do that is to just saying "as an ASCII decimal integer".

Sure, people could try to do "10,200,300" and claim it's "decimal 
integer", but at that point, you can just tell them they're crazy, and 
ignore them ;)

But your text certainly isn't wrong. I just think it overspecifies a bit, 
at the expense of readability.

		Linus