lalr1.cc: improve Doxygen documentation.

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

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

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.
  */
 

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