Even better docs

1 files changed, 5 insertions, 2 deletions

diff --git a/trivmix/Trivmix.hs b/trivmix/Trivmix.hs
index 8cfa1b6..fe62619 100644
--- a/trivmix/Trivmix.hs
+++ b/trivmix/Trivmix.hs
@@ -51,22 +51,25 @@ optionParser = Options
                                <> metavar "STRING"
                                <> value "in"
                                <> showDefault
+                               <> help "Name of the input port"
                              )
                <*> strOption ( long "output"
                                 <> metavar "STRING"
                                 <> value "out"
                                 <> showDefault
+                                <> help "Name of the output port"
                               )
                <*> strOption ( long "client"
                                <> metavar "STRING"
+                               <> help "Client name to use in jack (the part before the colon in port names)"
                              )
                <*> optional ( strOption ( long "run"
                                           <> metavar "FILE"
-                                          <> help "Execute a file once setup of jacks is done (use this to autoconnect)"
+                                          <> help "Execute a file once setup of jacks is done (use this to autoconnect)\nThe executable gets passed the input port (including client name) as its first argument and the output as its second."
                                         )
                             )
                <*> some (strArgument ( metavar "FILE..."
-                                       <> help "Files that contain levels to assume and synchronize — For deterministic behaviour use flock(2)"
+                                       <> help "Files that contain levels to assume and synchronize\nFor deterministic behaviour use flock(2).\nThe format used in these files is either a signed float, using ‘.’ as a decimal point or a signed float postfixed with ‘dB’.\nCaveat: ‘-InfinitydB’ exists and works as expected (i.e.: it is equal to ‘0.0’)"
                                      )
                         )