diff --git a/src/makeBaseApp/top/configure/CONFIG b/src/makeBaseApp/top/configure/CONFIG
index bf5e617fc..d95c11cae 100644
--- a/src/makeBaseApp/top/configure/CONFIG
+++ b/src/makeBaseApp/top/configure/CONFIG
@@ -1,13 +1,17 @@
-#CONFIG
+# CONFIG
 include $(TOP)/configure/CONFIG_APP
-# Add any changes to make definitions here
 
+# Make any application-specific changes to the EPICS build
+# configuration variables in this file.
+
+# Set this when you only want to compile this application
+# for a subset of the cross-compiled target architectures
+# that Base is built for.
 #CROSS_COMPILER_TARGET_ARCHS = vxWorks-68040
 
-# Use this when your IOC and the host use different paths
-# to access the application. Typically this will be 
-# used with the Microsoft FTP server or with NFS mounts. Use
-# is indicated by failure of the cdCommands script on
-# vxWorks. You must rebuild in the iocBoot directory 
-# before this takes effect.
-#IOCS_APPL_TOP = <the top of the application as seen by the IOC>
+# Set this when your IOC and the host use different paths
+# to access the application. This will be needed to boot
+# from a Microsoft FTP server or with some NFS mounts.
+# You must rebuild in the iocBoot directory for this to
+# take effect.
+#IOCS_APPL_TOP = <path to application top as seen by IOC>