Trolltech Home | Qt4-preview-feedback Home | Recent Threads | All Threads | Author | Date
All threads index page 1

Qt4-preview-feedback Archive, April 2008
Qt 4.4 documentation


Message 1 in thread

I have tried 4.4 with the Visual Studio 2008 compiler and everything 
seems to compile. However, when I start the assistant or the demo 
program none of the documentation is available. There is a bunch of 
*.qdoc files under the src/doc tree. Is there some kind of make command 
I have to specify to get the documentation created?

Theo

To unsubscribe - send "unsubscribe" in the subject to qt4-preview-feedback-request@xxxxxxxxxxxxx


Message 2 in thread

T. Landman wrote:
>I have tried 4.4 with the Visual Studio 2008 compiler and everything
>seems to compile. However, when I start the assistant or the demo
>program none of the documentation is available. There is a bunch of
>*.qdoc files under the src/doc tree. Is there some kind of make command
>I have to specify to get the documentation created?

The documentation is pre-generated in the beta 1 packages. If you're 
trying a snapshot, you have to run:
	nmake docs

-- 
 [ signature omitted ] 

Attachment: signature.asc
Description: This is a digitally signed message part.


Message 3 in thread

Thiago Macieira schreef:
> T. Landman wrote:
>   
>> I have tried 4.4 with the Visual Studio 2008 compiler and everything
>> seems to compile. However, when I start the assistant or the demo
>> program none of the documentation is available. There is a bunch of
>> *.qdoc files under the src/doc tree. Is there some kind of make command
>> I have to specify to get the documentation created?
>>     
>
> The documentation is pre-generated in the beta 1 packages. If you're 
> trying a snapshot, you have to run:
> 	nmake docs
>
>   
With the 20080325 snapshot I get an error that the qdoc3 tool isn't found

            (cd
    C:\Users\theo\dev\qt-win-commercial-src-4.4.0-snapshot-20080325/tool
    s/qdoc3/test && set
    QT_BUILD_TREE=C:\Users\theo\dev\qt-win-commercial-src-4.4.0-
    snapshot-20080325&& set
    QT_SOURCE_TREE=C:\Users\theo\dev\qt-win-commercial-src-4
    .4.0-snapshot-20080325&&
    C:\Users\theo\dev\qt-win-commercial-src-4.4.0-snapshot-
    20080325/tools/qdoc3/debug/qdoc3 -Ddesktopedition
    qt-build-docs.qdocconf)
    C:\Users\theo\dev\qt-win-commercial-src-4.4.0-snapshot-20080325/tools/qdoc3/debu
    g/qdoc3 wordt niet herkend als een interne
    of externe opdracht, programma of batchbestand.
    NMAKE : fatal error U1077: '(cd' : return code '0x1'
    Stop.

I think the problem is that the qdoc3 tool is in the release directory 
instead of the debug directory. I copied the qdoc3 from the release to 
the debug directory and now it works. I do get a lot of the following, 
but I assume these are known issues.

    C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-20080325/doc/src/licenses
    .qdoc:422: Cannot tie this documentation to anything
        [I found a /*! ... */ comment, but there was no topical command
    (e.g., '\fn'
    , '\page') in the comment and no function definition following the
    comment.]
    C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-20080325/src/corelib/tool
    s/qshareddata.cpp:361: Cannot find 'operator T *(...)' in '\fn'
        [I cannot find any function of that name with the specified
    signature. Make
    sure that the signature is identical to the declaration, including
    'const' quali
    fiers.]
    C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-20080325/src/corelib/tool
    s/qshareddata.cpp:367: Cannot find 'operator const T *(...)' in '\fn'
        [I cannot find any function of that name with the specified
    signature. Make
    sure that the signature is identical to the declaration, including
    'const' quali
    fiers.]
    C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-20080325/src/corelib/tool
    s/qshareddata.cpp:371: Cannot find 'data(...)' in '\fn'
        [I cannot find any function of that name with the specified
    signature. Make
    sure that the signature is identical to the declaration, including
    'const' quali
    fiers.]
    C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-20080325/doc/src/snippets
    /code/src.gui.util.qdesktopservices.cpp:16: Hostile character 0x40
    in C++ source

    C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-20080325/doc/src/snippets
    /code/doc.src.gpl.qdoc:1018: Unterminated C++ character literal


Message 4 in thread

Oops, forgot flat text.
Thiago Macieira schreef:
> T. Landman wrote:
>   
>> I have tried 4.4 with the Visual Studio 2008 compiler and everything
>> seems to compile. However, when I start the assistant or the demo
>> program none of the documentation is available. There is a bunch of
>> *.qdoc files under the src/doc tree. Is there some kind of make command
>> I have to specify to get the documentation created?
>>     
>
> The documentation is pre-generated in the beta 1 packages. If you're 
> trying a snapshot, you have to run:
> 	nmake docs
>
>   
With the 20080325 snapshot I get an error that the qdoc3 tool isn't found

            (cd
    C:\Users\theo\dev\qt-win-commercial-src-4.4.0-snapshot-20080325/tool
    s/qdoc3/test && set
    QT_BUILD_TREE=C:\Users\theo\dev\qt-win-commercial-src-4.4.0-
    snapshot-20080325&& set
    QT_SOURCE_TREE=C:\Users\theo\dev\qt-win-commercial-src-4
    .4.0-snapshot-20080325&&
    C:\Users\theo\dev\qt-win-commercial-src-4.4.0-snapshot-
    20080325/tools/qdoc3/debug/qdoc3 -Ddesktopedition
    qt-build-docs.qdocconf)
    C:\Users\theo\dev\qt-win-commercial-src-4.4.0-snapshot-20080325/tools/qdoc3/debu
    g/qdoc3 wordt niet herkend als een interne
    of externe opdracht, programma of batchbestand.
    NMAKE : fatal error U1077: '(cd' : return code '0x1'
    Stop.

I think the problem is that the qdoc3 tool is in the release directory 
instead of the debug directory. I copied the qdoc3 from the release to 
the debug directory and now it works. I do get a lot of the following, 
but I assume these are known issues.

    C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-20080325/doc/src/licenses
    .qdoc:422: Cannot tie this documentation to anything
        [I found a /*! ... */ comment, but there was no topical command
    (e.g., '\fn'
    , '\page') in the comment and no function definition following the
    comment.]
    C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-20080325/src/corelib/tool
    s/qshareddata.cpp:361: Cannot find 'operator T *(...)' in '\fn'
        [I cannot find any function of that name with the specified
    signature. Make
    sure that the signature is identical to the declaration, including
    'const' quali
    fiers.]
    C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-20080325/src/corelib/tool
    s/qshareddata.cpp:367: Cannot find 'operator const T *(...)' in '\fn'
        [I cannot find any function of that name with the specified
    signature. Make
    sure that the signature is identical to the declaration, including
    'const' quali
    fiers.]
    C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-20080325/src/corelib/tool
    s/qshareddata.cpp:371: Cannot find 'data(...)' in '\fn'
        [I cannot find any function of that name with the specified
    signature. Make
    sure that the signature is identical to the declaration, including
    'const' quali
    fiers.]
    C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-20080325/doc/src/snippets
    /code/src.gui.util.qdesktopservices.cpp:16: Hostile character 0x40
    in C++ source

    C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-20080325/doc/src/snippets
    /code/doc.src.gpl.qdoc:1018: Unterminated C++ character literal


To unsubscribe - send "unsubscribe" in the subject to qt4-preview-feedback-request@xxxxxxxxxxxxx


Message 5 in thread

Hi all,
As I said in another e-mail sent to this mailing list, the problem is solved
replacing (in the doc.pri file)

win32 {
    QT_WINCONFIG = release
    CONFIG(debug, debug|release) {
        QT_WINCONFIG = release
    }
}

With

win32 {
    QT_WINCONFIG = release
}

I hope this change will be part of the next snapshot.

Thank you very much for your attention.

Massimo


> With the 20080325 snapshot I get an error that the qdoc3 tool isn't
> found
> 
>             (cd
>     C:\Users\theo\dev\qt-win-commercial-src-4.4.0-snapshot-
> 20080325/tool
>     s/qdoc3/test && set
>     QT_BUILD_TREE=C:\Users\theo\dev\qt-win-commercial-src-4.4.0-
>     snapshot-20080325&& set
>     QT_SOURCE_TREE=C:\Users\theo\dev\qt-win-commercial-src-4
>     .4.0-snapshot-20080325&&
>     C:\Users\theo\dev\qt-win-commercial-src-4.4.0-snapshot-
>     20080325/tools/qdoc3/debug/qdoc3 -Ddesktopedition
>     qt-build-docs.qdocconf)
>     C:\Users\theo\dev\qt-win-commercial-src-4.4.0-snapshot-
> 20080325/tools/qdoc3/debu
>     g/qdoc3 wordt niet herkend als een interne
>     of externe opdracht, programma of batchbestand.
>     NMAKE : fatal error U1077: '(cd' : return code '0x1'
>     Stop.
> 
> I think the problem is that the qdoc3 tool is in the release directory
> instead of the debug directory. I copied the qdoc3 from the release to
> the debug directory and now it works. I do get a lot of the following,
> but I assume these are known issues.
> 
>     C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-
> 20080325/doc/src/licenses
>     .qdoc:422: Cannot tie this documentation to anything
>         [I found a /*! ... */ comment, but there was no topical command
>     (e.g., '\fn'
>     , '\page') in the comment and no function definition following the
>     comment.]
>     C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-
> 20080325/src/corelib/tool
>     s/qshareddata.cpp:361: Cannot find 'operator T *(...)' in '\fn'
>         [I cannot find any function of that name with the specified
>     signature. Make
>     sure that the signature is identical to the declaration, including
>     'const' quali
>     fiers.]
>     C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-
> 20080325/src/corelib/tool
>     s/qshareddata.cpp:367: Cannot find 'operator const T *(...)' in
> '\fn'
>         [I cannot find any function of that name with the specified
>     signature. Make
>     sure that the signature is identical to the declaration, including
>     'const' quali
>     fiers.]
>     C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-
> 20080325/src/corelib/tool
>     s/qshareddata.cpp:371: Cannot find 'data(...)' in '\fn'
>         [I cannot find any function of that name with the specified
>     signature. Make
>     sure that the signature is identical to the declaration, including
>     'const' quali
>     fiers.]
>     C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-
> 20080325/doc/src/snippets
>     /code/src.gui.util.qdesktopservices.cpp:16: Hostile character 0x40
>     in C++ source
> 
>     C:/Users/theo/dev/qt-win-commercial-src-4.4.0-snapshot-
> 20080325/doc/src/snippets
>     /code/doc.src.gpl.qdoc:1018: Unterminated C++ character literal
> 
> 
> To unsubscribe - send "unsubscribe" in the subject to qt4-preview-
> feedback-request@xxxxxxxxxxxxx

To unsubscribe - send "unsubscribe" in the subject to qt4-preview-feedback-request@xxxxxxxxxxxxx