policy: document handle_commandline_options

diff --git a/local/policy.lua b/local/policy.lua
index 6ff17bea626becfe4f5ad65379bd7f8b864216c5..cd32a6454bc4fb6f1a61236252b039cf06761a07 100644 (file)
--- a/local/policy.lua
+++ b/local/policy.lua
@@ -202,8 +202,15 @@ function policy.register_commandline_options()
     Enabled by default in 'release' mode.]])
 end
 
----
+--- Handle overall build modes.
+-- @param opts e2option table.
+-- @param use_default Use default build mode if none is specified.
+-- @return mode table or false on error.
+-- @return Error on failure.
 function policy.handle_commandline_options(opts, use_default)
+    assertIsTable(opts)
+    assertIsBoolean(use_default)
+
     local default_build_mode_name = "tag"
     local nmodes = 0
     local mode = false