docs: fix syntax highlighting of code blocks

And various other cleanups

Change-Id: I240badc5358c09f006c2a22d4706ce373f2dd188
diff --git a/docs/manpages/nfd-status-http-server.rst b/docs/manpages/nfd-status-http-server.rst
index e4e39eb..9d6ee15 100644
--- a/docs/manpages/nfd-status-http-server.rst
+++ b/docs/manpages/nfd-status-http-server.rst
@@ -1,12 +1,10 @@
 nfd-status-http-server
 ======================
 
-Usage
------
+Synopsis
+--------
 
-::
-
-    nfd-status-http-server [-h] [-p <PORT>] [-a <IPADDR>] [-r] [-v]
+**nfd-status-http-server** [**-h**] [**-a** *IPADDR*] [**-p** *PORT*] [**-r**] [**-v**]
 
 Description
 -----------
@@ -17,14 +15,14 @@
 -------
 
 ``-h``
-  Show this help message and exit.
-
-``-p <PORT>``
-  HTTP server port number (default is 8080).
+  Show help message and exit.
 
 ``-a <IPADDR>``
   HTTP server IP address (default is 127.0.0.1).
 
+``-p <PORT>``
+  HTTP server port number (default is 8080).
+
 ``-r``
   Enable HTTP robots to crawl (disabled by default).