Re: lalr1.cc: improve Doxygen documentation (was: header file guards conflict)

[Akim Demaille]

Le 21 mai 2012 à 14:42, Akim Demaille a écrit :

> lalr1.cc: extract stack.hh.
>  To make merging easier in master.
> lalr1.cc: improve Doxygen documentation.
>  To include the prefix part in the \file directive.
> skeletons: remove support for unused directive.
>  Something that should never have been included.
> c++: compute the header guards.
>  Really compute the CPP guards.

From 0e931dcd2eee03611ca980ed0d7805d045d3438c Mon Sep 17 00:00:00 2001
From: Akim Demaille <address@hidden>
Date: Mon, 21 May 2012 11:40:42 +0200
Subject: [PATCH 2/4] lalr1.cc: improve Doxygen documentation.

* data/location.cc: Qualify file names with directory name.
---
 data/lalr1.cc    |    5 +++++
 data/location.cc |    4 ++--
 data/stack.hh    |    5 +++++
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/data/lalr1.cc b/data/lalr1.cc
index c63e66d..0fe3aee 100644
--- 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 cb0f1f9..0ee02c2 100644
--- 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 e785e80..5293377 100644
--- 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
 
-- 
1.7.10.2