On Thu, 23 Jan 2020, Robert P. J. Day wrote:
given that i'm poking around man pages and submitting (admittedly minor) fixes, can someone clarify the proper markdown for commands versus files?
it seems that the marking of commands and/or filenames bounces back and forth between, well, what you see in podman-unshare.1.md:
**podman unshare** ... snip ... Executing `podman mount` fails for unprivileged users unless the user is running inside a `podman unshare` session.
while filenames seem to typically use backquotes.
i have no intention of generating massive churn making all of that consistent, but if i'm submitting a fix for a man page anyway, it might be useful to at least make that page consistent while i'm there.
thoughts?
as this morning's example, i fixed a couple things in "man podman-unshare" (grammar and list formatting), so i cleaned up the markdown while i was there: https://github.com/containers/libpod/pull/4951 that's the sort of thing i had in mind. rday