From 6b8f9ccec1de50faf05b6d354c83317780a077ec Mon Sep 17 00:00:00 2001
From: Kartik Singh <kssingh@hrl.com>
Date: Mon, 16 Dec 2024 09:35:21 -0800
Subject: [PATCH] Comment required-components

---
 src/asdf-utils.lisp | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/asdf-utils.lisp b/src/asdf-utils.lisp
index 15c8bd50..ba0ef8e0 100644
--- a/src/asdf-utils.lisp
+++ b/src/asdf-utils.lisp
@@ -55,6 +55,12 @@ DIRECTORY."
   "Return a list of all the required systems for SYSTEM topologically
 sorted by load order."
   (with-recursive-compile-bundle-op
+    ;; ASDF:REQUIRED-COMPONENTS traverses the dependency operations
+    ;; required to perform :GOAL-OPERATION on the provided system,
+    ;; returning a list of the components involved that have
+    ;; :COMPONENT-TYPE.
+    ;;
+    ;; TODO: what exactly do :OTHER-SYSTEMS and :KEEP-OPERATION do?
     (asdf:required-components system
                               :other-systems t
                               :component-type 'asdf:system