Doxygen
Loading...
Searching...
No Matches
DocbookGenerator Class Referencefinal

#include <src/docbookgen.h>

Inheritance diagram for DocbookGenerator:
Collaboration diagram for DocbookGenerator:

Classes

struct  TocState

Public Member Functions

 DocbookGenerator ()
 DocbookGenerator (const DocbookGenerator &)
DocbookGeneratoroperator= (const DocbookGenerator &)
 DocbookGenerator (DocbookGenerator &&)=delete
DocbookGeneratoroperator= (DocbookGenerator &&)=delete
 ~DocbookGenerator ()
OutputType type () const override
std::unique_ptr< OutputGenIntfclone () override
void addCodeGen (OutputCodeList &list) override
void cleanup () override
void writeDoc (const IDocNodeAST *node, const Definition *ctx, const MemberDef *md, int id, int sectionLevel) override
void startFile (const DString &name, bool isSource, const DString &manName, const DString &title, int id, int hierarchyLevel) override
void endFile () override
void writeSearchInfo () override
void writeFooter (const DString &) override
void startIndexSection (IndexSection) override
void endIndexSection (IndexSection) override
void writePageLink (const DString &, bool) override
void startProjectNumber () override
void endProjectNumber () override
void writeStyleInfo (int) override
void startTitleHead (const DString &) override
void endTitleHead (const DString &fileName, const DString &name) override
void startIndexListItem () override
void endIndexListItem () override
void startIndexList () override
void endIndexList () override
void startIndexKey () override
void endIndexKey () override
void startIndexValue (bool) override
void endIndexValue (const DString &, bool) override
void startItemList () override
void endItemList () override
void startIndexItem (const DString &, const DString &) override
void endIndexItem (const DString &, const DString &) override
void startItemListItem () override
void endItemListItem () override
void docify (const DString &text) override
void writeChar (char) override
void writeString (const DString &) override
void startParagraph (const DString &) override
void endParagraph () override
void writeObjectLink (const DString &, const DString &, const DString &, const DString &) override
void startBold () override
void endBold () override
void startTypewriter () override
void endTypewriter () override
void startEmphasis () override
void endEmphasis () override
void writeRuler () override
void startDescForItem () override
void endDescForItem () override
void startCenter () override
void endCenter () override
void startSmall () override
void endSmall () override
void startExamples () override
void endExamples () override
void writeAnchor (const DString &, const DString &) override
void startSection (const DString &, const DString &, SectionType) override
void endSection (const DString &, SectionType) override
void lineBreak (const DString &) override
void addIndexItem (const DString &, const DString &) override
void writeNonBreakableSpace (int) override
void startDescTable (const DString &title, bool hasInits) override
void endDescTable () override
void startDescTableRow () override
void endDescTableRow () override
void startDescTableTitle () override
void endDescTableTitle () override
void startDescTableInit () override
void endDescTableInit () override
void startDescTableData () override
void endDescTableData () override
void startTextLink (const DString &, const DString &) override
void endTextLink () override
void startPageRef () override
void endPageRef (const DString &, const DString &) override
void startGroupHeader (const DString &, int) override
void endGroupHeader (int) override
void startMemberSections () override
void endMemberSections () override
void startHeaderSection () override
void endHeaderSection () override
void startMemberHeader (const DString &anchor, int typ) override
void endMemberHeader () override
void startMemberSubtitle () override
void endMemberSubtitle () override
void startMemberDocList () override
void endMemberDocList () override
void startMemberList () override
void endMemberList () override
void startInlineHeader () override
void endInlineHeader () override
void startAnonTypeScope (int) override
void endAnonTypeScope (int) override
void startMemberItem (const DString &, MemberItemType, const DString &) override
void endMemberItem (MemberItemType) override
void startMemberTemplateParams () override
void endMemberTemplateParams (const DString &, const DString &) override
void startCompoundTemplateParams () override
void endCompoundTemplateParams () override
void startMemberGroupHeader (const DString &, bool) override
void endMemberGroupHeader (bool) override
void startMemberGroupDocs () override
void endMemberGroupDocs () override
void startMemberGroup () override
void endMemberGroup (bool) override
void insertMemberAlign (bool) override
void insertMemberAlignLeft (MemberItemType, bool) override
void startMemberDoc (const DString &, const DString &, const DString &, const DString &, int, int, bool) override
void endMemberDoc (bool) override
void startDoxyAnchor (const DString &fName, const DString &manName, const DString &anchor, const DString &name, const DString &args) override
void endDoxyAnchor (const DString &fileName, const DString &anchor) override
void addLabel (const DString &, const DString &) override
void writeLatexSpacing () override
void writeStartAnnoItem (const DString &, const DString &, const DString &, const DString &) override
void startMemberDescription (const DString &, const DString &, bool) override
void endMemberDescription () override
void startMemberDeclaration () override
void endMemberDeclaration (const DString &, const DString &) override
void writeInheritedSectionTitle (const DString &, const DString &, const DString &, const DString &, const DString &, const DString &) override
void startIndent () override
void endIndent () override
void writeSynopsis () override
void startClassDiagram () override
void endClassDiagram (const ClassDiagram &, const DString &, const DString &) override
void startDotGraph () override
void endDotGraph (DotClassGraph &g) override
void startInclDepGraph () override
void endInclDepGraph (DotInclDepGraph &g) override
void startGroupCollaboration () override
void endGroupCollaboration (DotGroupCollaboration &g) override
void startCallGraph () override
void endCallGraph (DotCallGraph &g) override
void startDirDepGraph () override
void endDirDepGraph (DotDirDeps &g) override
void writeGraphicalHierarchy (DotGfxHierarchyTable &) override
void startQuickIndices () override
void endQuickIndices () override
void writeSplitBar (const DString &, const DString &) override
void writeNavigationPath (const DString &) override
void writeLogo () override
void writeQuickLinks (HighlightedItem, const DString &, bool) override
void writeSummaryLink (const DString &, const DString &, const DString &, bool) override
void writePageOutline () override
void startContents () override
void endContents () override
void startPageDoc (const DString &) override
void endPageDoc () override
void startTextBlock (bool) override
void endTextBlock (bool) override
void lastIndexPage () override
void startMemberDocPrefixItem () override
void endMemberDocPrefixItem () override
void startMemberDocName (bool) override
void endMemberDocName () override
void startParameterType (bool, const DString &) override
void endParameterType () override
void startParameterName (bool) override
void endParameterName () override
void startParameterExtra () override
void endParameterExtra (bool, bool, bool) override
void startParameterDefVal (const char *sep) override
void endParameterDefVal () override
void startParameterList (bool) override
void endParameterList () override
void exceptionEntry (const DString &, bool) override
void startConstraintList (const DString &) override
void startConstraintParam () override
void endConstraintParam () override
void startConstraintType () override
void endConstraintType () override
void startConstraintDocs () override
void endConstraintDocs () override
void endConstraintList () override
void startMemberDocSimple (bool) override
void endMemberDocSimple (bool) override
void startInlineMemberType () override
void endInlineMemberType () override
void startInlineMemberName () override
void endInlineMemberName () override
void startInlineMemberDoc () override
void endInlineMemberDoc () override
void startLabels () override
void writeLabel (const DString &, bool) override
void endLabels () override
void startLocalToc (int level) override
void endLocalToc () override
void startTocEntry (const SectionInfo *si) override
void endTocEntry (const SectionInfo *si) override
void startPlainFile (const DString &name) override
void endPlainFile () override
void startEmbeddedDoc (size_t) override
void endEmbeddedDoc () override
Public Member Functions inherited from OutputGenerator
 OutputGenerator ()
 OutputGenerator (const DString &dir)
virtual ~OutputGenerator ()=default
DString dir () const
DString fileName () const
void startPlainFile (const DString &name)
void endPlainFile ()

Static Public Member Functions

static void init ()
static DString convertToDocbook (const DString &s, bool retainNewline=false, bool citeEntry=false)

Private Member Functions

void openSection (const DString &attr=DString())
void closeSection ()
void closeAllSections ()

Private Attributes

DString relPath
std::unique_ptr< OutputCodeListm_codeList
DocbookCodeGeneratorm_codeGen = nullptr
bool m_denseText = false
bool m_inGroup = false
int m_levelListItem = 0
std::array< bool, 20 > m_inListItem = { false, }
std::array< bool, 20 > m_inSimpleSect = { false, }
bool m_descTable = false
bool m_simpleTable = false
int m_inLevel = -1
bool m_firstMember = false
int m_openSectionCount = 0
DString m_pageLinks
TocState m_tocState

Additional Inherited Members

Public Types inherited from OutputGenerator
enum class  ParamListTypes { Param , RetVal , Exception }
enum class  MemberItemType { Normal , AnonymousStart , AnonymousEnd , Templated }
Protected Attributes inherited from OutputGenerator
TextStream m_t
DString m_dir

Detailed Description

Definition at line 102 of file docbookgen.h.

Constructor & Destructor Documentation

◆ DocbookGenerator() [1/3]

DocbookGenerator::DocbookGenerator ( )

Definition at line 314 of file docbookgen.cpp.

315 : OutputGenerator(Config_getString(DOCBOOK_OUTPUT))
316 , m_codeList(std::make_unique<OutputCodeList>())
317{
319 m_codeGen = m_codeList->add<DocbookCodeGenerator>(&m_t);
320}
std::unique_ptr< OutputCodeList > m_codeList
Definition docbookgen.h:332
DocbookCodeGenerator * m_codeGen
Definition docbookgen.h:333
TextStream m_t
Definition outputgen.h:113
#define Config_getString(name)
Definition config.h:32
#define DB_GEN_C

References Config_getString, DB_GEN_C, m_codeGen, m_codeList, OutputGenerator::m_t, and OutputGenerator::OutputGenerator().

Referenced by DocbookGenerator(), DocbookGenerator(), operator=(), and operator=().

◆ DocbookGenerator() [2/3]

DocbookGenerator::DocbookGenerator ( const DocbookGenerator & og)

Definition at line 322 of file docbookgen.cpp.

322 : OutputGenerator(og.m_dir), OutputGenIntf()
323{
324 m_codeList = std::make_unique<OutputCodeList>(*og.m_codeList);
325 m_codeGen = m_codeList->get<DocbookCodeGenerator>(OutputType::Docbook);
328 m_inGroup = og.m_inGroup;
334 m_inLevel = og.m_inLevel;
337}
void setTextStream(TextStream *t)
Definition docbookgen.h:50
std::array< bool, 20 > m_inSimpleSect
Definition docbookgen.h:338
std::array< bool, 20 > m_inListItem
Definition docbookgen.h:337

References Docbook, DocbookGenerator(), m_codeGen, m_codeList, m_denseText, m_descTable, OutputGenerator::m_dir, m_firstMember, m_inGroup, m_inLevel, m_inListItem, m_inSimpleSect, m_levelListItem, m_openSectionCount, m_simpleTable, OutputGenerator::m_t, OutputGenerator::OutputGenerator(), and DocbookCodeGenerator::setTextStream().

◆ DocbookGenerator() [3/3]

DocbookGenerator::DocbookGenerator ( DocbookGenerator && )
delete

References DocbookGenerator().

◆ ~DocbookGenerator()

DocbookGenerator::~DocbookGenerator ( )
default

Member Function Documentation

◆ addCodeGen()

void DocbookGenerator::addCodeGen ( OutputCodeList & list)
overridevirtual

Implements OutputGenIntf.

Definition at line 363 of file docbookgen.cpp.

364{
366}
void add(OutputCodeIntfPtr &&p)
Definition outputlist.h:192
OutputCodeDefer< DocbookCodeGenerator > DocbookCodeGeneratorDefer
Definition outputlist.h:103

References OutputCodeList::add(), and m_codeGen.

◆ addIndexItem()

void DocbookGenerator::addIndexItem ( const DString & prim,
const DString & sec )
overridevirtual

Implements OutputGenIntf.

Definition at line 1139 of file docbookgen.cpp.

1140{
1142 addIndexTerm(m_t, prim, sec);
1143}
static void addIndexTerm(TextStream &t, DString prim, DString sec="")

References addIndexTerm(), DB_GEN_C, and OutputGenerator::m_t.

◆ addLabel()

void DocbookGenerator::addLabel ( const DString & ,
const DString &  )
overridevirtual

Implements OutputGenIntf.

Definition at line 954 of file docbookgen.cpp.

955{
957}

References DB_GEN_C.

◆ cleanup()

void DocbookGenerator::cleanup ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 379 of file docbookgen.cpp.

380{
381 DString dname = Config_getString(DOCBOOK_OUTPUT);
382 Dir d(dname.str());
383 clearSubDirs(d);
384}
const std::string & str() const
Definition dstring.h:645
void clearSubDirs(const Dir &d)
Definition util.cpp:2996

References clearSubDirs(), Config_getString, and DString::str().

◆ clone()

std::unique_ptr< OutputGenIntf > DocbookGenerator::clone ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 120 of file docbookgen.h.

120{ return std::make_unique<DocbookGenerator>(*this); }

◆ closeAllSections()

void DocbookGenerator::closeAllSections ( )
private

Definition at line 1393 of file docbookgen.cpp.

1394{
1395 while (m_openSectionCount>0)
1396 {
1397 closeSection();
1398 }
1399}

References closeSection(), and m_openSectionCount.

Referenced by endFile().

◆ closeSection()

void DocbookGenerator::closeSection ( )
private

Definition at line 1387 of file docbookgen.cpp.

1388{
1389 m_t << "</section>\n";
1391}

References m_openSectionCount, and OutputGenerator::m_t.

Referenced by closeAllSections(), endSection(), startDoxyAnchor(), startGroupHeader(), and writeRuler().

◆ convertToDocbook()

DString DocbookGenerator::convertToDocbook ( const DString & s,
bool retainNewline = false,
bool citeEntry = false )
static

Converts a string to an DocBook-encoded string

Definition at line 1477 of file docbookgen.cpp.

1478{
1479 if (s.empty()) return s;
1480 DString result;
1481 result.reserve(s.length()+32);
1482 const char *p = s.data();
1483 char c = 0;
1484 while ((c=*p++))
1485 {
1486 switch (c)
1487 {
1488 case '\n':
1489 if (retainNewline)
1490 {
1491 result+="<literallayout>&#160;&#xa;</literallayout>";
1492 result+=c;
1493 }
1494 break;
1495 case '<': result+="&lt;"; break;
1496 case '>': result+="&gt;"; break;
1497 case '&': // possibility to have a special symbol
1499 result,
1500 p-1,
1501 [](HtmlEntityMapper::SymType symType) { return HtmlEntityMapper::instance().docbook(symType); },
1502 "&amp;");
1503 break;
1504 case '\'': result+="&apos;"; break;
1505 case '"': result+="&quot;"; break;
1506 case 1: case 2: case 3: case 4: case 5: case 6: case 7: case 8:
1507 case 11: case 12: case 14: case 15: case 16: case 17: case 18:
1508 case 19: case 20: case 21: case 22: case 23: case 24: case 25: case 26:
1509 case 27: case 28: case 29: case 30: case 31:
1510 result+="&#x24";
1511 result+=hex[static_cast<uint8_t>(c)>>4];
1512 result+=hex[static_cast<uint8_t>(c)&0xF];
1513 result+=';';
1514 break;
1515 default:
1516 result+=c;
1517 break;
1518 }
1519 }
1520 return result;
1521}
bool empty() const
Returns true iff the string is empty (std::string compatible alias for isEmpty()).
Definition dstring.h:148
void reserve(size_t size)
Reserve space for size bytes without changing the string contents.
Definition dstring.h:217
const char * data() const
Returns a pointer to the contents of the string in the form of a 0-terminated C string.
Definition dstring.h:157
size_t length() const
Returns the length of the string, not counting the 0-terminator.
Definition dstring.h:151
const char * writeHtmlEntity(T &result, const char *s, HtmlEntityMapperFunc &&mapper, const char *fallback)
Definition htmlentity.h:127
static HtmlEntityMapper & instance()
Returns the one and only instance of the HTML entity mapper.
const char * docbook(SymType symb) const
Access routine to the docbook code of the HTML entity.
static constexpr auto hex

References DString::data(), HtmlEntityMapper::docbook(), DString::empty(), hex, HtmlEntityMapper::instance(), DString::length(), DString::reserve(), and HtmlEntityMapper::writeHtmlEntity().

Referenced by addIndexTerm(), docify(), DocbookDocVisitor::filter(), objectLinkToString(), DocbookDocVisitor::operator()(), DocbookDocVisitor::operator()(), DocbookDocVisitor::operator()(), DocbookDocVisitor::operator()(), startDescTable(), startIndexSection(), startMemberDoc(), startMemberDocSimple(), startTocEntry(), DocbookDocVisitor::visitPreStart(), writeDocbookString(), and writeInheritedSectionTitle().

◆ docify()

void DocbookGenerator::docify ( const DString & text)
overridevirtual

Implements OutputGenIntf.

Definition at line 761 of file docbookgen.cpp.

762{
764 m_t << convertToDocbook(str);
765}
static DString convertToDocbook(const DString &s, bool retainNewline=false, bool citeEntry=false)

References convertToDocbook(), DB_GEN_C, and OutputGenerator::m_t.

Referenced by startConstraintList(), startExamples(), and writeChar().

◆ endAnonTypeScope()

void DocbookGenerator::endAnonTypeScope ( int )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 212 of file docbookgen.h.

#define DB_GEN_EMPTY
Definition docbookgen.h:25

References DB_GEN_EMPTY.

◆ endBold()

void DocbookGenerator::endBold ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 823 of file docbookgen.cpp.

824{
826 m_t << "</emphasis>";
827}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endCallGraph()

void DocbookGenerator::endCallGraph ( DotCallGraph & g)
overridevirtual

Implements OutputGenIntf.

Definition at line 1316 of file docbookgen.cpp.

1317{
1320}
DString writeGraph(TextStream &t, GraphOutputFormat gf, EmbeddedOutputFormat ef, const DString &path, const DString &fileName, const DString &relPath, bool writeImageMap=true, int graphId=-1)
DString dir() const
Definition outputgen.cpp:48
DString fileName() const
Definition outputgen.cpp:53

References BITMAP, DB_GEN_C, OutputGenerator::dir(), DocBook, OutputGenerator::fileName(), OutputGenerator::m_t, relPath, and DotCallGraph::writeGraph().

◆ endCenter()

void DocbookGenerator::endCenter ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 168 of file docbookgen.h.

#define DB_GEN_NEW
Definition docbookgen.h:41

References DB_GEN_NEW.

◆ endClassDiagram()

void DocbookGenerator::endClassDiagram ( const ClassDiagram & d,
const DString & fileName,
const DString &  )
overridevirtual

Implements OutputGenIntf.

Definition at line 992 of file docbookgen.cpp.

993{
995 m_t << " <informalfigure>\n";
996 m_t << " <mediaobject>\n";
997 m_t << " <imageobject>\n";
998 m_t << " <imagedata width=\"50%\" align=\"center\" valign=\"middle\" scalefit=\"0\" fileref=\""
999 << relPath << fileName << ".png\">" << "</imagedata>\n";
1000 m_t << " </imageobject>\n";
1001 d.writeImage(m_t,dir(),relPath,fileName,false,false);
1002 m_t << " </mediaobject>\n";
1003 m_t << " </informalfigure>\n";
1004 m_t << "</para>\n";
1005}
void writeImage(TextStream &t, const DString &path, const DString &relPath, const DString &file, bool generateMap, bool toIndex) const
Definition diagram.cpp:1363

References DB_GEN_C, OutputGenerator::dir(), OutputGenerator::fileName(), OutputGenerator::m_t, relPath, and ClassDiagram::writeImage().

◆ endCompoundTemplateParams()

void DocbookGenerator::endCompoundTemplateParams ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1040 of file docbookgen.cpp.

1041{
1043 m_t << "</title></simplesect>\n";
1044}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endConstraintDocs()

void DocbookGenerator::endConstraintDocs ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1369 of file docbookgen.cpp.

1370{
1372}

References DB_GEN_C.

◆ endConstraintList()

void DocbookGenerator::endConstraintList ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1373 of file docbookgen.cpp.

1374{
1376 m_t << "</simplesect>\n";
1377}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endConstraintParam()

void DocbookGenerator::endConstraintParam ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1351 of file docbookgen.cpp.

1352{
1354}

References DB_GEN_C.

◆ endConstraintType()

void DocbookGenerator::endConstraintType ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1360 of file docbookgen.cpp.

1361{
1363 m_t << "</emphasis></para>\n";
1364}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endContents()

void DocbookGenerator::endContents ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 270 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endDescForItem()

void DocbookGenerator::endDescForItem ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 166 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endDescTable()

void DocbookGenerator::endDescTable ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1231 of file docbookgen.cpp.

1232{
1234 m_t << " </tbody>\n";
1235 m_t << " </tgroup>\n";
1236 m_t << "</informaltable>\n";
1237 m_descTable = false;
1238}

References DB_GEN_C, m_descTable, and OutputGenerator::m_t.

◆ endDescTableData()

void DocbookGenerator::endDescTableData ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1280 of file docbookgen.cpp.

1281{
1283 m_t << "</entry>";
1284}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endDescTableInit()

void DocbookGenerator::endDescTableInit ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1269 of file docbookgen.cpp.

1270{
1272}

References DB_GEN_C.

◆ endDescTableRow()

void DocbookGenerator::endDescTableRow ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1247 of file docbookgen.cpp.

1248{
1250 m_t << "</row>";
1251}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endDescTableTitle()

void DocbookGenerator::endDescTableTitle ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1258 of file docbookgen.cpp.

1259{
1261}

References DB_GEN_C.

◆ endDirDepGraph()

void DocbookGenerator::endDirDepGraph ( DotDirDeps & g)
overridevirtual

Implements OutputGenIntf.

Definition at line 1325 of file docbookgen.cpp.

1326{
1329}
DString writeGraph(TextStream &out, GraphOutputFormat gf, EmbeddedOutputFormat ef, const DString &path, const DString &fileName, const DString &relPath, bool writeImageMap=true, int graphId=-1, bool linkRelations=true)

References BITMAP, DB_GEN_C, OutputGenerator::dir(), DocBook, OutputGenerator::fileName(), OutputGenerator::m_t, relPath, and DotDirDeps::writeGraph().

◆ endDotGraph()

void DocbookGenerator::endDotGraph ( DotClassGraph & g)
overridevirtual

Implements OutputGenIntf.

Definition at line 1298 of file docbookgen.cpp.

1299{
1302}
DString writeGraph(TextStream &t, GraphOutputFormat gf, EmbeddedOutputFormat ef, const DString &path, const DString &fileName, const DString &relPath, bool TBRank=true, bool imageMap=true, int graphId=-1)

References BITMAP, DB_GEN_C, OutputGenerator::dir(), DocBook, OutputGenerator::fileName(), OutputGenerator::m_t, relPath, and DotClassGraph::writeGraph().

◆ endDoxyAnchor()

void DocbookGenerator::endDoxyAnchor ( const DString & fileName,
const DString & anchor )
overridevirtual

Implements OutputGenIntf.

Definition at line 950 of file docbookgen.cpp.

951{
953}

References DB_GEN_C.

◆ endEmbeddedDoc()

void DocbookGenerator::endEmbeddedDoc ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 323 of file docbookgen.h.

323{}

◆ endEmphasis()

void DocbookGenerator::endEmphasis ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 163 of file docbookgen.h.

References DB_GEN_NEW.

◆ endExamples()

void DocbookGenerator::endExamples ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1030 of file docbookgen.cpp.

1031{
1033 m_t << "</simplesect>\n";
1034}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endFile()

void DocbookGenerator::endFile ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 418 of file docbookgen.cpp.

419{
422 m_inLevel = -1;
423 m_inGroup = false;
424
425 // Write page links only after all sections have been closed to avoid bugs
426 m_t << m_pageLinks;
427
428 DString fileType="section";
430 if (fileName == "index.xml")
431 {
432 fileType="book";
433 }
434 else if (fileName == "mainpage.xml")
435 {
436 fileType="chapter";
437 }
438 m_t << "</" << fileType << ">\n";
439 endPlainFile();
441}
DString sourceFileName()
Definition docbookgen.h:80
void setSourceFileName(const DString &sourceFileName)
Definition docbookgen.h:79
DString m_pageLinks
Definition docbookgen.h:344
void endPlainFile() override
Definition docbookgen.h:320

References closeAllSections(), DB_GEN_C, endPlainFile(), OutputGenerator::fileName(), m_codeGen, m_inGroup, m_inLevel, m_pageLinks, OutputGenerator::m_t, DocbookCodeGenerator::setSourceFileName(), and DocbookCodeGenerator::sourceFileName().

◆ endGroupCollaboration()

void DocbookGenerator::endGroupCollaboration ( DotGroupCollaboration & g)
overridevirtual

Implements OutputGenIntf.

Definition at line 1289 of file docbookgen.cpp.

1290{
1293}
DString writeGraph(TextStream &t, GraphOutputFormat gf, EmbeddedOutputFormat ef, const DString &path, const DString &fileName, const DString &relPath, bool writeImageMap=true, int graphId=-1)

References BITMAP, DB_GEN_C, OutputGenerator::dir(), DocBook, OutputGenerator::fileName(), OutputGenerator::m_t, relPath, and DotGroupCollaboration::writeGraph().

◆ endGroupHeader()

void DocbookGenerator::endGroupHeader ( int )
overridevirtual

Implements OutputGenIntf.

Definition at line 849 of file docbookgen.cpp.

850{
852 m_t << "</title>\n";
853}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endHeaderSection()

void DocbookGenerator::endHeaderSection ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 200 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endInclDepGraph()

void DocbookGenerator::endInclDepGraph ( DotInclDepGraph & g)
overridevirtual

Implements OutputGenIntf.

Definition at line 1307 of file docbookgen.cpp.

1308{
1311}
DString writeGraph(TextStream &t, GraphOutputFormat gf, EmbeddedOutputFormat ef, const DString &path, const DString &fileName, const DString &relPath, bool writeImageMap=true, int graphId=-1)

References BITMAP, DB_GEN_C, OutputGenerator::dir(), DocBook, OutputGenerator::fileName(), OutputGenerator::m_t, relPath, and DotInclDepGraph::writeGraph().

◆ endIndent()

void DocbookGenerator::endIndent ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 246 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endIndexItem()

void DocbookGenerator::endIndexItem ( const DString & ,
const DString &  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 149 of file docbookgen.h.

References DB_GEN_NEW.

◆ endIndexKey()

void DocbookGenerator::endIndexKey ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 142 of file docbookgen.h.

References DB_GEN_NEW.

◆ endIndexList()

void DocbookGenerator::endIndexList ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 140 of file docbookgen.h.

References DB_GEN_NEW.

◆ endIndexListItem()

void DocbookGenerator::endIndexListItem ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 138 of file docbookgen.h.

References DB_GEN_NEW.

◆ endIndexSection()

void DocbookGenerator::endIndexSection ( IndexSection is)
overridevirtual

Implements OutputGenIntf.

Definition at line 528 of file docbookgen.cpp.

529{
530DB_GEN_C2("IndexSection " << is)
531 switch (is)
532 {
534 break;
536 break;
538 {
540 {
541 writePageLink(DString("mainpage"), true);
542 }
543 }
544 break;
546 //m_t << "</chapter>\n";
547 break;
549 //m_t << "</chapter>\n";
550 break;
552 //m_t << "<xi:include href=\"dirs.xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>";
553 //m_t << "</chapter>\n";
554 break;
556 //m_t << "<xi:include href=\"namespaces.xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>";
557 //m_t << "</chapter>\n";
558 break;
560 //m_t << "<xi:include href=\"concepts.xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>";
561 //m_t << "</chapter>\n";
562 break;
564 //m_t << "<xi:include href=\"hierarchy.xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>";
565 //m_t << "</chapter>\n";
566 break;
568 //m_t << "</chapter>\n";
569 break;
571 //m_t << "<xi:include href=\"files.xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>";
572 //m_t << "</chapter>\n";
573 break;
575 //m_t << "<xi:include href=\"pages.xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>";
576 //m_t << "</chapter>\n";
577 break;
579 {
580 m_t << "</title>\n";
581 for (const auto &gd : *Doxygen::groupLinkedMap)
582 {
583 if (!gd->isReference() && !gd->isASubGroup())
584 {
585 writePageLink(gd->getOutputFileBase(), true);
586 }
587 }
588 }
589 m_t << "</chapter>\n";
590 break;
592 {
593 m_t << "</title>\n";
594 for (const auto &mod : ModuleManager::instance().modules())
595 {
596 if (!mod->isReference() && mod->isPrimaryInterface())
597 {
598 writePageLink(mod->getOutputFileBase(), true);
599 }
600 }
601 }
602 m_t << "</chapter>\n";
603 break;
604 break;
606 {
607 m_t << "</title>\n";
608 for (const auto &dd : *Doxygen::dirLinkedMap)
609 {
610 if (dd->isLinkableInProject())
611 {
612 m_t << " <xi:include href=\"" << dd->getOutputFileBase() << ".xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>\n";
613 }
614 }
615 }
616 m_t << "</chapter>\n";
617 break;
619 {
620 m_t << "</title>\n";
621 for (const auto &nd : *Doxygen::namespaceLinkedMap)
622 {
623 if (nd->isLinkableInProject() && !nd->isAlias())
624 {
625 m_t << " <xi:include href=\"" << nd->getOutputFileBase() << ".xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>\n";
626 }
627 }
628 }
629 m_t << "</chapter>\n";
630 break;
632 {
633 m_t << "</title>\n";
634 for (const auto &cd : *Doxygen::conceptLinkedMap)
635 {
636 if (cd->isLinkableInProject() && !cd->isAlias())
637 {
638 m_t << " <xi:include href=\"" << cd->getOutputFileBase() << ".xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>\n";
639 }
640 }
641 }
642 m_t << "</chapter>\n";
643 break;
645 {
646 m_t << "</title>\n";
647 for (const auto &cd : *Doxygen::classLinkedMap)
648 {
649 if (cd->isLinkableInProject() &&
650 !cd->isImplicitTemplateInstance() &&
651 !cd->isEmbeddedInOuterScope() &&
652 !cd->isAlias()
653 )
654 {
655 m_t << " <xi:include href=\"" << cd->getOutputFileBase() << ".xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>\n";
656 }
657 }
658 }
659 m_t << "</chapter>\n";
660 break;
662 {
663 m_t << "</title>\n";
664 for (const auto &fn : *Doxygen::inputNameLinkedMap)
665 {
666 for (const auto &fd : *fn)
667 {
668 if (fd->isLinkableInProject())
669 {
670 m_t << " <xi:include href=\"" << fd->getOutputFileBase() << ".xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>\n";
671 }
672 if (fd->generateSourceFile())
673 {
674 m_t << " <xi:include href=\"" << fd->getSourceFileBase() << ".xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>\n";
675 }
676 }
677 }
678 }
679 m_t << "</chapter>\n";
680 break;
682 {
683 m_t << "</title>\n";
684 for (const auto &pd : *Doxygen::exampleLinkedMap)
685 {
686 m_t << " <xi:include href=\"" << pd->getOutputFileBase() << ".xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>\n";
687 }
688 }
689 m_t << "</chapter>\n";
690 break;
692 for (const auto &pd : *Doxygen::pageLinkedMap)
693 {
694 if (!pd->getGroupDef() && !pd->isReference() && !pd->hasParentPage()
695 && Doxygen::mainPage.get() != pd.get())
696 {
697 writePageLink(pd->getOutputFileBase(), true);
698 }
699 }
700 break;
702 break;
704 m_t << "<index/>\n";
705 break;
706 }
707}
void writePageLink(const DString &, bool) override
static NamespaceLinkedMap * namespaceLinkedMap
Definition doxygen.h:108
static ConceptLinkedMap * conceptLinkedMap
Definition doxygen.h:90
static std::unique_ptr< PageDef > mainPage
Definition doxygen.h:93
static FileNameLinkedMap * inputNameLinkedMap
Definition doxygen.h:97
static ClassLinkedMap * classLinkedMap
Definition doxygen.h:88
static PageLinkedMap * exampleLinkedMap
Definition doxygen.h:91
static PageLinkedMap * pageLinkedMap
Definition doxygen.h:92
static DirLinkedMap * dirLinkedMap
Definition doxygen.h:120
static GroupLinkedMap * groupLinkedMap
Definition doxygen.h:107
static ModuleManager & instance()
#define DB_GEN_C2(y)
@ isMainPage
Definition index.h:34
@ isTitlePageAuthor
Definition index.h:33
@ isFileIndex
Definition index.h:42
@ isFileDocumentation
Definition index.h:50
@ isPageDocumentation
Definition index.h:52
@ isDirDocumentation
Definition index.h:46
@ isModuleDocumentation
Definition index.h:44
@ isClassHierarchyIndex
Definition index.h:40
@ isModuleIndex
Definition index.h:35
@ isTopicIndex
Definition index.h:36
@ isConceptIndex
Definition index.h:39
@ isExampleDocumentation
Definition index.h:51
@ isClassDocumentation
Definition index.h:48
@ isPageIndex
Definition index.h:43
@ isCompoundIndex
Definition index.h:41
@ isEndIndex
Definition index.h:54
@ isConceptDocumentation
Definition index.h:49
@ isDirIndex
Definition index.h:37
@ isNamespaceIndex
Definition index.h:38
@ isNamespaceDocumentation
Definition index.h:47
@ isTitlePageStart
Definition index.h:32
@ isTopicDocumentation
Definition index.h:45
@ isPageDocumentation2
Definition index.h:53

References Doxygen::classLinkedMap, Doxygen::conceptLinkedMap, DB_GEN_C2, Doxygen::dirLinkedMap, Doxygen::exampleLinkedMap, Doxygen::groupLinkedMap, Doxygen::inputNameLinkedMap, ModuleManager::instance(), isClassDocumentation, isClassHierarchyIndex, isCompoundIndex, isConceptDocumentation, isConceptIndex, isDirDocumentation, isDirIndex, isEndIndex, isExampleDocumentation, isFileDocumentation, isFileIndex, isMainPage, isModuleDocumentation, isModuleIndex, isNamespaceDocumentation, isNamespaceIndex, isPageDocumentation, isPageDocumentation2, isPageIndex, isTitlePageAuthor, isTitlePageStart, isTopicDocumentation, isTopicIndex, OutputGenerator::m_t, Doxygen::mainPage, Doxygen::namespaceLinkedMap, Doxygen::pageLinkedMap, and writePageLink().

◆ endIndexValue()

void DocbookGenerator::endIndexValue ( const DString & ,
bool  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 144 of file docbookgen.h.

References DB_GEN_NEW.

◆ endInlineHeader()

void DocbookGenerator::endInlineHeader ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 210 of file docbookgen.h.

References DB_GEN_NEW.

◆ endInlineMemberDoc()

void DocbookGenerator::endInlineMemberDoc ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1210 of file docbookgen.cpp.

1211{
1213 m_t << "</entry></row>\n";
1214}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endInlineMemberName()

void DocbookGenerator::endInlineMemberName ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1198 of file docbookgen.cpp.

1199{
1201 m_t << "</entry>";
1202}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endInlineMemberType()

void DocbookGenerator::endInlineMemberType ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1186 of file docbookgen.cpp.

1187{
1189 m_t << "</entry>";
1190}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endItemList()

void DocbookGenerator::endItemList ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 146 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endItemListItem()

void DocbookGenerator::endItemListItem ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 151 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endLabels()

void DocbookGenerator::endLabels ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1018 of file docbookgen.cpp.

1019{
1021}

References DB_GEN_C.

◆ endLocalToc()

void DocbookGenerator::endLocalToc ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1419 of file docbookgen.cpp.

1420{
1423 {
1424 m_t << "</tocdiv>\n";
1425 m_tocState.level--;
1426 }
1427 m_t << " </toc>\n";
1428}
TocState m_tocState
Definition docbookgen.h:352

References DocbookGenerator::TocState::level, OutputGenerator::m_t, m_tocState, and DocbookGenerator::TocState::maxLevel.

◆ endMemberDeclaration()

void DocbookGenerator::endMemberDeclaration ( const DString & ,
const DString &  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 241 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endMemberDescription()

void DocbookGenerator::endMemberDescription ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 239 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endMemberDoc()

void DocbookGenerator::endMemberDoc ( bool )
overridevirtual

Implements OutputGenIntf.

Definition at line 919 of file docbookgen.cpp.

920{
922 m_t << "</computeroutput></para>";
923}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endMemberDocList()

void DocbookGenerator::endMemberDocList ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1334 of file docbookgen.cpp.

1335{
1337 m_inGroup = true;
1338}

References DB_GEN_C, and m_inGroup.

◆ endMemberDocName()

void DocbookGenerator::endMemberDocName ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 963 of file docbookgen.cpp.

964{
966}

References DB_GEN_C.

◆ endMemberDocPrefixItem()

void DocbookGenerator::endMemberDocPrefixItem ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1058 of file docbookgen.cpp.

1059{
1061 m_t << "</computeroutput>";
1062}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endMemberDocSimple()

void DocbookGenerator::endMemberDocSimple ( bool )
overridevirtual

Implements OutputGenIntf.

Definition at line 1171 of file docbookgen.cpp.

1172{
1174 m_t << " </tbody>\n";
1175 m_t << " </tgroup>\n";
1176 m_t << "</table>\n";
1177 m_simpleTable = false;
1178}

References DB_GEN_C, m_simpleTable, and OutputGenerator::m_t.

◆ endMemberGroup()

void DocbookGenerator::endMemberGroup ( bool )
overridevirtual

Implements OutputGenIntf.

Definition at line 981 of file docbookgen.cpp.

982{
984 m_t << "</simplesect>\n";
985}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endMemberGroupDocs()

void DocbookGenerator::endMemberGroupDocs ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 222 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endMemberGroupHeader()

void DocbookGenerator::endMemberGroupHeader ( bool )
overridevirtual

Implements OutputGenIntf.

Definition at line 972 of file docbookgen.cpp.

973{
975 m_t << "</title>\n";
976}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endMemberHeader()

void DocbookGenerator::endMemberHeader ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 756 of file docbookgen.cpp.

757{
759 m_t << " </title>\n";
760}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endMemberItem()

void DocbookGenerator::endMemberItem ( MemberItemType )
overridevirtual

Implements OutputGenIntf.

Definition at line 813 of file docbookgen.cpp.

814{
816 m_t << "</para>\n";
817}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endMemberList()

void DocbookGenerator::endMemberList ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 796 of file docbookgen.cpp.

797{
799 if (m_inListItem[m_levelListItem]) m_t << "</listitem>\n";
801 m_t << " </itemizedlist>\n";
803 if (m_inSimpleSect[m_levelListItem]) m_t << "</simplesect>\n";
805}

References DB_GEN_C, m_inListItem, m_inSimpleSect, m_levelListItem, and OutputGenerator::m_t.

◆ endMemberSections()

void DocbookGenerator::endMemberSections ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 198 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endMemberSubtitle()

void DocbookGenerator::endMemberSubtitle ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 204 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endMemberTemplateParams()

void DocbookGenerator::endMemberTemplateParams ( const DString & ,
const DString &  )
overridevirtual

Implements OutputGenIntf.

Definition at line 1121 of file docbookgen.cpp.

1122{
1124 m_t << "</para>";
1125 m_t << "<para>";
1126}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endPageDoc()

void DocbookGenerator::endPageDoc ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 272 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endPageRef()

void DocbookGenerator::endPageRef ( const DString & ,
const DString &  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 193 of file docbookgen.h.

References DB_GEN_NEW.

◆ endParagraph()

void DocbookGenerator::endParagraph ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 738 of file docbookgen.cpp.

739{
741 m_t << "</para>\n";
742}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endParameterDefVal()

void DocbookGenerator::endParameterDefVal ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1110 of file docbookgen.cpp.

1111{
1113 if (!m_denseText) m_t << "</computeroutput>\n";
1114}

References DB_GEN_C, m_denseText, and OutputGenerator::m_t.

◆ endParameterExtra()

void DocbookGenerator::endParameterExtra ( bool last,
bool ,
bool closeBracket )
overridevirtual

Implements OutputGenIntf.

Definition at line 1093 of file docbookgen.cpp.

1094{
1096 if (last && closeBracket)
1097 {
1098 m_t << ")";
1099 }
1100}

References DB_GEN_C, and OutputGenerator::m_t.

◆ endParameterList()

void DocbookGenerator::endParameterList ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 860 of file docbookgen.cpp.

861{
863}

References DB_GEN_C.

◆ endParameterName()

void DocbookGenerator::endParameterName ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1083 of file docbookgen.cpp.

1084{
1086}

References DB_GEN_C.

◆ endParameterType()

void DocbookGenerator::endParameterType ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 281 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endPlainFile()

void DocbookGenerator::endPlainFile ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 320 of file docbookgen.h.

References OutputGenerator::endPlainFile().

Referenced by endFile().

◆ endProjectNumber()

void DocbookGenerator::endProjectNumber ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 133 of file docbookgen.h.

References DB_GEN_NEW.

◆ endQuickIndices()

void DocbookGenerator::endQuickIndices ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 262 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ endSection()

void DocbookGenerator::endSection ( const DString & ,
SectionType  )
overridevirtual

Implements OutputGenIntf.

Definition at line 1133 of file docbookgen.cpp.

1134{
1136 m_t << "</title>";
1137 closeSection();
1138}

References closeSection(), DB_GEN_C, and OutputGenerator::m_t.

◆ endSmall()

void DocbookGenerator::endSmall ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 170 of file docbookgen.h.

References DB_GEN_NEW.

◆ endTextBlock()

void DocbookGenerator::endTextBlock ( bool )
overridevirtual

Implements OutputGenIntf.

Definition at line 893 of file docbookgen.cpp.

894{
896 if (m_denseText)
897 {
898 m_denseText = false;
899 m_t << "</programlisting>";
900 }
901}

References DB_GEN_C, m_denseText, and OutputGenerator::m_t.

◆ endTextLink()

void DocbookGenerator::endTextLink ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 191 of file docbookgen.h.

References DB_GEN_NEW.

◆ endTitleHead()

void DocbookGenerator::endTitleHead ( const DString & fileName,
const DString & name )
overridevirtual

Implements OutputGenIntf.

Definition at line 929 of file docbookgen.cpp.

930{
932 m_t << "</title>\n";
933 if (!name.empty()) addIndexTerm(m_t, name);
934}

References addIndexTerm(), DB_GEN_C, DString::empty(), and OutputGenerator::m_t.

◆ endTocEntry()

void DocbookGenerator::endTocEntry ( const SectionInfo * si)
overridevirtual

Implements OutputGenIntf.

Definition at line 1460 of file docbookgen.cpp.

1461{
1462 SectionType type = si->type();
1463 int nextLevel = type.level();
1464 if (type.isSection() && nextLevel <= m_tocState.maxLevel)
1465 {
1466 m_t << "</tocentry>\n";
1467 m_tocState.inLi[nextLevel]=true;
1468 m_tocState.level = nextLevel;
1469 }
1470}
OutputType type() const override
Definition docbookgen.h:119
SectionType type() const
Definition section.h:71
constexpr bool isSection() const
Definition section.h:47
constexpr int level() const
Definition section.h:46

References DocbookGenerator::TocState::inLi, SectionType::isSection(), DocbookGenerator::TocState::level, SectionType::level(), OutputGenerator::m_t, m_tocState, DocbookGenerator::TocState::maxLevel, type(), and SectionInfo::type().

◆ endTypewriter()

void DocbookGenerator::endTypewriter ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 879 of file docbookgen.cpp.

880{
882 if (!m_denseText) m_t << "</computeroutput>\n";
883}

References DB_GEN_C, m_denseText, and OutputGenerator::m_t.

◆ exceptionEntry()

void DocbookGenerator::exceptionEntry ( const DString & prefix,
bool closeBracket )
overridevirtual

Implements OutputGenIntf.

Definition at line 1063 of file docbookgen.cpp.

1064{
1066 if (!prefix.empty())
1067 {
1068 m_t << " " << prefix << "(";
1069 }
1070 else if (closeBracket)
1071 {
1072 m_t << ")";
1073 }
1074 m_t << " ";
1075}
constexpr auto prefix
Definition anchor.cpp:47

References DB_GEN_C, OutputGenerator::m_t, and prefix.

◆ init()

void DocbookGenerator::init ( )
static

Definition at line 368 of file docbookgen.cpp.

369{
370 DString dir=Config_getString(DOCBOOK_OUTPUT);
371 Dir d(dir.str());
372 if (!d.exists() && !d.mkdir(dir.str()))
373 {
374 term("Could not create output directory {}\n",dir);
375 }
376
377 createSubDirs(d);
378}
#define term(fmt,...)
Definition message.h:137
void createSubDirs(const Dir &d)
Definition util.cpp:2969

References Config_getString, createSubDirs(), OutputGenerator::dir(), Dir::exists(), Dir::mkdir(), DString::str(), and term.

Referenced by generateOutput().

◆ insertMemberAlign()

void DocbookGenerator::insertMemberAlign ( bool )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 225 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ insertMemberAlignLeft()

void DocbookGenerator::insertMemberAlignLeft ( MemberItemType ,
bool  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 226 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ lastIndexPage()

void DocbookGenerator::lastIndexPage ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 275 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ lineBreak()

void DocbookGenerator::lineBreak ( const DString & )
overridevirtual

Implements OutputGenIntf.

Definition at line 869 of file docbookgen.cpp.

870{
872 m_t << "<?linebreak?>";
873}

References DB_GEN_C, and OutputGenerator::m_t.

◆ openSection()

void DocbookGenerator::openSection ( const DString & attr = DString())
private

Definition at line 1379 of file docbookgen.cpp.

1380{
1381 m_t << "<section";
1382 if (!attr.empty()) m_t << " " << attr;
1383 m_t << ">\n";
1385}

References DString::empty(), m_openSectionCount, and OutputGenerator::m_t.

Referenced by startGroupHeader(), startMemberDoc(), and startSection().

◆ operator=() [1/2]

◆ operator=() [2/2]

DocbookGenerator & DocbookGenerator::operator= ( DocbookGenerator && )
delete

References DocbookGenerator().

◆ startAnonTypeScope()

void DocbookGenerator::startAnonTypeScope ( int )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 211 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startBold()

void DocbookGenerator::startBold ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 818 of file docbookgen.cpp.

819{
821 m_t << "<emphasis role=\"strong\">";
822}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startCallGraph()

void DocbookGenerator::startCallGraph ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1312 of file docbookgen.cpp.

1313{
1315}

References DB_GEN_C.

◆ startCenter()

void DocbookGenerator::startCenter ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 167 of file docbookgen.h.

References DB_GEN_NEW.

◆ startClassDiagram()

void DocbookGenerator::startClassDiagram ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 986 of file docbookgen.cpp.

987{
989 m_t << "<para>";
990}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startCompoundTemplateParams()

void DocbookGenerator::startCompoundTemplateParams ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1035 of file docbookgen.cpp.

1036{
1038 m_t << "<simplesect><title>";
1039}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startConstraintDocs()

void DocbookGenerator::startConstraintDocs ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1365 of file docbookgen.cpp.

1366{
1368}

References DB_GEN_C.

◆ startConstraintList()

void DocbookGenerator::startConstraintList ( const DString & header)
overridevirtual

Implements OutputGenIntf.

Definition at line 1339 of file docbookgen.cpp.

1340{
1342 m_t << "<simplesect><title>";
1343 docify(header);
1344 m_t << "</title>\n";
1345}
void docify(const DString &text) override

References DB_GEN_C, docify(), and OutputGenerator::m_t.

◆ startConstraintParam()

void DocbookGenerator::startConstraintParam ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1346 of file docbookgen.cpp.

1347{
1349 m_t << "<para><emphasis role=\"strong\">";
1350}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startConstraintType()

void DocbookGenerator::startConstraintType ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1355 of file docbookgen.cpp.

1356{
1358 m_t << ":";
1359}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startContents()

void DocbookGenerator::startContents ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 269 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startDescForItem()

void DocbookGenerator::startDescForItem ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 165 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startDescTable()

void DocbookGenerator::startDescTable ( const DString & title,
bool hasInits )
overridevirtual

Implements OutputGenIntf.

Definition at line 1216 of file docbookgen.cpp.

1217{
1219 int ncols = (hasInits?3:2);
1220 m_t << "<informaltable frame=\"all\">\n";
1221 if (!title.empty()) m_t << "<title>" << convertToDocbook(title) << "</title>\n";
1222 m_t << " <tgroup cols=\"" << ncols << "\" align=\"left\" colsep=\"1\" rowsep=\"1\">\n";
1223 int i = 1;
1224 m_t << " <colspec colname='c" << i++ << "'/>\n";
1225 if (hasInits) m_t << " <colspec colname='c" << i++ << "' align='right'/>\n";
1226 m_t << " <colspec colname='c" << i++ << "'/>\n";
1227 m_t << "<tbody>\n";
1228 m_descTable = true;
1229}

References convertToDocbook(), DB_GEN_C, DString::empty(), m_descTable, and OutputGenerator::m_t.

◆ startDescTableData()

void DocbookGenerator::startDescTableData ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1274 of file docbookgen.cpp.

1275{
1277 m_t << "</entry><entry>";
1278}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startDescTableInit()

void DocbookGenerator::startDescTableInit ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1263 of file docbookgen.cpp.

1264{
1266 m_t << "</entry><entry>";
1267}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startDescTableRow()

void DocbookGenerator::startDescTableRow ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1240 of file docbookgen.cpp.

1241{
1243 m_t << "<row>";
1244 m_t << "<entry>";
1245}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startDescTableTitle()

void DocbookGenerator::startDescTableTitle ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1253 of file docbookgen.cpp.

1254{
1256}

References DB_GEN_C.

◆ startDirDepGraph()

void DocbookGenerator::startDirDepGraph ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1321 of file docbookgen.cpp.

1322{
1324}

References DB_GEN_C.

◆ startDotGraph()

void DocbookGenerator::startDotGraph ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1294 of file docbookgen.cpp.

1295{
1297}

References DB_GEN_C.

◆ startDoxyAnchor()

void DocbookGenerator::startDoxyAnchor ( const DString & fName,
const DString & manName,
const DString & anchor,
const DString & name,
const DString & args )
overridevirtual

Implements OutputGenIntf.

Definition at line 935 of file docbookgen.cpp.

938{
941 {
943 m_firstMember = false;
944 }
945 if (!anchor.empty())
946 {
947 m_t << "<anchor xml:id=\"_" << stripPath(fName) << "_1" << anchor << "\"/>";
948 }
949}
DString stripPath(const DString &s)
Definition util.cpp:3960

References closeSection(), DB_GEN_C, DString::empty(), m_descTable, m_firstMember, m_inListItem, m_levelListItem, m_simpleTable, OutputGenerator::m_t, and stripPath().

◆ startEmbeddedDoc()

void DocbookGenerator::startEmbeddedDoc ( size_t )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 322 of file docbookgen.h.

322{}

◆ startEmphasis()

void DocbookGenerator::startEmphasis ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 162 of file docbookgen.h.

References DB_GEN_NEW.

◆ startExamples()

void DocbookGenerator::startExamples ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1022 of file docbookgen.cpp.

1023{
1025 m_t << "<simplesect><title>";
1027 m_t << "</title>";
1028}
virtual DString trExamples()=0
Translator * theTranslator
Definition language.cpp:76

References DB_GEN_C, docify(), OutputGenerator::m_t, theTranslator, and Translator::trExamples().

◆ startFile()

void DocbookGenerator::startFile ( const DString & name,
bool isSource,
const DString & manName,
const DString & title,
int id,
int hierarchyLevel )
overridevirtual

Implements OutputGenIntf.

Definition at line 387 of file docbookgen.cpp.

388{
390 DString fileName=name;
391 DString pageName;
392 DString fileType="section";
393 if (fileName == "refman")
394 {
395 fileName="index";
396 fileType="book";
397 }
398 else if (fileName == "index")
399 {
400 fileName="mainpage";
401 fileType="chapter";
402 }
403 pageName = fileName;
405 if (!fileName.endsWith(".xml")) fileName+=".xml";
409 m_pageLinks = DString();
410
411 m_t << "<?xml version='1.0' encoding='UTF-8' standalone='no'?>\n";
412 m_t << "<" << fileType << " xmlns=\"http://docbook.org/ns/docbook\" version=\"5.0\" xmlns:xlink=\"http://www.w3.org/1999/xlink\"";
413 if (!pageName.empty()) m_t << " xml:id=\"_" << stripPath(pageName) << "\"";
414 m_t << " xml:lang=\"" << theTranslator->trISOLang() << "\"";
415 m_t << ">\n";
416}
void setRelativePath(const DString &path)
Definition docbookgen.h:78
void startPlainFile(const DString &name) override
Definition docbookgen.h:319
virtual DString trISOLang()=0
DString relativePathToRoot(const DString &name)
Definition util.cpp:2912

References DB_GEN_C, DString::empty(), OutputGenerator::fileName(), m_codeGen, m_pageLinks, OutputGenerator::m_t, relativePathToRoot(), relPath, DocbookCodeGenerator::setRelativePath(), DocbookCodeGenerator::setSourceFileName(), startPlainFile(), stripPath(), theTranslator, and Translator::trISOLang().

◆ startGroupCollaboration()

void DocbookGenerator::startGroupCollaboration ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1285 of file docbookgen.cpp.

1286{
1288}

References DB_GEN_C.

◆ startGroupHeader()

void DocbookGenerator::startGroupHeader ( const DString & ,
int extraIndentLevel )
overridevirtual

Implements OutputGenIntf.

Definition at line 828 of file docbookgen.cpp.

829{
830DB_GEN_C2("m_inLevel " << m_inLevel)
831DB_GEN_C2("extraIndentLevel " << extraIndentLevel)
832 m_firstMember = true;
833 if (m_inSimpleSect[m_levelListItem]) m_t << "</simplesect>\n";
835 if (m_inLevel != -1) m_inGroup = true;
836 if (m_inLevel == extraIndentLevel) closeSection();
837 m_inLevel = extraIndentLevel;
838 openSection();
839 m_t << "<title>";
840}
void openSection(const DString &attr=DString())

References closeSection(), DB_GEN_C2, m_firstMember, m_inGroup, m_inLevel, m_inSimpleSect, m_levelListItem, OutputGenerator::m_t, and openSection().

◆ startHeaderSection()

void DocbookGenerator::startHeaderSection ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 199 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startInclDepGraph()

void DocbookGenerator::startInclDepGraph ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1303 of file docbookgen.cpp.

1304{
1306}

References DB_GEN_C.

◆ startIndent()

void DocbookGenerator::startIndent ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 245 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startIndexItem()

void DocbookGenerator::startIndexItem ( const DString & ,
const DString &  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 148 of file docbookgen.h.

References DB_GEN_NEW.

◆ startIndexKey()

void DocbookGenerator::startIndexKey ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 141 of file docbookgen.h.

References DB_GEN_NEW.

◆ startIndexList()

void DocbookGenerator::startIndexList ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 139 of file docbookgen.h.

References DB_GEN_NEW.

◆ startIndexListItem()

void DocbookGenerator::startIndexListItem ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 137 of file docbookgen.h.

References DB_GEN_NEW.

◆ startIndexSection()

void DocbookGenerator::startIndexSection ( IndexSection is)
overridevirtual

Implements OutputGenIntf.

Definition at line 443 of file docbookgen.cpp.

444{
445DB_GEN_C2("IndexSection " << is)
446 switch (is)
447 {
449 {
450 DString dbk_projectName = Config_getString(PROJECT_NAME);
451 m_t << " <info>\n";
452 m_t << " <title>" << convertToDocbook(dbk_projectName) << "</title>\n";
453 m_t << " </info>\n";
454 }
455 break;
457 break;
459 break;
461 //Module Index\n"
462 break;
464 //Module Index\n"
465 break;
467 //Directory Index\n"
468 break;
470 //Namespace Index\n"
471 break;
473 //Concept Index\n"
474 break;
476 //Hierarchical Index\n"
477 break;
479 //m_t << "{"; //Class Index}\n"
480 break;
482 //Annotated File Index\n"
483 break;
485 //Annotated Page Index\n"
486 break;
488 m_t << "<chapter>\n";
489 m_t << " <title>";
490 break;
492 m_t << "<chapter>\n";
493 m_t << " <title>";
494 break;
496 m_t << "<chapter>\n";
497 m_t << " <title>";
498 break;
500 m_t << "<chapter>\n";
501 m_t << " <title>";
502 break;
504 m_t << "<chapter>\n";
505 m_t << " <title>";
506 break;
508 m_t << "<chapter>\n";
509 m_t << " <title>";
510 break;
512 m_t << "<chapter>\n";
513 m_t << " <title>";
514 break;
516 m_t << "<chapter>\n";
517 m_t << " <title>";
518 break;
520 break;
522 break;
524 break;
525 }
526}

References Config_getString, convertToDocbook(), DB_GEN_C2, isClassDocumentation, isClassHierarchyIndex, isCompoundIndex, isConceptDocumentation, isConceptIndex, isDirDocumentation, isDirIndex, isEndIndex, isExampleDocumentation, isFileDocumentation, isFileIndex, isMainPage, isModuleDocumentation, isModuleIndex, isNamespaceDocumentation, isNamespaceIndex, isPageDocumentation, isPageDocumentation2, isPageIndex, isTitlePageAuthor, isTitlePageStart, isTopicDocumentation, isTopicIndex, and OutputGenerator::m_t.

◆ startIndexValue()

void DocbookGenerator::startIndexValue ( bool )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 143 of file docbookgen.h.

References DB_GEN_NEW.

◆ startInlineHeader()

void DocbookGenerator::startInlineHeader ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 209 of file docbookgen.h.

References DB_GEN_NEW.

◆ startInlineMemberDoc()

void DocbookGenerator::startInlineMemberDoc ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1204 of file docbookgen.cpp.

1205{
1207 m_t << "<entry>";
1208}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startInlineMemberName()

void DocbookGenerator::startInlineMemberName ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1192 of file docbookgen.cpp.

1193{
1195 m_t << "<entry>";
1196}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startInlineMemberType()

void DocbookGenerator::startInlineMemberType ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1180 of file docbookgen.cpp.

1181{
1183 m_t << "<row><entry>";
1184}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startItemList()

void DocbookGenerator::startItemList ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 145 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startItemListItem()

void DocbookGenerator::startItemListItem ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 150 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startLabels()

void DocbookGenerator::startLabels ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1006 of file docbookgen.cpp.

1007{
1009}

References DB_GEN_C.

◆ startLocalToc()

void DocbookGenerator::startLocalToc ( int level)
overridevirtual

Implements OutputGenIntf.

Definition at line 1410 of file docbookgen.cpp.

1411{
1412 m_tocState.level=1;
1413 m_tocState.maxLevel=level;
1414 m_tocState.inLi = BoolVector(level+1,false);
1415 m_t << " <toc>\n";
1416 m_t << " <title>" << theTranslator->trRTFTableOfContents() << "</title>\n";
1417}
virtual DString trRTFTableOfContents()=0
std::vector< bool > BoolVector
Definition containers.h:36

References DocbookGenerator::TocState::inLi, DocbookGenerator::TocState::level, OutputGenerator::m_t, m_tocState, DocbookGenerator::TocState::maxLevel, theTranslator, and Translator::trRTFTableOfContents().

◆ startMemberDeclaration()

void DocbookGenerator::startMemberDeclaration ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 240 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startMemberDescription()

void DocbookGenerator::startMemberDescription ( const DString & ,
const DString & ,
bool  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 238 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startMemberDoc()

void DocbookGenerator::startMemberDoc ( const DString & clname,
const DString & memname,
const DString & ,
const DString & title,
int memCount,
int memTotal,
bool  )
overridevirtual

Implements OutputGenIntf.

Definition at line 902 of file docbookgen.cpp.

904{
905DB_GEN_C2("m_inLevel " << m_inLevel)
906 openSection();
907 m_t << " <title>" << convertToDocbook(title);
908 if (memTotal>1)
909 {
910 m_t << "<computeroutput>[" << memCount << "/" << memTotal << "]</computeroutput>";
911 }
912 m_t << "</title>\n";
913 if (!memname.empty() && memname[0]!='@')
914 {
915 addIndexTerm(m_t,memname,clname);
916 addIndexTerm(m_t,clname,memname);
917 }
918}

References addIndexTerm(), convertToDocbook(), DB_GEN_C2, DString::empty(), m_inLevel, OutputGenerator::m_t, and openSection().

◆ startMemberDocList()

void DocbookGenerator::startMemberDocList ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1330 of file docbookgen.cpp.

1331{
1333}

References DB_GEN_C.

◆ startMemberDocName()

void DocbookGenerator::startMemberDocName ( bool )
overridevirtual

Implements OutputGenIntf.

Definition at line 958 of file docbookgen.cpp.

959{
961 m_t << "<para><computeroutput>";
962}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startMemberDocPrefixItem()

void DocbookGenerator::startMemberDocPrefixItem ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1053 of file docbookgen.cpp.

1054{
1056 m_t << "<computeroutput>";
1057}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startMemberDocSimple()

void DocbookGenerator::startMemberDocSimple ( bool isEnum)
overridevirtual

Implements OutputGenIntf.

Definition at line 1145 of file docbookgen.cpp.

1146{
1148 int ncols=0;
1149 DString title;
1150 if (isEnum)
1151 {
1152 ncols = 2;
1154 }
1155 else
1156 {
1157 ncols = 3;
1159 }
1160 m_t << "<table frame=\"all\">\n";
1161 if (!title.empty()) m_t << "<title>" << convertToDocbook(title) << "</title>\n";
1162 m_t << " <tgroup cols=\"" << ncols << "\" align=\"left\" colsep=\"1\" rowsep=\"1\">\n";
1163 for (int i = 0; i < ncols; i++)
1164 {
1165 m_t << " <colspec colname='c" << i+1 << "'/>\n";
1166 }
1167 m_t << "<tbody>\n";
1168 m_simpleTable = true;
1169}
virtual DString trCompoundMembers()=0
virtual DString trEnumerationValues()=0

References convertToDocbook(), DB_GEN_C, DString::empty(), m_simpleTable, OutputGenerator::m_t, theTranslator, Translator::trCompoundMembers(), and Translator::trEnumerationValues().

◆ startMemberGroup()

void DocbookGenerator::startMemberGroup ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 977 of file docbookgen.cpp.

978{
980}

References DB_GEN_C.

◆ startMemberGroupDocs()

void DocbookGenerator::startMemberGroupDocs ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 221 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startMemberGroupHeader()

void DocbookGenerator::startMemberGroupHeader ( const DString & ,
bool  )
overridevirtual

Implements OutputGenIntf.

Definition at line 967 of file docbookgen.cpp.

968{
970 m_t << "<simplesect><title>";
971}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startMemberHeader()

void DocbookGenerator::startMemberHeader ( const DString & anchor,
int typ )
overridevirtual

Implements OutputGenIntf.

Definition at line 748 of file docbookgen.cpp.

749{
751 m_t << "<simplesect>\n";
753 m_t << " <title>";
754}

References DB_GEN_C, m_inSimpleSect, m_levelListItem, and OutputGenerator::m_t.

◆ startMemberItem()

void DocbookGenerator::startMemberItem ( const DString & ,
MemberItemType ,
const DString &  )
overridevirtual

Implements OutputGenIntf.

Definition at line 806 of file docbookgen.cpp.

807{
809 if (m_inListItem[m_levelListItem]) m_t << "</listitem>\n";
810 m_t << " <listitem><para>";
812}

References DB_GEN_C, m_inListItem, m_levelListItem, and OutputGenerator::m_t.

◆ startMemberList()

void DocbookGenerator::startMemberList ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 790 of file docbookgen.cpp.

791{
793 m_t << " <itemizedlist>\n";
795}

References DB_GEN_C, m_levelListItem, and OutputGenerator::m_t.

◆ startMemberSections()

void DocbookGenerator::startMemberSections ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 197 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startMemberSubtitle()

void DocbookGenerator::startMemberSubtitle ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 203 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startMemberTemplateParams()

void DocbookGenerator::startMemberTemplateParams ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1116 of file docbookgen.cpp.

1117{
1119}

References DB_GEN_C.

◆ startPageDoc()

void DocbookGenerator::startPageDoc ( const DString & )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 271 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startPageRef()

void DocbookGenerator::startPageRef ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 192 of file docbookgen.h.

References DB_GEN_NEW.

◆ startParagraph()

void DocbookGenerator::startParagraph ( const DString & )
overridevirtual

Implements OutputGenIntf.

Definition at line 732 of file docbookgen.cpp.

733{
735 m_t << "<para>\n";
736}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startParameterDefVal()

void DocbookGenerator::startParameterDefVal ( const char * sep)
overridevirtual

Implements OutputGenIntf.

Definition at line 1103 of file docbookgen.cpp.

1104{
1106 m_t << sep;
1107 if (!m_denseText) m_t << "<computeroutput>";
1108}

References DB_GEN_C, m_denseText, and OutputGenerator::m_t.

◆ startParameterExtra()

void DocbookGenerator::startParameterExtra ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 1088 of file docbookgen.cpp.

1089{
1091}

References DB_GEN_C.

◆ startParameterList()

void DocbookGenerator::startParameterList ( bool openBracket)
overridevirtual

Implements OutputGenIntf.

Definition at line 855 of file docbookgen.cpp.

856{
858 if (openBracket) m_t << "(";
859}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startParameterName()

void DocbookGenerator::startParameterName ( bool )
overridevirtual

Implements OutputGenIntf.

Definition at line 1077 of file docbookgen.cpp.

1078{
1080 m_t << " ";
1081}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startParameterType()

void DocbookGenerator::startParameterType ( bool ,
const DString &  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 280 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startPlainFile()

void DocbookGenerator::startPlainFile ( const DString & name)
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 319 of file docbookgen.h.

void startPlainFile(const DString &name)
Definition outputgen.cpp:28

References OutputGenerator::startPlainFile().

Referenced by startFile().

◆ startProjectNumber()

void DocbookGenerator::startProjectNumber ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 132 of file docbookgen.h.

References DB_GEN_NEW.

◆ startQuickIndices()

void DocbookGenerator::startQuickIndices ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 261 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ startSection()

void DocbookGenerator::startSection ( const DString & lab,
const DString & ,
SectionType  )
overridevirtual

Implements OutputGenIntf.

Definition at line 1127 of file docbookgen.cpp.

1128{
1130 openSection("xml:id=\"_" + stripPath(lab) + "\"");
1131 m_t << "<title>";
1132}

References DB_GEN_C, OutputGenerator::m_t, openSection(), and stripPath().

◆ startSmall()

void DocbookGenerator::startSmall ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 169 of file docbookgen.h.

References DB_GEN_NEW.

◆ startTextBlock()

void DocbookGenerator::startTextBlock ( bool dense)
overridevirtual

Implements OutputGenIntf.

Definition at line 884 of file docbookgen.cpp.

885{
887 if (dense)
888 {
889 m_denseText = true;
890 m_t << "<programlisting linenumbering=\"unnumbered\">";
891 }
892}

References DB_GEN_C, m_denseText, and OutputGenerator::m_t.

◆ startTextLink()

void DocbookGenerator::startTextLink ( const DString & ,
const DString &  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 190 of file docbookgen.h.

References DB_GEN_NEW.

◆ startTitleHead()

void DocbookGenerator::startTitleHead ( const DString & )
overridevirtual

Implements OutputGenIntf.

Definition at line 924 of file docbookgen.cpp.

925{
927 m_t << "<title>";
928}

References DB_GEN_C, and OutputGenerator::m_t.

◆ startTocEntry()

void DocbookGenerator::startTocEntry ( const SectionInfo * si)
overridevirtual

Implements OutputGenIntf.

Definition at line 1430 of file docbookgen.cpp.

1431{
1432 SectionType type = si->type();
1433 if (type.isSection())
1434 {
1435 //printf(" level=%d title=%s\n",level,qPrint(si->title));
1436 int nextLevel = type.level();
1437 if (nextLevel>m_tocState.level)
1438 {
1439 for (int l=m_tocState.level;l<nextLevel;l++)
1440 {
1441 if (l < m_tocState.maxLevel) m_t << " <tocdiv>\n";
1442 }
1443 }
1444 else if (nextLevel<m_tocState.level)
1445 {
1446 for (int l=m_tocState.level;l>nextLevel;l--)
1447 {
1448 m_tocState.inLi[l]=false;
1449 if (l <= m_tocState.maxLevel) m_t << " </tocdiv>\n";
1450 }
1451 }
1452 if (nextLevel <= m_tocState.maxLevel)
1453 {
1454 DString label = convertToDocbook(si->label());
1455 m_t << " <tocentry>";
1456 }
1457 }
1458}
DString label() const
Definition section.h:69

References convertToDocbook(), DocbookGenerator::TocState::inLi, SectionType::isSection(), SectionInfo::label(), DocbookGenerator::TocState::level, SectionType::level(), OutputGenerator::m_t, m_tocState, DocbookGenerator::TocState::maxLevel, type(), and SectionInfo::type().

◆ startTypewriter()

void DocbookGenerator::startTypewriter ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 874 of file docbookgen.cpp.

875{
877 if (!m_denseText) m_t << "<computeroutput>";
878}

References DB_GEN_C, m_denseText, and OutputGenerator::m_t.

◆ type()

OutputType DocbookGenerator::type ( ) const
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 119 of file docbookgen.h.

119{ return OutputType::Docbook; }

References Docbook.

Referenced by endTocEntry(), and startTocEntry().

◆ writeAnchor()

void DocbookGenerator::writeAnchor ( const DString & ,
const DString &  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 173 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ writeChar()

void DocbookGenerator::writeChar ( char c)
overridevirtual

Implements OutputGenIntf.

Definition at line 1045 of file docbookgen.cpp.

1046{
1048 char cs[2];
1049 cs[0]=c;
1050 cs[1]=0;
1051 docify(cs);
1052}

References DB_GEN_C, and docify().

◆ writeDoc()

void DocbookGenerator::writeDoc ( const IDocNodeAST * node,
const Definition * ctx,
const MemberDef * md,
int id,
int sectionLevel )
overridevirtual

Implements OutputGenIntf.

Definition at line 721 of file docbookgen.cpp.

722{
724 auto astImpl = dynamic_cast<const DocNodeAST*>(ast);
725 if (astImpl && sectionLevel<=m_tocState.maxLevel)
726 {
727 DocbookDocVisitor visitor(m_t,*m_codeList,ctx?ctx->getDefFileExtension():DString());
728 std::visit(visitor,astImpl->root);
729 }
730}
virtual DString getDefFileExtension() const =0

References DB_GEN_C, Definition::getDefFileExtension(), m_codeList, OutputGenerator::m_t, m_tocState, and DocbookGenerator::TocState::maxLevel.

◆ writeFooter()

void DocbookGenerator::writeFooter ( const DString & )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 128 of file docbookgen.h.

References DB_GEN_NEW.

◆ writeGraphicalHierarchy()

void DocbookGenerator::writeGraphicalHierarchy ( DotGfxHierarchyTable & )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 260 of file docbookgen.h.

References DB_GEN_NEW.

◆ writeInheritedSectionTitle()

void DocbookGenerator::writeInheritedSectionTitle ( const DString & ,
const DString & ref,
const DString & file,
const DString & anchor,
const DString & title,
const DString & name )
overridevirtual

Implements OutputGenIntf.

Definition at line 1401 of file docbookgen.cpp.

1405{
1407 m_t << theTranslator->trInheritedFrom(convertToDocbook(title), objectLinkToString(ref, file, anchor, name));
1408}
virtual DString trInheritedFrom(const DString &members, const DString &what)=0
static DString objectLinkToString(const DString &, const DString &f, const DString &anchor, const DString &text)

References convertToDocbook(), DB_GEN_C, OutputGenerator::m_t, objectLinkToString(), theTranslator, and Translator::trInheritedFrom().

◆ writeLabel()

void DocbookGenerator::writeLabel ( const DString & l,
bool isLast )
overridevirtual

Implements OutputGenIntf.

Definition at line 1011 of file docbookgen.cpp.

1012{
1014 m_t << "<computeroutput>[" << l << "]</computeroutput>";
1015 if (!isLast) m_t << ", ";
1016}

References DB_GEN_C, and OutputGenerator::m_t.

◆ writeLatexSpacing()

void DocbookGenerator::writeLatexSpacing ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 235 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ writeLogo()

void DocbookGenerator::writeLogo ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 265 of file docbookgen.h.

References DB_GEN_NEW.

◆ writeNavigationPath()

void DocbookGenerator::writeNavigationPath ( const DString & )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 264 of file docbookgen.h.

References DB_GEN_NEW.

◆ writeNonBreakableSpace()

void DocbookGenerator::writeNonBreakableSpace ( int n)
overridevirtual

Implements OutputGenIntf.

Definition at line 864 of file docbookgen.cpp.

865{
867 for (int i=0;i<n;i++) m_t << "&#160;";
868}

References DB_GEN_C, and OutputGenerator::m_t.

◆ writeObjectLink()

void DocbookGenerator::writeObjectLink ( const DString & ref,
const DString & f,
const DString & anchor,
const DString & text )
overridevirtual

Implements OutputGenIntf.

Definition at line 784 of file docbookgen.cpp.

786{
788 m_t << objectLinkToString(ref,f,anchor,text);
789}

References DB_GEN_C, OutputGenerator::m_t, and objectLinkToString().

◆ writePageLink()

void DocbookGenerator::writePageLink ( const DString & name,
bool first )
overridevirtual

Implements OutputGenIntf.

Definition at line 708 of file docbookgen.cpp.

709{
711 DString link;
712 link.sprintf(" <xi:include href=\"%s.xml\" xmlns:xi=\"http://www.w3.org/2001/XInclude\"/>\n",
713 name.data());
714 if (first)
715 m_t << link;
716 else
717 // Buffer page links and write them after all sections are closed
718 m_pageLinks += link;
719}

References DString::data(), DB_GEN_C, m_pageLinks, OutputGenerator::m_t, and DString::sprintf().

Referenced by endIndexSection().

◆ writePageOutline()

void DocbookGenerator::writePageOutline ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 268 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ writeQuickLinks()

void DocbookGenerator::writeQuickLinks ( HighlightedItem ,
const DString & ,
bool  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 266 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ writeRuler()

void DocbookGenerator::writeRuler ( )
overridevirtual

Implements OutputGenIntf.

Definition at line 841 of file docbookgen.cpp.

842{
843DB_GEN_C2("m_inLevel " << m_inLevel)
844DB_GEN_C2("m_inGroup " << m_inGroup)
845 if (m_inGroup) closeSection();
846 m_inGroup = false;
847}

References closeSection(), DB_GEN_C2, m_inGroup, and m_inLevel.

◆ writeSearchInfo()

void DocbookGenerator::writeSearchInfo ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 127 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ writeSplitBar()

void DocbookGenerator::writeSplitBar ( const DString & ,
const DString &  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 263 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ writeStartAnnoItem()

void DocbookGenerator::writeStartAnnoItem ( const DString & ,
const DString & ,
const DString & ,
const DString &  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 236 of file docbookgen.h.

237 {DB_GEN_NEW}

References DB_GEN_NEW.

◆ writeString()

void DocbookGenerator::writeString ( const DString & text)
overridevirtual

Implements OutputGenIntf.

Definition at line 743 of file docbookgen.cpp.

744{
746 m_t << text;
747}

References DB_GEN_C, and OutputGenerator::m_t.

◆ writeStyleInfo()

void DocbookGenerator::writeStyleInfo ( int )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 134 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ writeSummaryLink()

void DocbookGenerator::writeSummaryLink ( const DString & ,
const DString & ,
const DString & ,
bool  )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 267 of file docbookgen.h.

References DB_GEN_EMPTY.

◆ writeSynopsis()

void DocbookGenerator::writeSynopsis ( )
inlineoverridevirtual

Implements OutputGenIntf.

Definition at line 247 of file docbookgen.h.

References DB_GEN_EMPTY.

Member Data Documentation

◆ m_codeGen

DocbookCodeGenerator* DocbookGenerator::m_codeGen = nullptr
private

◆ m_codeList

std::unique_ptr<OutputCodeList> DocbookGenerator::m_codeList
private

Definition at line 332 of file docbookgen.h.

Referenced by DocbookGenerator(), DocbookGenerator(), operator=(), and writeDoc().

◆ m_denseText

bool DocbookGenerator::m_denseText = false
private

◆ m_descTable

bool DocbookGenerator::m_descTable = false
private

◆ m_firstMember

bool DocbookGenerator::m_firstMember = false
private

Definition at line 342 of file docbookgen.h.

Referenced by DocbookGenerator(), operator=(), startDoxyAnchor(), and startGroupHeader().

◆ m_inGroup

bool DocbookGenerator::m_inGroup = false
private

◆ m_inLevel

int DocbookGenerator::m_inLevel = -1
private

◆ m_inListItem

std::array<bool,20> DocbookGenerator::m_inListItem = { false, }
private

◆ m_inSimpleSect

std::array<bool,20> DocbookGenerator::m_inSimpleSect = { false, }
private

◆ m_levelListItem

int DocbookGenerator::m_levelListItem = 0
private

◆ m_openSectionCount

int DocbookGenerator::m_openSectionCount = 0
private

◆ m_pageLinks

DString DocbookGenerator::m_pageLinks
private

Definition at line 344 of file docbookgen.h.

Referenced by endFile(), startFile(), and writePageLink().

◆ m_simpleTable

bool DocbookGenerator::m_simpleTable = false
private

◆ m_tocState

TocState DocbookGenerator::m_tocState
private

Definition at line 352 of file docbookgen.h.

Referenced by endLocalToc(), endTocEntry(), startLocalToc(), startTocEntry(), and writeDoc().

◆ relPath

DString DocbookGenerator::relPath
private

The documentation for this class was generated from the following files: