/******************************************************************************

 *

 * 

 *

 *

 * Copyright (C) 1997-2015 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

 * granted. No representations are made about the suitability of this software

 * for any purpose. It is provided "as is" without express or implied warranty.

 * See the GNU General Public License for more details.

 *

 * Documents produced by Doxygen are derivative works derived from the

 * input used in their production; they are not affected by this license.

 *

 */

#include <qfileinfo.h>

#include "docbookvisitor.h"

#include "docparser.h"

#include "language.h"

#include "doxygen.h"

#include "outputgen.h"

#include "docbookgen.h"

#include "dot.h"

#include "message.h"

#include "util.h"

#include "parserintf.h"

#include "filename.h"

#include "config.h"

#include "filedef.h"

#include "msc.h"

#include "dia.h"

#include "htmlentity.h"

#include "plantuml.h"

static void visitPreStart(FTextStream &t, const bool hasCaption, QCString name,  QCString width,  QCString height)

{

  QCString tmpStr;

  t << "    <figure>" << endl;

  t << "        <title></title>" << endl;

  t << "        <mediaobject>" << endl;

  t << "            <imageobject>" << endl;

  t << "                

  if (!width.isEmpty())

  {

    t << " width=\"" << convertToXML(width) << "\"";

  }

  else

  {

    t << " width=\"50%\"";

  }

  if (!height.isEmpty())

  {

    t << " depth=\"" << convertToXML(tmpStr) << "\"";

  }

  t << " align=\"center\" valign=\"middle\" scalefit=\"1\" fileref=\"" << name << "\">";

  t << "</imagedata>" << endl;

  t << "            </imageobject>" << endl;

  if (hasCaption)

  {

    t << "        <caption>" << endl;

  }

}

static void visitPostEnd(FTextStream &t, const bool hasCaption)

{

  t << endl;

  if (hasCaption)

  {

    t << "        </caption>" << endl;

  }

  t << "        </mediaobject>" << endl;

  t << "    </figure>" << endl;

}

static void visitCaption(DocbookDocVisitor *parent, QList<DocNode> children)

{

  QListIterator<DocNode> cli(children);

  DocNode *n;

  for (cli.toFirst();(n=cli.current());++cli) n->accept(parent);

}

DocbookDocVisitor::DocbookDocVisitor(FTextStream &t,CodeOutputInterface &ci)

  : DocVisitor(DocVisitor_Docbook), m_t(t), m_ci(ci), m_insidePre(FALSE), m_hide(FALSE)

{

}

//--------------------------------------

// visitor functions for leaf nodes

//--------------------------------------

void DocbookDocVisitor::visit(DocWord *w)

{

  if (m_hide) return;

  filter(w->word());

}

void DocbookDocVisitor::visit(DocLinkedWord *w)

{

  if (m_hide) return;

  startLink(w->file(),w->anchor());

  filter(w->word());

  endLink();

}

void DocbookDocVisitor::visit(DocWhiteSpace *w)

{

  if (m_hide) return;

  if (m_insidePre)

  {

    m_t << w->chars();

  }

  else

  {

    m_t << " ";

  }

}

void DocbookDocVisitor::visit(DocSymbol *s)

{

  if (m_hide) return;

  const char *res = HtmlEntityMapper::instance()->docbook(s->symbol());

  if (res)

  {

    m_t << res;

  }

  else

  {

    err("DocBook: non supported HTML-entity found: %s\n",HtmlEntityMapper::instance()->html(s->symbol(),TRUE));

  }

}

void DocbookDocVisitor::visit(DocURL *u)

{

  if (m_hide) return;

  m_t << "

  if (u->isEmail()) m_t << "mailto:";

  filter(u->url());

  m_t << "\">";

  filter(u->url());

  m_t << "</link>";

}

void DocbookDocVisitor::visit(DocLineBreak *)

{

  if (m_hide) return;

  m_t << endl << "<literallayout>\n</literallayout>" << endl;

}

void DocbookDocVisitor::visit(DocHorRuler *)

{

  if (m_hide) return;

  m_t << "<informaltable frame='bottom'><tgroup cols='1'><colspec align='center'/><row><entry align='center'>\n";

  m_t << "</entry></row></tgroup></informaltable>\n";

}

void DocbookDocVisitor::visit(DocStyleChange *s)

{

  if (m_hide) return;

  switch (s->style())

  {

    case DocStyleChange::Bold:

      if (s->enable()) m_t << "<emphasis role=\"bold\">";      else m_t << "</emphasis>";

      break;

    case DocStyleChange::Italic:

      if (s->enable()) m_t << "<emphasis>";     else m_t << "</emphasis>";

      break;

    case DocStyleChange::Code:

      if (s->enable()) m_t << "<computeroutput>";   else m_t << "</computeroutput>";

      break;

    case DocStyleChange::Subscript:

      if (s->enable()) m_t << "<subscript>";    else m_t << "</subscript>";

      break;

    case DocStyleChange::Superscript:

      if (s->enable()) m_t << "<superscript>";    else m_t << "</superscript>";

      break;

    case DocStyleChange::Center:

      if (s->enable()) m_t << "<informaltable frame='none'><tgroup cols='1'><colspec align='center'/><row><entry align='center'>";

      else m_t << "</entry></row></tgroup></informaltable>";

      break;

    case DocStyleChange::Preformatted:

      if (s->enable())

      {

        m_t << "<literallayout>";

        m_insidePre=TRUE;

      }

      else

      {

        m_t << "</literallayout>";

        m_insidePre=FALSE;

      }

      break;

      /* There is no equivalent Docbook tag for rendering Small text */

    case DocStyleChange::Small: /* XSLT Stylesheets can be used */ break;

                                                                   /* HTML only */

    case DocStyleChange::Div:  /* HTML only */ break;

    case DocStyleChange::Span: /* HTML only */ break;

  }

}

void DocbookDocVisitor::visit(DocVerbatim *s)

{

  if (m_hide) return;

  SrcLangExt langExt = getLanguageFromFileName(m_langExt);

  switch(s->type())

  {

    case DocVerbatim::Code: // fall though

      m_t << "<literallayout><computeroutput>";

      Doxygen::parserManager->getParser(m_langExt)

        ->parseCode(m_ci,s->context(),s->text(),langExt,

            s->isExample(),s->exampleFile());

      m_t << "</computeroutput></literallayout>";

      break;

    case DocVerbatim::Verbatim:

      m_t << "<literallayout>";

      filter(s->text());

      m_t << "</literallayout>";

      break;

    case DocVerbatim::HtmlOnly:    

      break;

    case DocVerbatim::RtfOnly:     

      break;

    case DocVerbatim::ManOnly:     

      break;

    case DocVerbatim::LatexOnly:   

      break;

    case DocVerbatim::XmlOnly:     

      break;

    case DocVerbatim::DocbookOnly: 

      break;

      m_t << s->text();

      break;

    case DocVerbatim::Dot:

      {

        static int dotindex = 1;

        QCString baseName(4096);

        QCString name;

        QCString stext = s->text();

        m_t << "<para>" << endl;

        name.sprintf("%s%d", "dot_inline_dotgraph_", dotindex);

        baseName.sprintf("%s%d",

            (Config_getString(DOCBOOK_OUTPUT)+"/inline_dotgraph_").data(),

            dotindex++

            );

        QFile file(baseName+".dot");

        if (!file.open(IO_WriteOnly))

        {

          err("Could not open file %s.msc for writing\n",baseName.data());

        }

        file.writeBlock( stext, stext.length() );

        file.close();

        writeDotFile(baseName, s);

        m_t << "</para>" << endl;

      }

      break;

    case DocVerbatim::Msc:

      {

        static int mscindex = 1;

        QCString baseName(4096);

        QCString name;

        QCString stext = s->text();

        m_t << "<para>" << endl;

        name.sprintf("%s%d", "msc_inline_mscgraph_", mscindex);

        baseName.sprintf("%s%d",

            (Config_getString(DOCBOOK_OUTPUT)+"/inline_mscgraph_").data(),

            mscindex++

            );

        QFile file(baseName+".msc");

        if (!file.open(IO_WriteOnly))

        {

          err("Could not open file %s.msc for writing\n",baseName.data());

        }

        QCString text = "msc {";

        text+=stext;

        text+="}";

        file.writeBlock( text, text.length() );

        file.close();

        writeMscFile(baseName,s);

        m_t << "</para>" << endl;

      }

      break;

    case DocVerbatim::PlantUML:

      {

        static QCString docbookOutput = Config_getString(DOCBOOK_OUTPUT);

        QCString baseName = writePlantUMLSource(docbookOutput,s->exampleFile(),s->text());

        QCString shortName = baseName;

        int i;

        if ((i=shortName.findRev('/'))!=-1)

        {

          shortName=shortName.right(shortName.length()-i-1);

        }

        m_t << "<para>" << endl;

        writePlantUMLFile(baseName,s);

        m_t << "</para>" << endl;

      }

      break;

  }

}

void DocbookDocVisitor::visit(DocAnchor *anc)

{

  if (m_hide) return;

  m_t << "<anchor id=\"" << anc->file() << "_1" << anc->anchor() << "\"/>";

}

void DocbookDocVisitor::visit(DocInclude *inc)

{

  if (m_hide) return;

  SrcLangExt langExt = getLanguageFromFileName(inc->extension());

  switch(inc->type())

  {

    case DocInclude::IncWithLines:

      {

        m_t << "<literallayout><computeroutput>";

        QFileInfo cfi( inc->file() );

        FileDef fd( cfi.dirPath().utf8(), cfi.fileName().utf8() );

        Doxygen::parserManager->getParser(inc->extension())

          ->parseCode(m_ci,inc->context(),

              inc->text(),

              langExt,

              inc->isExample(),

              inc->exampleFile(), &fd;;

        m_t << "</computeroutput></literallayout>";

      }

      break;

    case DocInclude::Include:

      m_t << "<literallayout><computeroutput>";

      Doxygen::parserManager->getParser(inc->extension())

        ->parseCode(m_ci,inc->context(),

            inc->text(),

            langExt,

            inc->isExample(),

            inc->exampleFile());

      m_t << "</computeroutput></literallayout>";

      break;

    case DocInclude::DontInclude:

      break;

    case DocInclude::HtmlInclude:

      break;

    case DocInclude::LatexInclude:

      break;

    case DocInclude::VerbInclude:

      m_t << "<verbatim>";

      filter(inc->text());

      m_t << "</verbatim>";

      break;

    case DocInclude::Snippet:

      m_t << "<literallayout><computeroutput>";

      Doxygen::parserManager->getParser(inc->extension())

        ->parseCode(m_ci,

            inc->context(),

            extractBlock(inc->text(),inc->blockId()),

            langExt,

            inc->isExample(),

            inc->exampleFile()

            );

      m_t << "</computeroutput></literallayout>";

      break;

    case DocInclude::SnipWithLines:

      {

         QFileInfo cfi( inc->file() );

         FileDef fd( cfi.dirPath().utf8(), cfi.fileName().utf8() );

         m_t << "<literallayout><computeroutput>";

         Doxygen::parserManager->getParser(inc->extension())

                               ->parseCode(m_ci,

                                           inc->context(),

                                           extractBlock(inc->text(),inc->blockId()),

                                           langExt,

                                           inc->isExample(),

                                           inc->exampleFile(), 

                                           &fd,

                                           lineBlock(inc->text(),inc->blockId()),

                                           -1,    // endLine

                                           FALSE, // inlineFragment

                                           0,     // memberDef

                                           TRUE   // show line number

                                          );

         m_t << "</computeroutput></literallayout>";

      }

      break;

    case DocInclude::SnippetDoc: 

    case DocInclude::IncludeDoc: 

      err("Internal inconsistency: found switch SnippetDoc / IncludeDoc in file: %s"

          "Please create a bug report\n",__FILE__);

      break;

  }

}

void DocbookDocVisitor::visit(DocIncOperator *op)

{

  if (op->isFirst())

  {

    if (!m_hide)

    {

      m_t << "<programlisting>";

    }

    pushEnabled();

    m_hide = TRUE;

  }

  SrcLangExt langExt = getLanguageFromFileName(m_langExt);

  if (op->type()!=DocIncOperator::Skip)

  {

    popEnabled();

    if (!m_hide)

    {

      Doxygen::parserManager->getParser(m_langExt)

        ->parseCode(m_ci,op->context(),

            op->text(),langExt,op->isExample(),

            op->exampleFile());

    }

    pushEnabled();

    m_hide=TRUE;

  }

  if (op->isLast())

  {

    popEnabled();

    if (!m_hide) m_t << "</programlisting>";

  }

  else

  {

    if (!m_hide) m_t << endl;

  }

}

void DocbookDocVisitor::visit(DocFormula *f)

{

  if (m_hide) return;

  m_t << "<equation><title>" << f->name() << "</title>";

  filter(f->text());

  m_t << "</equation>";

}

void DocbookDocVisitor::visit(DocIndexEntry *ie)

{

  if (m_hide) return;

  m_t << "<indexentry><primaryie>" << endl;

  filter(ie->entry());

  m_t << "</primaryie><secondaryie></secondaryie></indexentry>" << endl;

}

void DocbookDocVisitor::visit(DocSimpleSectSep *)

{

  m_t << "<simplesect/>";

}

void DocbookDocVisitor::visit(DocCite *cite)

{

  if (m_hide) return;

  if (!cite->file().isEmpty()) startLink(cite->file(),cite->anchor());

  filter(cite->text());

  if (!cite->file().isEmpty()) endLink();

}

//--------------------------------------

// visitor functions for compound nodes

//--------------------------------------

void DocbookDocVisitor::visitPre(DocAutoList *l)

{

  if (m_hide) return;

  if (l->isEnumList())

  {

    m_t << "<orderedlist>\n";

  }

  else

  {

    m_t << "<itemizedlist>\n";

  }

}

void DocbookDocVisitor::visitPost(DocAutoList *l)

{

  if (m_hide) return;

  if (l->isEnumList())

  {

    m_t << "</orderedlist>\n";

  }

  else

  {

    m_t << "</itemizedlist>\n";

  }

}

void DocbookDocVisitor::visitPre(DocAutoListItem *)

{

  if (m_hide) return;

  m_t << "<listitem>";

}

void DocbookDocVisitor::visitPost(DocAutoListItem *)

{

  if (m_hide) return;

  m_t << "</listitem>";

}

void DocbookDocVisitor::visitPre(DocPara *)

{

  if (m_hide) return;

  m_t << endl;

  m_t << "<para>";

}

void DocbookDocVisitor::visitPost(DocPara *)

{

  if (m_hide) return;

  m_t << "</para>";

  m_t << endl;

}

void DocbookDocVisitor::visitPre(DocRoot *)

{

  //m_t << "
<font color=\"red\">New parser:</font>
\n";

}

void DocbookDocVisitor::visitPost(DocRoot *)

{

  //m_t << "
<font color=\"red\">Old parser:</font>
\n";

}

void DocbookDocVisitor::visitPre(DocSimpleSect *s)

{

  if (m_hide) return;

  switch(s->type())

  {

    case DocSimpleSect::See:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trSeeAlso() << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trSeeAlso()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Return:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trReturns()<< ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trReturns()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Author:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trAuthor(TRUE, TRUE) << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trAuthor(TRUE, TRUE)) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Authors:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trAuthor(TRUE, FALSE) << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trAuthor(TRUE, FALSE)) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Version:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trVersion() << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trVersion()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Since:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trSince() << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trSince()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Date:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trDate() << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trDate()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Note:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trNote() << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trNote()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Warning:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trWarning() << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trWarning()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Pre:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trPrecondition() << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trPrecondition()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Post:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trPostcondition() << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trPostcondition()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Copyright:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trCopyright() << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trCopyright()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Invar:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trInvariant() << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trInvariant()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Remark:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trRemarks() << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trRemarks()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::Attention:

      if (m_insidePre) 

      {

        m_t << "<formalpara><title>" << theTranslator->trAttention() << ": </title>" << endl;

      } 

      else 

      {

        m_t << "<formalpara><title>" << convertToXML(theTranslator->trAttention()) << ": </title>" << endl;

      }

      break;

    case DocSimpleSect::User:

      m_t << "<formalpara><title></title>" << endl;

      break;

    case DocSimpleSect::Rcs:

      m_t << "<formalpara><title></title>" << endl;

      break;

    case DocSimpleSect::Unknown: m_t << "<formalpara><title></title>" << endl; break;

  }

}

void DocbookDocVisitor::visitPost(DocSimpleSect *)

{

  if (m_hide) return;

  m_t << "</formalpara>" << endl;

}

void DocbookDocVisitor::visitPre(DocTitle *)

{

  if (m_hide) return;

  m_t << "<title>";

}

void DocbookDocVisitor::visitPost(DocTitle *)

{

  if (m_hide) return;

  m_t << "</title>";

}

void DocbookDocVisitor::visitPre(DocSimpleList *)

{

  if (m_hide) return;

  m_t << "<itemizedlist>\n";

}

void DocbookDocVisitor::visitPost(DocSimpleList *)

{

  if (m_hide) return;

  m_t << "</itemizedlist>\n";

}

void DocbookDocVisitor::visitPre(DocSimpleListItem *)

{

  if (m_hide) return;

  m_t << "<listitem>";

}

void DocbookDocVisitor::visitPost(DocSimpleListItem *)

{

  if (m_hide) return;

  m_t << "</listitem>\n";

}

void DocbookDocVisitor::visitPre(DocSection *s)

{

  if (m_hide) return;

  m_t << "<section xml:id=\"" << s->file();

  if (!s->anchor().isEmpty()) m_t << "_1" << s->anchor();

  m_t << "\">" << endl;

  m_t << "<title>";

  filter(s->title());

  m_t << "</title>" << endl;

}

void DocbookDocVisitor::visitPost(DocSection *)

{

  m_t << "</section>\n";

}

void DocbookDocVisitor::visitPre(DocHtmlList *s)

{

  if (m_hide) return;

  if (s->type()==DocHtmlList::Ordered)

    m_t << "<orderedlist>\n";

  else

    m_t << "<itemizedlist>\n";

}

void DocbookDocVisitor::visitPost(DocHtmlList *s)

{

  if (m_hide) return;

  if (s->type()==DocHtmlList::Ordered)

    m_t << "</orderedlist>\n";

  else

    m_t << "</itemizedlist>\n";

}

void DocbookDocVisitor::visitPre(DocHtmlListItem *)

{

  if (m_hide) return;

  m_t << "<listitem>\n";

}

void DocbookDocVisitor::visitPost(DocHtmlListItem *)

{

  if (m_hide) return;

  m_t << "</listitem>\n";

}

void DocbookDocVisitor::visitPre(DocHtmlDescList *)

{

  if (m_hide) return;

  m_t << "<variablelist>\n";

}

void DocbookDocVisitor::visitPost(DocHtmlDescList *)

{

  if (m_hide) return;

  m_t << "</variablelist>\n";

}

void DocbookDocVisitor::visitPre(DocHtmlDescTitle *)

{

  if (m_hide) return;

  m_t << "<varlistentry><term>";

}

void DocbookDocVisitor::visitPost(DocHtmlDescTitle *)

{

  if (m_hide) return;

  m_t << "</term>\n";

}

void DocbookDocVisitor::visitPre(DocHtmlDescData *)

{

  if (m_hide) return;

  m_t << "<listitem>";

}

void DocbookDocVisitor::visitPost(DocHtmlDescData *)

{

  if (m_hide) return;

  m_t << "</listitem></varlistentry>\n";

}

void DocbookDocVisitor::visitPre(DocHtmlTable *t)

{

  if (m_hide) return;

  m_t << "" << endl;

  m_t << "    <title></title>" << endl;

  m_t << "    <tgroup cols=\"" << t->numColumns() << "\" align=\"left\" colsep=\"1\" rowsep=\"1\">" << endl;

  m_t << "    " << endl;

}

void DocbookDocVisitor::visitPost(DocHtmlTable *)

{

  if (m_hide) return;

  m_t << "    " << endl;

  m_t << "    </tgroup>" << endl;

  m_t << "" << endl;

}

void DocbookDocVisitor::visitPre(DocHtmlRow *)

{

  if (m_hide) return;

  m_t << "<row>\n";

}

void DocbookDocVisitor::visitPost(DocHtmlRow *)

{

  if (m_hide) return;

  m_t << "</row>\n";

}

void DocbookDocVisitor::visitPre(DocHtmlCell *)

{

  if (m_hide) return;

  m_t << "<entry>";

}

void DocbookDocVisitor::visitPost(DocHtmlCell *)

{

  if (m_hide) return;

  m_t << "</entry>";

}

void DocbookDocVisitor::visitPre(DocHtmlCaption *)

{

  if (m_hide) return;

  m_t << "<caption>";

}

void DocbookDocVisitor::visitPost(DocHtmlCaption *)

{

  if (m_hide) return;

  m_t << "</caption>\n";

}

void DocbookDocVisitor::visitPre(DocInternal *)

{

  if (m_hide) return;

  // TODO: to be implemented

}

void DocbookDocVisitor::visitPost(DocInternal *)

{

  if (m_hide) return;

  // TODO: to be implemented

}

void DocbookDocVisitor::visitPre(DocHRef *href)

{

  if (m_hide) return;