The author was inspired by the usefulness of examples in man pages and improved them for the dig and tcpdump tools. The primary goal was to provide the most basic examples for infrequent users or beginners. This approach of targeting beginners and infrequent users has proven effective and well-received. The author found the review process valuable, leading to more accurate information discoverable within man pages. They learned about useful tcpdump features, such as the -v flag when saving packets. Despite a general skepticism towards documentation, the author is now optimistic about the potential for high-quality, accurate man pages. To avoid learning roff, a custom markdown-to-roff script was created for the tcpdump man page updates. This involved parsing Markdown's Abstract Syntax Tree and emitting roff code. The author also explored the history and evolution of roff and the mandoc project. Curiosity was sparked regarding the technical and cultural differences in documentation practices between BSD and Linux systems.
-vflag when saving packets. Despite a general skepticism towards documentation, the author is now optimistic about the potential for high-quality, accurate man pages. To avoid learning roff, a custom markdown-to-roff script was created for the tcpdump man page updates. This involved parsing Markdown's Abstract Syntax Tree and emitting roff code. The author also explored the history and evolution of roff and the mandoc project. Curiosity was sparked regarding the technical and cultural differences in documentation practices between BSD and Linux systems.