# 
# patch "ChangeLog"
#  from [54073c6fe47f02b9eccaac4f8c10adf34948db2b]
#    to [1efe2fd20e03b742d877907e5faf1bd0577e41b6]
# 
# patch "monotone.texi"
#  from [f14d034d11da26fc318f8f0d47cca3cdd63230b8]
#    to [5eb6b561146529eb7465aaeb8b90284df93a7fec]
# 
========================================================================
--- ChangeLog	54073c6fe47f02b9eccaac4f8c10adf34948db2b
+++ ChangeLog	1efe2fd20e03b742d877907e5faf1bd0577e41b6
@@ -1,3 +1,8 @@
+2005-10-04  Nathaniel Smith  <address@hidden>
+
+	* monotone.texi (Automation): Document the mysterious columns of
+	numbers in 'automate inventory' output format.
+
 2005-10-03  Nathaniel Smith  <address@hidden>
 
 	* monotone.texi (Automation): Clean up formatting and description
========================================================================
--- monotone.texi	f14d034d11da26fc318f8f0d47cca3cdd63230b8
+++ monotone.texi	5eb6b561146529eb7465aaeb8b90284df93a7fec
@@ -5194,6 +5194,34 @@
 'RRM' rename source and target and target missing
 @end verbatim
 
+The two numbers are used to match up the pre-state and post-state of a
+rename.  Imagine a situation where there are two renames.
address@hidden inventory} will print something like:
+
address@hidden
+R   1 0 a
+R   2 0 b
+ R  0 2 c
+ R  0 1 d
address@hidden verbatim
+
+Here the status characters tell us that @file{a} and @file{b} were
+renamed, and we can tell that one was renamed to @file{c} and one was
+renamed to @file{d}, but we can't tell which was renamed to which.  To
+do that, we have to refer to the numbers.  The numbers do not themselves
+mean anything; their only purpose is to let you match up the two
+``ends'' of a rename.  The 1 in the left column by @file{a} means that
address@hidden was the source of a rename, and the 1 in the right column by
address@hidden means that @file{d} was the target of that same rename.
+Similarly, the two 2's tell us that @file{b} was renamed to @file{c}.
+
+There are two columns of numbers because the same file can
+simultaneously be the target and source of a rename.  The number '0' is
+used as a meaningless placeholder in all cases where a file is not a
+source or target of a rename.  Any non-zero number that occurs at all
+will occur exactly once in the first column and exactly once in the
+second column.
+
 Full support for versioned directories is not yet complete and the
 inventory will only list entries for renamed or dropped
 directories.