X-Git-Url: http://gitweb.michael.orlitzky.com/?a=blobdiff_plain;f=src%2FCommandLine.hs;h=c2bbe0c45f15a6e023ab45597de7d8ad82561826;hb=e1d16438b44ecd962565756a828c9ed8014cf894;hp=31ca768cfaa043b872168313bc5153548bc37a5f;hpb=6c671cd410b81257514e1be76ca3f252ea69ccdb;p=hath.git

diff --git a/src/CommandLine.hs b/src/CommandLine.hs
index 31ca768..c2bbe0c 100644
--- a/src/CommandLine.hs
+++ b/src/CommandLine.hs
@@ -16,70 +16,72 @@ import System.Console.GetOpt
 import System.Environment (getArgs)
 
 
--- Dark magic.
+-- | Lowercase an entire string.
 lowercase :: String -> String
 lowercase = map toLower
 
 
--- The application currently has three modes. The default, Regex, will
--- compute a regular expression matching the input CIDRs. Reduce, on
--- the other hand, will combine any redundant/adjacent CIDR blocks
--- into one. Dupe will show you what would be removed by Reduce.
-data Mode = Regex | Reduce | Dupe
+-- | The application currently has four modes. The default, Regex,
+--   will compute a regular expression matching the input
+--   CIDRs. Reduce, on the other hand, will combine any
+--   redundant/adjacent CIDR blocks into one. Dupe will show you what
+--   would be removed by Reduce, and Diff will show both additions and
+--   deletions in a diff-like format.
+data Mode = Regex | Reduce | Dupe | Diff
 
 
--- A record containing values for all available options.
+-- | A record containing values for all available options.
 data Options = Options { opt_help  :: Bool,
                          opt_input :: IO String }
 
 
--- This constructs an instance of Options, with each of its members
--- set to default values.
+-- | This constructs an instance of Options, with each of its members
+--   set to default values.
 default_options :: Options
 default_options = Options { opt_help = False,
                             opt_input = getContents }
 
 
--- The options list that we construct associates a function with each
--- option. This function is responsible for updating an Options record
--- with the appropriate value.
+-- | The options list that we construct associates a function with
+--   each option. This function is responsible for updating an Options
+--   record with the appropriate value.
 --
--- For more information and an example of this idiom, see,
+--   For more information and an example of this idiom, see,
 --
--- http://www.haskell.org/haskellwiki/High-level_option_handling_with_GetOpt
+--   http://www.haskell.org/haskellwiki/High-level_option_handling_with_GetOpt
 --
 options :: [OptDescr (Options -> IO Options)]
 options =
-  [ Option ['h'][] (NoArg set_help) "Prints this help message.",
-    Option ['i'][] (ReqArg set_input "FILE") "Read FILE instead of stdin." ]
+  [ Option ['h']["help"] (NoArg set_help) "Prints this help message.",
+    Option ['i']["input"] (ReqArg set_input "FILE") "Read FILE instead of stdin." ]
 
--- Takes an Options as an argument, and sets its opt_help member to
--- True.
+-- | Takes an Options as an argument, and sets its opt_help member to
+--   True.
 set_help :: Options -> IO Options
 set_help opts = do
   return opts { opt_help = True }
 
 
--- If the input file option is set, this function will update the
--- passed Options record with a new function for opt_input. The
--- default opt_input is to read from stdin, but if this option is set,
--- we replace that with readFile.
+-- | If the input file option is set, this function will update the
+--   passed Options record with a new function for opt_input. The
+--   default opt_input is to read from stdin, but if this option is
+--   set, we replace that with readFile.
 set_input :: String -> Options -> IO Options
 set_input arg opts = do
   return opts { opt_input = readFile arg }
 
 
--- The usage header
+-- | The usage header.
 usage :: String
-usage = "Usage: hath [regexed|reduced|duplicated] [-h] [-i FILE]"
+usage = "Usage: hath [regexed|reduced|duped|diffed] [-h] [-i FILE] <input>"
 
 
--- The usage header, and all available flags (as generated by GetOpt)
+-- | The usage header, and all available flags (as generated by GetOpt).
 help_text :: String
 help_text = usageInfo usage options
 
 
--- Return a list of options.
+-- | Return a list of options.
 parse_options :: IO Options
 parse_options = do
   argv <- getArgs
@@ -94,7 +96,7 @@ parse_options = do
   return opts
 
 
--- Return the mode if one was given.
+-- | Return the mode if one was given.
 parse_mode :: IO Mode
 parse_mode = do
   argv <- getArgs
@@ -106,18 +108,20 @@ parse_mode = do
     else do
       -- Some non-option was given, but were any of them modes?
       case (lowercase (non_options !! 0)) of
-        "regex"      -> return Regex
-        "regexed"    -> return Regex
-        "reduce"     -> return Reduce
-        "reduced"    -> return Reduce
-        "dupe"       -> return Dupe
-        "duplicated" -> return Dupe
+        "regex"   -> return Regex
+        "regexed" -> return Regex
+        "reduce"  -> return Reduce
+        "reduced" -> return Reduce
+        "dupe"    -> return Dupe
+        "duped"   -> return Dupe
+        "diff"    -> return Diff
+        "diffed"  -> return Diff
         _         -> return Regex
 
 
 
 
--- Return a list of errors.
+-- | Return a list of errors.
 parse_errors :: IO [String]
 parse_errors = do
   argv <- getArgs
@@ -126,15 +130,15 @@ parse_errors = do
 
 
 
--- Is the help option set?
+-- | Is the help option set?
 help_set :: IO Bool
 help_set = do
     opts <- parse_options
     return (opt_help opts)
 
 
--- Return our input function, getContents by default, or readFile if
--- the input file option was set.
+-- | Return our input function, getContents by default, or readFile if
+--   the input file option was set.
 input_function :: IO (IO String)
 input_function = do
     opts <- parse_options