Add a warning about tag processing in the standardlayout file

1 files changed, 11 insertions, 0 deletions

diff --git a/samples/standardlayout.rules b/samples/standardlayout.rules
index b5e102f..bf3a6f8 100644
--- a/samples/standardlayout.rules
+++ b/samples/standardlayout.rules
@@ -20,6 +20,17 @@ match /branches/([^/]+)/
   branch \1
 end match
 
+# Important:
+# Subversion doesn't understand the Git concept of tags
+# In Subversion, tags are really branches
+#
+# Only a post-processing (i.e., after converting to Git) of the tag
+# branches can we be sure that a tag wasn't moved or changed from the
+# branch it was copied from
+#
+# This rule will create tags that don't exist in any of the
+# branches. It's not what you want.
+# See the merged-branches-tags.rules file
 match /tags/([^/]+)/
   repository myproject
   branch refs/tags/\1