# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1516297055 -3600
# Node ID 057166b8e8138fdf9a3ec8a3c3d26cb531d5a96c
# Parent  a646c10067e6c37c734e3c2112ef082551bbe57d
Removed superfluous parameter and expanded the documentation.

diff -r a646c10067e6 -r 057166b8e813 imiptools/handlers/common.py
--- a/imiptools/handlers/common.py	Thu Jan 18 16:38:23 2018 +0100
+++ b/imiptools/handlers/common.py	Thu Jan 18 18:37:35 2018 +0100
@@ -3,7 +3,7 @@
 """
 Common handler functionality for different entities.
 
-Copyright (C) 2014, 2015, 2016, 2017 Paul Boddie <paul@boddie.org.uk>
+Copyright (C) 2014, 2015, 2016, 2017, 2018 Paul Boddie <paul@boddie.org.uk>
 
 This program is free software; you can redistribute it and/or modify it under
 the terms of the GNU General Public License as published by the Free Software
@@ -155,11 +155,15 @@
 
         return not obj and self.is_recurrence()
 
-    def make_separate_occurrence(self, for_organiser=False):
+    def make_separate_occurrence(self):
 
         """
         Set the current object as a separate occurrence and redefine free/busy
-        records in terms of this new occurrence for other participants.
+        records in terms of this new occurrence for other participants. This
+        really only makes sense when receiving a new recurrence from an attendee
+        whose details are then to be combined with the general event details for
+        other participants, for whom the attendee responsible for the recurrence
+        cannot specify attendance.
         """
 
         parent = self.get_parent_object()
diff -r a646c10067e6 -r 057166b8e813 imiptools/handlers/person.py
--- a/imiptools/handlers/person.py	Thu Jan 18 16:38:23 2018 +0100
+++ b/imiptools/handlers/person.py	Thu Jan 18 18:37:35 2018 +0100
@@ -214,7 +214,7 @@
         # attendance information transferred, and the free/busy details updated.
 
         if self.is_newly_separated_occurrence():
-            if self.make_separate_occurrence(for_organiser=True):
+            if self.make_separate_occurrence():
 
                 # Update free/busy details for the event.