https://bugs.documentfoundation.org/show_bug.cgi?id=163743
Bug ID: 163743
Summary: Doxygen-generated API documentation graphs are erratic
Product: LibreOffice
Version: unspecified
Hardware: All
OS: All
Status: UNCONFIRMED
Keywords: topicDoc
Severity: normal
Priority: medium
Component: sdk
Assignee: [email protected]
Reporter: [email protected]
CC: [email protected],
[email protected],
[email protected]
Look at [1]. It describes DrawingDocumentDrawView service, defined at [2]. The
service has two *optional* interfaces: XWindow and XFormLayerAccess. This is
shown on the documentation's graph, with the optional interfaces connected by
greenish dashed arrows, as opposed to solid blue arrows connecting mandatory
interfaces.
On the same graph, there shown Controller service included into
DrawingDocumentDrawView; and its own interfaces. They, too, have
"optional"/"mandatory" arrows: XController, XDispatchController,
XContextMenuInterception, XUserInputInterception are marged using the dashed
greenish arrows, and XSelectionSupplier and XTransferableSupplier are marked
with solid blue arrows.
Now look at the dedicated documentation page for Controller service [3], and
its definition [4]. The four dashed greenish arrows connect different set of
interfaces on [3], namely, XContextMenuInterception, XUserInputInterception,
XSelectionSupplier, and XTransferableSupplier; and the two other - XController
and XDispatchController - are marked with solid blue. This correspond to the
"[optional]" in [4].
So in sum, the graphs in the API documentation may show incorrect optionality.
[1]
https://api.libreoffice.org/docs/idl/ref/servicecom_1_1sun_1_1star_1_1drawing_1_1DrawingDocumentDrawView.html
[2]
https://opengrok.libreoffice.org/xref/core/offapi/com/sun/star/drawing/DrawingDocumentDrawView.idl?r=5687eba4
[3]
https://api.libreoffice.org/docs/idl/ref/servicecom_1_1sun_1_1star_1_1frame_1_1Controller.html
[4]
https://opengrok.libreoffice.org/xref/core/offapi/com/sun/star/frame/Controller.idl?r=5687eba4
--
You are receiving this mail because:
You are the assignee for the bug.
