Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-104614

QDoc doesn't warn about undocumented methods

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Unresolved
    • Icon: P3: Somewhat important P3: Somewhat important
    • None
    • 6.3.0
    • Build tools: qdoc
    • None
    • DaVinci 58, DaVinci 59, DaVinci 62, DaVinci 63, DaVinci 64, DaVinci 65, DaVinci 66, DaVinci 67, DaVinci 68, DaVinci 69, DaVinci 70

      qdoc should warn about methods that are not documented. Anyhow, this doesn't work reliably, at least - see also the attached project:

      project = test
      outputdir   = html
      headers = a.h
      sources = a.cpp
      headerdirs  = .
      sourcedirs  = .
      
      class A {
      public:
          A() {}
      
          void f() { }
          void g();
          void h();
      };
      
      #include "a.h"
      
      /*!
        \class A
        \brief Powerful class for doing A.
        \inmodule test
      
        A is a class.
       */
      
      void A::g()
      {
      
      }
      
      /*!
        Does h() on a A class
       */
      void A::h()
      {
      }
      

      I would have expected some warnings from qdoc about the missing documentation for f(), g(). Anyhow, the output doesn't indicate anything:

      C:\dev\tmp\qtbug-104614>C:\Qt\6.3.0\msvc2019_64\bin\qdoc.exe qdocwarnings.qdocconf
      qt.qdoc: Start qdoc for test in dual process mode: generate phase.
      qt.qdoc: No include paths passed to qdoc; guessing reasonable include paths
      (qdoc) Could not find the module header in include paths for module "test"   (include paths:  QList() )
             Artificial module header built from header dirs in qdocconf file
      qt.qdoc: Parse source files for "test"
      qt.qdoc: No include paths passed to qdoc; guessing reasonable include paths
      qt.qdoc: Source files parsed for "test"
      qt.qdoc: End qdoc for test in dual process mode: generate phase.
      

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

            docinfrastructure Documentation Infrastructure Team
            kkohne Kai Köhne
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:

                There are no open Gerrit changes