Как создать документацию? Опции

[SABROG]

Скомпилил Qt из репозитория, скомпилил QtCreator из репозитория. В креаторе документация не находится, ассистент не показывает ничего, т.к. нет зарегистрированных документаций. А они видимо в реестре прописываются, а я ветку грохнул спецом. Как её сгенерить? Раньше ассистент вроде бы сам как-то индексировал, а сейчас ничего не происходит.

---
Не знаю в правильном ли я направлении полез. Набрал такую команду:

C:\SABROG\Qt46\qt\tools\qdoc3>release\qdoc3.exe test\qt.qdocconf

И получил дофига ошибок:

Раскрывающийся текст

c:/SABROG/Qt46/qt/src/3rdparty/webkit/WebKit/qt/Api/qwebhistory.cpp:540: Cannot
find 'operator<<(...)' 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:/SABROG/Qt46/qt/src/3rdparty/webkit/WebKit/qt/Api/qwebhistory.cpp:556: Cannot
find 'operator>>(...)' 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:/SABROG/Qt46/qt/src/gui/widgets/qabstractspinbox.cpp:898: Undocumented paramet
er 'event' in QAbstractSpinBox::keyPressEvent()
c:/SABROG/Qt46/qt/src/gui/graphicsview/qgraphicsscene.cpp:4147: Undocumented par
ameter 'watched' in QGraphicsScene::eventFilter()
c:/SABROG/Qt46/qt/src/gui/graphicsview/qgraphicsscene.cpp:4147: Undocumented par
ameter 'event' in QGraphicsScene::eventFilter()
c:/SABROG/Qt46/qt/doc/src/qnamespace.qdoc:816: Undocumented enum item 'WA_TouchP
adAcceptSingleTouchEvents' in Qt::WidgetAttribute
c:/SABROG/Qt46/qt/src/testlib/qtesttouch.h:141: No documentation for 'QTest::tou
chEvent()'
c:/SABROG/Qt46/qt/src/testlib/qtesttouch.h:75: No documentation for 'QTest::QTou
chEventSequence::~QTouchEventSequence()'
c:/SABROG/Qt46/qt/src/testlib/qtesttouch.h:94: No documentation for 'QTest::QTou
chEventSequence::release()'
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2660: Undocumented parameter 'valueDefaul
t' in QXmlDefaultHandler::attributeDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2660: Undocumented parameter 'aName' in Q
XmlDefaultHandler::attributeDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2660: Undocumented parameter 'eName' in Q
XmlDefaultHandler::attributeDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2660: Undocumented parameter 'type' in QX
mlDefaultHandler::attributeDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2660: Undocumented parameter 'value' in Q
XmlDefaultHandler::attributeDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2474: Undocumented parameter 'ch' in QXml
DefaultHandler::characters()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2650: Undocumented parameter 'ch' in QXml
DefaultHandler::comment()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2463: Undocumented parameter 'namespaceUR
I' in QXmlDefaultHandler::endElement()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2463: Undocumented parameter 'qName' in Q
XmlDefaultHandler::endElement()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2463: Undocumented parameter 'localName'
in QXmlDefaultHandler::endElement()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2620: Undocumented parameter 'name' in QX
mlDefaultHandler::endEntity()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2442: Undocumented parameter 'prefix' in
QXmlDefaultHandler::endPrefixMapping()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2525: Undocumented parameter 'exception'
in QXmlDefaultHandler::error()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2680: Undocumented parameter 'publicId' i
n QXmlDefaultHandler::externalEntityDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2680: Undocumented parameter 'name' in QX
mlDefaultHandler::externalEntityDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2680: Undocumented parameter 'systemId' i
n QXmlDefaultHandler::externalEntityDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2535: Undocumented parameter 'exception'
in QXmlDefaultHandler::fatalError()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2484: Undocumented parameter 'ch' in QXml
DefaultHandler::ignorableWhitespace()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2670: Undocumented parameter 'value' in Q
XmlDefaultHandler::internalEntityDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2670: Undocumented parameter 'name' in QX
mlDefaultHandler::internalEntityDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2545: Undocumented parameter 'publicId' i
n QXmlDefaultHandler::notationDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2545: Undocumented parameter 'name' in QX
mlDefaultHandler::notationDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2545: Undocumented parameter 'systemId' i
n QXmlDefaultHandler::notationDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2494: Undocumented parameter 'target' in
QXmlDefaultHandler::processingInstruction()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2494: Undocumented parameter 'data' in QX
mlDefaultHandler::processingInstruction()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2567: Undocumented parameter 'publicId' i
n QXmlDefaultHandler::resolveEntity()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2567: Undocumented parameter 'systemId' i
n QXmlDefaultHandler::resolveEntity()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2403: Undocumented parameter 'locator' in
 QXmlDefaultHandler::setDocumentLocator()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2505: Undocumented parameter 'name' in QX
mlDefaultHandler::skippedEntity()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2590: Undocumented parameter 'publicId' i
n QXmlDefaultHandler::startDTD()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2590: Undocumented parameter 'name' in QX
mlDefaultHandler::startDTD()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2590: Undocumented parameter 'systemId' i
n QXmlDefaultHandler::startDTD()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2452: Undocumented parameter 'namespaceUR
I' in QXmlDefaultHandler::startElement()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2452: Undocumented parameter 'atts' in QX
mlDefaultHandler::startElement()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2452: Undocumented parameter 'qName' in Q
XmlDefaultHandler::startElement()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2452: Undocumented parameter 'localName'
in QXmlDefaultHandler::startElement()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2610: Undocumented parameter 'name' in QX
mlDefaultHandler::startEntity()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2432: Undocumented parameter 'prefix' in
QXmlDefaultHandler::startPrefixMapping()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2432: Undocumented parameter 'uri' in QXm
lDefaultHandler::startPrefixMapping()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2556: Undocumented parameter 'publicId' i
n QXmlDefaultHandler::unparsedEntityDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2556: Undocumented parameter 'notationNam
e' in QXmlDefaultHandler::unparsedEntityDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2556: Undocumented parameter 'name' in QX
mlDefaultHandler::unparsedEntityDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2556: Undocumented parameter 'systemId' i
n QXmlDefaultHandler::unparsedEntityDecl()
c:/SABROG/Qt46/qt/src/xml/sax/qxml.cpp:2515: Undocumented parameter 'exception'
in QXmlDefaultHandler::warning()
c:/SABROG/Qt46/qt/src/corelib/animation/qpropertyanimation.cpp:269: Undocumented
 parameter 'newState' in QPropertyAnimation::updateState()
c:/SABROG/Qt46/qt/src/corelib/animation/qpropertyanimation.cpp:269: Undocumented
 parameter 'oldState' in QPropertyAnimation::updateState()
c:/SABROG/Qt46/qt/src/gui/itemviews/qcolumnview.cpp:347: Undocumented parameter
'cursorAction' in QColumnView::moveCursor()
c:/SABROG/Qt46/qt/src/gui/itemviews/qcolumnview.cpp:347: Undocumented parameter
'modifiers' in QColumnView::moveCursor()
c:/SABROG/Qt46/qt/src/qt3support/widgets/q3datetimeedit.cpp:2669: Missing parame
ter name
c:/SABROG/Qt46/qt/src/corelib/io/qtemporaryfile.cpp:746: Undocumented parameter
'flags' in QTemporaryFile::open()
c:/SABROG/Qt46/qt/src/gui/graphicsview/qgraphicssceneevent.h:337: No documentati
on for 'QGraphicsSceneGestureEvent::accept()'
c:/SABROG/Qt46/qt/src/gui/graphicsview/qgraphicssceneevent.cpp:1895: Undocumente
d parameter 'type' in QGraphicsSceneGestureEvent::accept()
c:/SABROG/Qt46/qt/src/gui/graphicsview/qgraphicssceneevent.cpp:1910: Undocumente
d parameter 'type' in QGraphicsSceneGestureEvent::accept()
c:/SABROG/Qt46/qt/src/gui/kernel/qgesture.h:89: No documentation for 'QGesture::
accept()'
c:/SABROG/Qt46/qt/src/gui/kernel/qgesture.h:90: No documentation for 'QGesture::
ignore()'
c:/SABROG/Qt46/qt/src/gui/kernel/qapplication.cpp:5095: Cannot link to 'QWidget:
:grabGesture' in QApplication::eventDeliveryDelayForGestures
c:/SABROG/Qt46/qt/src/gui/kernel/qapplication.cpp:5066: Cannot link to 'Qt::AA_E
nableGestures' in QApplication::addGestureRecognizer()
c:/SABROG/Qt46/qt/src/gui/kernel/qapplication.cpp:5080: Cannot link to 'Qt::AA_E
nableGestures' in QApplication::removeGestureRecognizer()
c:/SABROG/Qt46/qt/src/qt3support/sql/q3datatable.cpp:613: Undocumented parameter
 'row' in Q3DataTable::createEditor()
c:/SABROG/Qt46/qt/src/qt3support/sql/q3datatable.cpp:1719: Undocumented paramete
r 'cg' in Q3DataTable::paintCell()
c:/SABROG/Qt46/qt/src/qt3support/sql/q3datatable.cpp:1719: Cannot link to 'QSql:
:isNull()' in Q3DataTable::paintCell()
c:/SABROG/Qt46/qt/src/qt3support/sql/q3datatable.cpp:1548: Undocumented paramete
r 'r' in Q3DataTable::setNumCols()
c:/SABROG/Qt46/qt/src/qt3support/sql/q3datatable.cpp:1535: Undocumented paramete
r 'r' in Q3DataTable::setNumRows()
c:/SABROG/Qt46/qt/src/gui/kernel/qgesturerecognizer.cpp:122: Undocumented parame
ter 'result' in QGestureRecognizer::stateChanged()
c:/SABROG/Qt46/qt/src/gui/kernel/qevent.h:739: No documentation for 'QGestureEve
nt::accept()'
c:/SABROG/Qt46/qt/src/gui/styles/qwindowsvistastyle.cpp:1543: Undocumented param
eter 'painter' in QWindowsVistaStyle::drawComplexControl()
c:/SABROG/Qt46/qt/src/gui/styles/qwindowsvistastyle.cpp:1543: Undocumented param
eter 'widget' in QWindowsVistaStyle::drawComplexControl()
c:/SABROG/Qt46/qt/src/gui/styles/qwindowsvistastyle.cpp:1543: Undocumented param
eter 'option' in QWindowsVistaStyle::drawComplexControl()
c:/SABROG/Qt46/qt/src/gui/styles/qwindowsvistastyle.cpp:1543: Undocumented param
eter 'control' in QWindowsVistaStyle::drawComplexControl()
c:/SABROG/Qt46/qt/src/gui/styles/qwindowsvistastyle.cpp:879: Undocumented parame
ter 'painter' in QWindowsVistaStyle::drawControl()
c:/SABROG/Qt46/qt/src/gui/styles/qwindowsvistastyle.cpp:879: Undocumented parame
ter 'widget' in QWindowsVistaStyle::drawControl()
c:/SABROG/Qt46/qt/src/gui/styles/qwindowsvistastyle.cpp:879: Undocumented parame
ter 'option' in QWindowsVistaStyle::drawControl()
c:/SABROG/Qt46/qt/src/gui/styles/qwindowsvistastyle.cpp:879: Undocumented parame
ter 'element' in QWindowsVistaStyle::drawControl()
c:/SABROG/Qt46/qt/src/gui/styles/qwindowsvistastyle.cpp:310: Undocumented parame
ter 'painter' in QWindowsVistaStyle::drawPrimitive()
c:/SABROG/Qt46/qt/src/gui/styles/qwindowsvistastyle.cpp:310: Undocumented parame
ter 'widget' in QWindowsVistaStyle::drawPrimitive()
c:/SABROG/Qt46/qt/src/gui/styles/qwindowsvistastyle.cpp:310: Undocumented parame
ter 'option' in QWindowsVistaStyle::drawPrimitive()
c:/SABROG/Qt46/qt/src/gui/styles/qwindowsvistastyle.cpp:310: Undocumented parame
ter 'element' in QWindowsVistaStyle::drawPrimitive()
c:/SABROG/Qt46/qt/src/gui/itemviews/qheaderview.cpp:2697: Missing parameter name

c:/SABROG/Qt46/qt/src/gui/itemviews/qheaderview.cpp:2697: Missing parameter name

c:/SABROG/Qt46/qt/src/gui/itemviews/qheaderview.cpp:2697: No such parameter 'fla
gs' in QHeaderView::setSelection()
c:/SABROG/Qt46/qt/src/gui/itemviews/qheaderview.cpp:2697: No such parameter 'rec
t' in QHeaderView::setSelection()

Да и результата не получил, файлик чтоль должен был какой появится?

Сообщение отредактировал SABROG - 3.7.2009, 12:32

[kuzulis]

Доброго времени.

Подниму эту ветку.


А как собственно, используя утилиту qdoc3 сгенерировать *.qch файлы (и т.п.) для открытия в ассистенте и т.п. ?

Я взял (как написано в документации к QDoc : http://doc.qt.nokia.com/qdoc/index.html) ,
создал минимальный файлик qserialdevice.qdocconf

# QDoc is a tool that constantly evolves to suit our needs,
# and there are some compatibility issues between old and new
# practices. For that reason, any QDoc configuration file needs to
# include compat.qdocconf.

#include(compat.qdocconf)

# The outputdir variable specifies the directory
# where QDoc will put the generated documentation.

outputdir = html

# The headerdirs variable specifies the directories
# containing the header files associated
# with the .cpp source files used in the documentation.

headerdirs = .

# The sourcedirs variable specifies the
# directories containing the .cpp or .qdoc
# files used in the documentation.

sourcedirs = .

# The exampledirs variable specifies the directories containing
# the source code of the example files.

exampledirs = .

# The imagedirs variable specifies the
# directories containing the images used in the documentation.

imagedirs = ./images

для своего проекта (правда, комменты в проекте в Doxygen стиле, но это ничего ),
запустил

qdoc3.exe ./qserialdevice.qdocconf

оно мне ругнулось на кучу неправильных комментов, но в итоге создало мне *.html файлы.

Так вот, можно ли сразу генерить *.qch файлы и как вообще происходит процесс перевода документации на русский?

Сообщение отредактировал kuzulis - 27.4.2011, 15:31