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