4 ms·
I wrote a literate programming preprocessor in Haskell[0], and used it to weave/tangle a D-Bus implementation (also in Haskell). The woven PDF[1] weighs in arou
by jmillikin 3y ago
I wrote a literate programming preprocessor in Haskell[0], and used it to weave/tangle a D-Bus implementation (also in Haskell). The woven PDF[1] weighs in around 90 pages.
I'll quote from the linked page regarding my conclusions:
------------>8----------
But in the end, I was never able to realize the promised benefits of Literate Programming. The typeset PDF was not easier to read than hypertext documentation generated by Haddock, and both were obviously worse than the very nice docs being created by the Python community with Sphinx.
So in mid 2012 (~3 years after starting the project) I removed all the literate annotations and styles, dropped the fancy build scripts, and released haskell-dbus 0.10 as standard Haskell.
------------>8----------
I'm sure an expert in LaTeX could do a better job with the formatting, and with the benefit of 10 additional years of experience there are some design decisions I would do differently in the code, but even so I think it was a reasonably effortful attempt.
I've never felt any urge to try Literate Programming again.
[0] https://john-millikin.com/software/anansi#history https://john-millikin.com/software/anansi#history
[1] https://github.com/jmillikin/haskell-dbus/releases/download/dbus-core_0.9.2.1/dbus-core_0.9.2.1.pdf https://github.com/jmillikin/haskell-dbus/releases/download/...
- cnity 3y agoCute fleurons.
- smcl 3y agoI really hope that "--->8---" catches on here as a way to quote an extract from something nicely :)
- yuchi 3y agoThe actual size may change a lot depending on the font, but there’s a nice Unicode symbol for that: ——— <redacted> ——— Update: apparently HN doesn’t like some characters… Anyway these are the characters: https://unicode.org/charts/nameslist/n_2700.html https://unicode.org/charts/nameslist/n_2700.html - 2700 Black Safety Scissors - 2701 Upper Blade Scissors - 2702 Black Scissors - 2703 Lower Blade Scissors - 2704 White Scissors
- smcl 3y agoOh that's neat, but I've no problem using the little emoticon style 8< or >8