From 1ad75d1169764b599bd5fe6d1a3d9c1745e9f5cc Mon Sep 17 00:00:00 2001 From: Topi Reinio Date: Wed, 24 Oct 2018 14:52:53 +0200 Subject: Doc: Fix \code command usage Since Qt 5.12, \code command accepts parameters, and in-line usage no longer works (and was never documented to work). Task-number: QTBUG-70980 Change-Id: I010ba21c2a20f70bfdacd7bb0c1aea3836c8efca Reviewed-by: Martin Smith --- .../itemmodel/doc/src/itemmodel.qdoc | 8 +++++-- src/datavisualization/data/qbar3dseries.cpp | 27 ++++++++++++---------- 2 files changed, 21 insertions(+), 14 deletions(-) diff --git a/examples/datavisualization/itemmodel/doc/src/itemmodel.qdoc b/examples/datavisualization/itemmodel/doc/src/itemmodel.qdoc index 3920a37c..9a66c26a 100644 --- a/examples/datavisualization/itemmodel/doc/src/itemmodel.qdoc +++ b/examples/datavisualization/itemmodel/doc/src/itemmodel.qdoc @@ -118,12 +118,16 @@ We created the data generator in the application main and gave it the graph and the table widget as parameters: - \code GraphDataGenerator generator(graph, tableWidget); \endcode + \code + GraphDataGenerator generator(graph, tableWidget); + \endcode We added a separate start method to the generator, so that it wouldn't start doing anything until everything else is set up. We then called the method when starting the application: - \code generator.start(); \endcode + \code + generator.start(); + \endcode Let's have a look at the contents of the \c start() method: diff --git a/src/datavisualization/data/qbar3dseries.cpp b/src/datavisualization/data/qbar3dseries.cpp index e2be7cc9..54b973e8 100644 --- a/src/datavisualization/data/qbar3dseries.cpp +++ b/src/datavisualization/data/qbar3dseries.cpp @@ -250,18 +250,21 @@ static inline float quaternionAngle(const QQuaternion &rotation) } /*! - * \property QBar3DSeries::meshAngle - * - * \brief The series rotation angle in degrees. - * - * Setting this property is equivalent to the following call: - * \code setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle)) \endcode - * - * \note When reading this property, it is calculated from the - * QAbstract3DSeries::meshRotation value - * using floating point precision and always returns a value from zero to 360 degrees. - * - * \sa QAbstract3DSeries::meshRotation + \property QBar3DSeries::meshAngle + + \brief The series rotation angle in degrees. + + Setting this property is equivalent to the following call: + + \code + setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle)) + \endcode + + \note When reading this property, it is calculated from the + QAbstract3DSeries::meshRotation value using floating point precision + and always returns a value from zero to 360 degrees. + + \sa QAbstract3DSeries::meshRotation */ void QBar3DSeries::setMeshAngle(float angle) { -- cgit v1.2.3