vocabs.refresh: add a note about refesh-all after a fresh bootstrap

[factor.git] / basis / vocabs / refresh / refresh-docs.factor

diff --git a/basis/vocabs/refresh/refresh-docs.factor b/basis/vocabs/refresh/refresh-docs.factor
index ee02a491e134052ede801cd33c29eb06318caee1..f78664394da527935351ebec3919a5d0fc78f473 100644 (file)
--- a/basis/vocabs/refresh/refresh-docs.factor
+++ b/basis/vocabs/refresh/refresh-docs.factor
@@ -1,8 +1,8 @@
-USING: help.markup help.syntax strings ;
+USING: bootstrap.image help.markup help.syntax kernel strings ;
 IN: vocabs.refresh
 
 HELP: source-modified?
-{ $values { "path" "a pathname string" } { "?" "a boolean" } }
+{ $values { "path" "a pathname string" } { "?" boolean } }
 { $description "Tests if the source file has been modified since it was last loaded. This compares the file's CRC32 checksum of the file's contents against the previously-recorded value." } ;
 
 HELP: refresh
@@ -10,7 +10,9 @@ HELP: refresh
 { $description "Reloads source files and documentation belonging to loaded vocabularies whose names are prefixed by " { $snippet "prefix" } " which have been modified on disk." } ;
 
 HELP: refresh-all
-{ $description "Reloads source files and documentation for all loaded vocabularies which have been modified on disk." } ;
+{ $description "Reloads source files and documentation for all loaded vocabularies which have been modified on disk." }
+{ $notes
+"After a fresh bootstrap if " { $link refresh-all } " reloads any vocabularies, then the boot image was outdated. You can generate a new boot image with " { $link make-my-image } " and bootstrap again." } ;
 
 { refresh refresh-all } related-words