Imported Upstream version 1.9.4upstream/1.9.4

1 files changed, 29 insertions, 1403 deletions

diff --git a/src/docparser.h b/src/docparser.h
index e60b1a1..64db969 100644
--- a/src/docparser.h
+++ b/src/docparser.h
@@ -1,9 +1,6 @@
 /******************************************************************************
  *
- *
- *
- *
- * Copyright (C) 1997-2015 by Dimitri van Heesch.
+ * Copyright (C) 1997-2022 by Dimitri van Heesch.
  *
  * Permission to use, copy, modify, and distribute this software and its
  * documentation under the terms of the GNU General Public License is hereby
@@ -20,33 +17,42 @@
 #define DOCPARSER_H
 
 #include <stdio.h>
-#include <vector>
 #include <memory>
 
 #include "qcstring.h"
-#include "docvisitor.h"
-#include "htmlattrib.h"
+#include "growvector.h"
 
-class DocNode;
 class MemberDef;
 class Definition;
-class MemberGroup;
 
 //---------------------------------------------------------------------------
 
-// forward declared, opaque pointer
+//! @brief opaque parser interface
 class IDocParser
 {
   public:
-    virtual ~IDocParser() {}
+    virtual ~IDocParser() = default;
 };
 
-// factory function
-std::unique_ptr<IDocParser> createDocParser();
+//! @brief pointer to parser interface
+using IDocParserPtr = std::unique_ptr<IDocParser>;
+
+//! @brief factory function to create a parser
+IDocParserPtr createDocParser();
 
 //---------------------------------------------------------------------------
 
-/*! Main entry point for the documentation parser.
+//! @brief opaque representation of the abstract syntax tree (AST)
+class IDocNodeAST
+{
+  public:
+    virtual ~IDocNodeAST() = default;
+    virtual bool isEmpty() const = 0;
+};
+
+using IDocNodeASTPtr = std::unique_ptr<IDocNodeAST>;
+
+/*! Main entry point for the comment block parser.
  *  @param parser    The parser object created via createDocParser()
  *  @param fileName  File in which the documentation block is found (or the
  *                   name of the example file in case isExample is TRUE).
@@ -66,10 +72,10 @@ std::unique_ptr<IDocParser> createDocParser();
  *                   the relative path when making a link.
  *  @param markdownSupport TRUE if the input needs to take markdown markup into
  *                   account.
- *  @returns         Root node of the abstract syntax tree. Ownership of the
+ *  @returns         An object representing the abstract syntax tree. Ownership of the
  *                   pointer is handed over to the caller.
  */
-DocRoot *validatingParseDoc(IDocParser &parser,const QCString &fileName,int startLine,
+IDocNodeASTPtr validatingParseDoc(IDocParser &parser,const QCString &fileName,int startLine,
                             const Definition *context, const MemberDef *md,
                             const QCString &input,bool indexWords,
                             bool isExample,const QCString &exampleName,
@@ -79,1398 +85,18 @@ DocRoot *validatingParseDoc(IDocParser &parser,const QCString &fileName,int star
 /*! Main entry point for parsing simple text fragments. These
  *  fragments are limited to words, whitespace and symbols.
  */
-DocText *validatingParseText(IDocParser &parser,const QCString &input);
+IDocNodeASTPtr validatingParseText(IDocParser &parser,const QCString &input);
 
-/*! Searches for section and anchor commands in the input */
-void docFindSections(const QCString &input,
-                     const Definition *d,
-                     const QCString &fileName);
-
-DocRef *createRef(IDocParser &parser,const QCString &target,const QCString &context);
+IDocNodeASTPtr createRef(IDocParser &parser,const QCString &target,const QCString &context);
 
 //--------------------------------------------------------------------------------
 
-class DocParser;
-
-/** Abstract node interface with type information. */
-class DocNode
-{
-  public:
-    /*! Available node types. */
-    enum Kind { Kind_Root           = 0,
-                Kind_Word           = 1,
-                Kind_WhiteSpace     = 2,
-                Kind_Para           = 3,
-                Kind_AutoList       = 4,
-                Kind_AutoListItem   = 5,
-                Kind_Symbol         = 6,
-                Kind_URL            = 7,
-                Kind_StyleChange    = 8,
-                Kind_SimpleSect     = 9,
-                Kind_Title          = 10,
-                Kind_SimpleList     = 11,
-                Kind_SimpleListItem = 12,
-                Kind_Section        = 13,
-                Kind_Verbatim       = 14,
-                Kind_XRefItem       = 15,
-                Kind_HtmlList       = 16,
-                Kind_HtmlListItem   = 17,
-                Kind_HtmlDescList   = 18,
-                Kind_HtmlDescData   = 19,
-                Kind_HtmlDescTitle  = 20,
-                Kind_HtmlTable      = 21,
-                Kind_HtmlRow        = 22,
-                Kind_HtmlCell       = 23,
-                Kind_HtmlCaption    = 24,
-                Kind_LineBreak      = 25,
-                Kind_HorRuler       = 26,
-                Kind_Anchor         = 27,
-                Kind_IndexEntry     = 28,
-                Kind_Internal       = 29,
-                Kind_HRef           = 30,
-                Kind_Include        = 31,
-                Kind_IncOperator    = 32,
-                Kind_HtmlHeader     = 33,
-                Kind_Image          = 34,
-                Kind_DotFile        = 35,
-                Kind_Link           = 36,
-                Kind_Ref            = 37,
-                Kind_Formula        = 38,
-                Kind_SecRefItem     = 39,
-                Kind_SecRefList     = 40,
-                Kind_SimpleSectSep  = 41,
-                Kind_LinkedWord     = 42,
-                Kind_ParamSect      = 43,
-                Kind_ParamList      = 44,
-                Kind_InternalRef    = 45,
-                Kind_Copy           = 46,
-                Kind_Text           = 47,
-                Kind_MscFile        = 48,
-                Kind_HtmlBlockQuote = 49,
-                Kind_VhdlFlow       = 50,
-                Kind_ParBlock       = 51,
-                Kind_DiaFile        = 52,
-                Kind_Emoji          = 53,
-                Kind_Sep            = 54
-              };
-    /*! Creates a new node */
-    DocNode(DocParser &parser) : m_parser(parser) {}
-
-    /*! Destroys a node. */
-    virtual ~DocNode() {}
-
-    /*! Returns the kind of node. Provides runtime type information */
-    virtual Kind kind() const = 0;
-
-    /*! Returns the parent of this node or 0 for the root node. */
-    DocNode *parent() const { return m_parent; }
-
-    /*! Sets a new parent for this node. */
-    void setParent(DocNode *parent) { m_parent = parent; }
-
-    /*! Acceptor function for node visitors. Part of the visitor pattern.
-     *  @param v Abstract visitor.
-     */
-    virtual void accept(DocVisitor *v) = 0;
-
-    /*! Returns TRUE iff this node is inside a preformatted section */
-    bool isPreformatted() const { return m_insidePre; }
-
-  protected:
-    /*! Sets whether or not this item is inside a preformatted section */
-    void setInsidePreformatted(bool p) { m_insidePre = p; }
-    DocNode *m_parent = 0;
-    enum RefType { Unknown, Anchor, Section, Table };
-    DocParser &m_parser;
-  private:
-
-    bool m_insidePre = false;
-};
-
-using DocNodeList = std::vector< std::unique_ptr<DocNode> >;
-
-/** Default accept implementation for compound nodes in the abstract
- *  syntax tree.
- */
-template<class T>
-class CompAccept : public DocNode
-{
-  public:
-    CompAccept(DocParser &parser) : DocNode(parser) {}
-    void accept(DocVisitor *v) override
-    {
-      T *obj = dynamic_cast<T *>(this);
-      v->visitPre(obj);
-      for (const auto &n : m_children) n->accept(v);
-      v->visitPost(obj);
-    }
-    const DocNodeList &children() const { return m_children; }
-    DocNodeList &children() { return m_children; }
-
-  protected:
-    DocNodeList m_children;
-};
-
-
-/** Node representing a word
- */
-class DocWord : public DocNode
-{
-  public:
-    DocWord(DocParser &parser,DocNode *parent,const QCString &word);
-    QCString word() const { return m_word; }
-    Kind kind() const override { return Kind_Word; }
-    void accept(DocVisitor *v) override { v->visit(this); }
-
-  private:
-    QCString  m_word;
-};
-
-/** Node representing a word that can be linked to something
- */
-class DocLinkedWord : public DocNode
-{
-  public:
-    DocLinkedWord(DocParser &parser,DocNode *parent,const QCString &word,
-                  const QCString &ref,const QCString &file,
-                  const QCString &anchor,const QCString &tooltip);
-    QCString word() const       { return m_word; }
-    Kind kind() const override          { return Kind_LinkedWord; }
-    QCString file() const       { return m_file; }
-    QCString relPath() const    { return m_relPath; }
-    QCString ref() const        { return m_ref; }
-    QCString anchor() const     { return m_anchor; }
-    QCString tooltip() const    { return m_tooltip; }
-    void accept(DocVisitor *v) override { v->visit(this); }
-
-  private:
-    QCString  m_word;
-    QCString  m_ref;
-    QCString  m_file;
-    QCString  m_relPath;
-    QCString  m_anchor;
-    QCString  m_tooltip;
-};
-
-/** Node representing a URL (or email address) */
-class DocURL : public DocNode
-{
-  public:
-    DocURL(DocParser &parser,DocNode *parent,const QCString &url,bool isEmail) :
-      DocNode(parser), m_url(url), m_isEmail(isEmail) { m_parent=parent; }
-    QCString url() const        { return m_url; }
-    Kind kind() const override          { return Kind_URL; }
-    void accept(DocVisitor *v) override { v->visit(this); }
-    bool isEmail() const       { return m_isEmail; }
-
-  private:
-    QCString  m_url;
-    bool m_isEmail = false;
-};
-
-/** Node representing a line break */
-class DocLineBreak : public DocNode
-{
-  public:
-    DocLineBreak(DocParser &parser,DocNode *parent) : DocNode(parser) { m_parent = parent; }
-    DocLineBreak(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs)
-      : DocNode(parser), m_attribs(attribs) { m_parent = parent; }
-    Kind kind() const override          { return Kind_LineBreak; }
-    void accept(DocVisitor *v) override { v->visit(this); }
-
-    const HtmlAttribList &attribs() const { return m_attribs; }
-
-  private:
-    HtmlAttribList m_attribs;
-};
-
-/** Node representing a horizontal ruler */
-class DocHorRuler : public DocNode
-{
-  public:
-    DocHorRuler(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs)
-      : DocNode(parser), m_attribs(attribs) { m_parent = parent; }
-    Kind kind() const override          { return Kind_HorRuler; }
-    void accept(DocVisitor *v) override { v->visit(this); }
-
-    const HtmlAttribList &attribs() const { return m_attribs; }
-
-  private:
-    HtmlAttribList m_attribs;
-};
-
-/** Node representing an anchor */
-class DocAnchor : public DocNode
-{
-  public:
-    DocAnchor(DocParser &parser,DocNode *parent,const QCString &id,bool newAnchor);
-    Kind kind() const override          { return Kind_Anchor; }
-    QCString anchor() const    { return m_anchor; }
-    QCString file() const      { return m_file; }
-    void accept(DocVisitor *v) override { v->visit(this); }
-
-    const HtmlAttribList &attribs() const { return m_attribs; }
-
-  private:
-    QCString  m_anchor;
-    QCString  m_file;
-    HtmlAttribList m_attribs;
-};
-
-/** Node representing a citation of some bibliographic reference */
-class DocCite : public DocNode
-{
-  public:
-    DocCite(DocParser &parser,DocNode *parent,const QCString &target,const QCString &context);
-    Kind kind() const override            { return Kind_Ref; }
-    QCString file() const        { return m_file; }
-    QCString relPath() const     { return m_relPath; }
-    QCString ref() const         { return m_ref; }
-    QCString anchor() const      { return m_anchor; }
-    QCString text() const        { return m_text; }
-    void accept(DocVisitor *v) override { v->visit(this); }
-
-  private:
-    QCString   m_file;
-    QCString   m_relPath;
-    QCString   m_ref;
-    QCString   m_anchor;
-    QCString   m_text;
-};
-
-
-/** Node representing a style change */
-class DocStyleChange : public DocNode
-{
-  public:
-    enum Style { Bold          = (1<<0),
-                 Italic        = (1<<1),
-                 Code          = (1<<2),
-                 Center        = (1<<3),
-                 Small         = (1<<4),
-                 Subscript     = (1<<5),
-                 Superscript   = (1<<6),
-                 Preformatted  = (1<<7),
-                 Span          = (1<<8),
-                 Div           = (1<<9),
-                 Strike        = (1<<10),
-                 Underline     = (1<<11),
-                 Del           = (1<<12),
-                 Ins           = (1<<13),
-                 S             = (1<<14),
-                 Details       = (1<<15),
-                 Summary       = (1<<16),
-                 Cite          = (1<<17)
-               };
-
-    DocStyleChange(DocParser &parser,DocNode *parent,uint position,Style s,const QCString &tagName,bool enable,
-                   const HtmlAttribList *attribs=0) :
-      DocNode(parser), m_position(position), m_style(s), m_enable(enable)
-      { m_parent = parent; if (attribs) m_attribs=*attribs; m_tagName = tagName.lower();}
-    Kind kind() const override                     { return Kind_StyleChange; }
-    Style style() const                   { return m_style; }
-    const char *styleString() const;
-    bool enable() const                   { return m_enable; }
-    uint position() const                 { return m_position; }
-    void accept(DocVisitor *v) override            { v->visit(this); }
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    QCString tagName() const              { return m_tagName; }
-
-  private:
-    uint     m_position = 0;
-    Style    m_style = Bold;
-    bool     m_enable = false;
-    HtmlAttribList m_attribs;
-    QCString m_tagName;
-};
-
-/** Node representing a special symbol */
-class DocSymbol : public DocNode
-{
-  public:
-    enum SymType { Sym_Unknown = -1,
-                   Sym_nbsp, Sym_iexcl, Sym_cent, Sym_pound, Sym_curren,
-                   Sym_yen, Sym_brvbar, Sym_sect, Sym_uml, Sym_copy,
-                   Sym_ordf, Sym_laquo, Sym_not, Sym_shy, Sym_reg,
-                   Sym_macr, Sym_deg, Sym_plusmn, Sym_sup2, Sym_sup3,
-                   Sym_acute, Sym_micro, Sym_para, Sym_middot, Sym_cedil,
-                   Sym_sup1, Sym_ordm, Sym_raquo, Sym_frac14, Sym_frac12,
-                   Sym_frac34, Sym_iquest, Sym_Agrave, Sym_Aacute, Sym_Acirc,
-                   Sym_Atilde, Sym_Auml, Sym_Aring, Sym_AElig, Sym_Ccedil,
-                   Sym_Egrave, Sym_Eacute, Sym_Ecirc, Sym_Euml, Sym_Igrave,
-                   Sym_Iacute, Sym_Icirc, Sym_Iuml, Sym_ETH, Sym_Ntilde,
-                   Sym_Ograve, Sym_Oacute, Sym_Ocirc, Sym_Otilde, Sym_Ouml,
-                   Sym_times, Sym_Oslash, Sym_Ugrave, Sym_Uacute, Sym_Ucirc,
-                   Sym_Uuml, Sym_Yacute, Sym_THORN, Sym_szlig, Sym_agrave,
-                   Sym_aacute, Sym_acirc, Sym_atilde, Sym_auml, Sym_aring,
-                   Sym_aelig, Sym_ccedil, Sym_egrave, Sym_eacute, Sym_ecirc,
-                   Sym_euml, Sym_igrave, Sym_iacute, Sym_icirc, Sym_iuml,
-                   Sym_eth, Sym_ntilde, Sym_ograve, Sym_oacute, Sym_ocirc,
-                   Sym_otilde, Sym_ouml, Sym_divide, Sym_oslash, Sym_ugrave,
-                   Sym_uacute, Sym_ucirc, Sym_uuml, Sym_yacute, Sym_thorn,
-                   Sym_yuml, Sym_fnof, Sym_Alpha, Sym_Beta, Sym_Gamma,
-                   Sym_Delta, Sym_Epsilon, Sym_Zeta, Sym_Eta, Sym_Theta,
-                   Sym_Iota, Sym_Kappa, Sym_Lambda, Sym_Mu, Sym_Nu,
-                   Sym_Xi, Sym_Omicron, Sym_Pi, Sym_Rho, Sym_Sigma,
-                   Sym_Tau, Sym_Upsilon, Sym_Phi, Sym_Chi, Sym_Psi,
-                   Sym_Omega, Sym_alpha, Sym_beta, Sym_gamma, Sym_delta,
-                   Sym_epsilon, Sym_zeta, Sym_eta, Sym_theta, Sym_iota,
-                   Sym_kappa, Sym_lambda, Sym_mu, Sym_nu, Sym_xi,
-                   Sym_omicron, Sym_pi, Sym_rho, Sym_sigmaf, Sym_sigma,
-                   Sym_tau, Sym_upsilon, Sym_phi, Sym_chi, Sym_psi,
-                   Sym_omega, Sym_thetasym, Sym_upsih, Sym_piv, Sym_bull,
-                   Sym_hellip, Sym_prime, Sym_Prime, Sym_oline, Sym_frasl,
-                   Sym_weierp, Sym_image, Sym_real, Sym_trade, Sym_alefsym,
-                   Sym_larr, Sym_uarr, Sym_rarr, Sym_darr, Sym_harr,
-                   Sym_crarr, Sym_lArr, Sym_uArr, Sym_rArr, Sym_dArr,
-                   Sym_hArr, Sym_forall, Sym_part, Sym_exist, Sym_empty,
-                   Sym_nabla, Sym_isin, Sym_notin, Sym_ni, Sym_prod,
-                   Sym_sum, Sym_minus, Sym_lowast, Sym_radic, Sym_prop,
-                   Sym_infin, Sym_ang, Sym_and, Sym_or, Sym_cap,
-                   Sym_cup, Sym_int, Sym_there4, Sym_sim, Sym_cong,
-                   Sym_asymp, Sym_ne, Sym_equiv, Sym_le, Sym_ge,
-                   Sym_sub, Sym_sup, Sym_nsub, Sym_sube, Sym_supe,
-                   Sym_oplus, Sym_otimes, Sym_perp, Sym_sdot, Sym_lceil,
-                   Sym_rceil, Sym_lfloor, Sym_rfloor, Sym_lang, Sym_rang,
-                   Sym_loz, Sym_spades, Sym_clubs, Sym_hearts, Sym_diams,
-                   Sym_quot, Sym_amp, Sym_lt, Sym_gt, Sym_OElig,
-                   Sym_oelig, Sym_Scaron, Sym_scaron, Sym_Yuml, Sym_circ,
-                   Sym_tilde, Sym_ensp, Sym_emsp, Sym_thinsp, Sym_zwnj,
-                   Sym_zwj, Sym_lrm, Sym_rlm, Sym_ndash, Sym_mdash,
-                   Sym_lsquo, Sym_rsquo, Sym_sbquo, Sym_ldquo, Sym_rdquo,
-                   Sym_bdquo, Sym_dagger, Sym_Dagger, Sym_permil, Sym_lsaquo,
-                   Sym_rsaquo, Sym_euro,
-
-                   /* doxygen extensions */
-                   Sym_tm, Sym_apos,
-
-                   /* doxygen commands mapped */
-                   Sym_BSlash, Sym_At, Sym_Less, Sym_Greater, Sym_Amp,
-                   Sym_Dollar, Sym_Hash, Sym_DoubleColon, Sym_Percent, Sym_Pipe,
-                   Sym_Quot, Sym_Minus, Sym_Plus, Sym_Dot, Sym_Colon, Sym_Equal
-                 };
-    enum PerlType { Perl_unknown = 0, Perl_string, Perl_char, Perl_symbol, Perl_umlaut,
-                    Perl_acute, Perl_grave, Perl_circ, Perl_slash, Perl_tilde,
-                    Perl_cedilla, Perl_ring
-                  };
-    typedef struct PerlSymb {
-      const char     *symb;
-      const PerlType  type;
-    }PerlSymb;
-    DocSymbol(DocParser &parser,DocNode *parent,SymType s) :
-      DocNode(parser), m_symbol(s) { m_parent = parent; }
-    SymType symbol() const     { return m_symbol; }
-    Kind kind() const override          { return Kind_Symbol; }
-    void accept(DocVisitor *v) override { v->visit(this); }
-    static SymType decodeSymbol(const QCString &symName);
-
-  private:
-    SymType  m_symbol = Sym_Unknown;
-};
-
-/** Node representing a n emoji */
-class DocEmoji : public DocNode
-{
-  public:
-    DocEmoji(DocParser &parser,DocNode *parent,const QCString &symName);
-    QCString name() const      { return m_symName; }
-    int index() const          { return m_index; }
-    Kind kind() const override          { return Kind_Emoji; }
-    void accept(DocVisitor *v) override { v->visit(this); }
-
-  private:
-    QCString m_symName;
-    int m_index = 0;
-};
-
-/** Node representing some amount of white space */
-class DocWhiteSpace : public DocNode
-{
-  public:
-    DocWhiteSpace(DocParser &parser,DocNode *parent,const QCString &chars) :
-      DocNode(parser), m_chars(chars) { m_parent = parent; }
-    Kind kind() const override          { return Kind_WhiteSpace; }
-    QCString chars() const     { return m_chars; }
-    void accept(DocVisitor *v) override { v->visit(this); }
-  private:
-    QCString  m_chars;
-};
-
-/** Node representing a separator */
-class DocSeparator : public DocNode
-{
-  public:
-    DocSeparator(DocParser &parser,DocNode *parent,const QCString &chars) :
-      DocNode(parser), m_chars(chars) { m_parent = parent; }
-    Kind kind() const override          { return Kind_Sep; }
-    QCString chars() const     { return m_chars; }
-    void accept(DocVisitor *) override { }
-  private:
-    QCString  m_chars;
-};
-
-/** Node representing a verbatim, unparsed text fragment */
-class DocVerbatim : public DocNode
-{
-  public:
-    enum Type { Code, HtmlOnly, ManOnly, LatexOnly, RtfOnly, XmlOnly, Verbatim, Dot, Msc, DocbookOnly, PlantUML, JavaDocCode, JavaDocLiteral };
-    DocVerbatim(DocParser &parser,DocNode *parent,const QCString &context,
-                const QCString &text, Type t,bool isExample,
-                const QCString &exampleFile,bool isBlock=FALSE,const QCString &lang=QCString());
-    Kind kind() const override            { return Kind_Verbatim; }
-    Type type() const            { return m_type; }
-    QCString text() const        { return m_text; }
-    QCString context() const     { return m_context; }
-    void accept(DocVisitor *v) override   { v->visit(this); }
-    bool isExample() const       { return m_isExample; }
-    QCString exampleFile() const { return m_exampleFile; }
-    QCString relPath() const     { return m_relPath; }
-    QCString language() const    { return m_lang; }
-    bool isBlock() const         { return m_isBlock; }
-    bool hasCaption() const      { return !m_children.empty(); }
-    QCString width() const       { return m_width; }
-    QCString height() const      { return m_height; }
-    QCString engine() const      { return m_engine; }
-    bool useBitmap() const       { return m_useBitmap; }
-    const DocNodeList &children() const { return m_children; }
-    DocNodeList &children()      { return m_children; }
-    QCString srcFile() const     { return m_srcFile; }
-    int srcLine() const          { return m_srcLine; }
-    void setText(const QCString &t)   { m_text=t;   }
-    void setWidth(const QCString &w)  { m_width=w;  }
-    void setHeight(const QCString &h) { m_height=h; }
-    void setEngine(const QCString &e) { m_engine=e; }
-    void setUseBitmap(const bool &u)  { m_useBitmap=u; }
-    void setLocation(const QCString &file,int line) { m_srcFile=file; m_srcLine=line; }
-
-  private:
-    QCString  m_context;
-    QCString  m_text;
-    Type      m_type = Code;
-    bool      m_isExample = false;
-    QCString  m_exampleFile;
-    QCString  m_relPath;
-    QCString  m_lang;
-    bool      m_isBlock = false;
-    QCString  m_width;
-    QCString  m_height;
-    QCString  m_engine;
-    bool      m_useBitmap=false; // some PlantUML engines cannot output data in EPS format so bitmap format is required
-    DocNodeList m_children;
-    QCString  m_srcFile;
-    int       m_srcLine = -1;
-};
-
-
-/** Node representing an included text block from file */
-class DocInclude : public DocNode
-{
-  public:
-  enum Type { Include, DontInclude, VerbInclude, HtmlInclude, LatexInclude,
-	      IncWithLines, Snippet , IncludeDoc, SnippetDoc, SnipWithLines,
-	      DontIncWithLines, RtfInclude, ManInclude, DocbookInclude, XmlInclude};
-    DocInclude(DocParser &parser,DocNode *parent,const QCString &file,
-               const QCString &context, Type t,
-               bool isExample,const QCString &exampleFile,
-               const QCString &blockId, bool isBlock) :
-      DocNode(parser), m_file(file), m_context(context), m_type(t),
-      m_isExample(isExample), m_isBlock(isBlock),
-      m_exampleFile(exampleFile), m_blockId(blockId) { m_parent = parent; }
-    Kind kind() const override            { return Kind_Include; }
-    QCString file() const        { return m_file; }
-    QCString extension() const   { int i=m_file.findRev('.');
-                                   if (i!=-1)
-                                     return m_file.right(m_file.length()-(uint)i);
-                                   else
-                                     return QCString();
-                                 }
-    Type type() const            { return m_type; }
-    QCString text() const        { return m_text; }
-    QCString context() const     { return m_context; }
-    QCString blockId() const     { return m_blockId; }
-    bool isExample() const       { return m_isExample; }
-    QCString exampleFile() const { return m_exampleFile; }
-    bool isBlock() const         { return m_isBlock; }
-    void accept(DocVisitor *v) override   { v->visit(this); }
-    void parse();
-
-  private:
-    QCString  m_file;
-    QCString  m_context;
-    QCString  m_text;
-    Type      m_type;
-    bool      m_isExample;
-    bool      m_isBlock;
-    QCString  m_exampleFile;
-    QCString  m_blockId;
-};
-
-/** Node representing a include/dontinclude operator block */
-class DocIncOperator : public DocNode
-{
-  public:
-    enum Type { Line, SkipLine, Skip, Until };
-    DocIncOperator(DocParser &parser,DocNode *parent,Type t,const QCString &pat,
-                   const QCString &context,bool isExample,const QCString &exampleFile) :
-      DocNode(parser), m_type(t), m_pattern(pat), m_context(context),
-      m_isFirst(FALSE), m_isLast(FALSE),
-      m_isExample(isExample), m_exampleFile(exampleFile) { m_parent = parent; }
-    Kind kind() const override           { return Kind_IncOperator; }
-    Type type() const           { return m_type; }
-    const char *typeAsString() const
-    {
-      switch(m_type)
-      {
-        case Line:     return "line";
-        case SkipLine: return "skipline";
-        case Skip:     return "skip";
-        case Until:    return "until";
-      }
-      return "";
-    }
-    int line() const             { return m_line; }
-    bool showLineNo() const      { return m_showLineNo; }
-    QCString text() const        { return m_text; }
-    QCString pattern() const     { return m_pattern; }
-    QCString context() const     { return m_context; }
-    void accept(DocVisitor *v) override  { v->visit(this); }
-    bool isFirst() const        { return m_isFirst; }
-    bool isLast() const         { return m_isLast; }
-    void markFirst(bool v=TRUE) { m_isFirst = v; }
-    void markLast(bool v=TRUE)  { m_isLast = v; }
-    bool isExample() const      { return m_isExample; }
-    QCString exampleFile() const { return m_exampleFile; }
-    QCString includeFileName() const { return m_includeFileName; }
-    void parse();
-
-  private:
-    Type     m_type = Line;
-    int      m_line = 0;
-    bool     m_showLineNo = false;
-    QCString  m_text;
-    QCString  m_pattern;
-    QCString  m_context;
-    bool     m_isFirst = false;
-    bool     m_isLast = false;
-    bool     m_isExample = false;
-    QCString  m_exampleFile;
-    QCString m_includeFileName;
-};
-
-/** Node representing an item of a cross-referenced list */
-class DocFormula : public DocNode
-{
-  public:
-    DocFormula(DocParser &parser,DocNode *parent,int id);
-    Kind kind() const override          { return Kind_Formula; }
-    QCString name() const       { return m_name; }
-    QCString text() const       { return m_text; }
-    QCString relPath() const    { return m_relPath; }
-    int id() const             { return m_id; }
-    void accept(DocVisitor *v) override { v->visit(this); }
-    bool isInline()            {
-      if (m_text.length()>1 && m_text.at(0)=='\\' && m_text.at(1)=='[') return false;
-      if (m_text.length()>7 && m_text.startsWith("\\begin{")) return false;
-      return true;
-    }
-
-  private:
-    QCString  m_name;
-    QCString  m_text;
-    QCString  m_relPath;
-    int      m_id = 0;
-};
-
-/** Node representing an entry in the index. */
-class DocIndexEntry : public DocNode
-{
-  public:
-    DocIndexEntry(DocParser &parser,DocNode *parent,const Definition *scope,const MemberDef *md)
-      : DocNode(parser), m_scope(scope), m_member(md){ m_parent = parent; }
-    Kind kind() const override { return Kind_IndexEntry; }
-    int parse();
-    const Definition *scope() const    { return m_scope;  }
-    const MemberDef *member() const    { return m_member; }
-    QCString entry() const        { return m_entry;  }
-    void accept(DocVisitor *v) override   { v->visit(this);  }
-
-  private:
-    QCString     m_entry;
-    const Definition *m_scope = 0;
-    const MemberDef  *m_member = 0;
-};
-
-//-----------------------------------------------------------------------
-
-/** Node representing an auto List */
-class DocAutoList : public CompAccept<DocAutoList>
-{
-  public:
-    DocAutoList(DocParser &parser,DocNode *parent,int indent,bool isEnumList,int depth);
-    Kind kind() const override          { return Kind_AutoList; }
-    bool isEnumList() const    { return m_isEnumList; }
-    int  indent() const        { return m_indent; }
-    int depth() const          { return m_depth; }
-    int parse();
-
-  private:
-    int      m_indent = 0;
-    bool     m_isEnumList = false;
-    int      m_depth = 0;
-};
-
-/** Node representing an item of a auto list */
-class DocAutoListItem : public CompAccept<DocAutoListItem>
-{
-  public:
-    DocAutoListItem(DocParser &parser,DocNode *parent,int indent,int num);
-    Kind kind() const override          { return Kind_AutoListItem; }
-    int itemNumber() const     { return m_itemNum; }
-    int parse();
-
-  private:
-    int m_indent = 0;
-    int m_itemNum = 0;
-};
-
-
-
-/** Node representing a simple section title */
-class DocTitle : public CompAccept<DocTitle>
-{
-  public:
-    DocTitle(DocParser &parser,DocNode *parent) : CompAccept<DocTitle>(parser) { m_parent = parent; }
-    void parse();
-    void parseFromString(const QCString &title);
-    Kind kind() const override          { return Kind_Title; }
-    bool hasTitle() const      { return !m_children.empty(); }
-
-  private:
-};
-
-/** Node representing an item of a cross-referenced list */
-class DocXRefItem : public CompAccept<DocXRefItem>
-{
-  public:
-    DocXRefItem(DocParser &parser,DocNode *parent,int id,const QCString &key);
-    Kind kind() const override          { return Kind_XRefItem; }
-    QCString file() const       { return m_file; }
-    QCString anchor() const     { return m_anchor; }
-    QCString title() const      { return m_title; }
-    QCString relPath() const    { return m_relPath; }
-    QCString key() const        { return m_key; }
-    bool parse();
-
-  private:
-    int      m_id = 0;
-    QCString  m_key;
-    QCString  m_file;
-    QCString  m_anchor;
-    QCString  m_title;
-    QCString  m_relPath;
-};
-
-/** Node representing an image */
-class DocImage : public CompAccept<DocImage>
-{
-  public:
-    enum Type { Html, Latex, Rtf, DocBook, Xml };
-    DocImage(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs,
-             const QCString &name,Type t,const QCString &url=QCString(), bool inlineImage = TRUE);
-    Kind kind() const override           { return Kind_Image; }
-    Type type() const           { return m_type; }
-    QCString name() const       { return m_name; }
-    bool hasCaption() const     { return !m_children.empty(); }
-    QCString width() const      { return m_width; }
-    QCString height() const     { return m_height; }
-    QCString relPath() const    { return m_relPath; }
-    QCString url() const        { return m_url; }
-    bool isInlineImage() const  { return m_inlineImage; }
-    bool isSVG() const;
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    void parse();
-
-  private:
-    HtmlAttribList m_attribs;
-    QCString  m_name;
-    Type      m_type = Html;
-    QCString  m_width;
-    QCString  m_height;
-    QCString  m_relPath;
-    QCString  m_url;
-    bool      m_inlineImage = false;
-};
-
-template<class T>
-class DocDiagramFileBase : public CompAccept<T>
-{
-  public:
-    DocDiagramFileBase(DocParser &parser, const QCString &name,const QCString &context,
-                       const QCString &srcFile,int srcLine)
-          : CompAccept<T>(parser), m_name(name), m_context(context), m_srcFile(srcFile), m_srcLine(srcLine) {}
-    QCString name() const      { return m_name; }
-    QCString file() const      { return m_file; }
-    QCString relPath() const   { return m_relPath; }
-    bool hasCaption() const    { return !this->m_children.empty(); }
-    QCString width() const     { return m_width; }
-    QCString height() const    { return m_height; }
-    QCString context() const   { return m_context; }
-    QCString srcFile() const   { return m_srcFile; }
-    int srcLine() const        { return m_srcLine; }
-
-  protected:
-    QCString  m_name;
-    QCString  m_file;
-    QCString  m_relPath;
-    QCString  m_width;
-    QCString  m_height;
-    QCString  m_context;
-    QCString  m_srcFile;
-    int       m_srcLine = -1;
-};
-
-/** Node representing a dot file */
-class DocDotFile : public DocDiagramFileBase<DocDotFile>
-{
-  public:
-    DocDotFile(DocParser &parser,DocNode *parent,const QCString &name,const QCString &context,
-               const QCString &srcFile,int srcLine);
-    Kind kind() const override          { return Kind_DotFile; }
-    bool parse();
-};
-
-/** Node representing a msc file */
-class DocMscFile : public DocDiagramFileBase<DocMscFile>
-{
-  public:
-    DocMscFile(DocParser &parser,DocNode *parent,const QCString &name,const QCString &context,
-               const QCString &srcFile,int srcLine);
-    Kind kind() const override          { return Kind_MscFile; }
-    bool parse();
-};
-
-/** Node representing a dia file */
-class DocDiaFile : public DocDiagramFileBase<DocDiaFile>
-{
-  public:
-    DocDiaFile(DocParser &parser,DocNode *parent,const QCString &name,const QCString &context,
-               const QCString &srcFile,int srcLine);
-    Kind kind() const override          { return Kind_DiaFile; }
-    bool parse();
-};
-
-/** Node representing a VHDL flow chart */
-class DocVhdlFlow : public CompAccept<DocVhdlFlow>
-{
-  public:
-    DocVhdlFlow(DocParser &parser,DocNode *parent);
-    void parse();
-    Kind kind() const override    { return Kind_VhdlFlow; }
-    bool hasCaption()    { return !m_children.empty(); }
-  private:
-};
-
-/** Node representing a link to some item */
-class DocLink : public CompAccept<DocLink>
-{
-  public:
-    DocLink(DocParser &parser,DocNode *parent,const QCString &target);
-    QCString parse(bool,bool isXmlLink=FALSE);
-    Kind kind() const override          { return Kind_Link; }
-    QCString file() const       { return m_file; }
-    QCString relPath() const    { return m_relPath; }
-    QCString ref() const        { return m_ref; }
-    QCString anchor() const     { return m_anchor; }
-
-  private:
-    QCString  m_file;
-    QCString  m_relPath;
-    QCString  m_ref;
-    QCString  m_anchor;
-    QCString  m_refText;
-};
-
-/** Node representing a reference to some item */
-class DocRef : public CompAccept<DocRef>
-{
-  public:
-    DocRef(DocParser &parser,DocNode *parent,const QCString &target,const QCString &context);
-    void parse();
-    Kind kind() const override            { return Kind_Ref; }
-    QCString file() const         { return m_file; }
-    QCString relPath() const      { return m_relPath; }
-    QCString ref() const          { return m_ref; }
-    QCString anchor() const       { return m_anchor; }
-    QCString targetTitle() const  { return m_text; }
-    bool hasLinkText() const     { return !m_children.empty(); }
-    bool refToAnchor() const     { return m_refType==Anchor; }
-    bool refToSection() const    { return m_refType==Section; }
-    bool refToTable() const      { return m_refType==Table; }
-    bool isSubPage() const       { return m_isSubPage; }
-
-  private:
-    RefType    m_refType = Unknown;
-    bool       m_isSubPage = false;
-    QCString   m_file;
-    QCString   m_relPath;
-    QCString   m_ref;
-    QCString   m_anchor;
-    QCString   m_text;
-};
-
-/** Node representing an internal reference to some item */
-class DocInternalRef : public CompAccept<DocInternalRef>
-{
-  public:
-    DocInternalRef(DocParser &parser,DocNode *parent,const QCString &target);
-    void parse();
-    Kind kind() const override            { return Kind_Ref; }
-    QCString file() const         { return m_file; }
-    QCString relPath() const      { return m_relPath; }
-    QCString anchor() const       { return m_anchor; }
-
-  private:
-    QCString   m_file;
-    QCString   m_relPath;
-    QCString   m_anchor;
-};
-
-/** Node representing a Hypertext reference */
-class DocHRef : public CompAccept<DocHRef>
-{
-  public:
-    DocHRef(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs,const QCString &url,
-           const QCString &relPath, const QCString &file) :
-      CompAccept<DocHRef>(parser), m_attribs(attribs), m_url(url), m_relPath(relPath), m_file(file) { m_parent = parent; }
-    int parse();
-    QCString url() const        { return m_url; }
-    QCString file() const       { return m_file; }
-    QCString relPath() const    { return m_relPath; }
-    Kind kind() const override           { return Kind_HRef; }
-    const HtmlAttribList &attribs() const { return m_attribs; }
-
-  private:
-    HtmlAttribList m_attribs;
-    QCString   m_url;
-    QCString   m_relPath;
-    QCString   m_file;
-};
-
-/** Node Html heading */
-class DocHtmlHeader : public CompAccept<DocHtmlHeader>
-{
-  public:
-    DocHtmlHeader(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs,int level) :
-       CompAccept<DocHtmlHeader>(parser), m_level(level), m_attribs(attribs) { m_parent = parent; }
-    int level() const                     { return m_level; }
-    Kind kind() const override                     { return Kind_HtmlHeader; }
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    int parse();
-
-  private:
-    int           m_level = 0;
-    HtmlAttribList m_attribs;
-};
-
-/** Node representing a Html description item */
-class DocHtmlDescTitle : public CompAccept<DocHtmlDescTitle>
-{
-  public:
-    DocHtmlDescTitle(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs) :
-      CompAccept<DocHtmlDescTitle>(parser), m_attribs(attribs) { m_parent = parent; }
-    Kind kind() const override                     { return Kind_HtmlDescTitle; }
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    int parse();
-
-  private:
-    HtmlAttribList m_attribs;
-};
-
-/** Node representing a Html description list */
-class DocHtmlDescList : public CompAccept<DocHtmlDescList>
-{
-  public:
-    DocHtmlDescList(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs) :
-      CompAccept<DocHtmlDescList>(parser), m_attribs(attribs) { m_parent = parent; }
-    Kind kind() const override                     { return Kind_HtmlDescList; }
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    int parse();
-
-  private:
-    HtmlAttribList m_attribs;
-};
-
-/** Node representing a normal section */
-class DocSection : public CompAccept<DocSection>
-{
-  public:
-    DocSection(DocParser &parser,DocNode *parent,int level,const QCString &id) :
-      CompAccept<DocSection>(parser), m_level(level), m_id(id) { m_parent = parent; }
-    Kind kind() const override          { return Kind_Section; }
-    int level() const          { return m_level; }
-    QCString title() const      { return m_title; }
-    QCString anchor() const     { return m_anchor; }
-    QCString id() const         { return m_id; }
-    QCString file() const       { return m_file; }
-    int parse();
-
-  private:
-    int       m_level = 0;
-    QCString  m_id;
-    QCString  m_title;
-    QCString  m_anchor;
-    QCString  m_file;
-};
-
-/** Node representing a reference to a section */
-class DocSecRefItem : public CompAccept<DocSecRefItem>
-{
-  public:
-    DocSecRefItem(DocParser &parser,DocNode *parent,const QCString &target);
-    Kind kind() const override          { return Kind_SecRefItem; }
-    QCString target() const     { return m_target; }
-    QCString file() const       { return m_file; }
-    QCString anchor() const     { return m_anchor; }
-    QCString relPath() const     { return m_relPath; }
-    QCString ref() const         { return m_ref; }
-    bool refToTable() const      { return m_refType==Table; }
-    bool isSubPage() const       { return m_isSubPage; }
-    void parse();
-
-  private:
-    QCString   m_target;
-    RefType    m_refType = Unknown;
-    bool       m_isSubPage = false;
-    QCString   m_file;
-    QCString   m_relPath;
-    QCString   m_ref;
-    QCString   m_anchor;
-};
-
-/** Node representing a list of section references */
-class DocSecRefList : public CompAccept<DocSecRefList>
-{
-  public:
-    DocSecRefList(DocParser &parser,DocNode *parent) : CompAccept<DocSecRefList>(parser) { m_parent = parent; }
-    void parse();
-    Kind kind() const override          { return Kind_SecRefList; }
-
-  private:
-};
-
-/** Node representing an internal section of documentation */
-class DocInternal : public CompAccept<DocInternal>
-{
-  public:
-    DocInternal(DocParser &parser,DocNode *parent) : CompAccept<DocInternal>(parser) { m_parent = parent; }
-    int parse(int);
-    Kind kind() const override          { return Kind_Internal; }
-
-  private:
-};
-
-/** Node representing an block of paragraphs */
-class DocParBlock : public CompAccept<DocParBlock>
-{
-  public:
-    DocParBlock(DocParser &parser,DocNode *parent) : CompAccept<DocParBlock>(parser) { m_parent = parent; }
-    int parse();
-    Kind kind() const override          { return Kind_ParBlock; }
-
-  private:
-};
-
-
-/** Node representing a simple list */
-class DocSimpleList : public CompAccept<DocSimpleList>
-{
-  public:
-    DocSimpleList(DocParser &parser,DocNode *parent) : CompAccept<DocSimpleList>(parser) { m_parent = parent; }
-    Kind kind() const override          { return Kind_SimpleList; }
-    int parse();
-
-  private:
-};
-
-/** Node representing a Html list */
-class DocHtmlList : public CompAccept<DocHtmlList>
-{
-  public:
-    enum Type { Unordered, Ordered };
-    DocHtmlList(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs,Type t) :
-      CompAccept<DocHtmlList>(parser), m_type(t), m_attribs(attribs) { m_parent = parent; }
-    Kind kind() const override          { return Kind_HtmlList; }
-    Type type() const          { return m_type; }
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    int parse();
-    int parseXml();
-
-  private:
-    Type           m_type = Unordered;
-    HtmlAttribList m_attribs;
-};
-
-/** Node representing a simple section */
-class DocSimpleSect : public CompAccept<DocSimpleSect>
-{
-  public:
-    enum Type
-    {
-       Unknown, See, Return, Author, Authors, Version, Since, Date,
-       Note, Warning, Copyright, Pre, Post, Invar, Remark, Attention, User, Rcs
-    };
-    DocSimpleSect(DocParser &parser,DocNode *parent,Type t);
-    virtual ~DocSimpleSect();
-    Kind kind() const override       { return Kind_SimpleSect; }
-    Type type() const       { return m_type; }
-    QCString typeString() const;
-    void accept(DocVisitor *v) override;
-    int parse(bool userTitle,bool needsSeparator);
-    int parseRcs();
-    int parseXml();
-    void appendLinkWord(const QCString &word);
-    bool hasTitle() const      { return m_title->hasTitle(); }
-
-  private:
-    Type            m_type = Unknown;
-    DocTitle *      m_title = 0;
-};
-
-/** Node representing a separator between two simple sections of the
- *  same type.
+/*! Searches for section and anchor commands in the input
+ *  Sections found will be added to the SectionManager.
  */
-class DocSimpleSectSep : public DocNode
-{
-  public:
-    DocSimpleSectSep(DocParser &parser,DocNode *parent) : DocNode(parser) { m_parent = parent; }
-    Kind kind() const override { return Kind_SimpleSectSep; }
-    void accept(DocVisitor *v) override { v->visit(this); }
-
-  private:
-};
-
-/** Node representing a parameter section */
-class DocParamSect : public CompAccept<DocParamSect>
-{
-    friend class DocParamList;
-  public:
-    enum Type
-    {
-       Unknown, Param, RetVal, Exception, TemplateParam
-    };
-    enum Direction
-    {
-       In=1, Out=2, InOut=3, Unspecified=0
-    };
-    DocParamSect(DocParser &parser,DocNode *parent,Type t)
-      : CompAccept<DocParamSect>(parser), m_type(t), m_hasInOutSpecifier(FALSE), m_hasTypeSpecifier(FALSE)
-    { m_parent = parent; }
-    int parse(const QCString &cmdName,bool xmlContext,Direction d);
-    Kind kind() const override          { return Kind_ParamSect; }
-    Type type() const          { return m_type; }
-    bool hasInOutSpecifier() const { return m_hasInOutSpecifier; }
-    bool hasTypeSpecifier() const  { return m_hasTypeSpecifier; }
-
-  private:
-    Type            m_type = Unknown;
-    bool            m_hasInOutSpecifier = false;
-    bool            m_hasTypeSpecifier = false;
-};
-
-/** Node representing a paragraph in the documentation tree */
-class DocPara : public CompAccept<DocPara>
-{
-  public:
-    DocPara(DocParser &parser,DocNode *parent) :
-             CompAccept<DocPara>(parser), m_isFirst(FALSE), m_isLast(FALSE) { m_parent = parent; }
-    int parse();
-    Kind kind() const override           { return Kind_Para; }
-    bool isEmpty() const        { return m_children.empty(); }
-    void markFirst(bool v=TRUE) { m_isFirst=v; }
-    void markLast(bool v=TRUE)  { m_isLast=v; }
-    bool isFirst() const        { return m_isFirst; }
-    bool isLast() const         { return m_isLast; }
-
-    int handleCommand(const QCString &cmdName,const int tok);
-    int handleHtmlStartTag(const QCString &tagName,const HtmlAttribList &tagHtmlAttribs);
-    int handleHtmlEndTag(const QCString &tagName);
-    int handleSimpleSection(DocSimpleSect::Type t,bool xmlContext=FALSE);
-    int handleXRefItem();
-    int handleParamSection(const QCString &cmdName,DocParamSect::Type t,
-                           bool xmlContext,
-                           int direction);
-    void handleIncludeOperator(const QCString &cmdName,DocIncOperator::Type t);
-    void handleImage(const QCString &cmdName);
-    template<class T> void handleFile(const QCString &cmdName);
-    void handleInclude(const QCString &cmdName,DocInclude::Type t);
-    void handleLink(const QCString &cmdName,bool isJavaLink);
-    void handleCite();
-    void handleEmoji();
-    void handleRef(const QCString &cmdName);
-    void handleSection(const QCString &cmdName);
-    void handleInheritDoc();
-    void handleVhdlFlow();
-    void handleIline();
-    int handleStartCode();
-    int handleHtmlHeader(const HtmlAttribList &tagHtmlAttribs,int level);
-
-    bool injectToken(int tok,const QCString &tokText);
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    void setAttribs(const HtmlAttribList &attribs) { m_attribs = attribs; }
-
-  private:
-    QCString  m_sectionId;
-    bool      m_isFirst = false;
-    bool      m_isLast = false;
-    HtmlAttribList m_attribs;
-};
-
-using DocParaList = std::vector< std::unique_ptr<DocPara> >;
-
-/** Node representing a parameter list. */
-class DocParamList : public DocNode
-{
-  public:
-    DocParamList(DocParser &parser,DocNode *parent,DocParamSect::Type t,DocParamSect::Direction d)
-      : DocNode(parser), m_type(t), m_dir(d)
-    {
-      m_parent = parent;
-    }
-    virtual ~DocParamList()         { }
-    Kind kind() const override               { return Kind_ParamList; }
-    DocNodeList &parameters()       { return m_params; }
-    DocNodeList &paramTypes()       { return m_paramTypes; }
-    DocParamSect::Type type() const { return m_type; }
-    DocParamSect::Direction direction() const { return m_dir; }
-    void markFirst(bool b=TRUE)     { m_isFirst=b; }
-    void markLast(bool b=TRUE)      { m_isLast=b; }
-    bool isFirst() const            { return m_isFirst; }
-    bool isLast() const             { return m_isLast; }
-    void accept(DocVisitor *v) override
-    {
-      v->visitPre(this);
-      for (const auto &n : m_paragraphs) n->accept(v);
-      v->visitPost(this);
-    }
-    int parse(const QCString &cmdName);
-    int parseXml(const QCString &paramName);
-
-  private:
-    DocParaList             m_paragraphs;
-    DocNodeList             m_params;
-    DocNodeList             m_paramTypes;
-    DocParamSect::Type      m_type = DocParamSect::Unknown;
-    DocParamSect::Direction m_dir = DocParamSect::Unspecified;
-    bool                    m_isFirst = false;
-    bool                    m_isLast = false;
-};
-
-/** Node representing a simple list item */
-class DocSimpleListItem : public DocNode
-{
-  public:
-    DocSimpleListItem(DocParser &parser,DocNode *parent) :
-      DocNode(parser) { m_paragraph=new DocPara(parser,this); m_parent = parent; }
-    int parse();
-    virtual ~DocSimpleListItem() { delete m_paragraph; }
-    Kind kind() const override            { return Kind_SimpleListItem; }
-    void accept(DocVisitor *v) override
-    {
-      v->visitPre(this);
-      m_paragraph->accept(v);
-      v->visitPost(this);
-    }
-
-  private:
-    DocPara *m_paragraph = 0;
-};
-
-/** Node representing a HTML list item */
-class DocHtmlListItem : public CompAccept<DocHtmlListItem>
-{
-  public:
-    DocHtmlListItem(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs,int num) :
-      CompAccept<DocHtmlListItem>(parser), m_attribs(attribs), m_itemNum(num) { m_parent = parent; }
-    Kind kind() const override                     { return Kind_HtmlListItem; }
-    int itemNumber() const                { return m_itemNum; }
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    int parse();
-    int parseXml();
-
-  private:
-    HtmlAttribList m_attribs;
-    int            m_itemNum = 0;
-};
-
-/** Node representing a HTML description data */
-class DocHtmlDescData : public CompAccept<DocHtmlDescData>
-{
-  public:
-    DocHtmlDescData(DocParser &parser,DocNode *parent) : CompAccept<DocHtmlDescData>(parser) { m_parent = parent; }
-    Kind kind() const override                     { return Kind_HtmlDescData; }
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    int parse();
-
-  private:
-    HtmlAttribList m_attribs;
-};
-
-/** Node representing a HTML table cell */
-class DocHtmlCell : public CompAccept<DocHtmlCell>
-{
-    friend class DocHtmlTable;
-  public:
-    enum Alignment { Left, Right, Center };
-    enum Valignment {Top, Middle, Bottom};
-    DocHtmlCell(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs,bool isHeading) :
-       CompAccept<DocHtmlCell>(parser), m_isHeading(isHeading), m_attribs(attribs) { m_parent = parent; }
-    bool isHeading() const      { return m_isHeading; }
-    bool isFirst() const        { return m_isFirst; }
-    bool isLast() const         { return m_isLast; }
-    Kind kind() const override           { return Kind_HtmlCell; }
-    void markFirst(bool v=TRUE) { m_isFirst=v; }
-    void markLast(bool v=TRUE)  { m_isLast=v; }
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    int parse();
-    int parseXml();
-    uint rowIndex() const        { return m_rowIdx; }
-    uint columnIndex() const     { return m_colIdx; }
-    uint rowSpan() const;
-    uint colSpan() const;
-    Alignment alignment() const;
-    Valignment valignment() const;
-
-  private:
-    void setRowIndex(uint idx)    { m_rowIdx = idx; }
-    void setColumnIndex(uint idx) { m_colIdx = idx; }
-    bool           m_isHeading = false;
-    bool           m_isFirst = false;
-    bool           m_isLast = false;
-    HtmlAttribList m_attribs;
-    uint           m_rowIdx = (uint)-1;
-    uint           m_colIdx = (uint)-1;
-};
-
-/** Node representing a HTML table caption */
-class DocHtmlCaption : public CompAccept<DocHtmlCaption>
-{
-  public:
-    DocHtmlCaption(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs);
-    Kind kind() const override          { return Kind_HtmlCaption; }
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    int parse();
-    bool hasCaptionId() const { return m_hasCaptionId; }
-    QCString file() const     { return m_file;         }
-    QCString anchor() const   { return m_anchor;       }
-
-  private:
-    HtmlAttribList m_attribs;
-    bool           m_hasCaptionId = false;
-    QCString       m_file;
-    QCString       m_anchor;
-};
-
-/** Node representing a HTML table row */
-class DocHtmlRow : public CompAccept<DocHtmlRow>
-{
-    friend class DocHtmlTable;
-  public:
-    DocHtmlRow(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs)
-      : CompAccept<DocHtmlRow>(parser), m_attribs(attribs) { m_parent = parent; }
-    Kind kind() const override            { return Kind_HtmlRow; }
-    size_t numCells() const      { return m_children.size(); }
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    int parse();
-    int parseXml(bool header);
-    bool isHeading() const       { // a row is a table heading if all cells are marked as such
-                                   bool heading=TRUE;
-                                   for (const auto &n : m_children)
-                                   {
-                                     if (n->kind()==Kind_HtmlCell)
-                                     {
-                                       heading = heading && ((DocHtmlCell*)n.get())->isHeading();
-                                     }
-                                   }
-                                   return !m_children.empty() && heading;
-                                 }
-    void setVisibleCells(uint n) { m_visibleCells = n; }
-    uint visibleCells() const    { return m_visibleCells; }
-    uint rowIndex() const        { return m_rowIdx; }
-
-  private:
-    void setRowIndex(uint idx)   { m_rowIdx = idx; }
-    HtmlAttribList m_attribs;
-    uint m_visibleCells = 0;
-    uint m_rowIdx = (uint)-1;
-};
-
-/** Node representing a HTML table */
-class DocHtmlTable : public CompAccept<DocHtmlTable>
-{
-  public:
-    DocHtmlTable(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs)
-      : CompAccept<DocHtmlTable>(parser), m_attribs(attribs) { m_caption=0; m_numCols=0; m_parent = parent; }
-    ~DocHtmlTable()         { delete m_caption; }
-    Kind kind() const override       { return Kind_HtmlTable; }
-    size_t numRows() const  { return m_children.size(); }
-    bool hasCaption()       { return m_caption!=0; }
-    const HtmlAttribList &attribs() const { return m_attribs; }
-    int parse();
-    int parseXml();
-    size_t numColumns() const { return m_numCols; }
-    void accept(DocVisitor *v) override;
-    DocHtmlCaption *caption() const { return m_caption; }
-    DocHtmlRow *firstRow() const {
-                             return (!m_children.empty() && m_children.front()->kind()==Kind_HtmlRow) ?
-                                     (DocHtmlRow*)m_children.front().get() : 0;
-                           }
-
-  private:
-    void computeTableGrid();
-    DocHtmlCaption    *m_caption = 0;
-    HtmlAttribList     m_attribs;
-    size_t m_numCols = 0;
-};
-
-/** Node representing an HTML blockquote */
-class DocHtmlBlockQuote : public CompAccept<DocHtmlBlockQuote>
-{
-  public:
-    DocHtmlBlockQuote(DocParser &parser,DocNode *parent,const HtmlAttribList &attribs)
-      : CompAccept<DocHtmlBlockQuote>(parser), m_attribs(attribs) { m_parent = parent; }
-    Kind kind() const override       { return Kind_HtmlBlockQuote; }
-    int parse();
-    const HtmlAttribList &attribs() const { return m_attribs; }
-
-  private:
-    HtmlAttribList m_attribs;
-};
-
-/** Root node of a text fragment */
-class DocText : public CompAccept<DocText>
-{
-  public:
-    DocText(DocParser &parser) : CompAccept<DocText>(parser) {}
-    Kind kind() const override       { return Kind_Text; }
-    void parse();
-    bool isEmpty() const    { return m_children.empty(); }
-};
-
-/** Root node of documentation tree */
-class DocRoot : public CompAccept<DocRoot>
-{
-  public:
-    DocRoot(DocParser &parser,bool indent,bool sl) : CompAccept<DocRoot>(parser), m_indent(indent), m_singleLine(sl) {}
-    Kind kind() const override       { return Kind_Root; }
-    void parse();
-    bool indent() const { return m_indent; }
-    bool singleLine() const { return m_singleLine; }
-    bool isEmpty() const { return m_children.empty(); }
-
-  private:
-    bool m_indent = false;
-    bool m_singleLine = false;
-};
+void docFindSections(const QCString &input,
+                     const Definition *d,
+                     const QCString &fileName);
 
 
 #endif