1 files changed, 8 insertions, 2 deletions

diff --git a/UPGRADING b/UPGRADING
index ead80fd83..256fba8b1 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -1,18 +1,21 @@
 For the most part, mailing lists upgrade themselves with the new
 versions.  However, there are some changes in the filesystem that need
-to be taken care of separately.  running "make update" takes care of
+to be taken care of separately.  Running "make update" takes care of
 this for you.  If you still have problems upgrading after running
 this, or want to integrate mbox archives into the pipermail archiving,
 read on.
 
 "make update" creates a file named "update.log" in the top level of
-the source distribution.  If the script that updates the mailman
+the source distribution.  If the script that updates the Mailman
 filesystem encounters something that is not resolvable, it will log
 info about this to "update.log".  This might be worth checking.
 
 Below is an annotated listing of the things that "make update" does.
 Hopefully, this will help resolve any problems you are having.
 
+We update this procedure for each Mailman release, so it can't hurt to 
+run "make update" each time you upgrade.
+
 - Archiving files are moved around as part of integrating pipermail
   into mailman.  In particular, 
 
@@ -63,6 +66,9 @@ Hopefully, this will help resolve any problems you are having.
   variables have changed (There shouldn't be many, only options.html
   was updated from b5 to b6).
 
+- Some modules that existed in previous versions, but that have been
+  replaced with newer (differently named) modules, are removed.
+
 
 Local Variables:
 mode: indented-text