From 98804946f289fe8ab866cc7bf3383a29057f9251 Mon Sep 17 00:00:00 2001
From: Laszlo Papp <lpapp@kde.org>
Date: Wed, 15 Aug 2012 06:37:01 +0100
Subject: Make the "\internal" qdoc command stand on its own line

The qdoc manual currently claims that the command must stand on its own line.

The change follows the consistency with the rest and how the example looks like
inside the qdoc manual for this command.

Change-Id: I6b653dc95cf9d84e4adf32220dace5d313678419
Reviewed-by: Casper van Donderen <casper.vandonderen@nokia.com>
---
 src/corelib/tools/qbytearraymatcher.cpp |  6 ++++--
 src/corelib/tools/qdatetime.cpp         | 19 ++++++++++++++-----
 src/corelib/tools/qlocale.cpp           |  4 +++-
 src/corelib/tools/qregexp.cpp           |  3 ++-
 src/corelib/tools/qstringbuilder.cpp    |  3 ++-
 5 files changed, 25 insertions(+), 10 deletions(-)

(limited to 'src/corelib/tools')

diff --git a/src/corelib/tools/qbytearraymatcher.cpp b/src/corelib/tools/qbytearraymatcher.cpp
index c69602138e..17ae2cbe88 100644
--- a/src/corelib/tools/qbytearraymatcher.cpp
+++ b/src/corelib/tools/qbytearraymatcher.cpp
@@ -245,7 +245,8 @@ static int findChar(const char *str, int len, char ch, int from)
     return -1;
 }
 
-/*! \internal
+/*!
+    \internal
  */
 static int qFindByteArrayBoyerMoore(
     const char *haystack, int haystackLen, int haystackOffset,
@@ -264,7 +265,8 @@ static int qFindByteArrayBoyerMoore(
         hashHaystack -= (a) << sl_minus_1; \
     hashHaystack <<= 1
 
-/*! \internal
+/*!
+    \internal
  */
 int qFindByteArray(
     const char *haystack0, int haystackLen, int from,
diff --git a/src/corelib/tools/qdatetime.cpp b/src/corelib/tools/qdatetime.cpp
index ae56783e52..8c9944b001 100644
--- a/src/corelib/tools/qdatetime.cpp
+++ b/src/corelib/tools/qdatetime.cpp
@@ -3576,7 +3576,8 @@ QDateTime QDateTime::fromString(const QString &string, const QString &format)
     \sa toTimeSpec()
 */
 
-/*! \internal
+/*!
+    \internal
  */
 void QDateTime::detach()
 {
@@ -4355,7 +4356,9 @@ int QDateTimeParser::sectionPos(const SectionNode &sn) const
 
 
 /*!
-  \internal helper function for parseFormat. removes quotes that are
+  \internal
+
+  helper function for parseFormat. removes quotes that are
   not escaped and removes the escaping on those that are escaped
 
 */
@@ -5257,7 +5260,8 @@ end:
 
 #ifndef QT_NO_TEXTDATE
 /*!
-  \internal finds the first possible monthname that \a str1 can
+  \internal
+  finds the first possible monthname that \a str1 can
   match. Starting from \a index; str should already by lowered
 */
 
@@ -5551,7 +5555,9 @@ QDateTimeParser::FieldInfo QDateTimeParser::fieldInfo(int index) const
 }
 
 /*!
-  \internal Get a number that str can become which is between min
+  \internal
+
+  Get a number that str can become which is between min
   and max or -1 if this is not possible.
 */
 
@@ -5593,7 +5599,10 @@ QString QDateTimeParser::sectionFormat(Section s, int count) const
 }
 
 
-/*! \internal Returns true if str can be modified to represent a
+/*!
+  \internal
+
+  Returns true if str can be modified to represent a
   number that is within min and max.
 */
 
diff --git a/src/corelib/tools/qlocale.cpp b/src/corelib/tools/qlocale.cpp
index 128ac5f4e8..8016efd7b0 100644
--- a/src/corelib/tools/qlocale.cpp
+++ b/src/corelib/tools/qlocale.cpp
@@ -441,7 +441,9 @@ QSystemLocale::QSystemLocale()
         system_data->m_language_id = 0;
 }
 
-/*! \internal */
+/*!
+    \internal
+*/
 QSystemLocale::QSystemLocale(bool)
 { }
 
diff --git a/src/corelib/tools/qregexp.cpp b/src/corelib/tools/qregexp.cpp
index 54b8103b3b..0f3b67d16a 100644
--- a/src/corelib/tools/qregexp.cpp
+++ b/src/corelib/tools/qregexp.cpp
@@ -1311,7 +1311,8 @@ struct QRegExpLookahead
 };
 #endif
 
-/*! \internal
+/*!
+    \internal
     convert the pattern string to the RegExp syntax.
 
     This is also used by QScriptEngine::newRegExp to convert to a pattern that JavaScriptCore can understan
diff --git a/src/corelib/tools/qstringbuilder.cpp b/src/corelib/tools/qstringbuilder.cpp
index 2aeb891d23..1696c5694a 100644
--- a/src/corelib/tools/qstringbuilder.cpp
+++ b/src/corelib/tools/qstringbuilder.cpp
@@ -105,7 +105,8 @@ QT_BEGIN_NAMESPACE
  */
 
 
-/*! \internal
+/*!
+    \internal
  */
 void QAbstractConcatenable::convertFromAscii(const char *a, int len, QChar *&out)
 {
-- 
cgit v1.2.3