diff --git a/build/cmake/README.md b/build/cmake/README.md
index eed238ef2d..708b78a434 100644
--- a/build/cmake/README.md
+++ b/build/cmake/README.md
@@ -7,7 +7,7 @@ documentation.
 
 CMake files organization
 ========================
-All CMake files are located in $(wx)/build/cmake additionally there is a
+All CMake files are located in _$(wx)/build/cmake_ additionally there is a
 _CMakeLists.txt_ in the root directory.
 
 Files
@@ -19,15 +19,16 @@ Files
     * Generates config files used to find wxWidgets by other build systems
     * Creates wx-config
 * files.cmake
-    * List of source files generated by _update_files.py_ from _$(wx)/build/files_
-    * This file should **never** be edited manually
+    * List of source files generated by _$(wx)build/upmake_ from _$(wx)build/files_
+    * This file should usually **never** be edited manually
+    * However if a new group of files is added it needs to be edited manually
 * functions.cmake
     * contains various wxWidgets specific functions and macros used throughout
       the CMake files
     * Every function should contain a short description of it's parameters as
       a comment before the function/macro
 * install.cmake
-    * Handles defintions for the ´install` and `uninstall` target
+    * Handles defintions for the `install` and `uninstall` target
 * init.cmake
     * Intializes various variables used during the build process and for
       generation of setup.h and configuration files
@@ -49,8 +50,6 @@ Files
     * Define toolkit specific options and detection to this file
 * uninstall.cmake.in
     * Used by _install.cmake_ when creating the `uninstall` target
-* update_files.py
-    * Creates _files.cmake_ from _$(wx)/build/files_
 
 Sub directories
 ---------------