mwunsch's comments

mwunsch | 5 days ago | on: Mansplain – Generate mdoc(7) man pages from –help output using LLMs

Author here. I've been thinking about this for a bit — most modern CLI/TUI tools (especially in the AI space) don't ship man pages. The format is structurally ideal for agent consumption: standardized, terse, offline, parseable. But nobody writes them because the toolchain is hostile.

mansplain attacks this from two angles:

1. `generate` — point it at --help output, a README, or stdin and get a well-formed mdoc(7) man page via any OpenAI-compatible API.

2. `convert` — deterministic compilation of ronn-format Markdown to mdoc. Inspired by Ryan Tomayko's ronn (https://github.com/rtomayko/ronn), which I used years ago in some Ruby projects.

It also ships as an agent skill (`npx skills add mwunsch/mansplain`) — any coding agent can learn to write man pages as part of its normal workflow, no binary required. The SKILL.md is the system prompt for the CLI too, so they stay in sync.

Written in Go. Ships its own man page, generated by itself. MIT licensed.

mwunsch | 13 years ago | on: Show HN: OS X Text Substitution and osxsub

Thanks!

Adding backticks to the code spans is set in my CSS: http://mwunsch.tumblr.com/post/15836468477/espresso-tutti-co...

It was a stylistic choice to show off the markdown itself.

mwunsch | 13 years ago | on: Cross-platform emoji solution

I agree in principal, but in practice no such font is widely available. The emoji cheat sheet has emerged because a desire to use emoji exists, but both input and display are not well supported. The solution I propose, albeit imperfect, works today to display emoji input to those who would not otherwise see it.