From: Eric S. Raymond <esr@thyrsus.com>
Date: Wed, 12 Nov 2014 06:31:25 +0000 (-0500)
Subject: Document the timestamps issue.
X-Git-Tag: 0.6~36
X-Git-Url: http://thyrsus.com/gitweb/?a=commitdiff_plain;h=922a3a0baaabb46c4abccf84f3e6014d07d22fb9;p=src.git

Document the timestamps issue.
---

diff --git a/src.asc b/src.asc
index 5f962a9..69a2fe6 100644
--- a/src.asc
+++ b/src.asc
@@ -184,9 +184,15 @@ to support the src fast-import command.
 
 == LIMITATIONS ==
 
-The 'branch' command is not yet implemented; it is described here to
+The 'branch' command is not yet fully implemented; it is described here to
 document the UI design choice.
 
+src uses a trick with utime(2) to make distinguishing between modified
+and unmodified files fast. The trick has flaky failures under ZFS,
+though none have been seen under ext3, ext4, or xfs.  This affects 
+nothing other than 'src status'; when the tricj fails files may
+show as modfied ('M') when they should show as unmodified ('.').
+
 == REPORTING BUGS ==
 
 Report bugs to Eric S. Raymond <esr@thyrsus.com>.  The project page is