Document a workaround for getting past the groff infinite loop problem

when your userland is older tahn your kernel and Makefile.inc1 therefore
thinks that you don't need to rebuild groff, when in fact you do.  This
workaround is to set OSRELDATE to 500110 before building, but only if you
have a new enough Makefile.inc1.

I've confirmed this on my laptop, which was suffering from this problem.
Since it only hits power users, we'll naively assume that such users are
smart enough to read UPDATING.

1 files changed, 6 insertions, 1 deletions

diff --git a/UPDATING b/UPDATING
index a9b1b5f5c7f6..f3023818effe 100644
--- a/UPDATING
+++ b/UPDATING
@@ -17,6 +17,12 @@ NOTE TO PEOPLE WHO THINK THAT 5.0-CURRENT IS SLOW:
 	developers choose to disable these features on build machines
 	to maximize performance.
 
+20030502:
+	groff has been updated.  If you try to do a buildworld and
+	get an infinite loop in troff, update to May 4th or newer.  If you
+	have a newer kernel than userland, you may need to set the OSRELDATE
+	to 500110 in your environment before starting a buildworld.
+
 20030501:
 	The old rc system has been removed.  Please report any problems
 	to freebsd-rc@yahoogroups.com, and/or freebsd-current@freebsd.org.
@@ -25,7 +31,6 @@ NOTE TO PEOPLE WHO THINK THAT 5.0-CURRENT IS SLOW:
 	especially when using mergemaster, since the compatibility code that
 	utilizes these old scripts has also been removed.
 
-
 20030423:
 	A bug has been fixed in /dev/devctl which would cause devd
 	to hang on boot, were it not for a workaround in devd.  The