From 9d011a40e1bfc2907a095303e74c890ba243be50 Mon Sep 17 00:00:00 2001
From: "Robert P. Goldman" <rpgoldman@gmail.com>
Date: Thu, 13 Mar 2014 13:41:42 -0500
Subject: [PATCH] Minor wording tweaks for BUILD-OP docstrings.

---
 operate.lisp | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/operate.lisp b/operate.lisp
index 1fc00a57..017cb0bc 100644
--- a/operate.lisp
+++ b/operate.lisp
@@ -106,19 +106,20 @@ The :FORCE or :FORCE-NOT argument to OPERATE can be:
 (with-upgradability ()
   (defvar *load-system-operation* 'load-op
     "Operation used by ASDF:LOAD-SYSTEM. By default, ASDF:LOAD-OP.
-You may override it with e.g. ASDF:LOAD-FASL-OP from asdf-bundle (recommended on ECL?)
+You may override it with e.g. ASDF:LOAD-FASL-OP from asdf-bundle
 or ASDF:LOAD-SOURCE-OP if your fasl loading is somehow broken.
 
-This may change in the future if we implement component-directed strategy
-for how to load or compile stuff")
+The default operation may change in the future if we implement a
+component-directed strategy for how to load or compile systems.")
 
   (defclass build-op (non-propagating-operation) ()
-    (:documentation "Since ASDF3, BUILD-OP is the recommended 'master' operation,
-to operate by default on a system or component.
-Its meaning is configurable via the :BUILD-OPERATION option of a component,
-which is typically the name of a specific operation to which to delegate the build,
-and may be NIL, which designates the *LOAD-SYSTEM-OPERATION*
-that will load the system in the current image, and its typically LOAD-OP."))
+    (:documentation "BUILD-OP is the recommended 'master' operation,
+performing the default operation on a system or component.
+The meaning of BUILD-OP is configurable via the :BUILD-OPERATION option of a component,
+which is typically the name of a specific operation to which to delegate the build.
+:BUILD-OPERATION may be NIL, in which case BUILD-OP will be interpreted as
+*LOAD-SYSTEM-OPERATION*.  Currently *LOAD-SYSTEM-OPERATION* will load the system in
+the current image, using LOAD-OP."))
   (defmethod component-depends-on ((o build-op) (c component))
     `((,(or (component-build-operation c) *load-system-operation*) ,c)))
 
@@ -127,7 +128,8 @@ that will load the system in the current image, and its typically LOAD-OP."))
     "The recommended way to interact with ASDF3.1 is via (ASDF:BUILD :FOO).
 It will build system FOO using the operation BUILD-OP,
 the meaning of which is configurable by the system, and
-defaults to *LOAD-SYSTEM-OPERATION*, usually LOAD-OP, to load it in current image."
+defaults to *LOAD-SYSTEM-OPERATION*, usually LOAD-OP,
+to load it in current image."
     (apply 'operate 'build-op system keys)
     t)
 
-- 
GitLab