--- freem/doc/freem.texi	2025/05/16 13:22:58	1.56
+++ freem/doc/freem.texi	2025/05/17 17:00:05	1.57
@@ -5976,14 +5976,14 @@ Raised when an attempt is made to use a
 FreeM allows the following installation methods:
 @table @asis
 @item Binary Repository
-On recent versions the Ubuntu and Debian distributions of GNU/Linux, we provide package repositories from which FreeM may easily be installed. See the @emph{FreeM Wiki} for more information, and @emph{https://packages.coherent-logic.com} for instructions.
+For recent versions of the Ubuntu and Debian distributions of GNU/Linux, we provide package repositories from which FreeM may easily be installed. See the @emph{FreeM Wiki} for more information, and @emph{https://packages.coherent-logic.com} for instructions.
 
 If available, this is the simplest method of installing FreeM.
 @item Binary Packages
 We provide binary packages of FreeM for @emph{dpkg} and @emph{rpm}-based distributions of GNU/Linux, and @emph{pkgadd} packages for Solaris 8-10. If you cannot use repositories, this is the easiest option.
 
 See @emph{https://freem.coherent-logic.com/binaries.cfm} for downloads and instructions.
-@item Source Archive
+@item Source Tarball
 If you prefer installing from source, we recommend that you download the latest @emph{.tar.gz} file from @emph{https://freem.coherent-logic.com/downloads.cfm}, and follow these steps:
 
 @example
@@ -6035,6 +6035,20 @@ $ ./configure --enable-mwapi
 $ make
 $ sudo make install
 @end example
+
+@item @code{--enable-newglobals} (EXPERIMENTAL)
+Enables a new and modernized global handler. This global handler has a number of known bugs, and thus should be used with caution.
+
+Note that global files created in the default global handler are incompatible with the new global handler, and vice-versa. You will need to back up and remove all globals in your environments when switching global handlers.
+
+
+@emph{Example}
+
+@example
+$ ./configure --enable-newglobals
+$ make
+$ sudo make install
+@end example
 
 @end table