FindBISON: Update documentation

This fixes typos and syncs the style according to other documentation
pages.

Modules/FindBISON.cmake

diff --git a/Modules/FindBISON.cmake b/Modules/FindBISON.cmake
index 6d0ace7..fca054d 100644
--- a/Modules/FindBISON.cmake
+++ b/Modules/FindBISON.cmake
@@ -9,30 +9,34 @@
 
 The module defines the following variables:
 
+``BISON_FOUND``
+  True if the program was found.
+
 ``BISON_EXECUTABLE``
-  path to the ``bison`` program
+  The path to the ``bison`` program.
 
 ``BISON_VERSION``
-  version of ``bison``
-
-``BISON_FOUND``
-  "True" if the program was found
+  The version of ``bison``.
 
 The minimum required version of ``bison`` can be specified using the
-standard CMake syntax, e.g.  :command:`find_package(BISON 2.1.3)`.
+standard CMake syntax, e.g. :command:`find_package(BISON 2.1.3)`.
 
-If ``bison`` is found, the module defines the macro::
+If ``bison`` is found, the module defines the macro:
 
-  BISON_TARGET(<Name> <YaccInput> <CodeOutput>
-               [COMPILE_FLAGS <flags>]
-               [DEFINES_FILE <file>]
-               [VERBOSE [<file>]]
-               [REPORT_FILE <file>]
-               )
+.. command:: bison_target
+
+  .. code-block:: cmake
+
+    bison_target(<Name> <YaccInput> <CodeOutput>
+                 [COMPILE_FLAGS <string>]
+                 [DEFINES_FILE <file>]
+                 [VERBOSE [<file>]]
+                 [REPORT_FILE <file>]
+                 )
 
 which will create a custom rule to generate a parser.  ``<YaccInput>`` is
 the path to a yacc file.  ``<CodeOutput>`` is the name of the source file
-generated by bison.  A header file is also be generated, and contains
+generated by bison.  A header file can also be generated, and contains
 the token list.
 
 .. versionchanged:: 3.14
@@ -41,8 +45,9 @@
 
 The options are:
 
-``COMPILE_FLAGS <flags>``
-  Specify flags to be added to the ``bison`` command line.
+``COMPILE_FLAGS <string>``
+  Space-separated bison options added to the ``bison`` command line.
+  A :ref:`;-list <CMake Language Lists>` will not work.
 
 ``DEFINES_FILE <file>``
   .. versionadded:: 3.4
@@ -65,29 +70,31 @@
 The macro defines the following variables:
 
 ``BISON_<Name>_DEFINED``
-  ``True`` is the macro ran successfully
+  True if the macro ran successfully.
 
 ``BISON_<Name>_INPUT``
-  The input source file, an alias for <YaccInput>
+  The input source file, an alias for ``<YaccInput>``.
 
 ``BISON_<Name>_OUTPUT_SOURCE``
-  The source file generated by bison
+  The source file generated by ``bison``.
 
 ``BISON_<Name>_OUTPUT_HEADER``
-  The header file generated by bison
+  The header file generated by ``bison``.
 
 ``BISON_<Name>_OUTPUTS``
-  All files generated by bison including the source, the header and the report
+  All files generated by ``bison`` including the source, the header and the
+  report.
 
 ``BISON_<Name>_COMPILE_FLAGS``
-  Options used in the ``bison`` command line
+  Options used in the ``bison`` command line.
 
-Example usage:
+Examples
+^^^^^^^^
 
 .. code-block:: cmake
 
   find_package(BISON)
-  BISON_TARGET(MyParser parser.y ${CMAKE_CURRENT_BINARY_DIR}/parser.cpp
+  bison_target(MyParser parser.y ${CMAKE_CURRENT_BINARY_DIR}/parser.cpp
                DEFINES_FILE ${CMAKE_CURRENT_BINARY_DIR}/parser.h)
   add_executable(Foo main.cpp ${BISON_MyParser_OUTPUTS})
 #]=======================================================================]