From 94828bc348c4aab0d91da6499c30b26c2ef8f8e2 Mon Sep 17 00:00:00 2001 From: Andreas Stöckel Date: Sun, 11 Jan 2015 23:57:57 +0100 Subject: Silenced doxygen warnings --- src/core/model/Document.hpp | 8 ++++++++ src/core/model/Domain.hpp | 10 ++++++++++ 2 files changed, 18 insertions(+) (limited to 'src') diff --git a/src/core/model/Document.hpp b/src/core/model/Document.hpp index e27b577..a18e389 100644 --- a/src/core/model/Document.hpp +++ b/src/core/model/Document.hpp @@ -34,6 +34,7 @@ * * Consider this XML representation of a document using the "book" domain: * + * \code{.xml} * * * @@ -59,6 +60,7 @@ * * * + * \endcode * * As can be seen the StructureEntities inherently follow a tree structure that * is restricted by the implicit context free grammar of the "book" Domain @@ -70,12 +72,16 @@ * overlapping annotations and provides a more intuitive (and semantically * sound) handling of such span-like concepts. So the * + * \code{.xml} * content + * \endcode * * is implicitly expanded to: * + * \code{.xml} * content * + * \endcode * * Note that the place of an AnnotationEntity within the XML above is not * strictly defined. It might as well be placed as a child of the "book" node. @@ -88,11 +94,13 @@ * * is implicitly expanded using transparency to: * + * \code{.xml} * * * Here we might find the actual section content. * * + * \endcode * * @author Benjamin Paaßen (bpaassen@techfak.uni-bielefeld.de) */ diff --git a/src/core/model/Domain.hpp b/src/core/model/Domain.hpp index c80d057..3a56e52 100644 --- a/src/core/model/Domain.hpp +++ b/src/core/model/Domain.hpp @@ -32,6 +32,7 @@ * in turn might contain two FieldDescriptors, one for the meta data of ones * book and one for the actual structure. Consider the following XML: * + * \code{.xml} * * * @@ -89,6 +90,7 @@ * * * + * \endcode * * Note that we define one field as the TREE (meaning the main or default * document structure) and one mearly as SUBTREE, relating to supporting @@ -101,6 +103,7 @@ * * The translation to context free grammars is as follows: * + * \code{.txt} * BOOK := BOOK_TREE * BOOK_TREE := CHAPTER BOOK_TREE | PARAGRAPH BOOK_TREE | epsilon * CHAPTER := CHAPTER_TREE @@ -112,6 +115,7 @@ * SUBSECTION_TREE := PARAGRAPH SUBSECTION_TREE | epsilon * PARAGRAPH := PARAGRAPH_CONTENT * PARAGRAPH_CONTENT := string + * \endcode * * Note that this translation recurs to further nonterminals like SECTION but * necessarily produces one "book" terminal. Also note that, in principle, @@ -122,6 +126,7 @@ * It is possible to add further fields, like we would in the "headings" domain * to add titles to our structure. * + * \code{.xml} * * * @@ -139,11 +144,14 @@ * * * + * \endcode * * This would change the context free grammar as follows: * + * \code{.txt} * BOOK := HEADING BOOK_TREE * HEADING := PARAGRAPH + * \endcode * * AnnotationClasses on the other hand do not specify a context free grammar. * They merely specify what kinds of Annotations are allowed within this domain @@ -151,6 +159,7 @@ * to define structured children that manifest e.g. meta information of that * Annotation. An example for that would be the "comment" domain: * + * \code{.xml} * * * @@ -183,6 +192,7 @@ * * * + * \endcode * * Here we have comment annotations, which have a reply tree as sub structure. * -- cgit v1.2.3