Add comments about default processing in DialogProc/WindowProc, since I

often forget the rules.

[originally from svn r5532]

diff --git a/windows/windlg.c b/windows/windlg.c
index 0fd1acb8b02d143acc2dd675138dd7aef281d71b..59c0112a2656dfdf7f8dd80aaf08624e8d39e661 100644 (file)
--- a/windows/windlg.c
+++ b/windows/windlg.c
@@ -362,6 +362,8 @@ static void create_controls(HWND hwnd, char *path)
 
 /*
  * This function is the configuration box.
+ * (Being a dialog procedure, in general it returns 0 if the default
+ * dialog processing should be performed, and 1 if it should not.)
  */
 static int CALLBACK GenericMainDlgProc(HWND hwnd, UINT msg,
                                       WPARAM wParam, LPARAM lParam)

diff --git a/windows/window.c b/windows/window.c
index 05f0c618489ca001f9706a29d6a3cd5b4a09ef98..6046cf7ac5c9308b5b494d746000d64e7795f673 100644 (file)
--- a/windows/window.c
+++ b/windows/window.c
@@ -2934,6 +2934,10 @@ static LRESULT CALLBACK WndProc(HWND hwnd, UINT message,
        }
     }
 
+    /*
+     * Any messages we don't process completely above are passed through to
+     * DefWindowProc() for default processing.
+     */
     return DefWindowProc(hwnd, message, wParam, lParam);
 }