;dev: cli: doc cleanups

This commit is contained in:
Simon Michael 2024-09-13 12:33:16 -07:00
parent 6f10818544
commit e330ec9424

View File

@ -444,12 +444,13 @@ cmdargsParse desc m args0 = process m (ensureDebugFlagHasVal args0)
-- Notes: -- Notes:
-- --
-- - This hackery increases the risk of misleading errors, bugs, and confusion. -- - This hackery increases the risk of misleading errors, bugs, and confusion.
-- But it should be fairly robust now, being aware of all builtin flags. -- It should be fairly robust now, being aware of all builtin flags.
-- The main tests are in hledger/test/cli/cli.test, but they are not exhaustive.
-- --
-- - All general and builtin command flags (and their values) will be moved. It's clearer to -- - All general and builtin command flags (and their values) will be moved. It's clearer to
-- write command flags after the command, but if not we'll handle it (for greater robustness). -- write command flags after the command, but if not we'll handle it (for greater robustness).
-- --
-- - Long flags should be spelled in full; abbreviated long flags may not be moved. -- - Long flags should be spelled in full; abbreviated long flags might not get moved.
-- --
-- - Unknown flags (from addons) are assumed to be valueless or have a joined value, -- - Unknown flags (from addons) are assumed to be valueless or have a joined value,
-- and will be moved - but later rejected by cmdargs. -- and will be moved - but later rejected by cmdargs.