sal: fix numerous doxygen warnings

Change-Id: I2fd3fb7b67a62d349ff917466b08c75c19dcbff6

include/osl/diagnose.h

@@ -27,7 +27,8 @@
 #include <sal/saldllapi.h>
 #include <sal/types.h>
 
-/** @file Provides simple diagnostic support.
+/** @file
+    Provides simple diagnostic support.
 
     @deprecated
     The facilities provided by this header are deprecated.  True assertions

include/osl/file.h

@@ -547,6 +547,8 @@ SAL_DLLPUBLIC oslFileError SAL_CALL osl_getVolumeDeviceMountPath(
 #define osl_VolumeInfo_Mask_DeviceHandle           0x00000080L
 #define osl_VolumeInfo_Mask_FileSystemCaseHandling 0x00000100L
 
+/** @} */
+
 /** Structure containing information about volumes
 
     @see    osl_getVolumeInformation()

include/osl/socket_decl.hxx

@@ -89,7 +89,7 @@ namespace osl
 
         /** Converts the address to a (human readable) domain-name.
 
-            @param pResult[out] value of 0 if you are not interested in errors,
+            @param[out] pResult value of 0 if you are not interested in errors,
                            otherwise *pResult contains an error code on failure
                            or osl_Socket_Ok on success
 
@@ -101,7 +101,7 @@ namespace osl
 
         /** Sets the IP address or hostname of the SocketAddress
 
-           @param sDottedIpOrHostname[in]   IP address or hostname
+           @param[in] sDottedIpOrHostname   IP address or hostname
 
            @retval true     success
            @retval false    failure
@@ -116,7 +116,7 @@ namespace osl
 
         /** Sets the port number of the address.
 
-           @param nPort[in] port number
+           @param[in] nPort port number
 
            @retval true     success
            @retval false    failure

include/rtl/character.hxx

@@ -244,7 +244,7 @@ template<typename T> inline bool isAsciiOctalDigit(T code)
     @param code  A Unicode code point.
 
     @return  True if code is an ASCII white space character as defined by C for
-    isspace in the "C" locale (ASCII ' ', '\f', '\n', '\r', '\t' '\v').
+    isspace in the "C" locale (ASCII ' ', '\\f', '\\n', '\\r', '\\t' '\\v').
 
     @since LibreOffice 5.4
 */

include/sal/log.hxx

@@ -346,6 +346,8 @@ inline char const * unwrapStream(SAL_UNUSED_PARAMETER StreamIgnore const &) {
   This macro is meant to be used only while working on code and should never
   exist in production code.
 
+  @param stream input stream
+
   @param backtraceDepth a sal_uInt32 value indicating the maximum backtrace
   depth; zero means no backtrace