Results 1 to 14 of 14

Thread: qdoc problem

Hybrid View

Previous Post Previous Post   Next Post Next Post
  1. #1
    Join Date
    Apr 2009
    Posts
    206
    Thanks
    34
    Thanked 2 Times in 2 Posts

    Default Re: qdoc problem

    The documentary did not say anything about the too-existing files. That's why I know not at all what I should be surprised about.
    I do not know at what goes in or what goes out.

  2. #2
    Join Date
    Jan 2006
    Location
    Warsaw, Poland
    Posts
    33,376
    Qt products
    Qt3 Qt4 Qt5 Qt/Embedded
    Platforms
    Unix/X11 Windows Android Maemo/MeeGo
    Thanks
    4
    Thanked 5,019 Times in 4,795 Posts
    Wiki edits
    10

    Default Re: qdoc problem

    Quote Originally Posted by codeman View Post
    The documentary did not say anything about the too-existing files.
    I'm sorry, I don't know what "too-existing" means.

    That's why I know not at all what I should be surprised about.
    I do not know at what goes in or what goes out.
    qhelpgenerator doesn't create documentation files out of thin air, if they don't exist at the moment when qhelpgenerator is run, they will not be included in the archive. Thus if index.html does not exist as you didn't document the page, it will not go into the qch file and will not be found when someone tries to access it.
    Your biological and technological distinctiveness will be added to our own. Resistance is futile.

    Please ask Qt related questions on the forum and not using private messages or visitor messages.


  3. #3
    Join Date
    Apr 2009
    Posts
    206
    Thanks
    34
    Thanked 2 Times in 2 Posts

    Default Re: qdoc problem

    too-existing: files that has to be exists.

    I respect your knowlegde, but you explain things like a miracle for me(yes thats my problem I know).
    After running qdoc which section of the documentation says, "the generated files are:" or "after that process there will be created these files etc".

    I have no overview of the ingredients. Do you understand my dilemma...

  4. #4
    Join Date
    Jan 2006
    Location
    Warsaw, Poland
    Posts
    33,376
    Qt products
    Qt3 Qt4 Qt5 Qt/Embedded
    Platforms
    Unix/X11 Windows Android Maemo/MeeGo
    Thanks
    4
    Thanked 5,019 Times in 4,795 Posts
    Wiki edits
    10

    Default Re: qdoc problem

    qdoc is not a magic wand, it creates documentation files out of qualified comments you have to put in your code (like those in post #6). If you don't put any qualified comments, qdoc will not generate any pages. The tool is documented, if you want to use it, I suggest you start by reading its manual.

    E.g. there is a qtbase/src/corelib/doc/src/qtcore-index.qdoc file which is responsible for documenting a qtcore-index.html page which is then displayed as the landing page for "Qt Core" help in Qt5.
    Your biological and technological distinctiveness will be added to our own. Resistance is futile.

    Please ask Qt related questions on the forum and not using private messages or visitor messages.


  5. The following user says thank you to wysota for this useful post:

    codeman (20th January 2015)

Similar Threads

  1. Qt assistant qdoc how to generate application help
    By salcin in forum Qt Programming
    Replies: 0
    Last Post: 11th February 2014, 16:49

Bookmarks

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •  
Qt is a trademark of The Qt Company.