lalr1.cc: improve Doxygen documentation.

* data/location.cc: Qualify file names with directory name.

diff --git a/data/lalr1.cc b/data/lalr1.cc
index c63e66de5b1ef62214b38f1cff224d0b4cb83778..0fe3aeed40eb35751e25b8bf779922f565850650 100644 (file)
--- a/data/lalr1.cc
+++ b/data/lalr1.cc
@@ -39,6 +39,11 @@ b4_copyright([Skeleton interface for Bison LALR(1) parsers in C++],
              [2002-2012])
 dnl FIXME: This is wrong, we want computed header guards.
 [
+/**
+ ** \file ]b4_spec_defines_file[
+ ** Define the ]b4_namespace_ref[::parser class.
+ */
+
 /* C++ LALR(1) parser skeleton written by Akim Demaille.  */
 
 #ifndef PARSER_HEADER_H

diff --git a/data/location.cc b/data/location.cc
index cb0f1f91fb604f06170bdb67ad49dc538c28eb29..0ee02c28bc938ee6a70bfa2758bf81b3712b0cac 100644 (file)
--- a/data/location.cc
+++ b/data/location.cc
@@ -23,7 +23,7 @@ b4_copyright([Positions for Bison parsers in C++],
              [2002-2007, 2009-2012])[
 
 /**
- ** \file position.hh
+ ** \file ]b4_dir_prefix[position.hh
  ** Define the ]b4_namespace_ref[::position class.
  */
 
@@ -154,7 +154,7 @@ b4_copyright([Locations for Bison parsers in C++],
              [2002-2007, 2009-2012])[
 
 /**
- ** \file location.hh
+ ** \file ]b4_dir_prefix[location.hh
  ** Define the ]b4_namespace_ref[::location class.
  */
 

diff --git a/data/stack.hh b/data/stack.hh
index e785e8081895d5a5734eba9fe6996edb5952f359..529337740eb5398a9ef7b58d3ba89e6a919c9ac8 100644 (file)
--- a/data/stack.hh
+++ b/data/stack.hh
@@ -25,6 +25,11 @@ m4_divert_push(0)dnl
 b4_copyright([Stack handling for Bison parsers in C++],
              [2002-2012])[
 
+/**
+ ** \file ]b4_dir_prefix[stack.hh
+ ** Define the ]b4_namespace_ref[::stack class.
+ */
+
 #ifndef BISON_STACK_HH
 # define BISON_STACK_HH