Re: git-fast-import

From: Linus Torvalds <torvalds@linux-foundation.org>
Date: Feb 6, 2007, 17:24 UTC
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:

Show 9 quoted lines

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