@@ 1,4 1,12 @@
-* What is it?
++++
+title = "duodecimal"
+description = "A library, and set of applications for manipulating duodecimal (base-12) numbers."
+tags = [ "haskell", tool" ]
+categories = [ "Utility" ]
++++
+
+DuoDecimal
+===========
A library, and set of applications for manipulating duodecimal (base-12)
numbers. The library provides mechanisms for adding, multiplying, subtracting,
@@ 13,43 21,41 @@ containing duodecimal numbers. The RPN
library gtk2hs.
-* Building:
-
+GUI
+---
-** RPN GUI:
-
-*** Dependencies: gtk2hs
+Dependencies: gtk2hs
- ghc --make -isrc -odir out -hidir out -o duodecimal src/Control.hs
-
-*** Usage:
+```sh
+ghc --make -isrc -odir out -hidir out -o duodecimal src/Control.hs
+```
- Run ./duodecimal. The calculator understands duodecimal numbers (10 => A, 11
- => B), *, /, +, -, and Backspace. Backspace pops the top item from the stack;
- the other keys are evaluated in-line.
+Run `./duodecimal`. The calculator understands duodecimal numbers (10 => A, 11
+=> B), *, /, +, -, and Backspace. Backspace pops the top item from the stack;
+the other keys are evaluated in-line.
-*** Bugs, Caveats:
+### Bugs, Caveats
- The GUI isn't terribly smart. It doesn't handle exceptions very well, such as
- trying to pop from an empty stack, or trying to perform a calculation on an
- insufficient number of arguments. It also won't be very happy to receive
- ill-formed numbers; basically, there's very little error checking.
+The GUI isn't terribly smart. It doesn't handle exceptions very well, such as
+trying to pop from an empty stack, or trying to perform a calculation on an
+insufficient number of arguments. It also won't be very happy to receive
+ill-formed numbers; basically, there's very little error checking.
- The calculator only takes floating point numbers out to 10 decimal places; you
- can change this in DuoDecimal.hs.
+The calculator only takes floating point numbers out to 10 decimal places; you
+can change this in DuoDecimal.hs.
-
-** Command line:
+Command line
+------------
-*** Dependencies: None
+Dependencies: None
- ghc --make -isrc -odir out -hidir out -o dd src/Main.hs
-
-*** Usage:
+```sh
+ghc --make -isrc -odir out -hidir out -o dd src/Main.hs
+```
- Run ./dd without arguments for help.
+Run `./dd` without arguments for help.
-*** Bugs, Caveats:
+### Bugs, Caveats:
- None. Poorly formatted numbers (too many decimals, illegal characters)
- result in cryptic error messages.
+None, although poorly formatted numbers (too many decimals, illegal characters)
+may result in cryptic error messages.