Subject: Some minor patches for the python script

From: Nikolaos Chatzikonstantinou <[email-masked]>
Date: Thu, 31 Oct 2024 07:02:21 -0400

Hello,

>From a quick discussion on IRC I've decided to contribute the
following two patches. The first is stylistic but the second is
something that was requested. Note that I've already assigned
copyright to the FSF for my contributions to Emacs.

Regards,
Nikolaos Chatzikonstantinou
From 62a534d527b79a5ff62b73940e8f604f8db1f325 Mon Sep 17 00:00:00 2001
From: Nikolaos Chatzikonstantinou <[email-masked]>
Date: Thu, 31 Oct 2024 06:37:31 -0400
Subject: [PATCH 1/2] add docstrings

* admin/nt/dist-build/build-dep-zips.py: Change some top-level comments
to docstrings.
---
 admin/nt/dist-build/build-dep-zips.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/admin/nt/dist-build/build-dep-zips.py b/admin/nt/dist-build/build-dep-zips.py
index 0b1cc4d8695..bb0ff7e32bf 100755
--- a/admin/nt/dist-build/build-dep-zips.py
+++ b/admin/nt/dist-build/build-dep-zips.py
@@ -62,8 +62,8 @@ def check_output_maybe(*args,**kwargs):
     else:
         return check_output(*args,**kwargs)
 
-## DLL Capture
 def gather_deps():
+    """DLL Capture"""
 
     os.mkdir("x86_64")
     os.chdir("x86_64")
@@ -78,13 +78,13 @@ def gather_deps():
                        shell=True)
     os.chdir("../")
 
-## Return all Emacs dependencies
 def full_dll_dependency():
+    """Return all Emacs dependencies"""
     deps = [dll_dependency(dep) for dep in DLL_REQ]
     return set(sum(deps, []) + DLL_REQ)
 
-## Dependencies for a given DLL
 def dll_dependency(dll):
+    """Dependencies for a given DLL"""
     output = check_output(["/mingw64/bin/ntldd", "--recursive",
                            "/mingw64/bin/{}*.dll".format(dll)]).decode("utf-8")
     ## munge output
@@ -141,8 +141,8 @@ def immediate_deps(pkgs):
     return dependencies

-## Extract all the msys2 packages that are dependencies of our direct dependencies
 def extract_deps():
+    """Extract all the msys2 packages that are dependencies of our direct dependencies"""
 
     print( "Extracting deps" )
 
@@ -178,8 +178,8 @@ def download_source(tarball):
                     "{}".format(tarball))

-## Fetch all the source code
 def gather_source(deps):
+    """Fetch all the source code"""
 
     if not os.path.exists("emacs-src-cache"):
         os.mkdir("emacs-src-cache")
-- 
2.39.5