patch to asdf.texinfo
[email protected] (Tim Daly Jr.)
| Newsgroups | gmane.lisp.cclan.general |
|---|---|
| Message-ID | <[email protected]> |
I was confused (more than usual) last night when ASDF threw a COMPILE-FAILED even though only warnings were signalled while compiling. It turns out that ASDF will signal a COMPILE-FAILED condition for both errors and warnings, excepting only style-warnings. This is because that's how the return values of COMPILE-FILE are defined. So, here's a patch attempting to document what I learned last night: [Note: I sent this the other day, but it looks like it didn't get through, so I subscribed and sent it again. My apologies if you get 7 of them.] -- -Tim
compile-file-warnings-doc.patch
(text/x-patch, 1.5 KB)
Index: asdf.texinfo
===================================================================
RCS file: /cvsroot/sbcl/sbcl/contrib/asdf/asdf.texinfo,v
retrieving revision 1.2
diff -u -r1.2 asdf.texinfo
--- asdf.texinfo 18 Aug 2004 12:58:41 -0000 1.2
+++ asdf.texinfo 9 Feb 2005 12:29:33 -0000
@@ -969,9 +969,20 @@
ASDF checks for warnings and errors when a file is compiled. The
variables @code{*compile-file-warnings-behaviour*} and
-@code{*compile-file-errors-behavior*} controls the handling of any
-such events. The valid values for these variables are @code{:error},
-@code{:warn}, and @code{:ignore}.
+@code{*compile-file-errors-behavior*} control the handling of any such
+events. The valid values for these variables are @code{:error},
+@code{:warn}, and @code{:ignore}.
+
+The @code{*compile-file-warnings-behaviour*} will be invoked when the
+second return value of @code{COMPILE-FILE} is true. In conforming
+lisps, this happens if any conditions of type @code{error} or
+@code{warning} were signalled by the compiler. Similarly,
+@code{*compile-file-errors-behaviour*} is invoked when the third value
+of @code{COMPILE-FILE} is true. This is also the case if any
+conditions of type @code{error} or @code{warning} were signalled by
+the compiler, except @code{style-warning}s. In other words, the only
+difference between the two is regarding conditions of type
+@code{style-warning}.
@node Getting the latest version, TODO list, Compilation error and warning handling, Top
@comment node-name, next, previous, up