From abbd8a43c6f9f929804bc38da1989c1512b725a9 Mon Sep 17 00:00:00 2001
From: Rafael Ortiz <dirakx@gmail.com>
Date: Mon, 11 Mar 2013 17:20:20 +0000
Subject: various comments

---
diff --git a/GetIABooksActivity.py b/GetIABooksActivity.py
index 133fdb9..9859a48 100644
--- a/GetIABooksActivity.py
+++ b/GetIABooksActivity.py
@@ -16,6 +16,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program; if not, write to the Free Software
 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+
 import os
 import logging
 import time
@@ -652,7 +653,8 @@ class GetIABooksActivity(activity.Activity):
             self.queryresults.cancel()
             self.queryresults = None
         return True
-
+    
+    # selection callback
     def selection_cb(self, widget):
         # Testing...
         selected_book = self.listview.get_selected_book()
@@ -854,7 +856,8 @@ class GetIABooksActivity(activity.Activity):
             self.show_message(_('Performing lookup, please wait...'))
             self.get_window().set_cursor(Gdk.Cursor(Gdk.CursorType.WATCH))
             self.queryresults.connect('updated', self.__query_updated_cb)
-
+    
+    # Query updated
     def __query_updated_cb(self, query, midway):
         self.listview.populate(self.queryresults)
         if 'bozo_exception' in self.queryresults._feedobj:
@@ -891,6 +894,7 @@ class GetIABooksActivity(activity.Activity):
         self.get_window().set_cursor(None)
         self._allow_suspend()
 
+    # catalogs updated
     def catalogs_updated(self, query, midway):
         self.catalogs = {}
         i = 0
@@ -937,6 +941,7 @@ class GetIABooksActivity(activity.Activity):
         else:
             self.catalog_history.pop()
 
+    # Source changed
     def __source_changed_cb(self, widget):
         search_terms = self.get_search_terms()
         if search_terms == '':
@@ -986,12 +991,14 @@ class GetIABooksActivity(activity.Activity):
             self._books_toolbar.search_entry.set_sensitive(True)
             logging.debug('Download was canceled by the user.')
             self._allow_suspend()
-
+    
+    # getting book
     def get_book(self):
         self.enable_button(False)
         self.progressbox.show_all()
         GObject.idle_add(self.download_book, self.download_url)
-
+    
+    # downloading book
     def download_book(self,  url):
         self._inhibit_suspend()
         logging.error('DOWNLOAD BOOK %s', url)
@@ -1012,7 +1019,8 @@ class GetIABooksActivity(activity.Activity):
 
         self._download_content_length = self._getter.get_content_length()
         self._download_content_type = self._getter.get_content_type()
-
+    
+    # getting book result callback
     def _get_book_result_cb(self, getter, tempfile, suggested_name):
         self.listview.props.sensitive = True
         self._books_toolbar.search_entry.set_sensitive(True)
@@ -1022,6 +1030,7 @@ class GetIABooksActivity(activity.Activity):
             return
         self.process_downloaded_book(tempfile,  suggested_name)
 
+    # get book progress callback
     def _get_book_progress_cb(self, getter, bytes_downloaded):
         if self._download_content_length > 0:
             logging.debug("Downloaded %u of %u bytes...",
@@ -1034,6 +1043,7 @@ class GetIABooksActivity(activity.Activity):
         while Gtk.events_pending():
             Gtk.main_iteration()
 
+    # get book error callback
     def _get_book_error_cb(self, getter, err):
         self.listview.props.sensitive = True
         self.enable_button(True)
@@ -1069,6 +1079,7 @@ class GetIABooksActivity(activity.Activity):
         self._getter = None
         self._allow_suspend()
 
+    # creating journal entry
     def create_journal_entry(self,  tempfile):
         journal_entry = datastore.create()
         journal_title = self.selected_title
@@ -1135,7 +1146,8 @@ class GetIABooksActivity(activity.Activity):
         if response_id is Gtk.ResponseType.APPLY:
             activity.show_object_in_journal(self._object_id)
         self.remove_alert(alert)
-
+    
+    # obtaining image preview 
     def _get_preview_image_buffer(self):
         preview_width, preview_height = style.zoom(300), style.zoom(225)
 
--
cgit v0.9.1