Doc: Fix \sa usage

Ensure comma between elements (4 missing), single space and curly-
braces around title elements, etc.

Change-Id: I7c6d5c31d00b30e48aa40455a66131843b3e70ee
Reviewed-by: Casper van Donderen <casper.vandonderen@nokia.com>

diff --git a/src/xmlpatterns/api/qcoloroutput.cpp b/src/xmlpatterns/api/qcoloroutput.cpp
index 02bcfce..e5b2118 100644 (file)
--- a/src/xmlpatterns/api/qcoloroutput.cpp
+++ b/src/xmlpatterns/api/qcoloroutput.cpp
@@ -202,11 +202,11 @@ const char *const ColorOutputPrivate::backgrounds[] =
   output.write("Jack, I'm only the selected official!", Error);
   \endcode
 
-  \sa {http://tldp.org/HOWTO/Bash-Prompt-HOWTO/x329.html}                        {Bash Prompt HOWTO, 6.1. Colours}
-     {http://linuxgazette.net/issue51/livingston-blade.html}                    {Linux Gazette, Tweaking Eterm, Edward Livingston-Blade}
-     {http://www.ecma-international.org/publications/standards/Ecma-048.htm}    {Standard ECMA-48, Control Functions for Coded Character Sets, ECMA International},
-     {http://en.wikipedia.org/wiki/ANSI_escape_code}                            {Wikipedia, ANSI escape code}
-     {http://linuxgazette.net/issue65/padala.html}                              {Linux Gazette, So You Like Color!, Pradeep Padala}
+  \sa {http://tldp.org/HOWTO/Bash-Prompt-HOWTO/x329.html}{Bash Prompt HOWTO, 6.1. Colours},
+      {http://linuxgazette.net/issue51/livingston-blade.html}{Linux Gazette, Tweaking Eterm, Edward Livingston-Blade},
+      {http://www.ecma-international.org/publications/standards/Ecma-048.htm}{Standard ECMA-48, Control Functions for Coded Character Sets, ECMA International},
+      {http://en.wikipedia.org/wiki/ANSI_escape_code}{Wikipedia, ANSI escape code},
+      {http://linuxgazette.net/issue65/padala.html}{Linux Gazette, So You Like Color!, Pradeep Padala}
  */
 
 /*!

diff --git a/src/xmlpatterns/api/qxmlname.cpp b/src/xmlpatterns/api/qxmlname.cpp
index 97b1921..0bee853 100644 (file)
--- a/src/xmlpatterns/api/qxmlname.cpp
+++ b/src/xmlpatterns/api/qxmlname.cpp
@@ -140,7 +140,7 @@ QT_BEGIN_NAMESPACE
   QXmlName represents what is sometimes called an \e {expanded QName},
   or simply a QName.
 
-  \sa {http://www.w3.org/TR/REC-xml-names/#NT-NCName} {Namespaces in XML 1.0 (Second Edition), [4] NCName}
+  \sa {http://www.w3.org/TR/REC-xml-names/#NT-NCName}{Namespaces in XML 1.0 (Second Edition), [4] NCName}
  */
 
 /*!
@@ -396,8 +396,7 @@ QString QXmlName::localName(const QXmlNamePool &namePool) const
 
   This function can be useful for debugging.
 
- \sa {http://www.jclark.com/xml/xmlns.htm} {XML Namespaces, James Clark}
- \sa fromClarkName()
+ \sa {http://www.jclark.com/xml/xmlns.htm}{XML Namespaces, James Clark}, fromClarkName()
  */
 QString QXmlName::toClarkName(const QXmlNamePool &namePool) const
 {
@@ -419,7 +418,7 @@ QXmlName &QXmlName::operator=(const QXmlName &other)
  e.g., the prefix or local name in an element or attribute,
  or the name of a variable.
 
- \sa {http://www.w3.org/TR/REC-xml-names/#NT-NCName} {Namespaces in XML 1.0 (Second Edition), [4] NCName}
+ \sa {http://www.w3.org/TR/REC-xml-names/#NT-NCName}{Namespaces in XML 1.0 (Second Edition), [4] NCName}
  */
 bool QXmlName::isNCName(const QString &candidate)
 {