fix: consolidate dirac-dms-add-file help into single Usage/Arguments blocks

The module docstring used two 'Usage:' / 'Arguments:' blocks separated by
'**OR**'. LocalConfiguration.setUsageMessage only keeps the FIRST match of
each block (re.search), so the second invocation form and the LocalFile
argument were dropped from both the --help output and the generated docs.

Merge both invocation forms into one Usage block and all arguments into one
Arguments block so nothing is lost.

Closes #7290

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: fstagni

src/DIRAC/DataManagementSystem/scripts/dirac_dms_add_file.py

@@ -4,27 +4,24 @@
 # Author :  Stuart Paterson
 ########################################################################
 """
-Upload a file to the grid storage and register it in the File Catalog
+Upload a file to the grid storage and register it in the File Catalog.
 
-Usage:
-  dirac-dms-add-file [options] ... LFN Path SE [GUID]
-
-Arguments:
-  LFN:      Logical File Name
-  Path:     Local path to the file
-  SE:       DIRAC Storage Element
-  GUID:     GUID to use in the registration (optional)
-
-**OR**
+The file(s) to upload can be passed either directly as arguments, or listed in a
+local text file given as the only argument (one upload per line).
 
 Usage:
+  dirac-dms-add-file [options] ... LFN Path SE [GUID]
   dirac-dms-add-file [options] ... LocalFile ...
 
 Arguments:
-  LocalFile: Path to local file containing all the above, i.e.::
-
-  lfn1 localfile1 SE [GUID1]
-  lfn2 localfile2 SE [GUID2]
+  LFN:       Logical File Name
+  Path:      Local path to the file
+  SE:        DIRAC Storage Element
+  GUID:      GUID to use in the registration (optional)
+  LocalFile: Path to a local file listing the uploads described above, one per line, i.e.::
+
+               lfn1 localfile1 SE [GUID1]
+               lfn2 localfile2 SE [GUID2]
 
 Example:
   $ dirac-dms-add-file LFN:/formation/user/v/vhamar/Example.txt Example.txt DIRAC-USER

src/DIRAC/RequestManagementSystem/DB/RequestDB.py

@@ -5,18 +5,19 @@
 
 # We disable pylint no-callable because of https://github.com/PyCQA/pylint/issues/8138
 
-""" Frontend for ReqDB
+"""Frontend for ReqDB
 
-    :mod: RequestDB
+:mod: RequestDB
 
-    =======================
+=======================
 
-    .. module: RequestDB
+.. module: RequestDB
 
-    :synopsis: db holding Requests
+:synopsis: db holding Requests
 
-    db holding Request, Operation and File
+db holding Request, Operation and File
 """
+
 import errno
 import random
 from urllib.parse import quote_plus
@@ -600,7 +601,9 @@ def getDBSummary(self):
 
             operationQuery = (
                 session.query(
-                    Operation.Type, Operation._Status, func.count(Operation.OperationID)  # pylint: disable=not-callable
+                    Operation.Type,
+                    Operation._Status,
+                    func.count(Operation.OperationID),  # pylint: disable=not-callable
                 )
                 .group_by(Operation.Type, Operation._Status)
                 .all()
@@ -759,8 +762,9 @@ def getRequestCountersWeb(self, groupingAttribute, selectDict):
                 groupingColumn = self._get_column("Request", groupingAttribute)
 
             summaryQuery = session.query(
-                groupingColumn, func.count(Request.RequestID)
-            )  # pylint: disable=not-callable,no-member
+                groupingColumn,
+                func.count(Request.RequestID),  # pylint: disable=not-callable
+            )
 
             for key, value in selectDict.items():
                 if key == "ToDate":