From 0f5fdd6d396b9dfb51ffac4251ff90daa4d54a5b Mon Sep 17 00:00:00 2001
From: Markus Unterwaditzer <markus@unterwaditzer.net>
Date: Thu, 20 Nov 2014 13:52:24 +0100
Subject: [PATCH] add comment

---
 vdirsyncer/utils/vobject.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/vdirsyncer/utils/vobject.py b/vdirsyncer/utils/vobject.py
index 0747656..6fdab18 100644
--- a/vdirsyncer/utils/vobject.py
+++ b/vdirsyncer/utils/vobject.py
@@ -95,6 +95,13 @@ class Item(object):
         '''Used for generating hrefs and matching up items during
         synchronization. This is either the UID or the hash of the item's
         content.'''
+
+        # We hash the item instead of directly using its raw content, because
+        #
+        # 1. The raw content might be really large, e.g. when its a contact
+        #    with a picture, which bloats the status file.
+        #
+        # 2. The status file would contain really sensitive information.
         return self.uid or self.hash
 
     @cached_property