Bug 639 – PySide should not depend on qdoc3 WebXML generator to create the documentation

PySide Bugzilla Closed for New Bugs

PySide is now a Qt Add-on and uses the Qt Project's JIRA Bug Tracker instead of this Bugzilla instance. This Bugzilla is left for reference purposes.

Bug 639 - PySide should not depend on qdoc3 WebXML generator to create the documentation

Summary:

PySide should not depend on qdoc3 WebXML generator to create the documentation

Status:	NEW

Product:	PySide
Classification:	Unclassified
Component:	Documentation
Version:	1.0.0 beta4
Platform:	All All

Importance:	P4 normal
Assigned To:	renato filho

URL:

Depends on:
Blocks:
	Show dependency tree / graph

Reported:	2011-01-24 17:45 EET by Hugo Parente Lima
Modified:	2012-03-08 16:57 EET (History)
CC List:	8 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.

Description Hugo Parente Lima 2011-01-24 17:45:04 EET

In Qt bug 16462 comments, a qdoc3 developer told that the WebXML generator
among other experimental generators will be removed from Qt.

http://bugreports.qt.nokia.com/browse/QTBUG-16462?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=139859#comment-139859

Nowadays PySide uses the XML output of qdoc3 WebXML generator to create the
PySide documentation, we need to find another solution like Doxygen, but we
don't known if Doxygen can correct parse all tags used in Qt documentation.

Comment 1 Matti Airas 2011-01-25 05:44:15 EET

Hugo, thanks a lot for catching this one.

I'm a bit undecided whether this should be P3 or P4. Assuming WebXML isn't
removed by the time we release 1.0, this could be P4, but in that case PySide
couldn't be built with later Qt versions. Making P3 - comment, if you want it
changed...

Comment 2 Hugo Parente Lima 2011-02-16 11:34:28 EET

Matti, I'm lowering the priority to P4 until qdoc3 WebXML generator being
removed from Qt, so we can fork qdoc3 only when necessary.

About the problem pointed by you that this PySide version *docs* wouldn't be
built with future versions of Qt isn't really a problem since we always specify
the Qt version supported by each PySide release.

Is it ok for you?

Comment 3 Matti Airas 2012-03-08 16:57:59 EET

PySide is now a Qt-addon and uses Qt Project's JIRA tool for tracking bugs.
Please verify that the bug is still valid and re-submit it in the address
below:

https://bugreports.qt-project.org/

Sorry for the inconvenience!