docs: reformat man pages to improve consistency and readability
Change-Id: I4f9afbc73c365dfa31eb6cd1e4a48368b6a9064f
diff --git a/docs/manpages/nfd.rst b/docs/manpages/nfd.rst
index a3ed42b..57db00c 100644
--- a/docs/manpages/nfd.rst
+++ b/docs/manpages/nfd.rst
@@ -4,45 +4,57 @@
Synopsis
--------
-**nfd** [**-h**] [**-V**] [**-c** *file*] [**-m**]
+| **nfd** [**-c**\|\ **\--config** *file*]
+| **nfd** **-h**\|\ **\--help**
+| **nfd** **-m**\|\ **\--modules**
+| **nfd** **-V**\|\ **\--version**
Description
-----------
-NFD forwarding daemon.
+NFD is a network forwarder that implements the Named Data Networking (NDN) protocol.
Options
-------
-``-c <path/to/nfd.conf>`` or ``--config <path/to/nfd.conf>``
- Specify the path to nfd configuration file (default: ``${SYSCONFDIR}/ndn/nfd.conf``).
+.. option:: -c <file>, --config <file>
-``-m`` or ``--modules``
- List available logging modules.
+ Specify the path to NFD's configuration file.
-``-h`` or ``--help``
- Print help message and exit.
+.. option:: -h, --help
-``-V`` or ``--version``
- Show version information and exit.
+ Print help message and exit.
-Exit status
+.. option:: -m, --modules
+
+ List available logging modules.
+
+.. option:: -V, --version
+
+ Show version information and exit.
+
+Exit Status
-----------
-0: No error.
+0
+ No error.
-1: An unspecified error occurred.
+1
+ An unspecified error occurred.
-2: Malformed command line, e.g., invalid, missing, or unknown argument.
+2
+ Malformed command line, e.g., invalid, missing, or unknown argument.
-4: Insufficient privileges.
+4
+ Insufficient privileges.
Examples
--------
-Start NFD forwarding daemon as super user and use a configuration file from the current
-working directory.
+``sudo nfd --config nfd.conf``
+ Start NFD as super user with a configuration file from the current directory.
-::
+See Also
+--------
- sudo nfd --config nfd.conf
+:manpage:`nfdc(1)`