Skip to main content

Julia Evans

3 comments on "Examples for the tcpdump and dig man pages"

If you have a Mastodon or Fediverse account, you can reply to this post to leave a comment.

Optionally, set the Mastodon server for "Reply" links:

dzwdz

@b0rk

re: what you said about roff

If you ever contribute to a project that uses mdoc(7) rather than "bare" roff macros, I'd actually recommend giving it a shot! I know it looks very intimidating, but once some friends convinced me to give it a shot anyways, I found it surprisingly comfy!

I'm sure you've stumbled upon that already, but for other people reading this: manpages.bsd.lv/ is a good read.

b0rk
Reply to dzwdz

@dzwdz it does look very intimidating! it's really hard for me to imagine preferring mdoc over something like AsciiDoc or ReStructuredText or Markdown

(i found a talk talking about how mandoc is 100x faster than using AsciiDoc which I'm sure is true but having used AsciiDoc, definitely waiting 1 second for the man page to build was not a problem for me)

jnareb

@b0rk The source code for `dig` manpage seems to be in reStructuredText, based on the *.rst extension... which GitLab mangles rendering of, not showing anything between "where:" and "Options" in "Simple usage".

Plain text is better: gitlab.isc.org/isc-projects/bi