From b270ba6a424dc222624aa1ec481b6676b714b7b7 Mon Sep 17 00:00:00 2001
From: "Robert P. Goldman" <rpgoldman@gmail.com>
Date: Sun, 9 Mar 2014 22:38:45 -0500
Subject: [PATCH] Removed rec. of ASDF-SYSTEM-CONNECTIONS, added warning about
 if-feature.

---
 doc/asdf.texinfo | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/doc/asdf.texinfo b/doc/asdf.texinfo
index 6ca0dd04d..461ba15fa 100644
--- a/doc/asdf.texinfo
+++ b/doc/asdf.texinfo
@@ -1255,12 +1255,12 @@ Programmers are cautioned not
 to use this component option except at the @code{defsystem} level, as
 this anomalous behavior may be removed without warning.
 
-Finally, you might look into the @code{asdf-system-connections} extension,
-that will let you define additional code to be loaded
-when two systems are simultaneously loaded.
-It may or may not be considered good style, but at least it can be used
-in a way that has deterministic behavior independent of load order,
-unlike @code{weakly-depends-on}.
+@c Finally, you might look into the @code{asdf-system-connections} extension,
+@c that will let you define additional code to be loaded
+@c when two systems are simultaneously loaded.
+@c It may or may not be considered good style, but at least it can be used
+@c in a way that has deterministic behavior independent of load order,
+@c unlike @code{weakly-depends-on}.
 
 
 @subsection Pathname specifiers
@@ -1513,10 +1513,20 @@ that can be used for manipulations beside building your project, and
 that is accessible to outside code that wishes to reason about system
 structure.
 
+Programmers should be careful to consider @strong{when} the
+@code{:if-feature} is evaluated.  Recall that ASDF first computes a
+build plan, and then executes that plan.  ASDF will check to see whether
+or not a feature is present @strong{at planning time}, not during the
+build.  It follows that one cannot use @code{:if-feature} to check
+features that are set during the course of the build.  It can only be
+used to check the state of features before any build operations have
+been performed.
+
 This option was added in ASDF 3.  For more information,
 @xref{required-features, Required features}.
 
 @subsection if-component-dep-fails option
+@cindex :if-component-dep-fails component option
 This option was removed in ASDF 3.
 Its semantics was limited in purpose and dubious to explain,
 and its implementation was breaking a hole into the ASDF object model.
-- 
GitLab