News for hackers. Stuff that matters.
Re:Literate Programming: Articles by jmillikin on Thursday May 18, 2023 @05:38AM (#35985835)
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

[1] https://github.com/jmillikin/haskell-dbus/releases/download/...

Re:Literate Programming: Articles by cnity on Thursday May 18, 2023 @05:49AM (#35985893)
Cute fleurons.
Re:Literate Programming: Articles by smcl on Thursday May 18, 2023 @06:30AM (#35986153)
I really hope that "--->8---" catches on here as a way to quote an extract from something nicely :)
Re:Literate Programming: Articles by yuchi on Thursday May 18, 2023 @07:18AM (#35986431)
The 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

- 2700 Black Safety Scissors

- 2701 Upper Blade Scissors

- 2702 Black Scissors

- 2703 Lower Blade Scissors

- 2704 White Scissors

Re:Literate Programming: Articles by smcl on Thursday May 18, 2023 @07:42AM (#35986599)
Oh that's neat, but I've no problem using the little emoticon style 8< or >8