From a46c76950c28dc166741d076a9f9347df529c7a2 Mon Sep 17 00:00:00 2001
From: Jonas Bernoulli <jonas@bernoul.li>
Date: Sun, 15 Dec 2024 23:02:47 +0100
Subject: [PATCH] Add doc-strings for many commands

---
 emir-gelpa.el | 3 +++
 emir-melpa.el | 2 ++
 emir-utils.el | 2 ++
 3 files changed, 7 insertions(+)

diff --git a/emir-gelpa.el b/emir-gelpa.el
index 3b55608..2521026 100644
--- a/emir-gelpa.el
+++ b/emir-gelpa.el
@@ -27,6 +27,7 @@
 
 ;;;###autoload
 (defun emir-import-all-elpa-recipes (args)
+  "Import GNU Elpa, NonGNU Elpa and Melpa package recipes."
   (interactive (list (transient-args 'emir-import-recipes)))
   (emir-import-melpa-recipes args)
   (emir-import-nongnu-elpa-recipes args)
@@ -34,12 +35,14 @@
 
 ;;;###autoload
 (defun emir-import-nongnu-elpa-recipes (args)
+  "Import NonGNU Elpa package recipes."
   (interactive (list (transient-args 'emir-import-recipes)))
   (let ((default-directory emir-nongnu-elpa-repository ))
     (emir-gelpa--import-recipes 'nongnu "NonGNU Elpa" args)))
 
 ;;;###autoload
 (defun emir-import-gnu-elpa-recipes (args)
+  "Import GNU Elpa package recipes."
   (interactive (list (transient-args 'emir-import-recipes)))
   (let ((default-directory emir-gnu-elpa-repository))
     (emir-gelpa--import-recipes 'gnu "GNU Elpa" args)))
diff --git a/emir-melpa.el b/emir-melpa.el
index dbee4a9..b5d9df9 100644
--- a/emir-melpa.el
+++ b/emir-melpa.el
@@ -33,6 +33,7 @@
 
 ;;;###autoload
 (defun emir-import-melpa-recipes (args)
+  "Import Melpa package recipes."
   (interactive (list (transient-args 'emir-import-recipes)))
   (let* ((default-directory emir-melpa-repository)
          (imported (magit-rev-verify "mirror-imported"))
@@ -114,6 +115,7 @@
 
 ;;;###autoload
 (defun emir-import-melpa-downloads ()
+  "Import Melpa download counts."
   (interactive)
   (message "Importing Melpa downloads...")
   (with-current-buffer
diff --git a/emir-utils.el b/emir-utils.el
index 530c3fd..e224432 100644
--- a/emir-utils.el
+++ b/emir-utils.el
@@ -30,11 +30,13 @@
 
 ;;;###autoload
 (defun emir-report ()
+  "Open the main maintainance report file."
   (interactive)
   (find-file-other-frame
    (expand-file-name "compare.org" emir-stats-repository)))
 
 (defun emir-remove-obsolete-wiki-branches ()
+  "Remove branches corresponding to shelved and removed packages."
   (interactive)
   (with-epkg-repository 'epkg-wiki-package
     (dolist (branch (magit-list-local-branch-names))