clarify options name behaviour

Author: schmalliso

source/reference/options.txt

@@ -39,8 +39,8 @@ Fields
 
 - ``name``: Name of the option/setting. 
 
-  When generated, giza automatically
-  prepends two dashes ``-`` to the beginning except when the first
+  If the directive is ``option``, giza automatically
+  prepends two dashes ``-`` to the beginning of the filename unless the first
   character of the name value is ``<`` or ``-``.
 
   The following would therefore render as ``--host``:
@@ -160,7 +160,7 @@ Built-In Variables
 ------------------
 
 - ``{{role}}``: automatically replaced by a link to the option or
-  setting (e.g. :option:`mongod --dbpath`).
+  setting (e.g. :option:`mongod.--dbpath`).
 
 - ``{{program}}``: automatically replaced by the a link to the option
   or setting's specified ``program`` (e.g. :binary:`~bin.mongod`).