issue doxygen#11593 Missing links for LaTex, RTF, ... with IMPLICIT_DIR_DOCS

Author: doxygen

src/dirdef.cpp

@@ -73,6 +73,7 @@ class DirDefImpl : public DefinitionMixin<DirDef>
     void addUsesDependency(const DirDef *usedDir,const FileDef *srcFd,
                                    const FileDef *dstFd,bool srcDirect, bool dstDirect) override;
     void computeDependencies() override;
+    void findSectionsInDocumentation() override;
 
     bool hasDirectoryGraph() const override;
     void overrideDirectoryGraph(bool e) override;
@@ -761,6 +762,12 @@ void DirDefImpl::addUsesDependency(const DirDef *dir,const FileDef *srcFd,
   }
 }
 
+void DirDefImpl::findSectionsInDocumentation()
+{
+  docFindSections(briefDescription(),this,docFile());
+  docFindSections(documentation(),this,docFile());
+}
+
 /** Computes the dependencies between directories
  */
 void DirDefImpl::computeDependencies()

src/dirdef.h

@@ -139,6 +139,7 @@ class DirDef : public DefinitionMutable, public Definition
     virtual void addUsesDependency(const DirDef *usedDir,const FileDef *srcFd,
                                    const FileDef *dstFd,bool srcDirect, bool dstDirect) = 0;
     virtual void computeDependencies() = 0;
+    virtual void findSectionsInDocumentation() = 0;
 
     // directory graph related members
     virtual bool hasDirectoryGraph() const = 0;

src/doxygen.cpp

@@ -9320,6 +9320,11 @@ static void findSectionsInDocumentation()
   {
     pd->findSectionsInDocumentation();
   }
+  // for each directory
+  for (const auto &dd : *Doxygen::dirLinkedMap)
+  {
+    dd->findSectionsInDocumentation();
+  }
   ModuleManager::instance().findSectionsInDocumentation();
   if (Doxygen::mainPage) Doxygen::mainPage->findSectionsInDocumentation();
 }

src/index.cpp

@@ -1536,6 +1536,34 @@ static void writeSingleFileIndex(OutputList &ol,const FileDef *fd)
     // --------------------------------------------------------
   }
 }
+//----------------------------------------------------------------------------
+
+static void writeDirIndex(OutputList &ol)
+{
+  if (Index::instance().numDocumentedDirs()==0) return;
+  ol.pushGeneratorState();
+  ol.disable(OutputType::Html);
+
+  QCString title = theTranslator->trDirectories();
+  startFile(ol,"dirs",QCString(),title,HighlightedItem::Files);
+  startTitle(ol,title);
+  ol.parseText(title);
+  endTitle(ol,QCString(),QCString());
+
+  ol.startIndexList();
+  for (const auto &dir : *Doxygen::dirLinkedMap)
+  {
+    if (dir->hasDocumentation())
+    {
+      writeDirTreeNode(ol, dir.get(), 1, nullptr, false);
+    }
+  }
+
+  ol.endIndexList();
+
+  endFile(ol);
+  ol.popGeneratorState();
+}
 
 //----------------------------------------------------------------------------
 
@@ -5049,6 +5077,12 @@ static void writeIndex(OutputList &ol)
       ol.parseText(/*projPrefix+*/ theTranslator->trTopicIndex());
       ol.endIndexSection(IndexSection::isTopicIndex);
     }
+    if (index.numDocumentedDirs()>0)
+    {
+      ol.startIndexSection(IndexSection::isDirIndex);
+      ol.parseText(theTranslator->trDirIndex());
+      ol.endIndexSection(IndexSection::isDirIndex);
+    }
     if (Config_getBool(SHOW_NAMESPACES) && (index.numDocumentedNamespaces()>0))
     {
       LayoutNavEntry *lne = LayoutDocManager::instance().rootNavEntry()->find(LayoutNavEntry::Namespaces);
@@ -5140,6 +5174,12 @@ static void writeIndex(OutputList &ol)
     ol.parseText(/*projPrefix+*/theTranslator->trTopicDocumentation());
     ol.endIndexSection(IndexSection::isTopicDocumentation);
   }
+  if (index.numDocumentedDirs()>0)
+  {
+    ol.startIndexSection(IndexSection::isDirDocumentation);
+    ol.parseText(/*projPrefix+*/theTranslator->trDirDocumentation());
+    ol.endIndexSection(IndexSection::isDirDocumentation);
+  }
   if (index.numDocumentedNamespaces()>0)
   {
     ol.startIndexSection(IndexSection::isNamespaceDocumentation);
@@ -5514,6 +5554,9 @@ static void writeIndexHierarchyEntries(OutputList &ol,const LayoutNavEntryList &
     }
     //printf("ending %s kind=%d\n",qPrint(lne->title()),lne->kind());
   }
+
+  // always write the directory index as it is used for non-HTML output only
+  writeDirIndex(ol);
 }
 
 static bool quickLinkVisible(LayoutNavEntry::Kind kind)