docs: Follow man-pages(7) suggestions for SYNOPSIS

man-pages(7) has [1]:

> For commands, this shows the syntax of the command and its arguments
> (including options); boldface is used for as-is text and italics are
> used to indicate replaceable arguments. Brackets ([]) surround
> optional arguments, vertical bars (|) separate choices, and ellipses
> (...) can be repeated.

I've adjusted our SYNOPSIS entries to match that formatting, and
generally tried to make them more consistent with the precedent set by
the man-pages project.  Outside of the SYNOPSIS entry, I prefer using
backticks for literals, although in some places I've left the **
bolding to keep things visually similar to a nearby SYNOPSIS entry.

[1]: http://man7.org/linux/man-pages/man7/man-pages.7.html

Signed-off-by: W. Trevor King <wking@tremily.us>

Closes: #1027
Approved by: rhatdan

1 files changed, 2 insertions, 5 deletions

diff --git a/docs/podman-wait.1.md b/docs/podman-wait.1.md
index 085472a0c..3868928dd 100644
--- a/docs/podman-wait.1.md
+++ b/docs/podman-wait.1.md
@@ -4,17 +4,14 @@
 podman\-wait - Waits on one or more containers to stop and prints exit code
 
 ## SYNOPSIS
-**podman wait**
-[**--help**|**-h**]
+**podman wait** [*options*] *container*
 
 ## DESCRIPTION
 Waits on one or more containers to stop.  The container can be referred to by its
 name or ID.  In the case of multiple containers, podman will wait on each consecutively.
 After the container stops, the container's return code is printed.
 
-**podman [GLOBAL OPTIONS] wait **
-
-## GLOBAL OPTIONS
+## OPTIONS
 
 **--help, -h**