build: use -fparse-all-comments with -Wdocumentation

[Akim Demaille]

This revealed no error.

commit 493182f70e4cac49abdab375c6219a69ffc1a4a5
Author: Akim Demaille <address@hidden>
Date:   Sun Sep 9 17:19:08 2018 +0200

    build: use -fparse-all-comments with -Wdocumentation
    
    Clang checks only /** ... */ comments without this flag.
    
    * configure.ac (warn_common): Also check -fparse-all-comments.

diff --git a/configure.ac b/configure.ac
index cf4428d7..3e730a07 100644
--- a/configure.ac
+++ b/configure.ac
@@ -84,7 +84,8 @@ AC_ARG_ENABLE([gcc-warnings],
               [enable_gcc_warnings=no])
 AM_CONDITIONAL([ENABLE_GCC_WARNINGS], [test "$enable_gcc_warnings" = yes])
 if test "$enable_gcc_warnings" = yes; then
-  warn_common='-Wall -Wextra -Wno-sign-compare -Wcast-align -Wdocumentation
+  warn_common='-Wall -Wextra -Wno-sign-compare -Wcast-align
+    -fparse-all-comments -Wdocumentation
     -Wformat -Wnull-dereference -Wpointer-arith -Wwrite-strings'
   warn_c='-Wbad-function-cast -Wshadow -Wstrict-prototypes'
   warn_cxx='-Wnoexcept'
diff --git a/data/lalr1.cc b/data/lalr1.cc
index 4679eb42..f9165056 100644
--- a/data/lalr1.cc
+++ b/data/lalr1.cc
@@ -344,7 +344,7 @@ b4_location_define])])[
     ///             if null, no trace is output.
     /// \param s    the state
     /// \param sym  the symbol (for its value and location).
-    /// \warning the contents of \a s.value is stolen.
+    /// \warning the contents of \a sym.value is stolen.
     void yypush_ (const char* m, state_type s, symbol_type& sym);
 
     /// Pop \a n symbols the three stacks.