From e330ec9424995cf04100d8cd69dee5160a9a2622 Mon Sep 17 00:00:00 2001 From: Simon Michael Date: Fri, 13 Sep 2024 12:33:16 -0700 Subject: [PATCH] ;dev: cli: doc cleanups --- hledger/Hledger/Cli.hs | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/hledger/Hledger/Cli.hs b/hledger/Hledger/Cli.hs index b575ddc4d..e23cfa7b5 100644 --- a/hledger/Hledger/Cli.hs +++ b/hledger/Hledger/Cli.hs @@ -444,12 +444,13 @@ cmdargsParse desc m args0 = process m (ensureDebugFlagHasVal args0) -- Notes: -- -- - 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 -- 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, -- and will be moved - but later rejected by cmdargs.