Luke Plant avatar Luke Plant committed 710b13a

Improved some code comments

Comments (0)

Files changed (1)

cciw/bookings/models.py

         ever be called by the 'process_payments' management command. Client code
         should use the 'send_payment' function.
         """
+        # See process_payments management command for an explanation of the above
+
         # = Receiving payments =
         #
         # This system needs to be robust, and cope with all kinds of user error, and
         # worst, most complicated scenario, and this will then easily handle the more
         # simple case where everything matches up as a special case.
         #
-        # When a payment is received, django-paypal creates an object
-        # and a signal handler calls BookingAccount.receive_payment, which must
-        # update the 'total_received' field.
+        # When a payment is received, django-paypal creates an object and a
+        # signal handler indirectly calls BookingAccount.receive_payment, which
+        # must update the 'total_received' field.
         #
         # We also need to set the 'Booking.booking_expires' field of relevant Booking
         # objects to null, so that the place is securely booked.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.