A model of a page symbol. More...

#include <pagedef.h>

Inheritance diagram for PageDef:

Public Member Functions
	PageDef (const char f, int l, const char n, const char d, const char t)

	~PageDef ()

void	setFileName (const char *name)

void	setShowToc (bool b)

DefType	definitionType () const

bool	isLinkableInProject () const

bool	isLinkable () const

QCString	getOutputFileBase () const

QCString	anchor () const

void	findSectionsInDocumentation ()

QCString	title () const

GroupDef *	getGroupDef () const

PageSDict *	getSubPages () const

void	addInnerCompound (Definition *d)

bool	visibleInIndex () const

bool	documentedPage () const

bool	hasSubPages () const

bool	hasParentPage () const

bool	showToc () const

void	setPageScope (Definition *d)

Definition *	getPageScope () const

QCString	displayName (bool=TRUE) const

void	writeDocumentation (OutputList &ol)

void	writeTagFile (FTextStream &)

Public Member Functions inherited from Definition
	Definition (const char defFileName, int defLine, int defColumn, const char name, const char b=0, const char d=0, bool isSymbol=TRUE)

virtual	~Definition ()

const QCString &	name () const

QCString	localName () const

virtual QCString	qualifiedName () const

QCString	symbolName () const

virtual QCString	getSourceFileBase () const

virtual QCString	getSourceAnchor () const

virtual QCString	documentation () const

int	docLine () const

QCString	docFile () const

virtual QCString	briefDescription (bool abbreviate=FALSE) const

QCString	briefDescriptionAsTooltip () const

int	briefLine () const

QCString	inbodyDocumentation () const

QCString	inbodyFile () const

int	inbodyLine () const

QCString	briefFile () const

QCString	getDefFileName () const

QCString	getDefFileExtension () const

int	getDefLine () const

int	getDefColumn () const

virtual bool	hasDocumentation () const

virtual bool	hasUserDocumentation () const

virtual bool	isVisibleInProject () const

virtual bool	isVisible () const

bool	isHidden () const

bool	isArtificial () const

virtual QCString	getReference () const

virtual bool	isReference () const

QCString	externalReference (const QCString &relPath) const

int	getStartBodyLine () const

int	getEndBodyLine () const

FileDef *	getBodyDef () const

SrcLangExt	getLanguage () const

GroupList *	partOfGroups () const

QList< ListItemInfo > *	xrefListItems () const

virtual Definition *	findInnerCompound (const char *name)

virtual Definition *	getOuterScope () const

MemberSDict *	getReferencesMembers () const

MemberSDict *	getReferencedByMembers () const

bool	hasSections () const

bool	hasSources () const

bool	hasBriefDescription () const

QCString	id () const

virtual void	setName (const char *name)

void	setId (const char *name)

virtual void	setDocumentation (const char d, const char docFile, int docLine, bool stripWhiteSpace=TRUE)

virtual void	setBriefDescription (const char b, const char briefFile, int briefLine)

virtual void	setInbodyDocumentation (const char d, const char docFile, int docLine)

void	setReference (const char *r)

void	addSectionsToDefinition (QList< SectionInfo > *anchorList)

void	setBodySegment (int bls, int ble)

void	setBodyDef (FileDef *fd)

void	addSourceReferencedBy (MemberDef *d)

void	addSourceReferences (MemberDef *d)

void	setRefItems (const QList< ListItemInfo > *sli)

void	mergeRefItems (Definition *d)

virtual void	setOuterScope (Definition *d)

virtual void	setHidden (bool b)

void	setArtificial (bool b)

void	setLanguage (SrcLangExt lang)

QCString	convertNameToFile (const char *name, bool allowDots=FALSE) const

void	writeSourceDef (OutputList &ol, const char *scopeName)

void	writeInlineCode (OutputList &ol, const char *scopeName)

void	writeSourceRefs (OutputList &ol, const char *scopeName)

void	writeSourceReffedBy (OutputList &ol, const char *scopeName)

void	makePartOfGroup (GroupDef *gd)

void	writeNavigationPath (OutputList &ol) const

QCString	navigationPathAsString () const

virtual void	writeQuickMemberLinks (OutputList &, MemberDef *) const

virtual void	writeSummaryLinks (OutputList &)

QCString	pathFragment () const

void	writeDocAnchorsToTagFile (FTextStream &)

void	setLocalName (const QCString name)

void	addSectionsToIndex ()

void	writeToc (OutputList &ol)

void	setCookie (Cookie *cookie)

Cookie *	cookie () const

Public Member Functions inherited from DefinitionIntf
	DefinitionIntf ()

virtual	~DefinitionIntf ()

Private Member Functions
void	setNestingLevel (int l)

void	writePageDocumentation (OutputList &ol)

Private Attributes
QCString	m_fileName

QCString	m_title

PageSDict *	m_subPageDict

Definition *	m_pageScope

int	m_nestingLevel

bool	m_showToc

Additional Inherited Members
Public Types inherited from DefinitionIntf
enum	DefType { TypeClass = 0, TypeFile = 1, TypeNamespace = 2, TypeMember = 3, TypeGroup = 4, TypePackage = 5, TypePage = 6, TypeDir = 7, TypeSymbolList = 8 }

Protected Member Functions inherited from Definition
	Definition (const Definition &d)

Detailed Description

A model of a page symbol.

Definition at line 29 of file pagedef.h.

Constructor & Destructor Documentation

PageDef::PageDef	(	const char *	f,
		int	l,
		const char *	n,
		const char *	d,
		const char *	t
	)

Definition at line 29 of file pagedef.cpp.

  : Definition(f,l,1,n), m_title(t)
 {
   setDocumentation(d,f,l);
   m_subPageDict = new PageSDict(7);
   m_pageScope = 0;
   m_nestingLevel = 0;
   static bool shortNames = Config_getBool("SHORT_NAMES");
   m_fileName = shortNames ? convertNameToFile(n) : QCString(n);
   m_showToc = FALSE;
 }

PageDef::~PageDef ( )

Definition at line 42 of file pagedef.cpp.

 {
   delete m_subPageDict;
 }

Member Function Documentation

void PageDef::addInnerCompound ( Definition * d )

virtual

Reimplemented from Definition.

Definition at line 71 of file pagedef.cpp.

 {
   if (def->definitionType()==Definition::TypePage)
   {
     PageDef *pd = (PageDef*)def;
     m_subPageDict->append(pd->name(),pd);
     def->setOuterScope(this);
     if (this==Doxygen::mainPage)
     {
       pd->setNestingLevel(m_nestingLevel);
     }
     else
     {
       pd->setNestingLevel(m_nestingLevel+1);
     }
   }
 }

QCString PageDef::anchor ( ) const

inlinevirtual

Returns the anchor within a page where this item can be found

Implements Definition.

Definition at line 52 of file pagedef.h.

52 { return QCString(); }

QCString

Definition: qcstring.h:131

DefType PageDef::definitionType ( ) const

inlinevirtual

Use this for dynamic inspection of the type of the derived class

Implements DefinitionIntf.

Definition at line 40 of file pagedef.h.

40 { return TypePage; }

DefinitionIntf::TypePage

Definition: definition.h:79

QCString PageDef::displayName ( bool includeScope = TRUE ) const

inlinevirtual

Returns the name of the definition as it appears in the output

Implements Definition.

Definition at line 65 of file pagedef.h.

65 { return !m_title.isEmpty() ? m_title : Definition::name(); }

QCString::isEmpty

bool isEmpty() const

Definition: qcstring.h:189

Definition::name

const QCString & name() const

Definition: definition.h:114

PageDef::m_title

QCString m_title

Definition: pagedef.h:74

bool PageDef::documentedPage ( ) const

Definition at line 292 of file pagedef.cpp.

 {
    return // not part of a group
           !getGroupDef() && 
           // not an externally defined page
           !isReference();
 }

void PageDef::findSectionsInDocumentation ( )

Definition at line 47 of file pagedef.cpp.

 {
   docFindSections(documentation(),this,0,docFile());
 }

GroupDef * PageDef::getGroupDef ( ) const

Definition at line 52 of file pagedef.cpp.

 { 
   GroupList *groups = partOfGroups();
   return groups!=0 ? groups->getFirst() : 0; 
 }

QCString PageDef::getOutputFileBase ( ) const

virtual

Returns the base file name (without extension) of this definition. as it is referenced to/written to disk.

Implements Definition.

Definition at line 58 of file pagedef.cpp.

 { 
   if (getGroupDef()) 
     return getGroupDef()->getOutputFileBase();
   else 
     return m_fileName; 
 }

Definition* PageDef::getPageScope ( ) const

inline

Definition at line 64 of file pagedef.h.

64 { return m_pageScope; }

PageDef::m_pageScope

Definition * m_pageScope

Definition: pagedef.h:76

PageSDict* PageDef::getSubPages ( ) const

inline

Definition at line 56 of file pagedef.h.

56 { return m_subPageDict; }

PageDef::m_subPageDict

PageSDict * m_subPageDict

Definition: pagedef.h:75

bool PageDef::hasParentPage ( ) const

Definition at line 89 of file pagedef.cpp.

 {
   return getOuterScope() && 
          getOuterScope()->definitionType()==Definition::TypePage;
 }

bool PageDef::hasSubPages ( ) const

Definition at line 300 of file pagedef.cpp.

 {
   return m_subPageDict->count()>0;
 }

bool PageDef::isLinkable ( ) const

inlinevirtual

Returns TRUE iff it is possible to link to this item. This can be a link to another project imported via a tag file.

Implements Definition.

Definition at line 45 of file pagedef.h.

     {
       return isLinkableInProject() || isReference();
     } 

bool PageDef::isLinkableInProject ( ) const

inlinevirtual

Returns TRUE iff it is possible to link to this item within this project.

Implements Definition.

Definition at line 41 of file pagedef.h.

     { 
       return /*hasDocumentation() &&*/ !isReference();
     }

void PageDef::setFileName ( const char * name )

Definition at line 66 of file pagedef.cpp.

 {
   m_fileName = name;
 }

void PageDef::setNestingLevel ( int l )

private

Definition at line 305 of file pagedef.cpp.

 {
   m_nestingLevel = l;
 }

void PageDef::setPageScope ( Definition * d )

inline

Definition at line 63 of file pagedef.h.

63 { m_pageScope = d; }

bump_copyright.d

string d

Definition: bump_copyright.py:70

PageDef::m_pageScope

Definition * m_pageScope

Definition: pagedef.h:76

void PageDef::setShowToc ( bool b )

Definition at line 310 of file pagedef.cpp.

 {
   m_showToc = b;
 }

bool PageDef::showToc ( ) const

inline

Definition at line 62 of file pagedef.h.

62 { return m_showToc; }

PageDef::m_showToc

bool m_showToc

Definition: pagedef.h:78

QCString PageDef::title ( ) const

inline

Definition at line 54 of file pagedef.h.

54 { return m_title; }

PageDef::m_title

QCString m_title

Definition: pagedef.h:74

bool PageDef::visibleInIndex ( ) const

Definition at line 282 of file pagedef.cpp.

 {
   static bool externalPages = Config_getBool("EXTERNAL_PAGES");
   return // not part of a group
          !getGroupDef() && 
          // not an externally defined page
          (!isReference() || externalPages) 
          ;
 }

void PageDef::writeDocumentation ( OutputList & ol )

Definition at line 119 of file pagedef.cpp.

 {
   static bool generateTreeView = Config_getBool("GENERATE_TREEVIEW");
 
   //outputList->disable(OutputGenerator::Man);
   QCString pageName,manPageName;
   pageName    = escapeCharsInString(name(),FALSE,TRUE);
   manPageName = escapeCharsInString(name(),TRUE,TRUE);
 
   //printf("PageDef::writeDocumentation: %s\n",getOutputFileBase().data());
 
   ol.pushGeneratorState();
   //1.{ 
 
   if (m_nestingLevel>0 
       //&& // a sub page
       //(Doxygen::mainPage==0 || getOuterScope()!=Doxygen::mainPage) // and not a subpage of the mainpage
      )
   {
     // do not generate sub page output for RTF and LaTeX, as these are
     // part of their parent page
     ol.disableAll();
     ol.enable(OutputGenerator::Man);
     ol.enable(OutputGenerator::Html);
   }
 
   ol.pushGeneratorState();
   //2.{ 
   ol.disableAllBut(OutputGenerator::Man);
   startFile(ol,getOutputFileBase(),manPageName,title(),HLI_Pages,!generateTreeView);
   ol.enableAll();
   ol.disable(OutputGenerator::Man);
   startFile(ol,getOutputFileBase(),pageName,title(),HLI_Pages,!generateTreeView);
   ol.popGeneratorState();
   //2.} 
 
   if (!generateTreeView)
   {
     if (getOuterScope()!=Doxygen::globalScope && !Config_getBool("DISABLE_INDEX"))
     {
       getOuterScope()->writeNavigationPath(ol);
     }
     ol.endQuickIndices();
   }
   SectionInfo *si=Doxygen::sectionDict->find(name());
 
   // save old generator state and write title only to Man generator
   ol.pushGeneratorState();
   //2.{
   ol.disableAllBut(OutputGenerator::Man);
   ol.startTitleHead(manPageName);
   ol.endTitleHead(manPageName, manPageName);
   if (si)
   {
     ol.generateDoc(docFile(),docLine(),this,0,si->title,TRUE,FALSE,0,TRUE,FALSE);
     ol.endSection(si->label,si->type);
   }
   ol.popGeneratorState();
   //2.}
 
   // for Latex the section is already generated as a chapter in the index!
   ol.pushGeneratorState();
   //2.{
   ol.disable(OutputGenerator::Latex);
   ol.disable(OutputGenerator::RTF);
   ol.disable(OutputGenerator::Man);
   if (!title().isEmpty() && !name().isEmpty() && si!=0)
   {
     //ol.startSection(si->label,si->title,si->type);
     startTitle(ol,getOutputFileBase(),this);
     ol.generateDoc(docFile(),docLine(),this,0,si->title,TRUE,FALSE,0,TRUE,FALSE);
     //stringToSearchIndex(getOutputFileBase(),
     //                    theTranslator->trPage(TRUE,TRUE)+" "+si->title,
     //                    si->title);
     //ol.endSection(si->label,si->type);
     endTitle(ol,getOutputFileBase(),name());
   }
   ol.startContents();
   ol.popGeneratorState();
   //2.}
 
   if (m_showToc && hasSections())
   {
     writeToc(ol);
   }
 
   writePageDocumentation(ol);
 
   if (generateTreeView && getOuterScope()!=Doxygen::globalScope && !Config_getBool("DISABLE_INDEX"))
   {
     ol.endContents();
     endFileWithNavPath(getOuterScope(),ol);
   }
   else
   {
     endFile(ol);
   }
 
   ol.popGeneratorState();
   //1.}
 
   Doxygen::indexList->addIndexItem(this,0,0,filterTitle(title()));
 }

void PageDef::writePageDocumentation ( OutputList & ol )

private

Definition at line 223 of file pagedef.cpp.

 {
 
   bool markdownEnabled = Doxygen::markdownSupport;
   if (getLanguage()==SrcLangExt_Markdown)
   {
     Doxygen::markdownSupport = TRUE;
   }
 
   ol.startTextBlock();
   ol.generateDoc(
       docFile(),           // fileName
       docLine(),           // startLine
       this,                // context
       0,                   // memberdef
       documentation()+inbodyDocumentation(), // docStr
       TRUE,                // index words
       FALSE                // not an example
       );
   ol.endTextBlock();
 
   Doxygen::markdownSupport = markdownEnabled;
 
   if (hasSubPages())
   {
     // for printed documentation we write subpages as section's of the
     // parent page.
     ol.pushGeneratorState();
     ol.disableAll();
     ol.enable(OutputGenerator::Latex);
     ol.enable(OutputGenerator::RTF);
 
     PageSDict::Iterator pdi(*m_subPageDict);
     PageDef *subPage=pdi.toFirst();
     for (pdi.toFirst();(subPage=pdi.current());++pdi)
     {
       SectionInfo::SectionType sectionType = SectionInfo::Paragraph;
       switch (m_nestingLevel)
       {
         case  0: sectionType = SectionInfo::Page;          break;
         case  1: sectionType = SectionInfo::Section;       break;
         case  2: sectionType = SectionInfo::Subsection;    break;
         case  3: sectionType = SectionInfo::Subsubsection; break;
         default: sectionType = SectionInfo::Paragraph;     break;
       }
       QCString title = subPage->title();
       if (title.isEmpty()) title = subPage->name();
       ol.startSection(subPage->name(),title,sectionType);
       ol.parseText(title);
       ol.endSection(subPage->name(),sectionType);
       Doxygen::subpageNestingLevel++;
       subPage->writePageDocumentation(ol);
       Doxygen::subpageNestingLevel--;
     }
 
     ol.popGeneratorState();
   }
 }

void PageDef::writeTagFile ( FTextStream & tagFile )

Definition at line 95 of file pagedef.cpp.

 {
   bool found = name()=="citelist";
   QDictIterator<RefList> rli(*Doxygen::xrefLists);
   RefList *rl;
   for (rli.toFirst();(rl=rli.current()) && !found;++rli)
   {
     if (rl->listName()==name())
     {
       found=TRUE;
       break;
     }
   }
   if (!found) // not one of the generated related pages
   {
     tagFile << "  <compound kind=\"page\">" << endl;
     tagFile << "    <name>" << name() << "</name>" << endl;
     tagFile << "    <title>" << convertToXML(title()) << "</title>" << endl;
     tagFile << "    <filename>" << convertToXML(getOutputFileBase()) << "</filename>" << endl;
     writeDocAnchorsToTagFile(tagFile);
     tagFile << "  </compound>" << endl;
   }
 }

Member Data Documentation

QCString PageDef::m_fileName

private

Definition at line 73 of file pagedef.h.

int PageDef::m_nestingLevel

private

Definition at line 77 of file pagedef.h.

Definition* PageDef::m_pageScope

private

Definition at line 76 of file pagedef.h.

bool PageDef::m_showToc

private

Definition at line 78 of file pagedef.h.

PageSDict* PageDef::m_subPageDict

private

Definition at line 75 of file pagedef.h.

QCString PageDef::m_title

private

Definition at line 74 of file pagedef.h.

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

doxygen-1.8.11/src/pagedef.h
doxygen-1.8.11/src/pagedef.cpp

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation