Changeset 46475 in vbox for trunk/src/bldprogs/VBoxDef2LazyLoad.cpp

Timestamp:

Jun 10, 2013 4:08:43 PM (11 years ago)

Author:

vboxsync

Message:

sans debug noise, pluss docs.

File:

• trunk/src/bldprogs/VBoxDef2LazyLoad.cpp (modified) (7 diffs)

trunk/src/bldprogs/VBoxDef2LazyLoad.cpp

@@ -2 +2 @@
 /** @file
  * VBoxDef2LazyLoad - Lazy Library Loader Generator.
+ *
+ * @note Only tested on win.amd64.
  */
 
@@ -132 +134 @@
 #define WORD_CMP(pszWord1, cchWord1, szWord2) \
             ( (cchWord1) == sizeof(szWord2) - 1 && memcmp(pszWord1, szWord2, sizeof(szWord2) - 1) == 0 )
-fprintf(stderr,"word: %u: cchWord0=%d '%s'\n", iLine, cchWord0, psz);
         if (WORD_CMP(psz, cchWord0, "EXPORTS"))
         {
@@ -278 +279 @@
 
 
+/**
+ * Generates the assembly source code, writing it to @a pOutput.
+ *
+ * @returns RTEXITCODE_SUCCESS or RTEXITCODE_FAILURE, in the latter case full
+ *          details has been displayed.
+ * @param   pOutput              The output stream (caller checks it for errors
+ *                               when closing).
+ */
 static RTEXITCODE generateOutputInner(FILE *pOutput)
 {
@@ -493 +502 @@
 
 
+/**
+ * Generates the assembly source code, writing it to g_pszOutput.
+ *
+ * @returns RTEXITCODE_SUCCESS or RTEXITCODE_FAILURE, in the latter case full
+ *          details has been displayed.
+ */
 static RTEXITCODE generateOutput(void)
 {
@@ -512 +527 @@
 
 
+/**
+ * Displays usage information.
+ *
+ * @returns RTEXITCODE_SUCCESS.
+ * @param   pszArgv0            The argv[0] string.
+ */
 static int usage(const char *pszArgv0)
 {
@@ -551 +572 @@
                 g_pszLibrary = argv[i];
             }
+            /** @todo Support different load methods so this can be used on system libs and
+             *        such if we like. */
             else if (   !strcmp(psz, "--help")
                      || !strcmp(psz, "-help")
@@ -567 +590 @@
                 return RTEXITCODE_SYNTAX;
             }
-
         }
         else