diff --git a/os/hal/boards/readme.txt b/os/hal/boards/readme.txt
index 5d08e8ad1..c033834fd 100644
--- a/os/hal/boards/readme.txt
+++ b/os/hal/boards/readme.txt
@@ -4,3 +4,14 @@ want to support a new board:
 - Copy inside the new directory the files from a similar board.
 - Customize board.c, board.h and board.mk in order to correctly initialize
   your board.
+
+The files in those board directories containing:
+- <board>/cfg/board.chcfg
+- <board>/cfg/board.fmpp
+are generated automatically, just run the "fmpp" tool from within <board>/cfg,
+the download is available here: http://fmpp.sourceforge.net, note, it
+requires Java.
+
+All board files can be batch-regenerated automatically by running the
+genboards.sh script in this same directory.
+