Merge branch 'master' of https://git.maemo.org/projects/findit into mosfet/master

diff --combined src/findit.py
index 9204f65,c04b5d2..a286fca
--- 1/src/findit.py
--- 2/src/findit.py
+++ b/src/findit.py
@@@ -36,6 -36,7 +36,7 @@@ except IOError
  
  # Функция которая возвращает строку из числа и единиц для столбца "Размер"("Size")
  def size_convert(size):
+     """Return string with file size in b or Kb or Mb or Gb or Tb."""
      for i, unit in enumerate(['%d b', '%.1f Kb', '%.2f Mb', '%.3f Gb', '%.4f Tb']):
          if size < 1024**(i+1):
              return unit % (size/1024.**i)
@@@ -43,6 -44,7 +44,7 @@@
  
  # Функция поставляющая размер файла и путь к нему
  def filegetter(startdir, obj):
+     """Generator of file sizes and paths based on os.walk."""
      # Список игнорируемых каталогов:
      ignore_dirs = ['/dev', '/proc', '/sys', '/mnt']
      # Проходим по всем папкам вглубь от заданного пути
@@@ -73,6 -75,7 +75,7 @@@
  
  # Fullscreen
  def toggle_fullscreen(obj):
+     """Switch fullscreen on/off."""
      if obj.fullscreen:
          obj.window.unfullscreen()
      else: 
@@@ -81,13 -84,18 +84,18 @@@
  
  # Нажатие на кнопку клавиатуры
  def on_key_press(obj, event):
+     """Key press callback."""
+     # Toggle fullscreen on Maemo when hw key is pressed
      if hildonFound and event.keyval == gtk.keysyms.F6:
          toggle_fullscreen(obj)
  
  ### Properties dialog ##########################################################
  
  class PropertiesDialog(gtk.Dialog):
+     """File property dialog window."""
+ 
      def __init__(self, path, size, bytesize):
+         """Create&show file properties dialog."""
          gtk.Dialog.__init__(self)
          self.set_title( _('File properties') )
          self.set_transient_for(app)
@@@ -140,9 -148,11 +148,11 @@@
  ### Main window ################################################################
  
  class MainWindow(gtk.Window):
+     """Main window class."""
  
      # Окно сообщения заданного типа с заданным текстом
      def mess_window(self, mestype, content):
+         """Show popup message window."""
          dialog = gtk.MessageDialog(parent=self, flags=gtk.DIALOG_MODAL,
                                     type=mestype, buttons=gtk.BUTTONS_OK,
                                     message_format=content)
@@@ -153,6 -163,7 +163,7 @@@
  
      # Функция выполняющаяся при нажатии на кнопку "Показать"
      def start_print(self, widget):
+         """Start file search. Button "Go" activate callback."""         
          self.start_path = self.srch_p_entr.get_text()
          # Проверяем правильное ли значение введено
          if isdir(self.start_path):
@@@ -187,10 -198,12 +198,12 @@@
  
      # Функция выполняющаяся при нажатии на кнопку "Стоп"
      def stop_print(self, widget):
+         """Stop search. "Stop" button clicked callback."""
          self.stopit = True
  
      # Функция выполняющаяся при нажатии на кнопку "Свойства файла"
      def show_properties_dialog(self, *args):
+         """Show property dialog window."""
          selection = self.treeview.get_selection()
          (model, it) = selection.get_selected()
          try:
@@@ -205,6 -218,7 +218,7 @@@
      ### Window initialization ##################################################
  
      def __init__(self, win_width, win_height, st_path):
+         """Create MainWindow."""
          # Создаем новое окно
          gtk.Window.__init__(self)
          self.set_default_size(win_width, win_height)
@@@ -301,33 -315,6 +315,33 @@@
          currFileFrm = gtk.Frame()
          currFileFrm.add(self.currFileLbl)
  
 +        # 7 Меню
 +        if not hildonFound:
 +            menubar = gtk.MenuBar()
 +    
 +            menubaritem0 = gtk.MenuItem('menubaritem0')
 +            menu0 = gtk.Menu()
 +            menuitem00 = gtk.MenuItem('item00')
 +            menuitem01 = gtk.MenuItem('item01')
 +            menuitem02 = gtk.MenuItem('item02')
 +            menu0.add(menuitem00)
 +            menu0.add(menuitem01)
 +            menu0.add(menuitem02)
 +            menubaritem0.set_submenu(menu0)
 +    
 +            menubaritem1 = gtk.MenuItem('menubaritem1')
 +            menu1 = gtk.Menu()
 +            menuitem10 = gtk.MenuItem('item10')
 +            menuitem11 = gtk.MenuItem('item11')
 +            menuitem12 = gtk.MenuItem('item12')
 +            menu1.add(menuitem10)
 +            menu1.add(menuitem11)
 +            menu1.add(menuitem12)
 +            menubaritem1.set_submenu(menu1)
 +    
 +            menubar.add(menubaritem0)
 +            menubar.add(menubaritem1)
 +
          #########  Упаковываем элементы ################
          # Создаем основной вертикальный контейнер
          main_Vbox = gtk.VBox(False, 4)
@@@ -343,7 -330,6 +357,7 @@@
          hbox1.pack_start(self.propertiesBtn, True, True, 0)
  
          # Добавляем элементы в основной контейнер
 +        main_Vbox.pack_start(menubar, False, False, 0)
          main_Vbox.pack_start(self.srch_p_entr, False, False, 0)
          main_Vbox.pack_start(hbox1, False, False, 0)
          scrollwind.add(self.treeview)
@@@ -353,6 -339,7 +367,7 @@@
          self.add(main_Vbox)
  
      def run(self):
+         """Show all widgets and run gtk.main()."""
          self.show_all()
          gtk.main()