Doxygen
Loading...
Searching...
No Matches
DirDefImpl Class Referencefinal
Inheritance diagram for DirDefImpl:
Collaboration diagram for DirDefImpl:

Public Member Functions

 DirDefImpl (const DString &path)
 ~DirDefImpl () override
DefType definitionType () const override
CodeSymbolType codeSymbolType () const override
DString getOutputFileBase () const override
DString anchor () const override
bool isLinkableInProject () const override
bool isLinkable () const override
DString displayName (bool=true) const override
const DString shortName () const override
void addSubDir (DirDef *subdir) override
const FileListgetFiles () const override
void addFile (FileDef *fd) override
const DirListsubDirs () const override
bool hasSubdirs () const override
int level () const override
DirDefparent () const override
int dirIndex () const override
const UsedDirLinkedMapusedDirs () const override
bool isParentOf (const DirDef *dir) const override
bool depGraphIsTrivial () const override
DString shortTitle () const override
bool hasDetailedDescription () const override
void writeDocumentation (OutputList &ol) override
void writePageNavigation (OutputList &ol) const override
void writeTagFile (TextStream &t) override
void setDiskName (const DString &name) override
void sort () override
void setParent (DirDef *parent) override
void setDirIndex (int index) override
void setLevel () override
void addUsesDependency (const DirDef *usedDir, const FileDef *srcFd, const FileDef *dstFd, bool srcDirect, bool dstDirect) override
 Add as "uses" dependency between this dir and dir, that was caused by a dependency on file fd.
void computeDependencies () override
 Computes the dependencies between directories.
void findSectionsInDocumentation () override
void addListReferences () override
void addRequirementReferences () override
bool hasDirectoryGraph () const override
void overrideDirectoryGraph (bool e) override
Public Member Functions inherited from DefinitionMixin< DirDef >
 DefinitionMixin (const DString &defFileName, int defLine, size_t defColumn, const DString &name, const char *b=nullptr, const char *d=nullptr, bool isSymbol=true)
DefinitionMixinoperator= (const DefinitionMixin &other)
 ~DefinitionMixin () override=default
bool isAlias () const override
const DStringname () const override
bool isAnonymous () const override
const DStringlocalName () const override
DString qualifiedName () const override
DString symbolName () const override
DString getSourceFileBase () const override
DString getSourceAnchor () const override
DString documentation () const override
int docLine () const override
DString docFile () const override
DString briefDescription (bool abbreviate=false) const override
DString briefDescriptionAsTooltip () const override
int briefLine () const override
DString inbodyDocumentation () const override
DString inbodyFile () const override
int inbodyLine () const override
DString briefFile () const override
DString getDefFileName () const override
DString getDefFileExtension () const override
int getDefLine () const override
size_t getDefColumn () const override
bool hasDocumentation () const override
bool hasUserDocumentation () const override
bool isVisibleInProject () const override
bool isVisible () const override
bool isHidden () const override
bool isArtificial () const override
bool isExported () const override
DString getReference () const override
bool isReference () const override
DString externalReference (const DString &relPath) const override
int getStartDefLine () const override
int getStartBodyLine () const override
int getEndBodyLine () const override
const FileDefgetBodyDef () const override
SrcLangExt getLanguage () const override
const GroupListpartOfGroups () const override
bool isLinkableViaGroup () const override
const RefItemVectorxrefListItems () const override
const RequirementRefsrequirementReferences () const override
const DefinitionfindInnerCompound (const DString &name) const override
DefinitiongetOuterScope () const override
const MemberVectorgetReferencesMembers () const override
const MemberVectorgetReferencedByMembers () const override
bool hasSections () const override
bool hasSources () const override
bool hasBriefDescription () const override
DString id () const override
const SectionRefsgetSectionRefs () const override
void setName (const DString &name) override
void setId (const DString &name) override
void setDefFile (const DString &df, int defLine, size_t defColumn) override
void setDocumentation (const DString &doc, const DString &docFile, int docLine, bool stripWhiteSpace=true) override
void setBriefDescription (const DString &brief, const DString &briefFile, int briefLine) override
void setInbodyDocumentation (const DString &doc, const DString &docFile, int docLine) override
void setReference (const DString &r) override
void addSectionsToDefinition (const std::vector< const SectionInfo * > &anchorList) override
void setBodySegment (int defLine, int bls, int ble) override
void setBodyDef (const FileDef *fd) override
void addSourceReferencedBy (MemberDef *md, const DString &sourceRefName) override
void addSourceReferences (MemberDef *md, const DString &sourceRefName) override
void setRefItems (const RefItemVector &sli) override
void setRequirementReferences (const RequirementRefs &rqli) override
void mergeRefItems (Definition *def) override
void mergeReferences (const Definition *other) override
void mergeReferencedBy (const Definition *other) override
void addInnerCompound (Definition *def) override
void setOuterScope (Definition *def) override
void setHidden (bool b) override
void setArtificial (bool b) override
void setExported (bool b) override
void setLanguage (SrcLangExt lang) override
void writeSourceDef (OutputList &ol) const override
void writeInlineCode (OutputList &ol, const DString &scopeName) const override
bool hasSourceRefs () const override
bool hasSourceReffedBy () const override
void writeSourceRefs (OutputList &ol, const DString &scopeName) const override
void writeSourceReffedBy (OutputList &ol, const DString &scopeName) const override
bool hasRequirementRefs () const override
void writeRequirementRefs (OutputList &ol) const override
void makePartOfGroup (GroupDef *gd) override
void writeNavigationPath (OutputList &ol) const override
DString navigationPathAsString () const override
void writeQuickMemberLinks (OutputList &ol, const MemberDef *md) const override
void writeSummaryLinks (OutputList &ol) const override
DString pathFragment () const override
void writeDocAnchorsToTagFile (TextStream &fs) const override
void setLocalName (const DString &name) override
void writeToc (OutputList &ol, const LocalToc &lt) const override
void computeTooltip () override
void _setSymbolName (const DString &name) override
DString _symbolName () const override

Static Public Member Functions

static DirDefmergeDirectoryInTree (const DString &path)

Private Member Functions

void writeDetailedDescription (OutputList &ol, const DString &title)
void writeBriefDescription (OutputList &ol)
void writeDirectoryGraph (OutputList &ol)
void writeSubDirList (OutputList &ol)
void writeFileList (OutputList &ol)
void startMemberDeclarations (OutputList &ol)
void endMemberDeclarations (OutputList &ol)

Static Private Member Functions

static DirDefcreateNewDir (const DString &path)
static bool matchPath (const DString &path)

Private Attributes

DirList m_subdirs
DString m_dispName
DString m_shortName
DString m_diskName
FileList m_fileList
int m_dirIndex = -1
int m_level
DirDefm_parent
UsedDirLinkedMap m_usedDirs
bool m_hasDirectoryGraph = false

Additional Inherited Members

Public Types inherited from Definition
enum  DefType {
  TypeClass = 0 , TypeFile = 1 , TypeNamespace = 2 , TypeModule = 3 ,
  TypeMember = 4 , TypeGroup = 5 , TypePackage = 6 , TypePage = 7 ,
  TypeDir = 8 , TypeConcept = 9
}

Detailed Description

Definition at line 41 of file dirdef.cpp.

Constructor & Destructor Documentation

◆ DirDefImpl()

DirDefImpl::DirDefImpl ( const DString & path)

Definition at line 124 of file dirdef.cpp.

124 : DefinitionMixin(path,1,1,path)
125{
126 bool fullPathNames = Config_getBool(FULL_PATH_NAMES);
127 // get display name (stripping the paths mentioned in STRIP_FROM_PATH)
128 // get short name (last part of path)
129 m_shortName = path;
130 m_diskName = path;
131 if (m_shortName.at(m_shortName.length()-1)=='/')
132 { // strip trailing /
134 }
135 if (size_t pi=m_shortName.rfind('/'); pi!=DString::npos)
136 { // remove everything till the last /
138 }
140 m_dispName = fullPathNames ? stripFromPath(path) : m_shortName;
141 if (m_dispName.length()>0 && m_dispName.at(m_dispName.length()-1)=='/')
142 { // strip trailing /
144 }
145
146 m_level=-1;
147 m_parent=nullptr;
148 m_hasDirectoryGraph=Config_getBool(DIRECTORY_GRAPH);
149
150}
size_t rfind(char c, size_t pos=npos) const
Definition dstring.h:244
DString mid(size_t index, size_t len=npos) const
Definition dstring.h:318
static constexpr size_t npos
value used to indicate 'not found' or 'to the end of the string', matching std::string::npos
Definition dstring.h:178
char & at(size_t i)
Returns a reference to the character at index i.
Definition dstring.h:686
DString left(size_t len) const
Definition dstring.h:306
size_t length() const
Returns the length of the string, not counting the 0-terminator.
Definition dstring.h:151
DefinitionMixin(const DString &defFileName, int defLine, size_t defColumn, const DString &name, const char *b=nullptr, const char *d=nullptr, bool isSymbol=true)
void setLocalName(const DString &name) override
DirDef * m_parent
Definition dirdef.cpp:110
DString m_dispName
Definition dirdef.cpp:104
DString m_shortName
Definition dirdef.cpp:105
DString m_diskName
Definition dirdef.cpp:106
int m_level
Definition dirdef.cpp:109
bool m_hasDirectoryGraph
Definition dirdef.cpp:112
#define Config_getBool(name)
Definition config.h:33
DString stripFromPath(const DString &path)
Definition util.cpp:219

References DString::at(), Config_getBool, DefinitionMixin< DirDef >::DefinitionMixin(), DString::left(), DString::length(), m_diskName, m_dispName, m_hasDirectoryGraph, m_level, m_parent, m_shortName, DString::mid(), DString::npos, DString::rfind(), DefinitionMixin< DirDef >::setLocalName(), and stripFromPath().

◆ ~DirDefImpl()

DirDefImpl::~DirDefImpl ( )
override

Definition at line 152 of file dirdef.cpp.

153{
154}

Member Function Documentation

◆ addFile()

void DirDefImpl::addFile ( FileDef * fd)
overridevirtual

Implements DirDef.

Definition at line 183 of file dirdef.cpp.

184{
185 m_fileList.push_back(fd);
186 fd->setDirDef(this);
187}
FileList m_fileList
Definition dirdef.cpp:107
virtual void setDirDef(DirDef *dd)=0

References m_fileList, and FileDef::setDirDef().

◆ addListReferences()

void DirDefImpl::addListReferences ( )
overridevirtual

Implements DirDef.

Definition at line 770 of file dirdef.cpp.

771{
772 DString name = getOutputFileBase();
774 theTranslator->trDir(true,true),
775 name,displayName(),DString(),nullptr);
776}
virtual const DString & name() const =0
const RefItemVector & xrefListItems() const override
DString displayName(bool=true) const override
Definition dirdef.cpp:54
DString getOutputFileBase() const override
Definition dirdef.cpp:204
virtual DString trDir(bool first_capital, bool singular)=0
Translator * theTranslator
Definition language.cpp:76
void addRefItem(const RefItemVector &sli, const DString &key, const DString &prefix, const DString &name, const DString &title, const DString &args, const Definition *scope)
Definition reflist.h:136

References addRefItem(), displayName(), getOutputFileBase(), DefinitionMixin< DirDef >::name(), theTranslator, Translator::trDir(), and DefinitionMixin< DirDef >::xrefListItems().

◆ addRequirementReferences()

void DirDefImpl::addRequirementReferences ( )
overridevirtual

Implements DirDef.

Definition at line 778 of file dirdef.cpp.

779{
781}
static RequirementManager & instance()
void addRequirementRefsForSymbol(const Definition *symbol)

References RequirementManager::addRequirementRefsForSymbol(), and RequirementManager::instance().

◆ addSubDir()

void DirDefImpl::addSubDir ( DirDef * subdir)
overridevirtual

Implements DirDef.

Definition at line 166 of file dirdef.cpp.

167{
168 m_subdirs.push_back(subdir);
169 subdir->setOuterScope(this);
170 subdir->setParent(this);
171}
virtual void setOuterScope(Definition *d)=0
virtual void setParent(DirDef *parent)=0
DirList m_subdirs
Definition dirdef.cpp:103

References m_subdirs, DefinitionMutable::setOuterScope(), and DirDef::setParent().

◆ addUsesDependency()

void DirDefImpl::addUsesDependency ( const DirDef * dir,
const FileDef * srcFd,
const FileDef * dstFd,
bool srcDirect,
bool dstDirect )
overridevirtual

Add as "uses" dependency between this dir and dir, that was caused by a dependency on file fd.

srcDirect and dstDirect indicate if it is a direct dependencies (true) or if the dependencies was indirect (e.g. a parent dir that has a child dir that has the dependencies)

Implements DirDef.

Definition at line 706 of file dirdef.cpp.

708{
709 if (this==dir) return; // do not add self-dependencies
710 AUTO_TRACE("add dependency {}->{} due to {}->{}",
711 qPrint(shortName()),
712 qPrint(dir->shortName()),
713 qPrint(srcFd->name()),
714 qPrint(dstFd->name()));
715
716 // levels match => add direct dependency
717 bool added=false;
718 UsedDir *usedDir = m_usedDirs.find(dir->getOutputFileBase());
719 if (usedDir) // dir dependency already present
720 {
721 const FilePair *usedPair = usedDir->findFilePair(FilePair::key(srcFd,dstFd));
722 if (usedPair==nullptr) // new file dependency
723 {
724 AUTO_TRACE_ADD("{} => {} new file dependency",srcFd->name(),dstFd->name());
725 usedDir->addFileDep(srcFd,dstFd, srcDirect, dstDirect);
726 added=true;
727 }
728 else
729 {
730 // dir & file dependency already added
731 }
732 }
733 else // new directory dependency
734 {
735 AUTO_TRACE_ADD("{} => {} new file dependency",srcFd->name(),dstFd->name());
736 auto newUsedDir = std::make_unique<UsedDir>(dir);
737 newUsedDir->addFileDep(srcFd,dstFd, srcDirect, dstDirect);
738 m_usedDirs.add(dir->getOutputFileBase(),std::move(newUsedDir));
739 added=true;
740 }
741 if (added)
742 {
743 if (dir->parent())
744 {
745 // add relation to parent of used dir
747 srcFd,
748 dstFd,
749 srcDirect,
750 false); // indirect dependency on dest dir
751 }
752 if (parent())
753 {
754 // add relation for the parent of this dir as well
756 srcFd,
757 dstFd,
758 false, // indirect dependency from source dir
759 dstDirect);
760 }
761 }
762}
virtual DString getOutputFileBase() const =0
virtual const DString shortName() const =0
virtual DirDef * parent() const =0
virtual void addUsesDependency(const DirDef *usedDir, const FileDef *srcFd, const FileDef *dstFd, bool srcDirect, bool dstDirect)=0
DirDef * parent() const override
Definition dirdef.cpp:62
const DString shortName() const override
Definition dirdef.cpp:55
void addUsesDependency(const DirDef *usedDir, const FileDef *srcFd, const FileDef *dstFd, bool srcDirect, bool dstDirect) override
Add as "uses" dependency between this dir and dir, that was caused by a dependency on file fd.
Definition dirdef.cpp:706
UsedDirLinkedMap m_usedDirs
Definition dirdef.cpp:111
static DString key(const FileDef *srcFd, const FileDef *dstFd)
Definition dirdef.cpp:926
T * add(const char *k, Args &&... args)
Definition linkedmap.h:90
const T * find(const std::string &key) const
Definition linkedmap.h:47
FilePair * findFilePair(const DString &name)
Definition dirdef.cpp:860
void addFileDep(const FileDef *srcFd, const FileDef *dstFd, bool srcDirect, bool dstDirect)
Take up dependency between files.
Definition dirdef.cpp:839
#define AUTO_TRACE_ADD(...)
Definition docnode.cpp:54
#define AUTO_TRACE(...)
Definition docnode.cpp:53
const char * qPrint(const char *s)
Definition dstring.h:783

References LinkedMap< T, Hash, KeyEqual, Map >::add(), UsedDir::addFileDep(), DirDef::addUsesDependency(), addUsesDependency(), AUTO_TRACE, AUTO_TRACE_ADD, LinkedMap< T, Hash, KeyEqual, Map >::find(), UsedDir::findFilePair(), Definition::getOutputFileBase(), FilePair::key(), m_usedDirs, Definition::name(), DirDef::parent(), parent(), qPrint(), DirDef::shortName(), and shortName().

Referenced by addUsesDependency(), and computeDependencies().

◆ anchor()

DString DirDefImpl::anchor ( ) const
inlineoverridevirtual

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

Implements Definition.

Definition at line 51 of file dirdef.cpp.

51{ return DString(); }

◆ codeSymbolType()

CodeSymbolType DirDefImpl::codeSymbolType ( ) const
inlineoverridevirtual

Used for syntax highlighting symbol class

Implements Definition.

Definition at line 49 of file dirdef.cpp.

References Default.

◆ computeDependencies()

void DirDefImpl::computeDependencies ( )
overridevirtual

Computes the dependencies between directories.

Implements DirDef.

Definition at line 785 of file dirdef.cpp.

786{
787 AUTO_TRACE();
788 for (const auto &fd : m_fileList)
789 {
790 AUTO_TRACE_ADD("dir={} file={}",shortName(),fd->name());
791 for (const auto &ii : fd->includeFileList())
792 {
793 AUTO_TRACE_ADD("#include {}",ii.includeName);
794 if (ii.fileDef && ii.fileDef->isLinkable()) // linkable file
795 {
796 DirDef *usedDir = ii.fileDef->getDirDef();
797 if (usedDir)
798 {
799 // add dependency: thisDir->usedDir
800 AUTO_TRACE_ADD("add dependency {}->{}",name(),usedDir->name());
801 addUsesDependency(usedDir,fd,ii.fileDef,true,true);
802 }
803 }
804 }
805 }
806
807 std::stable_sort(m_usedDirs.begin(),m_usedDirs.end(),
808 [](const auto &u1,const auto &u2)
809 { return dstricmp_sort(u1->dir()->getOutputFileBase(),u2->dir()->getOutputFileBase())<0; });
810
811 for (const auto& usedDirectory : m_usedDirs)
812 {
813 usedDirectory->sort();
814 }
815}
const DString & name() const override
iterator begin()
Definition linkedmap.h:201
iterator end()
Definition linkedmap.h:202

References addUsesDependency(), AUTO_TRACE, AUTO_TRACE_ADD, LinkedMap< T, Hash, KeyEqual, Map >::begin(), LinkedMap< T, Hash, KeyEqual, Map >::end(), m_fileList, m_usedDirs, Definition::name(), DefinitionMixin< DirDef >::name(), and shortName().

◆ createNewDir()

DirDef * DirDefImpl::createNewDir ( const DString & path)
staticprivate

Definition at line 865 of file dirdef.cpp.

866{
867 AUTO_TRACE();
868 ASSERT(path!=nullptr);
869 DirDef *dir = Doxygen::dirLinkedMap->find(path);
870 if (dir==nullptr) // new dir
871 {
872 dir = Doxygen::dirLinkedMap->add(path,
873 std::unique_ptr<DirDef>(
874 createDirDef(path)));
875 AUTO_TRACE_ADD("Adding new dir {} shortName {}",path,dir->shortName());
876 }
877 return dir;
878}
static DirLinkedMap * dirLinkedMap
Definition doxygen.h:120
DirDef * createDirDef(const DString &path)
Definition dirdef.cpp:115
#define ASSERT(x)
Definition message.h:142

References LinkedMap< T, Hash, KeyEqual, Map >::add(), ASSERT, AUTO_TRACE, AUTO_TRACE_ADD, createDirDef(), Doxygen::dirLinkedMap, LinkedMap< T, Hash, KeyEqual, Map >::find(), and DirDef::shortName().

Referenced by mergeDirectoryInTree().

◆ definitionType()

DefType DirDefImpl::definitionType ( ) const
inlineoverridevirtual

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

Implements Definition.

Definition at line 48 of file dirdef.cpp.

48{ return TypeDir; }

References definitionType(), and Definition::TypeDir.

Referenced by definitionType().

◆ depGraphIsTrivial()

bool DirDefImpl::depGraphIsTrivial ( ) const
overridevirtual

Implements DirDef.

Definition at line 827 of file dirdef.cpp.

828{
829 return m_usedDirs.empty() && m_parent==nullptr;
830}
bool empty() const
Definition linkedmap.h:209

References LinkedMap< T, Hash, KeyEqual, Map >::empty(), m_parent, and m_usedDirs.

◆ dirIndex()

int DirDefImpl::dirIndex ( ) const
inlineoverridevirtual

Implements DirDef.

Definition at line 63 of file dirdef.cpp.

63{ return m_dirIndex; }
int m_dirIndex
Definition dirdef.cpp:108

References m_dirIndex.

◆ displayName()

DString DirDefImpl::displayName ( bool includeScope = true) const
inlineoverridevirtual

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

Implements Definition.

Definition at line 54 of file dirdef.cpp.

54{ return m_dispName; }

References m_dispName.

Referenced by addListReferences(), writeDirectoryGraph(), and writeTagFile().

◆ endMemberDeclarations()

void DirDefImpl::endMemberDeclarations ( OutputList & ol)
private

Definition at line 490 of file dirdef.cpp.

491{
493}
void endMemberSections()
Definition outputlist.h:459

References OutputList::endMemberSections().

Referenced by writeDocumentation().

◆ findSectionsInDocumentation()

void DirDefImpl::findSectionsInDocumentation ( )
overridevirtual

Implements DirDef.

Definition at line 764 of file dirdef.cpp.

765{
768}
DString docFile() const override
DString briefDescription(bool abbreviate=false) const override
DString documentation() const override
void docFindSections(const DString &input, const Definition *d, const DString &fileName)

References DefinitionMixin< DirDef >::briefDescription(), DefinitionMixin< DirDef >::docFile(), docFindSections(), and DefinitionMixin< DirDef >::documentation().

◆ getFiles()

const FileList & DirDefImpl::getFiles ( ) const
inlineoverridevirtual

Implements DirDef.

Definition at line 57 of file dirdef.cpp.

57{ return m_fileList; }

References m_fileList.

◆ getOutputFileBase()

DString DirDefImpl::getOutputFileBase ( ) const
overridevirtual

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

Implements Definition.

Definition at line 204 of file dirdef.cpp.

205{
206 DString dir = "dir_"+encodeDirName(m_diskName);
207 AUTO_TRACE("diskName={} result={}",m_diskName,dir);
208 return dir;
209}
static DString encodeDirName(const DString &anchor)
Definition dirdef.cpp:195

References AUTO_TRACE, encodeDirName(), and m_diskName.

Referenced by addListReferences(), writeDocumentation(), and writeTagFile().

◆ hasDetailedDescription()

bool DirDefImpl::hasDetailedDescription ( ) const
overridevirtual

Implements DirDef.

Definition at line 507 of file dirdef.cpp.

508{
509 bool repeatBrief = Config_getBool(REPEAT_BRIEF);
510 return (!briefDescription().empty() && repeatBrief) || !documentation().empty() || hasRequirementRefs();
511}
bool empty() const
Returns true iff the string is empty (std::string compatible alias for isEmpty()).
Definition dstring.h:148
bool hasRequirementRefs() const override

References DefinitionMixin< DirDef >::briefDescription(), Config_getBool, DefinitionMixin< DirDef >::documentation(), DString::empty(), and DefinitionMixin< DirDef >::hasRequirementRefs().

Referenced by writeDetailedDescription().

◆ hasDirectoryGraph()

bool DirDefImpl::hasDirectoryGraph ( ) const
overridevirtual

Implements DirDef.

Definition at line 919 of file dirdef.cpp.

920{
921 return m_hasDirectoryGraph;
922}

References m_hasDirectoryGraph.

◆ hasSubdirs()

bool DirDefImpl::hasSubdirs ( ) const
inlineoverridevirtual

Implements DirDef.

Definition at line 60 of file dirdef.cpp.

60{ return !m_subdirs.empty(); }

References m_subdirs.

◆ isLinkable()

bool DirDefImpl::isLinkable ( ) const
overridevirtual

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 161 of file dirdef.cpp.

162{
163 return isReference() || isLinkableInProject();
164}
bool isReference() const override
bool isLinkableInProject() const override
Definition dirdef.cpp:156

References isLinkableInProject(), and DefinitionMixin< DirDef >::isReference().

◆ isLinkableInProject()

bool DirDefImpl::isLinkableInProject ( ) const
overridevirtual

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

Implements Definition.

Definition at line 156 of file dirdef.cpp.

157{
158 return !isReference() && hasDocumentation();
159}
bool hasDocumentation() const override

References DefinitionMixin< DirDef >::hasDocumentation(), and DefinitionMixin< DirDef >::isReference().

Referenced by isLinkable().

◆ isParentOf()

bool DirDefImpl::isParentOf ( const DirDef * dir) const
overridevirtual

Implements DirDef.

Definition at line 817 of file dirdef.cpp.

818{
819 if (dir->parent()==this) // this is a parent of dir
820 return true;
821 else if (dir->parent()) // repeat for the parent of dir
822 return isParentOf(dir->parent());
823 else
824 return false;
825}
bool isParentOf(const DirDef *dir) const override
Definition dirdef.cpp:817

References isParentOf(), and DirDef::parent().

Referenced by isParentOf().

◆ level()

int DirDefImpl::level ( ) const
inlineoverridevirtual

Implements DirDef.

Definition at line 61 of file dirdef.cpp.

61{ return m_level; }

References m_level.

◆ matchPath()

bool DirDefImpl::matchPath ( const DString & path)
staticprivate

Definition at line 880 of file dirdef.cpp.

881{
882 StringVector l = Config_getList(STRIP_FROM_PATH);
883 for (const auto &s : l)
884 {
885 std::string prefix = s.substr(0,path.length());
886 if (dstricmp_sort(prefix.c_str(),path)==0) // case insensitive compare
887 {
888 return true;
889 }
890 }
891 return false;
892}
constexpr auto prefix
Definition anchor.cpp:47
#define Config_getList(name)
Definition config.h:38
std::vector< std::string > StringVector
Definition containers.h:33
int dstricmp_sort(const char *str1, const char *str2)
Definition dstring.h:67

References Config_getList, dstricmp_sort(), DString::length(), and prefix.

Referenced by mergeDirectoryInTree().

◆ mergeDirectoryInTree()

DirDef * DirDefImpl::mergeDirectoryInTree ( const DString & path)
static

strip part of path if it matches one of the paths in the Config_getList(STRIP_FROM_PATH) list

Definition at line 897 of file dirdef.cpp.

898{
899 AUTO_TRACE("path={}",path);
900 size_t p=0,i=0;
901 DirDef *dir=nullptr;
902 while ((i=path.find('/',p))!=DString::npos)
903 {
904 DString part=path.left(i+1);
905 if (!matchPath(part) && (part!="/" && part!="//" && part!="//?/"))
906 {
908 }
909 p=i+1;
910 }
911 return dir;
912}
size_t find(char c, size_t pos=0) const
Definition dstring.h:239
static DirDef * createNewDir(const DString &path)
Definition dirdef.cpp:865
static bool matchPath(const DString &path)
Definition dirdef.cpp:880
DString removeLongPathMarker(const DString &path)
Definition portable.cpp:656

References AUTO_TRACE, createNewDir(), DString::find(), DString::left(), matchPath(), DString::npos, and Portable::removeLongPathMarker().

Referenced by buildDirectories().

◆ overrideDirectoryGraph()

void DirDefImpl::overrideDirectoryGraph ( bool e)
overridevirtual

Implements DirDef.

Definition at line 914 of file dirdef.cpp.

915{
917}

References m_hasDirectoryGraph.

◆ parent()

DirDef * DirDefImpl::parent ( ) const
inlineoverridevirtual

Implements DirDef.

Definition at line 62 of file dirdef.cpp.

62{ return m_parent; }

References m_parent.

Referenced by addUsesDependency(), and setLevel().

◆ setDirIndex()

void DirDefImpl::setDirIndex ( int index)
overridevirtual

Implements DirDef.

Definition at line 178 of file dirdef.cpp.

179{
180 m_dirIndex=index;
181}

References m_dirIndex.

◆ setDiskName()

void DirDefImpl::setDiskName ( const DString & name)
inlineoverridevirtual

Implements DirDef.

Definition at line 72 of file dirdef.cpp.

72{ m_diskName = name; }

References m_diskName, and DefinitionMixin< DirDef >::name().

◆ setLevel()

void DirDefImpl::setLevel ( )
overridevirtual

Implements DirDef.

Definition at line 684 of file dirdef.cpp.

685{
686 if (m_level==-1) // level not set before
687 {
688 DirDef *p = parent();
689 if (p)
690 {
691 p->setLevel();
692 m_level = p->level()+1;
693 }
694 else
695 {
696 m_level = 0;
697 }
698 }
699}
virtual int level() const =0
virtual void setLevel()=0

References DirDef::level(), m_level, parent(), and DirDef::setLevel().

◆ setParent()

void DirDefImpl::setParent ( DirDef * parent)
overridevirtual

Implements DirDef.

Definition at line 173 of file dirdef.cpp.

174{
175 m_parent=p;
176}

References m_parent.

◆ shortName()

const DString DirDefImpl::shortName ( ) const
inlineoverridevirtual

Implements DirDef.

Definition at line 55 of file dirdef.cpp.

55{ return m_shortName; }

References m_shortName.

Referenced by addUsesDependency(), computeDependencies(), and writeDirectoryGraph().

◆ shortTitle()

DString DirDefImpl::shortTitle ( ) const
overridevirtual

Implements DirDef.

Definition at line 495 of file dirdef.cpp.

496{
497 if (Config_getBool(HIDE_COMPOUND_REFERENCE))
498 {
499 return m_shortName;
500 }
501 else
502 {
504 }
505}
virtual DString trDirReference(const DString &dirName)=0

References Config_getBool, m_shortName, theTranslator, and Translator::trDirReference().

Referenced by writeDocumentation().

◆ sort()

void DirDefImpl::sort ( )
overridevirtual

Implements DirDef.

Definition at line 189 of file dirdef.cpp.

190{
191 std::stable_sort(m_subdirs.begin(), m_subdirs.end(), compareDirDefs);
192 std::stable_sort(m_fileList.begin(), m_fileList.end(), compareFileDefs);
193}
bool compareDirDefs(const DirDef *item1, const DirDef *item2)
Definition dirdef.cpp:1211
bool compareFileDefs(const FileDef *fd1, const FileDef *fd2)
Definition filedef.cpp:2021

References compareDirDefs(), compareFileDefs(), m_fileList, and m_subdirs.

◆ startMemberDeclarations()

void DirDefImpl::startMemberDeclarations ( OutputList & ol)
private

Definition at line 485 of file dirdef.cpp.

486{
488}
void startMemberSections()
Definition outputlist.h:457

References OutputList::startMemberSections().

Referenced by writeDocumentation().

◆ subDirs()

const DirList & DirDefImpl::subDirs ( ) const
inlineoverridevirtual

Implements DirDef.

Definition at line 59 of file dirdef.cpp.

59{ return m_subdirs; }

References m_subdirs.

◆ usedDirs()

const UsedDirLinkedMap & DirDefImpl::usedDirs ( ) const
inlineoverridevirtual

Implements DirDef.

Definition at line 64 of file dirdef.cpp.

64{ return m_usedDirs; }

References m_usedDirs.

◆ writeBriefDescription()

void DirDefImpl::writeBriefDescription ( OutputList & ol)
private

Definition at line 269 of file dirdef.cpp.

270{
271 AUTO_TRACE();
273 {
274 auto parser { createDocParser() };
275 auto ast { validatingParseDoc(*parser.get(),
276 briefFile(),
277 briefLine(),
278 this,
279 nullptr,
281 DocOptions()
282 .setIndexWords(true))
283 };
284 if (!ast->empty())
285 {
286 ol.startParagraph();
289 ol.writeString(" - ");
291 ol.writeDoc(ast.get(),this,nullptr);
294 ol.writeString(" \n");
296
297 if (Config_getBool(REPEAT_BRIEF) ||
298 !documentation().empty()
299 )
300 {
302 ol.startTextLink(DString(),"details");
304 ol.endTextLink();
305 }
307
308 ol.endParagraph();
309 }
310 }
311 ol.writeSynopsis();
312}
virtual DString briefFile() const =0
bool hasBriefDescription() const override
int briefLine() const override
void writeDoc(const IDocNodeAST *ast, const Definition *ctx, const MemberDef *md, int sectionLevel=-1)
Definition outputlist.h:379
void parseText(const DString &textStr)
void disable(OutputType o)
void startParagraph(const DString &classDef=DString())
Definition outputlist.h:403
void enable(OutputType o)
void writeString(const DString &text)
Definition outputlist.h:407
void endParagraph()
Definition outputlist.h:405
void endTextLink()
Definition outputlist.h:440
void writeSynopsis()
Definition outputlist.h:588
void pushGeneratorState()
void disableAllBut(OutputType o)
void popGeneratorState()
void startTextLink(const DString &file, const DString &anchor)
Definition outputlist.h:438
virtual DString trMore()=0
IDocParserPtr createDocParser()
factory function to create a parser
Definition docparser.cpp:59
IDocNodeASTPtr validatingParseDoc(IDocParser &parserIntf, const DString &fileName, int startLine, const Definition *ctx, const MemberDef *md, const DString &input, const DocOptions &options)

References AUTO_TRACE, DefinitionMixin< DirDef >::briefDescription(), DefinitionMixin< DirDef >::briefFile(), DefinitionMixin< DirDef >::briefLine(), Config_getBool, createDocParser(), OutputList::disable(), OutputList::disableAllBut(), DefinitionMixin< DirDef >::documentation(), OutputList::enable(), OutputList::endParagraph(), OutputList::endTextLink(), DefinitionMixin< DirDef >::hasBriefDescription(), Html, Man, OutputList::parseText(), OutputList::popGeneratorState(), OutputList::pushGeneratorState(), RTF, OutputList::startParagraph(), OutputList::startTextLink(), theTranslator, Translator::trMore(), validatingParseDoc(), OutputList::writeDoc(), OutputList::writeString(), and OutputList::writeSynopsis().

Referenced by writeDocumentation().

◆ writeDetailedDescription()

void DirDefImpl::writeDetailedDescription ( OutputList & ol,
const DString & title )
private

Definition at line 211 of file dirdef.cpp.

212{
213 AUTO_TRACE();
215 {
218 ol.writeRuler();
222 ol.writeAnchor(DString(),"details");
224 ol.startGroupHeader("details");
225 ol.parseText(title);
226 ol.endGroupHeader();
227
228 // repeat brief description
229 ol.startTextBlock();
230 if (!briefDescription().empty() && Config_getBool(REPEAT_BRIEF))
231 {
233 briefLine(),
234 this,
235 nullptr,
237 DocOptions());
238 }
239 // separator between brief and details
240 if (!briefDescription().empty() && Config_getBool(REPEAT_BRIEF) &&
241 !documentation().empty())
242 {
246 ol.enableAll();
249 ol.writeString("\n\n");
251 }
252
253 // write documentation
254 if (!documentation().empty())
255 {
256 ol.generateDoc(docFile(),
257 docLine(),
258 this,
259 nullptr,
260 documentation()+"\n",
261 DocOptions()
262 .setIndexWords(true));
263 }
265 ol.endTextBlock();
266 }
267}
DString briefFile() const override
void writeRequirementRefs(OutputList &ol) const override
int docLine() const override
bool hasDetailedDescription() const override
Definition dirdef.cpp:507
void writeRuler()
Definition outputlist.h:517
void endTextBlock(bool paraBreak=false)
Definition outputlist.h:668
void writeAnchor(const DString &fileName, const DString &name)
Definition outputlist.h:519
void startTextBlock(bool dense=false)
Definition outputlist.h:666
void endGroupHeader(int extraLevels=0)
Definition outputlist.h:451
void generateDoc(const DString &fileName, int startLine, const Definition *ctx, const MemberDef *md, const DString &docStr, const DocOptions &options)
void startGroupHeader(const DString &id=DString(), int extraLevels=0)
Definition outputlist.h:449
void enableAll()

References AUTO_TRACE, DefinitionMixin< DirDef >::briefDescription(), DefinitionMixin< DirDef >::briefFile(), DefinitionMixin< DirDef >::briefLine(), Config_getBool, OutputList::disable(), OutputList::disableAllBut(), DefinitionMixin< DirDef >::docFile(), DefinitionMixin< DirDef >::docLine(), DefinitionMixin< DirDef >::documentation(), OutputList::enable(), OutputList::enableAll(), OutputList::endGroupHeader(), OutputList::endTextBlock(), OutputList::generateDoc(), hasDetailedDescription(), DefinitionMixin< DirDef >::hasRequirementRefs(), Html, Latex, Man, OutputList::parseText(), OutputList::popGeneratorState(), OutputList::pushGeneratorState(), RTF, OutputList::startGroupHeader(), OutputList::startTextBlock(), OutputList::writeAnchor(), DefinitionMixin< DirDef >::writeRequirementRefs(), OutputList::writeRuler(), and OutputList::writeString().

Referenced by writeDocumentation().

◆ writeDirectoryGraph()

void DirDefImpl::writeDirectoryGraph ( OutputList & ol)
private

Definition at line 319 of file dirdef.cpp.

320{
321 // write graph dependency graph
322 if (Config_getBool(HAVE_DOT) && m_hasDirectoryGraph /*&& Config_getBool(DIRECTORY_GRAPH)*/)
323 {
324 DotDirDeps dirDep(this);
325 if (!dirDep.isTrivial())
326 {
327 msg("Generating dependency graph for directory {}\n",displayName());
329 //ol.startParagraph();
330 ol.startDirDepGraph();
332 ol.endDirDepGraph(dirDep);
333 //ol.endParagraph();
334 ol.enableAll();
335 }
336 }
337}
void endDirDepGraph(DotDirDeps &g)
Definition outputlist.h:658
void startDirDepGraph()
Definition outputlist.h:656
virtual DString trDirDepGraph(const DString &name)=0
#define msg(fmt,...)
Definition message.h:94

References Config_getBool, OutputList::disable(), displayName(), OutputList::enableAll(), OutputList::endDirDepGraph(), DotDirDeps::isTrivial(), m_hasDirectoryGraph, Man, msg, OutputList::parseText(), shortName(), OutputList::startDirDepGraph(), theTranslator, and Translator::trDirDepGraph().

Referenced by writeDocumentation().

◆ writeDocumentation()

void DirDefImpl::writeDocumentation ( OutputList & ol)
overridevirtual

Implements DirDef.

Definition at line 552 of file dirdef.cpp.

553{
554 bool generateTreeView = Config_getBool(GENERATE_TREEVIEW);
556
557 DString title;
558 if (Config_getBool(HIDE_COMPOUND_REFERENCE))
559 {
560 title=m_dispName;
561 }
562 else
563 {
565 }
566 AUTO_TRACE("title={}",title);
567 startFile(ol,getOutputFileBase(),false,name(),title,HighlightedItem::Files,!generateTreeView);
568
569 if (!generateTreeView)
570 {
571 // write navigation path
573 ol.endQuickIndices();
574 }
575
579 ol.parseText(shortTitle());
580 ol.enableAll();
582 ol.parseText(title);
584 endTitle(ol,getOutputFileBase(),title);
585 ol.startContents();
586
587 //---------------------------------------- start flexible part -------------------------------
588
589 SrcLangExt lang = getLanguage();
590 for (const auto &lde : LayoutDocManager::instance().docEntries(LayoutDocManager::Directory))
591 {
592 switch (lde->kind())
593 {
594 case LayoutDocEntry::BriefDesc:
596 break;
597 case LayoutDocEntry::DirGraph:
599 break;
600 case LayoutDocEntry::MemberDeclStart:
602 break;
603 case LayoutDocEntry::DirSubDirs:
604 writeSubDirList(ol);
605 break;
606 case LayoutDocEntry::DirFiles:
607 writeFileList(ol);
608 break;
609 case LayoutDocEntry::MemberDeclEnd:
611 break;
612 case LayoutDocEntry::DetailedDesc:
613 {
614 const LayoutDocEntrySection *ls = dynamic_cast<const LayoutDocEntrySection*>(lde.get());
615 if (ls)
616 {
617 writeDetailedDescription(ol,ls->title(lang));
618 }
619 }
620 break;
621 case LayoutDocEntry::ClassIncludes:
622 case LayoutDocEntry::ClassInlineClasses:
623 case LayoutDocEntry::ClassInheritanceGraph:
624 case LayoutDocEntry::ClassNestedClasses:
625 case LayoutDocEntry::ClassCollaborationGraph:
626 case LayoutDocEntry::ClassAllMembersLink:
627 case LayoutDocEntry::ClassUsedFiles:
628 case LayoutDocEntry::NamespaceNestedNamespaces:
629 case LayoutDocEntry::NamespaceNestedConstantGroups:
630 case LayoutDocEntry::NamespaceClasses:
631 case LayoutDocEntry::NamespaceConcepts:
632 case LayoutDocEntry::NamespaceInterfaces:
633 case LayoutDocEntry::NamespaceStructs:
634 case LayoutDocEntry::NamespaceExceptions:
635 case LayoutDocEntry::NamespaceInlineClasses:
636 case LayoutDocEntry::ConceptDefinition:
637 case LayoutDocEntry::FileClasses:
638 case LayoutDocEntry::FileConcepts:
639 case LayoutDocEntry::FileInterfaces:
640 case LayoutDocEntry::FileStructs:
641 case LayoutDocEntry::FileExceptions:
642 case LayoutDocEntry::FileNamespaces:
643 case LayoutDocEntry::FileConstantGroups:
644 case LayoutDocEntry::FileIncludes:
645 case LayoutDocEntry::FileIncludeGraph:
646 case LayoutDocEntry::FileIncludedByGraph:
647 case LayoutDocEntry::FileSourceLink:
648 case LayoutDocEntry::FileInlineClasses:
649 case LayoutDocEntry::GroupClasses:
650 case LayoutDocEntry::GroupConcepts:
651 case LayoutDocEntry::GroupModules:
652 case LayoutDocEntry::GroupInlineClasses:
653 case LayoutDocEntry::GroupNamespaces:
654 case LayoutDocEntry::GroupDirs:
655 case LayoutDocEntry::GroupNestedGroups:
656 case LayoutDocEntry::GroupFiles:
657 case LayoutDocEntry::GroupGraph:
658 case LayoutDocEntry::GroupPageDocs:
659 case LayoutDocEntry::ModuleExports:
660 case LayoutDocEntry::ModuleClasses:
661 case LayoutDocEntry::ModuleConcepts:
662 case LayoutDocEntry::ModuleUsedFiles:
663 case LayoutDocEntry::AuthorSection:
664 case LayoutDocEntry::MemberGroups:
665 case LayoutDocEntry::MemberDecl:
666 case LayoutDocEntry::MemberDef:
667 case LayoutDocEntry::MemberDefStart:
668 case LayoutDocEntry::MemberDefEnd:
669 err("Internal inconsistency: member '{}' should not be part of "
670 "LayoutDocManager::Directory entry list\n",qPrint(lde->entryToString()));
671 break;
672 }
673 }
674
675 //---------------------------------------- end flexible part -------------------------------
676
677 ol.endContents();
678
679 endFileWithNavPath(ol,this);
680
682}
void writeNavigationPath(OutputList &ol) const override
SrcLangExt getLanguage() const override
void writeSubDirList(OutputList &ol)
Definition dirdef.cpp:339
DString shortTitle() const override
Definition dirdef.cpp:495
void startMemberDeclarations(OutputList &ol)
Definition dirdef.cpp:485
void writeDetailedDescription(OutputList &ol, const DString &title)
Definition dirdef.cpp:211
void writeDirectoryGraph(OutputList &ol)
Definition dirdef.cpp:319
void writeFileList(OutputList &ol)
Definition dirdef.cpp:400
void endMemberDeclarations(OutputList &ol)
Definition dirdef.cpp:490
void writeBriefDescription(OutputList &ol)
Definition dirdef.cpp:269
static LayoutDocManager & instance()
Returns a reference to this singleton.
Definition layout.cpp:1438
void endContents()
Definition outputlist.h:616
void endQuickIndices()
Definition outputlist.h:600
void startContents()
Definition outputlist.h:614
void endTitle(OutputList &ol, const DString &fileName, const DString &name)
Definition index.cpp:398
void endFileWithNavPath(OutputList &ol, const DefinitionMutable *d, bool showPageNavigation)
Definition index.cpp:452
void startTitle(OutputList &ol, const DString &fileName, const DefinitionMutable *def)
Definition index.cpp:388
void startFile(OutputList &ol, const DString &name, bool isSource, const DString &manName, const DString &title, HighlightedItem hli, bool additionalIndices, const DString &altSidebarName, int hierarchyLevel, const DString &allMembersFile)
Definition index.cpp:405
#define err(fmt,...)
Definition message.h:127
DString title(SrcLangExt lang) const
Definition layout.cpp:1782
SrcLangExt
Definition types.h:207

References AUTO_TRACE, Config_getBool, OutputList::disable(), OutputList::disableAllBut(), OutputList::enableAll(), OutputList::endContents(), endFileWithNavPath(), endMemberDeclarations(), OutputList::endQuickIndices(), endTitle(), err, Files, DefinitionMixin< DirDef >::getLanguage(), getOutputFileBase(), Html, LayoutDocManager::instance(), m_dispName, DefinitionMixin< DirDef >::name(), OutputList::parseText(), OutputList::popGeneratorState(), OutputList::pushGeneratorState(), qPrint(), shortTitle(), OutputList::startContents(), startFile(), startMemberDeclarations(), startTitle(), theTranslator, LayoutDocEntrySection::title(), Translator::trDirReference(), writeBriefDescription(), writeDetailedDescription(), writeDirectoryGraph(), writeFileList(), DefinitionMixin< DirDef >::writeNavigationPath(), and writeSubDirList().

◆ writeFileList()

void DirDefImpl::writeFileList ( OutputList & ol)
private

Definition at line 400 of file dirdef.cpp.

401{
402 AUTO_TRACE();
403 int numFiles = 0;
404 for (const auto &fd : m_fileList)
405 {
406 bool genSourceFile=false;
407 if (fd->visibleInIndex(genSourceFile))
408 {
409 numFiles++;
410 }
411 else if (genSourceFile)
412 {
413 numFiles++;
414 }
415 }
416
417 AUTO_TRACE_ADD("numFiles={}",numFiles);
418 // write file list
419 if (numFiles>0)
420 {
421 ol.startMemberHeader("files");
422 ol.parseText(theTranslator->trFile(true,false));
423 ol.endMemberHeader();
424 ol.startMemberList();
425 for (const auto &fd : m_fileList)
426 {
427 bool src = false;
428 bool doc = fd->visibleInIndex(src);
429 if (doc || src)
430 {
432 DString anc = fd->anchor();
433 if (anc.empty()) anc=fd->displayName(); else anc.prepend(fd->displayName()+"_");
435 {
438 bool genSrc = fd->generateSourceFile();
439 if (genSrc)
440 {
441 ol.startTextLink(fd->includeName(),DString());
442 }
443 ol.writeString("<span class=\"icondoc\"><div class=\"doc-icon\"></div></span>");
444 if (genSrc)
445 {
446 ol.endTextLink();
447 }
448 ol.enableAll();
450 ol.docify(theTranslator->trFile(false,true)+" ");
452 }
454 if (fd->isLinkable())
455 {
456 ol.writeObjectLink(fd->getReference(),fd->getOutputFileBase(),DString(),fd->displayName());
457 }
458 else
459 {
460 ol.startBold();
461 ol.docify(fd->displayName());
462 ol.endBold();
463 }
465 if (!fd->briefDescription().empty() && Config_getBool(BRIEF_MEMBER_DESC))
466 {
467 ol.startMemberDescription(fd->getOutputFileBase());
469 briefLine(),
470 fd,
471 nullptr,
472 fd->briefDescription(),
473 DocOptions()
474 .setSingleLine(true)
475 .setLinkFromIndex(true));
477 }
478 ol.endMemberDeclaration(fd->anchor(),DString());
479 }
480 }
481 ol.endMemberList();
482 }
483}
DString & prepend(const char *s)
Definition dstring.h:515
void startMemberDeclaration()
Definition outputlist.h:565
void writeObjectLink(const DString &ref, const DString &file, const DString &anchor, const DString &name)
Definition outputlist.h:435
void endMemberDescription()
Definition outputlist.h:563
void endMemberDeclaration(const DString &anchor, const DString &inheritId)
Definition outputlist.h:567
void docify(const DString &s)
Definition outputlist.h:433
void startMemberHeader(const DString &anchor, int typ=2)
Definition outputlist.h:465
void insertMemberAlign(bool templ=false)
Definition outputlist.h:513
void startMemberList()
Definition outputlist.h:477
void startBold()
Definition outputlist.h:557
void endMemberItem(OutputGenerator::MemberItemType type)
Definition outputlist.h:491
void endMemberList()
Definition outputlist.h:479
void endBold()
Definition outputlist.h:559
void startMemberItem(const DString &anchor, OutputGenerator::MemberItemType type, const DString &id=DString())
Definition outputlist.h:489
void startMemberDescription(const DString &anchor, const DString &inheritId=DString(), bool typ=false)
Definition outputlist.h:561
void endMemberHeader()
Definition outputlist.h:467
virtual DString trFile(bool first_capital, bool singular)=0

References AUTO_TRACE, AUTO_TRACE_ADD, DefinitionMixin< DirDef >::briefFile(), DefinitionMixin< DirDef >::briefLine(), Config_getBool, OutputList::disable(), OutputList::disableAllBut(), OutputList::docify(), DString::empty(), OutputList::enableAll(), OutputList::endBold(), OutputList::endMemberDeclaration(), OutputList::endMemberDescription(), OutputList::endMemberHeader(), OutputList::endMemberItem(), OutputList::endMemberList(), OutputList::endTextLink(), OutputList::generateDoc(), Html, OutputList::insertMemberAlign(), m_fileList, OutputGenerator::Normal, OutputList::parseText(), OutputList::popGeneratorState(), DString::prepend(), OutputList::pushGeneratorState(), OutputList::startBold(), OutputList::startMemberDeclaration(), OutputList::startMemberDescription(), OutputList::startMemberHeader(), OutputList::startMemberItem(), OutputList::startMemberList(), OutputList::startTextLink(), theTranslator, Translator::trFile(), OutputList::writeObjectLink(), and OutputList::writeString().

Referenced by writeDocumentation().

◆ writePageNavigation()

void DirDefImpl::writePageNavigation ( OutputList & ol) const
overridevirtual

Reimplemented from DefinitionMixin< DirDef >.

Definition at line 314 of file dirdef.cpp.

315{
316 ol.writePageOutline();
317}
void writePageOutline()
Definition outputlist.h:612

References OutputList::writePageOutline().

◆ writeSubDirList()

void DirDefImpl::writeSubDirList ( OutputList & ol)
private

Definition at line 339 of file dirdef.cpp.

340{
341 AUTO_TRACE();
342 int numSubdirs = 0;
343 for(const auto &dd : m_subdirs)
344 {
345 if (dd->hasDocumentation() || !dd->getFiles().empty())
346 {
347 numSubdirs++;
348 }
349 }
350
351 AUTO_TRACE_ADD("numSubdirs={}",numSubdirs);
352 // write subdir list
353 if (numSubdirs>0)
354 {
355 ol.startMemberHeader("subdirs");
356 ol.parseText(theTranslator->trDir(true,false));
357 ol.endMemberHeader();
358 ol.startMemberList();
359 for(const auto &dd : m_subdirs)
360 {
361 if (dd->hasDocumentation() || !dd->getFiles().empty())
362 {
364 DString anc=dd->anchor();
365 if (anc.empty()) anc=dd->shortName(); else anc.prepend(dd->shortName()+"_");
367 {
370 ol.writeString("<span class=\"iconfolder\"><div class=\"folder-icon\"></div></span>");
371 ol.enableAll();
373 ol.parseText(theTranslator->trDir(false,true)+" ");
375 }
377 ol.writeObjectLink(dd->getReference(),dd->getOutputFileBase(),DString(),dd->shortName());
379 if (!dd->briefDescription().empty() && Config_getBool(BRIEF_MEMBER_DESC))
380 {
381 ol.startMemberDescription(dd->getOutputFileBase());
383 briefLine(),
384 dd,
385 nullptr,
386 dd->briefDescription(),
387 DocOptions()
388 .setSingleLine(true)
389 .setLinkFromIndex(true));
391 }
392 ol.endMemberDeclaration(dd->anchor(),DString());
393 }
394 }
395
396 ol.endMemberList();
397 }
398}

References AUTO_TRACE, AUTO_TRACE_ADD, DefinitionMixin< DirDef >::briefFile(), DefinitionMixin< DirDef >::briefLine(), Config_getBool, OutputList::disable(), OutputList::disableAllBut(), DString::empty(), OutputList::enableAll(), OutputList::endMemberDeclaration(), OutputList::endMemberDescription(), OutputList::endMemberHeader(), OutputList::endMemberItem(), OutputList::endMemberList(), OutputList::generateDoc(), Html, OutputList::insertMemberAlign(), m_subdirs, OutputGenerator::Normal, OutputList::parseText(), OutputList::popGeneratorState(), DString::prepend(), OutputList::pushGeneratorState(), OutputList::startMemberDeclaration(), OutputList::startMemberDescription(), OutputList::startMemberHeader(), OutputList::startMemberItem(), OutputList::startMemberList(), theTranslator, Translator::trDir(), OutputList::writeObjectLink(), and OutputList::writeString().

Referenced by writeDocumentation().

◆ writeTagFile()

void DirDefImpl::writeTagFile ( TextStream & t)
overridevirtual

Implements DirDef.

Definition at line 513 of file dirdef.cpp.

514{
515 tagFile << " <compound kind=\"dir\">\n";
516 tagFile << " <name>" << convertToXML(displayName()) << "</name>\n";
517 tagFile << " <path>" << convertToXML(stripFromPath(name())) << "</path>\n";
518 DString fn=getOutputFileBase();
520 tagFile << " <filename>" << fn << "</filename>\n";
521 for (const auto &lde : LayoutDocManager::instance().docEntries(LayoutDocManager::Directory))
522 {
523 switch (lde->kind())
524 {
525 case LayoutDocEntry::DirSubDirs:
526 {
527 if (m_subdirs.size()>0)
528 {
529 for (const auto &dd : m_subdirs)
530 {
531 tagFile << " <dir>" << convertToXML(dd->displayName()) << "</dir>\n";
532 }
533 }
534 }
535 break;
536 case LayoutDocEntry::DirFiles:
537 {
538 for (const auto &fd : m_fileList)
539 {
540 tagFile << " <file>" << convertToXML(fd->name()) << "</file>\n";
541 }
542 }
543 break;
544 default:
545 break;
546 }
547 }
549 tagFile << " </compound>\n";
550}
void writeDocAnchorsToTagFile(TextStream &fs) const override
void addHtmlExtensionIfMissing(DString &fName)
Definition util.cpp:3931
DString convertToXML(const DString &s, bool keepEntities, const bool citeEntry)
Definition util.cpp:3232

References addHtmlExtensionIfMissing(), convertToXML(), displayName(), getOutputFileBase(), LayoutDocManager::instance(), m_fileList, m_subdirs, DefinitionMixin< DirDef >::name(), stripFromPath(), and DefinitionMixin< DirDef >::writeDocAnchorsToTagFile().

Member Data Documentation

◆ m_dirIndex

int DirDefImpl::m_dirIndex = -1
private

Definition at line 108 of file dirdef.cpp.

Referenced by dirIndex(), and setDirIndex().

◆ m_diskName

DString DirDefImpl::m_diskName
private

Definition at line 106 of file dirdef.cpp.

Referenced by DirDefImpl(), getOutputFileBase(), and setDiskName().

◆ m_dispName

DString DirDefImpl::m_dispName
private

Definition at line 104 of file dirdef.cpp.

Referenced by DirDefImpl(), displayName(), and writeDocumentation().

◆ m_fileList

FileList DirDefImpl::m_fileList
private

Definition at line 107 of file dirdef.cpp.

Referenced by addFile(), computeDependencies(), getFiles(), sort(), writeFileList(), and writeTagFile().

◆ m_hasDirectoryGraph

bool DirDefImpl::m_hasDirectoryGraph = false
private

◆ m_level

int DirDefImpl::m_level
private

Definition at line 109 of file dirdef.cpp.

Referenced by DirDefImpl(), level(), and setLevel().

◆ m_parent

DirDef* DirDefImpl::m_parent
private

Definition at line 110 of file dirdef.cpp.

Referenced by depGraphIsTrivial(), DirDefImpl(), parent(), and setParent().

◆ m_shortName

DString DirDefImpl::m_shortName
private

Definition at line 105 of file dirdef.cpp.

Referenced by DirDefImpl(), shortName(), and shortTitle().

◆ m_subdirs

DirList DirDefImpl::m_subdirs
private

Definition at line 103 of file dirdef.cpp.

Referenced by addSubDir(), hasSubdirs(), sort(), subDirs(), writeSubDirList(), and writeTagFile().

◆ m_usedDirs

UsedDirLinkedMap DirDefImpl::m_usedDirs
private

Definition at line 111 of file dirdef.cpp.

Referenced by addUsesDependency(), computeDependencies(), depGraphIsTrivial(), and usedDirs().


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