diff -r f6881d10e995 -r 2f70ca07f0af src/eric7/Plugins/PluginVcsMercurial.py --- a/src/eric7/Plugins/PluginVcsMercurial.py Fri Dec 22 17:24:07 2023 +0100 +++ b/src/eric7/Plugins/PluginVcsMercurial.py Fri Dec 22 19:45:17 2023 +0100 @@ -50,6 +50,7 @@ @return dictionary containing the data to query the presence of the executable + @rtype dict """ data = { "programEntry": True, @@ -72,9 +73,9 @@ Public function to get the indicators for this version control system. @return dictionary with indicator as key and a tuple with the vcs name - (string) and vcs display string (string) + and vcs display string + @rtype dict """ - ##global __header__ data = {} exe = getHgExecutable() if FileSystemUtilities.isinpath(exe): @@ -87,7 +88,8 @@ """ Public function to get the display string. - @return display string (string) + @return display string + @rtype str """ exe = getHgExecutable() if FileSystemUtilities.isinpath(exe): @@ -103,8 +105,10 @@ """ Module function to create the configuration page. - @param configDlg reference to the configuration dialog (QDialog) + @param configDlg reference to the configuration dialog + @type QDialog @return reference to the configuration page + @rtype MercurialPage """ from eric7.Plugins.VcsPlugins.vcsMercurial.ConfigurationPage.MercurialPage import ( MercurialPage, @@ -122,8 +126,8 @@ """ Module function returning data as required by the configuration dialog. - @return dictionary with key "zzz_mercurialPage" containing the relevant - data + @return dictionary with key "zzz_mercurialPage" containing the relevant data + @rtype dict """ return { "zzz_mercurialPage": [ @@ -192,7 +196,8 @@ """ Constructor - @param ui reference to the user interface object (UI.UserInterface) + @param ui reference to the user interface object + @type UserInterface """ from eric7.Plugins.VcsPlugins.vcsMercurial.ProjectHelper import HgProjectHelper @@ -213,6 +218,7 @@ Public method to get a reference to the project helper object. @return reference to the project helper object + @rtype HgProjectHelper """ return self.__projectHelperObject @@ -220,9 +226,10 @@ """ Public slot to initialize the VCS toolbar. - @param ui reference to the main window (UserInterface) + @param ui reference to the main window + @type UserInterface @param toolbarManager reference to a toolbar manager object - (EricToolBarManager) + @type EricToolBarManager """ if self.__projectHelperObject: self.__projectHelperObject.initToolbar(ui, toolbarManager) @@ -232,7 +239,8 @@ Public method to activate this plugin. @return tuple of reference to instantiated viewmanager and - activation status (boolean) + activation status + @rtype tuple of (Hg, bool) """ from eric7.Plugins.VcsPlugins.vcsMercurial.hg import Hg @@ -268,7 +276,9 @@ Class method to retrieve the various settings. @param key the key of the value to get + @type str @return the requested setting + @rtype Any """ if key in ( "StopLogOnCopy", @@ -332,7 +342,9 @@ Class method to store the various settings. @param key the key of the setting to be set + @type str @param value the value to be set + @type Any """ Preferences.getSettings().setValue("Mercurial/" + key, value) @@ -340,7 +352,8 @@ """ Public method to build a list of global options. - @return list of global options (list of string) + @return list of global options + @rtype list of str """ args = [] if self.getPreferences("Encoding") != self.MercurialDefaults["Encoding"]: @@ -360,7 +373,8 @@ """ Public method to get the filename of the config file. - @return filename of the config file (string) + @return filename of the config file + @rtype str """ return getConfigPath()