From 7a33780bc2e4221a3444d47ee7e69cbfd84fb446 Mon Sep 17 00:00:00 2001
From: Slava Pestov <slava@shill.local>
Date: Sun, 12 Apr 2009 16:31:25 -0500
Subject: [PATCH] Fix bootstrap

---
 basis/help/lint/lint-docs.factor      |  4 ++++
 basis/tools/errors/errors-docs.factor | 13 ++++++-------
 basis/tools/test/test-docs.factor     |  6 ++++--
 3 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/basis/help/lint/lint-docs.factor b/basis/help/lint/lint-docs.factor
index 0c0fcf92d2..ed74748356 100644
--- a/basis/help/lint/lint-docs.factor
+++ b/basis/help/lint/lint-docs.factor
@@ -14,6 +14,10 @@ $nl
 "To run help lint, use one of the following two words:"
 { $subsection help-lint }
 { $subsection help-lint-all }
+"Once a help lint run completes, failures can be listed:"
+{ $subsection :lint-failures }
+"Help lint failures are also shown in the " { $link "ui.tools.error-list" } "."
+$nl
 "Help lint performs the following checks:"
 { $list
     "ensures examples run and produce stated output"
diff --git a/basis/tools/errors/errors-docs.factor b/basis/tools/errors/errors-docs.factor
index 8fff063847..456f39c041 100644
--- a/basis/tools/errors/errors-docs.factor
+++ b/basis/tools/errors/errors-docs.factor
@@ -5,17 +5,16 @@ words quotations io ;
 ARTICLE: "compiler-errors" "Compiler warnings and errors"
 "After loading a vocabulary, you might see messages like:"
 { $code
-    ":errors - print 2 compiler errors."
-    ":warnings - print 50 compiler warnings."
+    ":errors - print 2 compiler errors"
+    ":warnings - print 50 compiler warnings"
 }
-"These warnings arise from the compiler's stack effect checker. Warnings are non-fatal conditions -- not all code has a static stack effect, so you try to minimize warnings but understand that in many cases they cannot be eliminated. Errors indicate programming mistakes, such as erroneous stack effect declarations."
-$nl
-"The precise warning and error conditions are documented in " { $link "inference-errors" } "."
+"These messages arise from the compiler's stack effect checker. Production code should not have any warnings and errors in it. Warning and error conditions are documented in " { $link "inference-errors" } "."
 $nl
 "Words to view warnings and errors:"
-{ $subsection :errors }
 { $subsection :warnings }
-{ $subsection :linkage } ;
+{ $subsection :errors }
+{ $subsection :linkage }
+"Compiler warnings and errors are also shown in the " { $link "ui.tools.error-list" } "." ;
 
 HELP: compiler-error
 { $values { "error" "an error" } { "word" word } }
diff --git a/basis/tools/test/test-docs.factor b/basis/tools/test/test-docs.factor
index 06a54f0868..03e068d795 100644
--- a/basis/tools/test/test-docs.factor
+++ b/basis/tools/test/test-docs.factor
@@ -16,7 +16,9 @@ ARTICLE: "tools.test.run" "Running unit tests"
 { $subsection test }
 { $subsection test-all }
 "The following word prints failures:"
-{ $subsection :failures }
+{ $subsection :test-failures }
+"Help lint failures are also shown in the " { $link "ui.tools.error-list" } "."
+$nl
 "Unit test failurs are instances of a class, and are stored in a global variable:"
 { $subsection test-failure }
 { $subsection test-failures } ;
@@ -70,5 +72,5 @@ HELP: test
 HELP: test-all
 { $description "Runs unit tests for all loaded vocabularies." } ;
 
-HELP: :failures
+HELP: :test-failures
 { $description "Prints all pending unit test failures." } ;