--- a/eric6/Documentation/Source/eric6.Plugins.PluginVcsMercurial.html Wed Sep 25 19:40:31 2019 +0200 +++ b/eric6/Documentation/Source/eric6.Plugins.PluginVcsMercurial.html Wed Sep 25 19:42:44 2019 +0200 @@ -18,260 +18,340 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>eric6.Plugins.PluginVcsMercurial</h1> + <p> Module implementing the Mercurial version control plugin. </p> <h3>Global Attributes</h3> + <table> <tr><td>author</td></tr><tr><td>autoactivate</td></tr><tr><td>className</td></tr><tr><td>deactivateable</td></tr><tr><td>error</td></tr><tr><td>longDescription</td></tr><tr><td>mercurialCfgPluginObject</td></tr><tr><td>name</td></tr><tr><td>packageName</td></tr><tr><td>pluginType</td></tr><tr><td>pluginTypename</td></tr><tr><td>pyqtApi</td></tr><tr><td>shortDescription</td></tr><tr><td>version</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#VcsMercurialPlugin">VcsMercurialPlugin</a></td> <td>Class implementing the Mercurial version control plugin.</td> </tr> </table> <h3>Functions</h3> + <table> + <tr> <td><a href="#clearPrivateData">clearPrivateData</a></td> <td>Module function to clear the private data of the plug-in.</td> -</tr><tr> +</tr> +<tr> <td><a href="#createConfigurationPage">createConfigurationPage</a></td> <td>Module function to create the configuration page.</td> -</tr><tr> +</tr> +<tr> <td><a href="#displayString">displayString</a></td> <td>Public function to get the display string.</td> -</tr><tr> +</tr> +<tr> <td><a href="#exeDisplayData">exeDisplayData</a></td> <td>Public method to support the display of some executable info.</td> -</tr><tr> +</tr> +<tr> <td><a href="#getConfigData">getConfigData</a></td> <td>Module function returning data as required by the configuration dialog.</td> -</tr><tr> +</tr> +<tr> <td><a href="#getVcsSystemIndicator">getVcsSystemIndicator</a></td> <td>Public function to get the indicators for this version control system.</td> -</tr><tr> +</tr> +<tr> <td><a href="#prepareUninstall">prepareUninstall</a></td> <td>Module function to prepare for an uninstallation.</td> </tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="VcsMercurialPlugin" ID="VcsMercurialPlugin"></a> <h2>VcsMercurialPlugin</h2> + <p> Class implementing the Mercurial version control plugin. </p> <h3>Derived from</h3> QObject <h3>Class Attributes</h3> + <table> <tr><td>MercurialDefaults</td></tr> </table> <h3>Class Methods</h3> + <table> + <tr> <td><a href="#VcsMercurialPlugin.getPreferences">getPreferences</a></td> <td>Class method to retrieve the various settings.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VcsMercurialPlugin.setPreferences">setPreferences</a></td> <td>Class method to store the various settings.</td> </tr> </table> <h3>Methods</h3> + <table> + <tr> <td><a href="#VcsMercurialPlugin.__init__">VcsMercurialPlugin</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#VcsMercurialPlugin.activate">activate</a></td> <td>Public method to activate this plugin.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VcsMercurialPlugin.deactivate">deactivate</a></td> <td>Public method to deactivate this plugin.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VcsMercurialPlugin.getConfigPath">getConfigPath</a></td> <td>Public method to get the filename of the config file.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VcsMercurialPlugin.getGlobalOptions">getGlobalOptions</a></td> <td>Public method to build a list of global options.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VcsMercurialPlugin.getProjectHelper">getProjectHelper</a></td> <td>Public method to get a reference to the project helper object.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VcsMercurialPlugin.initToolbar">initToolbar</a></td> <td>Public slot to initialize the VCS toolbar.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VcsMercurialPlugin.prepareUninstall">prepareUninstall</a></td> <td>Public method to prepare for an uninstallation.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VcsMercurialPlugin.prepareUnload">prepareUnload</a></td> <td>Public method to prepare for an unload.</td> </tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> + <a NAME="VcsMercurialPlugin.getPreferences" ID="VcsMercurialPlugin.getPreferences"></a> <h4>VcsMercurialPlugin.getPreferences (class method)</h4> <b>getPreferences</b>(<i>key</i>) + <p> Class method to retrieve the various settings. -</p><dl> +</p> +<dl> + <dt><i>key</i></dt> <dd> the key of the value to get </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> the requested setting </dd> -</dl><a NAME="VcsMercurialPlugin.setPreferences" ID="VcsMercurialPlugin.setPreferences"></a> +</dl> +<a NAME="VcsMercurialPlugin.setPreferences" ID="VcsMercurialPlugin.setPreferences"></a> <h4>VcsMercurialPlugin.setPreferences (class method)</h4> <b>setPreferences</b>(<i>key, value</i>) + <p> Class method to store the various settings. -</p><dl> +</p> +<dl> + <dt><i>key</i></dt> <dd> the key of the setting to be set -</dd><dt><i>value</i></dt> +</dd> +<dt><i>value</i></dt> <dd> the value to be set </dd> -</dl><a NAME="VcsMercurialPlugin.__init__" ID="VcsMercurialPlugin.__init__"></a> +</dl> +<a NAME="VcsMercurialPlugin.__init__" ID="VcsMercurialPlugin.__init__"></a> <h4>VcsMercurialPlugin (Constructor)</h4> <b>VcsMercurialPlugin</b>(<i>ui</i>) + <p> Constructor -</p><dl> +</p> +<dl> + <dt><i>ui</i></dt> <dd> reference to the user interface object (UI.UserInterface) </dd> -</dl><a NAME="VcsMercurialPlugin.activate" ID="VcsMercurialPlugin.activate"></a> +</dl> +<a NAME="VcsMercurialPlugin.activate" ID="VcsMercurialPlugin.activate"></a> <h4>VcsMercurialPlugin.activate</h4> <b>activate</b>(<i></i>) + <p> Public method to activate this plugin. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> tuple of reference to instantiated viewmanager and activation status (boolean) </dd> -</dl><a NAME="VcsMercurialPlugin.deactivate" ID="VcsMercurialPlugin.deactivate"></a> +</dl> +<a NAME="VcsMercurialPlugin.deactivate" ID="VcsMercurialPlugin.deactivate"></a> <h4>VcsMercurialPlugin.deactivate</h4> <b>deactivate</b>(<i></i>) + <p> Public method to deactivate this plugin. -</p><a NAME="VcsMercurialPlugin.getConfigPath" ID="VcsMercurialPlugin.getConfigPath"></a> +</p> +<a NAME="VcsMercurialPlugin.getConfigPath" ID="VcsMercurialPlugin.getConfigPath"></a> <h4>VcsMercurialPlugin.getConfigPath</h4> <b>getConfigPath</b>(<i></i>) + <p> Public method to get the filename of the config file. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> filename of the config file (string) </dd> -</dl><a NAME="VcsMercurialPlugin.getGlobalOptions" ID="VcsMercurialPlugin.getGlobalOptions"></a> +</dl> +<a NAME="VcsMercurialPlugin.getGlobalOptions" ID="VcsMercurialPlugin.getGlobalOptions"></a> <h4>VcsMercurialPlugin.getGlobalOptions</h4> <b>getGlobalOptions</b>(<i></i>) + <p> Public method to build a list of global options. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> list of global options (list of string) </dd> -</dl><a NAME="VcsMercurialPlugin.getProjectHelper" ID="VcsMercurialPlugin.getProjectHelper"></a> +</dl> +<a NAME="VcsMercurialPlugin.getProjectHelper" ID="VcsMercurialPlugin.getProjectHelper"></a> <h4>VcsMercurialPlugin.getProjectHelper</h4> <b>getProjectHelper</b>(<i></i>) + <p> Public method to get a reference to the project helper object. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> reference to the project helper object </dd> -</dl><a NAME="VcsMercurialPlugin.initToolbar" ID="VcsMercurialPlugin.initToolbar"></a> +</dl> +<a NAME="VcsMercurialPlugin.initToolbar" ID="VcsMercurialPlugin.initToolbar"></a> <h4>VcsMercurialPlugin.initToolbar</h4> <b>initToolbar</b>(<i>ui, toolbarManager</i>) + <p> Public slot to initialize the VCS toolbar. -</p><dl> +</p> +<dl> + <dt><i>ui</i></dt> <dd> reference to the main window (UserInterface) -</dd><dt><i>toolbarManager</i></dt> +</dd> +<dt><i>toolbarManager</i></dt> <dd> reference to a toolbar manager object (E5ToolBarManager) </dd> -</dl><a NAME="VcsMercurialPlugin.prepareUninstall" ID="VcsMercurialPlugin.prepareUninstall"></a> +</dl> +<a NAME="VcsMercurialPlugin.prepareUninstall" ID="VcsMercurialPlugin.prepareUninstall"></a> <h4>VcsMercurialPlugin.prepareUninstall</h4> <b>prepareUninstall</b>(<i></i>) + <p> Public method to prepare for an uninstallation. -</p><a NAME="VcsMercurialPlugin.prepareUnload" ID="VcsMercurialPlugin.prepareUnload"></a> +</p> +<a NAME="VcsMercurialPlugin.prepareUnload" ID="VcsMercurialPlugin.prepareUnload"></a> <h4>VcsMercurialPlugin.prepareUnload</h4> <b>prepareUnload</b>(<i></i>) + <p> Public method to prepare for an unload. </p> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="clearPrivateData" ID="clearPrivateData"></a> <h2>clearPrivateData</h2> <b>clearPrivateData</b>(<i></i>) + <p> Module function to clear the private data of the plug-in. </p> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="createConfigurationPage" ID="createConfigurationPage"></a> <h2>createConfigurationPage</h2> <b>createConfigurationPage</b>(<i>configDlg</i>) + <p> Module function to create the configuration page. -</p><dl> +</p> +<dl> + <dt><i>configDlg</i></dt> <dd> reference to the configuration dialog (QDialog) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> reference to the configuration page </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="displayString" ID="displayString"></a> <h2>displayString</h2> <b>displayString</b>(<i></i>) + <p> Public function to get the display string. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> display string (string) </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="exeDisplayData" ID="exeDisplayData"></a> <h2>exeDisplayData</h2> <b>exeDisplayData</b>(<i></i>) + <p> Public method to support the display of some executable info. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> dictionary containing the data to query the presence of @@ -279,13 +359,16 @@ </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="getConfigData" ID="getConfigData"></a> <h2>getConfigData</h2> <b>getConfigData</b>(<i></i>) + <p> Module function returning data as required by the configuration dialog. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> dictionary with key "zzz_mercurialPage" containing the relevant @@ -293,13 +376,16 @@ </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="getVcsSystemIndicator" ID="getVcsSystemIndicator"></a> <h2>getVcsSystemIndicator</h2> <b>getVcsSystemIndicator</b>(<i></i>) + <p> Public function to get the indicators for this version control system. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> dictionary with indicator as key and a tuple with the vcs name @@ -307,10 +393,12 @@ </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="prepareUninstall" ID="prepareUninstall"></a> <h2>prepareUninstall</h2> <b>prepareUninstall</b>(<i></i>) + <p> Module function to prepare for an uninstallation. </p>