QLatin1String: documentation updates

Some updates for QLatin1String documentation:
- Update signatures of some methods
- Update outdated description for several methods
- Add missing docs for friend operators
- Wrap descriptions at 80 characters

Task-number: QTBUG-87962
Change-Id: I1c3c5ce2a6f4f57f92ab503a734c8244fe7cd7c5
Reviewed-by: Mårten Nordheim <marten.nordheim@qt.io>
Reviewed-by: Karsten Heimrich <karsten.heimrich@qt.io>
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
(cherry picked from commit 5545b0f1d3ae6e0f4db56484debe3ac0f25635ed)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>

1 files changed, 246 insertions, 61 deletions

diff --git a/src/corelib/text/qstring.cpp b/src/corelib/text/qstring.cpp
index 27e26a3f2d..56914840cc 100644
--- a/src/corelib/text/qstring.cpp
+++ b/src/corelib/text/qstring.cpp
@@ -8588,11 +8588,11 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     Many of QString's member functions are overloaded to accept
     \c{const char *} instead of QString. This includes the copy
     constructor, the assignment operator, the comparison operators,
-    and various other functions such as \l{QString::insert()}{insert()}, \l{QString::replace()}{replace()},
-    and \l{QString::indexOf()}{indexOf()}. These functions
-    are usually optimized to avoid constructing a QString object for
-    the \c{const char *} data. For example, assuming \c str is a
-    QString,
+    and various other functions such as \l{QString::insert()}{insert()},
+    \l{QString::replace()}{replace()}, and \l{QString::indexOf()}{indexOf()}.
+    These functions are usually optimized to avoid constructing a
+    QString object for the \c{const char *} data. For example,
+    assuming \c str is a QString,
 
     \snippet code/src_corelib_text_qstring.cpp 3
 
@@ -8629,7 +8629,8 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     in the first place. In those cases, using QStringLiteral may be
     the better option.
 
-    \sa QString, QLatin1Char, {QStringLiteral()}{QStringLiteral}, QT_NO_CAST_FROM_ASCII
+    \sa QString, QLatin1Char, {QStringLiteral()}{QStringLiteral},
+    QT_NO_CAST_FROM_ASCII
 */
 
 /*!
@@ -8763,7 +8764,7 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 */
 
 /*!
-    \fn QLatin1String::toString() const
+    \fn QString QLatin1String::toString() const
     \since 6.0
 
     Converts this Latin-1 string into a QString. Equivalent to
@@ -8782,7 +8783,7 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     Returns the Latin-1 string stored in this object.
 */
 
-/*! \fn QLatin1String::size() const
+/*! \fn qsizetype QLatin1String::size() const
 
     Returns the size of the Latin-1 string stored in this object.
 
@@ -8919,14 +8920,15 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 */
 
 /*!
-    \fn int QLatin1String::indexOf(QStringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \fn int QLatin1String::indexOf(QLatin1String l1, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \fn int QLatin1String::indexOf(QChar c, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
+    \fn qsizetype QLatin1String::indexOf(QStringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
+    \fn qsizetype QLatin1String::indexOf(QLatin1String l1, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
+    \fn qsizetype QLatin1String::indexOf(QChar c, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
     \since 5.14
 
-    Returns the index position of the first occurrence of the string-view \a str,
-    Latin-1 string \a l1, or character \a ch, respectively, in this Latin-1 string,
-    searching forward from index position \a from. Returns -1 if \a str is not found.
+    Returns the index position of the first occurrence of the string-view
+    \a str, Latin-1 string \a l1, or character \a ch, respectively, in this
+    Latin-1 string, searching forward from index position \a from.
+    Returns -1 if \a str is not found.
 
     If \a cs is Qt::CaseSensitive (default), the search is case
     sensitive; otherwise the search is case insensitive.
@@ -8943,39 +8945,44 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \fn bool QLatin1String::contains(QChar c, Qt::CaseSensitivity cs) const
     \since 5.14
 
-    Returns \c true if this Latin-1 string contains an occurrence of the string-view
-    \a str, Latin-1 string \a l1, or character \a ch; otherwise returns \c false.
+    Returns \c true if this Latin-1 string contains an occurrence of the
+    string-view \a str, Latin-1 string \a l1, or character \a ch;
+    otherwise returns \c false.
 
     If \a cs is Qt::CaseSensitive (the default), the search is
     case-sensitive; otherwise the search is case-insensitive.
 
-    \sa indexOf(), QStringView::contains(), QStringView::indexOf(), QString::indexOf()
+    \sa indexOf(), QStringView::contains(), QStringView::indexOf(),
+    QString::indexOf()
 */
 
 /*!
-    \fn int QLatin1String::lastIndexOf(QStringView str, qsizetype from, Qt::CaseSensitivity cs) const
-    \fn int QLatin1String::lastIndexOf(QLatin1String l1, qsizetype from, Qt::CaseSensitivity cs) const
-    \fn int QLatin1String::lastIndexOf(QChar c, qsizetype from, Qt::CaseSensitivity cs) const
+    \fn qsizetype QLatin1String::lastIndexOf(QStringView str, qsizetype from, Qt::CaseSensitivity cs) const
+    \fn qsizetype QLatin1String::lastIndexOf(QLatin1String l1, qsizetype from, Qt::CaseSensitivity cs) const
+    \fn qsizetype QLatin1String::lastIndexOf(QChar c, qsizetype from, Qt::CaseSensitivity cs) const
     \since 5.14
 
     Returns the index position of the last occurrence of the string-view \a str,
-    Latin-1 string \a l1, or character \a ch, respectively, in this Latin-1 string,
-    searching backward from index position \a from. If \a from is -1 (default),
-    the search starts at the last character; if \a from is -2, at the next to last
-    character and so on. Returns -1 if \a str is not found.
+    Latin-1 string \a l1, or character \a ch, respectively, in this Latin-1
+    string, searching backward from index position \a from.
+    Returns -1 if \a str is not found.
+
+    If \a from is -1 (default), the search starts at the last character;
+    if \a from is -2, at the next to last character and so on.
 
     If \a cs is Qt::CaseSensitive (default), the search is case
     sensitive; otherwise the search is case insensitive.
 
-    \sa indexOf(), QStringView::lastIndexOf(), QStringView::indexOf(), QString::indexOf()
+    \sa indexOf(), QStringView::lastIndexOf(), QStringView::indexOf(),
+    QString::indexOf()
 */
 
 /*!
     \fn QLatin1String::const_iterator QLatin1String::begin() const
     \since 5.10
 
-    Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the first character in
-    the string.
+    Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the
+    first character in the string.
 
     This function is provided for STL compatibility.
 
@@ -8997,8 +9004,8 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \fn QLatin1String::const_iterator QLatin1String::end() const
     \since 5.10
 
-    Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the imaginary
-    character after the last character in the list.
+    Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the
+    imaginary character after the last character in the list.
 
     This function is provided for STL compatibility.
 
@@ -9019,8 +9026,8 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \fn QLatin1String::const_reverse_iterator QLatin1String::rbegin() const
     \since 5.10
 
-    Returns a const \l{STL-style iterators}{STL-style} reverse iterator pointing to the first
-    character in the string, in reverse order.
+    Returns a const \l{STL-style iterators}{STL-style} reverse iterator pointing
+    to the first character in the string, in reverse order.
 
     This function is provided for STL compatibility.
 
@@ -9042,8 +9049,8 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \fn QLatin1String::const_reverse_iterator QLatin1String::rend() const
     \since 5.10
 
-    Returns a \l{STL-style iterators}{STL-style} reverse iterator pointing to one past
-    the last character in the string, in reverse order.
+    Returns a \l{STL-style iterators}{STL-style} reverse iterator pointing to
+    one past the last character in the string, in reverse order.
 
     This function is provided for STL compatibility.
 
@@ -9068,8 +9075,8 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     Returns the substring of length \a length starting at position
     \a start in this Latin-1 string.
 
-    If you know that \a start and \a length cannot be out of bounds, use sliced()
-    instead in new code, because it is faster.
+    If you know that \a start and \a length cannot be out of bounds, use
+    sliced() instead in new code, because it is faster.
 
     Returns an empty Latin-1 string if \a start exceeds the
     length of this Latin-1 string. If there are less than \a length characters
@@ -9113,7 +9120,7 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 */
 
 /*!
-    \fn QLatin1String::first(qsizetype n) const
+    \fn QLatin1String QLatin1String::first(qsizetype n) const
     \since 6.0
 
     Returns a Latin-1 string that contains the first \a n characters
@@ -9125,7 +9132,7 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 */
 
 /*!
-    \fn QLatin1String::last(qsizetype n) const
+    \fn QLatin1String QLatin1String::last(qsizetype n) const
     \since 6.0
 
     Returns a Latin-1 string that contains the last \a n characters
@@ -9137,7 +9144,7 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 */
 
 /*!
-    \fn QLatin1String::sliced(qsizetype pos, qsizetype n) const
+    \fn QLatin1String QLatin1String::sliced(qsizetype pos, qsizetype n) const
     \since 6.0
 
     Returns a Latin-1 string that points to \a n characters of this
@@ -9150,7 +9157,7 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 */
 
 /*!
-    \fn QLatin1String::sliced(qsizetype pos) const
+    \fn QLatin1String QLatin1String::sliced(qsizetype pos) const
     \since 6.0
 
     Returns a Latin-1 string starting at position \a pos in this
@@ -9215,7 +9222,9 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 /*!
     \fn bool QLatin1String::operator==(const char *other) const
     \since 4.3
-    \overload
+
+    Returns \c true if the string is equal to const char pointer \a other;
+    otherwise returns \c false.
 
     The \a other const char pointer is converted to a QString using
     the QString::fromUtf8() function.
@@ -9224,6 +9233,8 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \l QT_NO_CAST_FROM_ASCII when you compile your applications. This
     can be useful if you want to ensure that all user-visible strings
     go through QObject::tr(), for example.
+
+    \sa {Comparing Strings}
 */
 
 /*!
@@ -9243,7 +9254,9 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 /*!
     \fn bool QLatin1String::operator!=(const char *other) const
     \since 4.3
-    \overload operator!=()
+
+    Returns \c true if this string is not equal to const char pointer \a other;
+    otherwise returns \c false.
 
     The \a other const char pointer is converted to a QString using
     the QString::fromUtf8() function.
@@ -9252,6 +9265,8 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \l QT_NO_CAST_FROM_ASCII when you compile your applications. This
     can be useful if you want to ensure that all user-visible strings
     go through QObject::tr(), for example.
+
+    \sa {Comparing Strings}
 */
 
 /*!
@@ -9271,7 +9286,9 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 /*!
     \fn bool QLatin1String::operator>(const char *other) const
     \since 4.3
-    \overload
+
+    Returns \c true if this string is lexically greater than const char pointer
+    \a other; otherwise returns \c false.
 
     The \a other const char pointer is converted to a QString using
     the QString::fromUtf8() function.
@@ -9280,6 +9297,8 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     when you compile your applications. This can be useful if you want
     to ensure that all user-visible strings go through QObject::tr(),
     for example.
+
+    \sa {Comparing Strings}
 */
 
 /*!
@@ -9287,7 +9306,7 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \since 5.0
     \overload
 
-    The \a other const char pointer is converted to a QString using
+    The \a other byte array is converted to a QString using
     the QString::fromUtf8() function.
 
     You can disable this operator by defining \l QT_NO_CAST_FROM_ASCII
@@ -9299,7 +9318,9 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 /*!
     \fn bool QLatin1String::operator<(const char *other) const
     \since 4.3
-    \overload
+
+    Returns \c true if this string is lexically less than const char pointer
+    \a other; otherwise returns \c false.
 
     The \a other const char pointer is converted to a QString using
     the QString::fromUtf8() function.
@@ -9308,6 +9329,8 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \l QT_NO_CAST_FROM_ASCII when you compile your applications. This
     can be useful if you want to ensure that all user-visible strings
     go through QObject::tr(), for example.
+
+    \sa {Comparing Strings}
 */
 
 /*!
@@ -9315,7 +9338,7 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \since 5.0
     \overload
 
-    The \a other const char pointer is converted to a QString using
+    The \a other byte array is converted to a QString using
     the QString::fromUtf8() function.
 
     You can disable this operator by defining
@@ -9327,7 +9350,9 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 /*!
     \fn bool QLatin1String::operator>=(const char *other) const
     \since 4.3
-    \overload
+
+    Returns \c true if this string is lexically greater than or equal to
+    const char pointer \a other; otherwise returns \c false.
 
     The \a other const char pointer is converted to a QString using
     the QString::fromUtf8() function.
@@ -9336,6 +9361,8 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \l QT_NO_CAST_FROM_ASCII when you compile your applications. This
     can be useful if you want to ensure that all user-visible strings
     go through QObject::tr(), for example.
+
+    \sa {Comparing Strings}
 */
 
 /*!
@@ -9343,7 +9370,7 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \since 5.0
     \overload
 
-    The \a other array is converted to a QString using
+    The \a other byte array is converted to a QString using
     the QString::fromUtf8() function.
 
     You can disable this operator by defining
@@ -9355,7 +9382,9 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 /*!
     \fn bool QLatin1String::operator<=(const char *other) const
     \since 4.3
-    \overload
+
+    Returns \c true if this string is lexically less than or equal to
+    const char pointer \a other; otherwise returns \c false.
 
     The \a other const char pointer is converted to a QString using
     the QString::fromUtf8() function.
@@ -9364,6 +9393,8 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \l QT_NO_CAST_FROM_ASCII when you compile your applications. This
     can be useful if you want to ensure that all user-visible strings
     go through QObject::tr(), for example.
+
+    \sa {Comparing Strings}
 */
 
 /*!
@@ -9371,7 +9402,7 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
     \since 5.0
     \overload
 
-    The \a other array is converted to a QString using
+    The \a other byte array is converted to a QString using
     the QString::fromUtf8() function.
 
     You can disable this operator by defining
@@ -9382,35 +9413,189 @@ QString &QString::setRawData(const QChar *unicode, qsizetype size)
 
 /*! \fn bool QLatin1String::operator==(QLatin1String s1, QLatin1String s2)
 
-   Returns \c true if string \a s1 is lexically equal to string \a s2; otherwise
-   returns \c false.
+    Returns \c true if string \a s1 is lexically equal to string \a s2;
+    otherwise returns \c false.
 */
 /*! \fn bool QLatin1String::operator!=(QLatin1String s1, QLatin1String s2)
 
-   Returns \c true if string \a s1 is lexically unequal to string \a s2; otherwise
-   returns \c false.
+    Returns \c true if string \a s1 is lexically unequal to string \a s2;
+    otherwise returns \c false.
 */
 /*! \fn bool QLatin1String::operator<(QLatin1String s1, QLatin1String s2)
 
-   Returns \c true if string \a s1 is lexically smaller than string \a s2; otherwise
-   returns \c false.
+    Returns \c true if string \a s1 is lexically smaller than string \a s2;
+    otherwise returns \c false.
 */
 /*! \fn bool QLatin1String::operator<=(QLatin1String s1, QLatin1String s2)
 
-   Returns \c true if string \a s1 is lexically smaller than or equal to string \a s2; otherwise
-   returns \c false.
+    Returns \c true if string \a s1 is lexically smaller than or equal to
+    string \a s2; otherwise returns \c false.
 */
 /*! \fn bool QLatin1String::operator>(QLatin1String s1, QLatin1String s2)
 
-   Returns \c true if string \a s1 is lexically greater than string \a s2; otherwise
-   returns \c false.
+    Returns \c true if string \a s1 is lexically greater than string \a s2;
+    otherwise returns \c false.
 */
 /*! \fn bool QLatin1String::operator>=(QLatin1String s1, QLatin1String s2)
 
-   Returns \c true if string \a s1 is lexically greater than or equal to
-   string \a s2; otherwise returns \c false.
+    Returns \c true if string \a s1 is lexically greater than or equal
+    to string \a s2; otherwise returns \c false.
+*/
+
+/*! \fn bool QLatin1String::operator==(QChar ch, QLatin1String s)
+
+    Returns \c true if char \a ch is lexically equal to string \a s;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator<(QChar ch, QLatin1String s)
+
+    Returns \c true if char \a ch is lexically smaller than string \a s;
+    otherwise returns \c false.
 */
+/*! \fn bool QLatin1String::operator>(QChar ch, QLatin1String s)
 
+    Returns \c true if char \a ch is lexically greater than string \a s;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator!=(QChar ch, QLatin1String s)
+
+    Returns \c true if char \a ch is lexically not equal to string \a s;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator<=(QChar ch, QLatin1String s)
+
+    Returns \c true if char \a ch is lexically smaller than or equal to
+    string \a s; otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator>=(QChar ch, QLatin1String s)
+
+    Returns \c true if char \a ch is lexically greater than or equal to
+    string \a s; otherwise returns \c false.
+*/
+
+/*! \fn bool QLatin1String::operator==(QLatin1String s, QChar ch)
+
+    Returns \c true if string \a s is lexically equal to char \a ch;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator<(QLatin1String s, QChar ch)
+
+    Returns \c true if string \a s is lexically smaller than char \a ch;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator>(QLatin1String s, QChar ch)
+
+    Returns \c true if string \a s is lexically greater than char \a ch;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator!=(QLatin1String s, QChar ch)
+
+    Returns \c true if string \a s is lexically not equal to char \a ch;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator<=(QLatin1String s, QChar ch)
+
+    Returns \c true if string \a s is lexically smaller than or equal to
+    char \a ch; otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator>=(QLatin1String s, QChar ch)
+
+    Returns \c true if string \a s is lexically greater than or equal to
+    char \a ch; otherwise returns \c false.
+*/
+
+/*! \fn bool QLatin1String::operator==(QStringView s1, QLatin1String s2)
+
+    Returns \c true if string view \a s1 is lexically equal to string \a s2;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator<(QStringView s1, QLatin1String s2)
+
+    Returns \c true if string view \a s1 is lexically smaller than string \a s2;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator>(QStringView s1, QLatin1String s2)
+
+    Returns \c true if string view \a s1 is lexically greater than string \a s2;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator!=(QStringView s1, QLatin1String s2)
+
+    Returns \c true if string view \a s1 is lexically not equal to string \a s2;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator<=(QStringView s1, QLatin1String s2)
+
+    Returns \c true if string view \a s1 is lexically smaller than or equal to
+    string \a s2; otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator>=(QStringView s1, QLatin1String s2)
+
+    Returns \c true if string view \a s1 is lexically greater than or equal to
+    string \a s2; otherwise returns \c false.
+*/
+
+/*! \fn bool QLatin1String::operator==(QLatin1String s1, QStringView s2)
+
+    Returns \c true if string \a s1 is lexically equal to string view \a s2;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator<(QLatin1String s1, QStringView s2)
+
+    Returns \c true if string \a s1 is lexically smaller than string view \a s2;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator>(QLatin1String s1, QStringView s2)
+
+    Returns \c true if string \a s1 is lexically greater than string view \a s2;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator!=(QLatin1String s1, QStringView s2)
+
+    Returns \c true if string \a s1 is lexically not equal to string view \a s2;
+    otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator<=(QLatin1String s1, QStringView s2)
+
+    Returns \c true if string \a s1 is lexically smaller than or equal to
+    string view \a s2; otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator>=(QLatin1String s1, QStringView s2)
+
+    Returns \c true if string \a s1 is lexically greater than or equal to
+    string view \a s2; otherwise returns \c false.
+*/
+
+/*! \fn bool QLatin1String::operator==(const char *s1, QLatin1String s2)
+
+    Returns \c true if const char pointer \a s1 is lexically equal to
+    string \a s2; otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator<(const char *s1, QLatin1String s2)
+
+    Returns \c true if const char pointer \a s1 is lexically smaller than
+    string \a s2; otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator>(const char *s1, QLatin1String s2)
+
+    Returns \c true if const char pointer \a s1 is lexically greater than
+    string \a s2; otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator!=(const char *s1, QLatin1String s2)
+
+    Returns \c true if const char pointer \a s1 is lexically not equal to
+    string \a s2; otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator<=(const char *s1, QLatin1String s2)
+
+    Returns \c true if const char pointer \a s1 is lexically smaller than or
+    equal to string \a s2; otherwise returns \c false.
+*/
+/*! \fn bool QLatin1String::operator>=(const char *s1, QLatin1String s2)
+
+    Returns \c true if const char pointer \a s1 is lexically greater than or
+    equal to string \a s2; otherwise returns \c false.
+*/
 
 #if !defined(QT_NO_DATASTREAM) || (defined(QT_BOOTSTRAPPED) && !defined(QT_BUILD_QMAKE))
 /*!