On Thu Oct 24, 2024 at 6:46 PM CEST, G. Branden Robinson wrote:
> [...]
> > I tried to do this for years and the result was always sub-optimal. I
> > started by using `pandoc` to reformat Markdown as a man page.  Then I
> > converted the docs to asciidoc and used `asciidoctor` (or `asciidoc`)
> > to convert that to a man page.  Finally, I spent about ~4-6 hours
> > learning the basics of `roff` and how to write a man page.  It would
> > have taken me a lot less time had I know[n] about the existence of
> > `man groff_man_style`.  On a Linux system at least, _that's_ where the
> > gold is.
> https://www.reddit.com/r/rust/comments/184ijwg/ripgrep_14_released_hyperlink_support_regex/

I wonder if the author tried Drew DeVault's scdoc, it seems to work
well for simpler manpages. (Output is man.)

https://git.sr.ht/~sircmpwn/scdoc/blob/master/scdoc.5.scd (input)
https://paste.c-net.org/GrillingThyroid (output)
https://man.voidlinux.org/man5/scdoc.5 (HTML rendering)

~ onf

Reply via email to