diff --git a/data/core/init.lua b/data/core/init.lua
index 0f20576f..59601d2e 100644
--- a/data/core/init.lua
+++ b/data/core/init.lua
@@ -166,7 +166,7 @@ local function write_user_init_file(init_filename)
   init_file:write([[
 -- put user settings here
 -- this module will be loaded after everything else when the application starts
--- it will be automatically reloaded when use save it
+-- it will be automatically reloaded when saved
 
 local keymap = require "core.keymap"
 local config = require "core.config"
@@ -187,6 +187,14 @@ local style = require "core.style"
 -- style.big_font  : big text in welcome screen
 -- style.icon_font : icons
 -- style.code_font : code
+--
+-- the function to load the font accept a 3rd optional argument like:
+--
+-- {antialiasing="grayscale", hinting="full"}
+--
+-- possible values are:
+-- antialiasing: grayscale, subpixel
+-- hinting: none, slight, full
 ]])
   init_file:close()
 end
diff --git a/data/user/init.lua b/data/user/init.lua
index b72bab26..afaa6108 100644
--- a/data/user/init.lua
+++ b/data/user/init.lua
@@ -1,6 +1,6 @@
 -- put user settings here
 -- this module will be loaded after everything else when the application starts
--- it will be automatically reloaded when use save it
+-- it will be automatically reloaded when saved
 
 local keymap = require "core.keymap"
 local config = require "core.config"
@@ -21,4 +21,11 @@ local style = require "core.style"
 -- style.big_font  : big text in welcome screen
 -- style.icon_font : icons
 -- style.code_font : code
-
+--
+-- the function to load the font accept a 3rd optional argument like:
+--
+-- {antialiasing="grayscale", hinting="full"}
+--
+-- possible values are:
+-- antialiasing: grayscale, subpixel
+-- hinting: none, slight, full