Add note about avoiding -j when following the upgrade path. It isn't

strictly verboten, just a recommendation to avoid problems.
Add note about LINT being built from NOTES.

1 files changed, 10 insertions, 1 deletions

diff --git a/UPDATING b/UPDATING
index a24cbe5..00b96e8 100644
--- a/UPDATING
+++ b/UPDATING
@@ -167,7 +167,7 @@ ITEMS:'
 	the config file update procedure.
 		http://people.freebsd.org/~imp/config-upd.html
 	NOTE: LINT is gone.  It has been replaced with NOTES.  NOTES
-	isn't buildable.
+	isn't buildable.  However, you can generate a LINT file.
 
 20000620:
 	Binutils 2.10 have hit the tree, or will shortly.  As soon
@@ -271,6 +271,15 @@ ITEMS:'
 
 COMMON ITEMS:
 
+	General Notes
+	-------------
+	Avoid using make -j when upgrading.  From time to time in the
+	past there have been problems using -j with buildworld and/or
+	installworld.  This is especially true when upgrading between
+	"distant" versions (eg one that cross a major release boundary
+	or several minor releases, or when several months have passed
+	on the -current branch).
+
 	To build a kernel
 	-----------------
 	If you are updating from a prior version of FreeBSD (even one just