src/eric7/Plugins/VcsPlugins/vcsPySvn/SvnStatusDialog.py

branch
eric7
changeset 10438
4cd7e5a8b3cf
parent 9653
e67609152c5e
child 10439
21c28b0f9e41
--- a/src/eric7/Plugins/VcsPlugins/vcsPySvn/SvnStatusDialog.py	Fri Dec 22 19:45:17 2023 +0100
+++ b/src/eric7/Plugins/VcsPlugins/vcsPySvn/SvnStatusDialog.py	Sat Dec 23 15:40:23 2023 +0100
@@ -45,7 +45,9 @@
         Constructor
 
         @param vcs reference to the vcs object
-        @param parent parent widget (QWidget)
+        @type Subversion
+        @param parent parent widget
+        @type QWidget
         """
         super().__init__(parent)
         self.setupUi(self)
@@ -234,18 +236,30 @@
         """
         Private method to generate a status item in the status list.
 
-        @param changelist name of the changelist (string)
-        @param status text status (pysvn.wc_status_kind)
-        @param propStatus property status (pysvn.wc_status_kind)
-        @param locked locked flag (boolean)
-        @param history history flag (boolean)
-        @param switched switched flag (boolean)
-        @param lockinfo lock indicator (string)
-        @param uptodate up to date flag (boolean)
-        @param revision revision (integer)
-        @param change revision of last change (integer)
-        @param author author of the last change (string)
-        @param path path of the file or directory (string)
+        @param changelist name of the changelist
+        @type str
+        @param status text status
+        @type pysvn.wc_status_kind
+        @param propStatus property status
+        @type pysvn.wc_status_kind
+        @param locked locked flag
+        @type bool
+        @param history history flag
+        @type bool
+        @param switched switched flag
+        @type bool
+        @param lockinfo lock indicator
+        @type str
+        @param uptodate up to date flag
+        @type bool
+        @param revision revision
+        @type int
+        @param change revision of last change
+        @type int
+        @param author author of the last change
+        @type str
+        @param path path of the file or directory
+        @type str
         """
         statusText = self.tr(svnStatusMap[status])
         itm = QTreeWidgetItem(self.statusList)
@@ -298,7 +312,7 @@
         Public slot to start the svn status command.
 
         @param fn filename(s)/directoryname(s) to show the status of
-            (string or list of strings)
+        @type str or list of str
         """
         self.errorGroup.hide()
 
@@ -352,7 +366,7 @@
             try:
                 with EricMutexLocker(self.vcs.vcsExecutionMutex):
                     for name in fnames:
-                        # step 1: determine changelists and their files
+                        # step 1: determine change lists and their files
                         changelistsDict = {}
                         if hasattr(self.client, "get_changelist"):
                             if recurse:
@@ -503,7 +517,8 @@
         """
         Private slot called by a button of the button box clicked.
 
-        @param button button that was clicked (QAbstractButton)
+        @param button button that was clicked
+        @type QAbstractButton
         """
         if button == self.buttonBox.button(QDialogButtonBox.StandardButton.Close):
             self.close()
@@ -523,7 +538,8 @@
         """
         Private slot to show an error message.
 
-        @param msg error message to show (string)
+        @param msg error message to show
+        @type str
         """
         self.errorGroup.show()
         self.errors.insertPlainText(msg)
@@ -573,8 +589,10 @@
         """
         Private slot to act upon item changes.
 
-        @param item reference to the changed item (QTreeWidgetItem)
-        @param column index of column that changed (integer)
+        @param item reference to the changed item
+        @type QTreeWidgetItem
+        @param column index of column that changed
+        @type int
         """
         if column == self.__toBeCommittedColumn:
             self.__updateCommitButton()
@@ -636,7 +654,8 @@
         """
         Private slot to show the context menu of the status list.
 
-        @param coord the position of the mouse pointer (QPoint)
+        @param coord the position of the mouse pointer
+        @type QPoint
         """
         self.menu.popup(self.statusList.mapToGlobal(coord))
 
@@ -903,7 +922,7 @@
 
     def __removeFromChangelist(self):
         """
-        Private slot to remove entries from their changelists.
+        Private slot to remove entries from their change lists.
         """
         names = [
             os.path.join(self.dname, itm.text(self.__pathColumn))
@@ -927,6 +946,7 @@
         Private method to retrieve all entries the user wants to commit.
 
         @return list of all items, the user has checked
+        @rtype list of QTreeWidgetItem
         """
         commitableItems = []
         for index in range(self.statusList.topLevelItemCount()):
@@ -940,6 +960,7 @@
         Private method to retrieve all entries, that have a modified status.
 
         @return list of all items with a modified status
+        @rtype list of QTreeWidgetItem
         """
         modifiedItems = []
         for itm in self.statusList.selectedItems():
@@ -956,6 +977,7 @@
         unversioned status.
 
         @return list of all items with an unversioned status
+        @rtype list of QTreeWidgetItem
         """
         unversionedItems = []
         for itm in self.statusList.selectedItems():
@@ -968,6 +990,7 @@
         Private method to retrieve all entries, that have a missing status.
 
         @return list of all items with a missing status
+        @rtype list of QTreeWidgetItem
         """
         missingItems = []
         for itm in self.statusList.selectedItems():
@@ -979,8 +1002,10 @@
         """
         Private method to retrieve all entries, that have a locked status.
 
-        @param indicators list of indicators to check against (list of strings)
+        @param indicators list of indicators to check against
+        @type list of str
         @return list of all items with a locked status
+        @rtype list of QTreeWidgetItem
         """
         lockitems = []
         for itm in self.statusList.selectedItems():
@@ -994,6 +1019,7 @@
         a changelist.
 
         @return list of all items belonging to a changelist
+        @rtype list of QTreeWidgetItem
         """
         clitems = []
         for itm in self.statusList.selectedItems():
@@ -1007,6 +1033,7 @@
         a changelist.
 
         @return list of all items not belonging to a changelist
+        @rtype list of QTreeWidgetItem
         """
         clitems = []
         for itm in self.statusList.selectedItems():
@@ -1018,7 +1045,8 @@
         """
         Private slot to select or deselect all entries.
 
-        @param selected commit selection state to be set (boolean)
+        @param selected commit selection state to be set
+        @type bool
         """
         for index in range(self.statusList.topLevelItemCount()):
             itm = self.statusList.topLevelItem(index)

eric ide

mercurial