Changeset 16489 in vbox

Timestamp:

Feb 3, 2009 1:54:13 PM (16 years ago)

Author:

vboxsync

Message:

Improved comments.

File:

• trunk/src/VBox/Main/cbinding/cbinding.h (modified) (1 diff)

trunk/src/VBox/Main/cbinding/cbinding.h

@@ -39 +39 @@
 #endif
 
+/* Initialize/Uninitialize XPCOM. */
 VBOXXPCOMC_DECL(void) VBoxComInitialize(IVirtualBox **virtualBox, ISession **session);
 VBOXXPCOMC_DECL(void) VBoxComUninitialize(void);
+
+/* Deallocation functions. */
 VBOXXPCOMC_DECL(void) VBoxComUnallocStr(PRUnichar *str_dealloc);
 VBOXXPCOMC_DECL(void) VBoxComUnallocIID(nsIID *iid);
+VBOXXPCOMC_DECL(void) VBoxUtf16Free(PRUnichar *pwszString);
+VBOXXPCOMC_DECL(void) VBoxStrFree(char *pszString);
+
+/* Converting to and from ASCII. */
 VBOXXPCOMC_DECL(const char *) VBoxConvertPRUnichartoAscii(PRUnichar *src);
 VBOXXPCOMC_DECL(const PRUnichar *) VBoxConvertAsciitoPRUnichar(char *src);
+
+/* Converting to and from UTF-8. */
+VBOXXPCOMC_DECL(const char *) VBoxConvertPRUnichartoUTF8(PRUnichar *src);
 VBOXXPCOMC_DECL(const PRUnichar *) VBoxConvertUTF8toPRUnichar(char *src);
-VBOXXPCOMC_DECL(const char *) VBoxConvertPRUnichartoUTF8(PRUnichar *src);
+
+/* Converting to and from UTF-8 and UTF-16. */
 VBOXXPCOMC_DECL(int)  VBoxStrToUtf16(const char *pszString, PRUnichar **ppwszString);
 VBOXXPCOMC_DECL(int)  VBoxUtf16ToUtf8(const PRUnichar *pszString, char **ppwszString);
-VBOXXPCOMC_DECL(void) VBoxUtf16Free(PRUnichar *pwszString);
-VBOXXPCOMC_DECL(void) VBoxStrFree(char *pszString);
 
 #ifdef __cplusplus