Converted some source code documentation to the new style. eric7

Sat, 23 Dec 2023 16:13:31 +0100

author
Detlev Offenbach <detlev@die-offenbachs.de>
date
Sat, 23 Dec 2023 16:13:31 +0100
branch
eric7
changeset 86
812d4cf28c23
parent 85
8bdcb62db996
child 87
f8aa4aec9695

Converted some source code documentation to the new style.

Documentation/source/Plugin_Documentation_Sets.PluginDocumentationSets.html file | annotate | diff | comparison | revisions
PluginDocumentationSets.epj file | annotate | diff | comparison | revisions
PluginDocumentationSets.py file | annotate | diff | comparison | revisions
--- a/Documentation/source/Plugin_Documentation_Sets.PluginDocumentationSets.html	Sat Dec 23 15:48:46 2023 +0100
+++ b/Documentation/source/Plugin_Documentation_Sets.PluginDocumentationSets.html	Sat Dec 23 16:13:31 2023 +0100
@@ -86,9 +86,9 @@
 </p>
 <dl>
 
-<dt><i>ui</i></dt>
+<dt><i>ui</i> (UserInterface)</dt>
 <dd>
-reference to the user interface object (UI.UserInterface)
+reference to the user interface object
 </dd>
 </dl>
 <a NAME="PluginDocumentationSets.activate" ID="PluginDocumentationSets.activate"></a>
@@ -101,7 +101,13 @@
 <dl>
 <dt>Return:</dt>
 <dd>
-tuple of None and activation status (boolean)
+tuple of None and activation status
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+bool
 </dd>
 </dl>
 <a NAME="PluginDocumentationSets.deactivate" ID="PluginDocumentationSets.deactivate"></a>
--- a/PluginDocumentationSets.epj	Sat Dec 23 15:48:46 2023 +0100
+++ b/PluginDocumentationSets.epj	Sat Dec 23 16:13:31 2023 +0100
@@ -11,10 +11,14 @@
           "AllowStarArgAny": false,
           "AllowUntypedDefs": false,
           "AllowUntypedNested": false,
+          "CheckFutureAnnotations": false,
           "DispatchDecorators": [
             "singledispatch",
             "singledispatchmethod"
           ],
+          "ExemptedTypingSymbols": [
+            ""
+          ],
           "ForceFutureAnnotations": false,
           "MaximumComplexity": 3,
           "MaximumLength": 7,
@@ -62,9 +66,9 @@
         "CopyrightAuthor": "",
         "CopyrightMinFileSize": 0,
         "DocstringType": "eric_black",
-        "EnabledCheckerCategories": "C, D, E, M, N, Y, W",
+        "EnabledCheckerCategories": "C, D, E, I, L, M, NO, N, Y, U, W",
         "ExcludeFiles": "*/Ui_*.py, */*_rc.py,",
-        "ExcludeMessages": "C101,E265,E266,E305,E402,M201,M301,M302,M303,M304,M305,M306,M307,M308,M311,M312,M313,M314,M315,M321,M701,M702,M811,M834,N802,N803,N807,N808,N821,W293,W503,Y119,Y401,Y402",
+        "ExcludeMessages": "C101,E265,E266,E305,E402,M201,M301,M302,M303,M304,M305,M306,M307,M308,M311,M312,M313,M314,M315,M321,M701,M702,M811,M834,M852,N802,N803,N807,N808,N821,W293,W503,Y119,Y401,Y402",
         "FixCodes": "",
         "FixIssues": false,
         "FutureChecker": "",
@@ -80,6 +84,14 @@
         "MaxCodeComplexity": 10,
         "MaxDocLineLength": 88,
         "MaxLineLength": 88,
+        "NameOrderChecker": {
+          "ApplicationPackageNames": [],
+          "CombinedAsImports": false,
+          "SortCaseSensitive": false,
+          "SortFromFirst": false,
+          "SortIgnoringStyle": false,
+          "SortOrder": "natural"
+        },
         "NoFixCodes": "E501",
         "RepeatMessages": true,
         "SecurityChecker": {
@@ -113,6 +125,19 @@
           "WeakKeySizeRsaMedium": "2048"
         },
         "ShowIgnored": false,
+        "UnusedChecker": {
+          "IgnoreAbstract": true,
+          "IgnoreDunderGlobals": true,
+          "IgnoreDunderMethods": true,
+          "IgnoreEventHandlerMethods": false,
+          "IgnoreLambdas": false,
+          "IgnoreNestedFunctions": false,
+          "IgnoreOverload": true,
+          "IgnoreOverride": true,
+          "IgnoreSlotMethods": false,
+          "IgnoreStubs": true,
+          "IgnoreVariadicNames": false
+        },
         "ValidEncodings": "latin-1, utf-8"
       }
     },
@@ -131,6 +156,7 @@
         ],
         "outputDirectory": "Documentation/source",
         "qtHelpEnabled": false,
+        "startDirectory": "",
         "useRecursion": true
       }
     },
--- a/PluginDocumentationSets.py	Sat Dec 23 15:48:46 2023 +0100
+++ b/PluginDocumentationSets.py	Sat Dec 23 16:13:31 2023 +0100
@@ -7,8 +7,8 @@
 Module implementing the QtHelp documentation provider plug-in.
 """
 
+import glob
 import os
-import glob
 
 from PyQt6.QtCore import QObject
 
@@ -66,7 +66,8 @@
         """
         Constructor
 
-        @param ui reference to the user interface object (UI.UserInterface)
+        @param ui reference to the user interface object
+        @type UserInterface
         """
         super().__init__(ui)
         self.__ui = ui
@@ -75,7 +76,8 @@
         """
         Public method to activate this plugin.
 
-        @return tuple of None and activation status (boolean)
+        @return tuple of None and activation status
+        @rtype bool
         """
         global error
         error = ""  # clear previous error
@@ -87,3 +89,6 @@
         Public method to deactivate this plugin.
         """
         pass
+
+#
+# eflag: noqa = U200

eric ide

mercurial