Continue documentation cleanup

public/fpdf_fwlevent.h

 // Copyright 2014 PDFium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com
 
 #ifndef PUBLIC_FPDF_FWLEVENT_H_
 #define PUBLIC_FPDF_FWLEVENT_H_
 
 #include "fpdfview.h"
 
 #ifdef __cplusplus
 extern "C" {
-#endif
+#endif  // __cplusplus
 
 typedef int FPDF_INT32;
 typedef unsigned int FPDF_UINT32;
 typedef float FPDF_FLOAT;
-// event type
+
+// Event types.
 typedef enum {
   FWL_EVENTTYPE_Mouse = 0,
   FWL_EVENTTYPE_MouseWheel,
   FWL_EVENTTYPE_Key,
 } FWL_EVENTTYPE;
 
-// key flag
+// Key flags.
 typedef enum {
   FWL_EVENTFLAG_ShiftKey = 1 << 0,
   FWL_EVENTFLAG_ControlKey = 1 << 1,
   FWL_EVENTFLAG_AltKey = 1 << 2,
   FWL_EVENTFLAG_MetaKey = 1 << 3,
   FWL_EVENTFLAG_KeyPad = 1 << 4,
   FWL_EVENTFLAG_AutoRepeat = 1 << 5,
   FWL_EVENTFLAG_LeftButtonDown = 1 << 6,
   FWL_EVENTFLAG_MiddleButtonDown = 1 << 7,
   FWL_EVENTFLAG_RightButtonDown = 1 << 8,
 } FWL_EVENTFLAG;
 
-// Mouse message command
+// Mouse messages.
 typedef enum {
   FWL_EVENTMOUSECMD_LButtonDown = 1,
   FWL_EVENTMOUSECMD_LButtonUp,
   FWL_EVENTMOUSECMD_LButtonDblClk,
   FWL_EVENTMOUSECMD_RButtonDown,
   FWL_EVENTMOUSECMD_RButtonUp,
   FWL_EVENTMOUSECMD_RButtonDblClk,
   FWL_EVENTMOUSECMD_MButtonDown,
   FWL_EVENTMOUSECMD_MButtonUp,
   FWL_EVENTMOUSECMD_MButtonDblClk,
   FWL_EVENTMOUSECMD_MouseMove,
   FWL_EVENTMOUSECMD_MouseEnter,
   FWL_EVENTMOUSECMD_MouseHover,
   FWL_EVENTMOUSECMD_MouseLeave,
 } FWL_EVENT_MOUSECMD;
 
-// mouse event
+// Mouse events.
 struct FWL_EVENT_MOUSE {
   FPDF_UINT32 command;
   FPDF_DWORD flag;
   FPDF_FLOAT x;
   FPDF_FLOAT y;
 };
 
-// mouse wheel
+// Mouse wheel events.
 struct FWL_EVENT_MOUSEWHEEL {
   FPDF_DWORD flag;
   FPDF_FLOAT x;
   FPDF_FLOAT y;
   FPDF_FLOAT deltaX;
   FPDF_FLOAT deltaY;
 };
 
-// virtual keycode
+// Virtual keycodes.
 typedef enum {
   FWL_VKEY_Back = 0x08,
   FWL_VKEY_Tab = 0x09,
   FWL_VKEY_Clear = 0x0C,
   FWL_VKEY_Return = 0x0D,
   FWL_VKEY_Shift = 0x10,
   FWL_VKEY_Control = 0x11,
   FWL_VKEY_Menu = 0x12,
   FWL_VKEY_Pause = 0x13,
   FWL_VKEY_Capital = 0x14,
@@ skipping 151 matching lines @@
   FWL_VKEY_Exsel = 0xF8,
   FWL_VKEY_Ereof = 0xF9,
   FWL_VKEY_Play = 0xFA,
   FWL_VKEY_Zoom = 0xFB,
   FWL_VKEY_NoName = 0xFC,
   FWL_VKEY_PA1 = 0xFD,
   FWL_VKEY_OEM_Clear = 0xFE,
   FWL_VKEY_Unknown = 0,
 } FWL_VKEYCODE;
 
-// key event command
+// Key event commands.
 typedef enum {
   FWL_EVENTKEYCMD_KeyDown = 1,
   FWL_EVENTKEYCMD_KeyUp,
   FWL_EVENTKEYCMD_Char,
 } FWL_EVENTKEYCMD;
 
-// key event
+// Key events.
 struct FWL_EVENT_KEY {
   FPDF_UINT32 command;
   FPDF_DWORD flag;
   union {
     // Virtual key code.
     FPDF_UINT32 vkcode;
     // Character code.
     FPDF_DWORD charcode;
   } code;
 };
 
-// event type
+// Event types.
 struct FWL_EVENT {
-  // structure size.
+  // Structure size.
   FPDF_UINT32 size;
   // FWL_EVENTTYPE.
   FPDF_UINT32 type;
   union {
     struct FWL_EVENT_MOUSE mouse;
     struct FWL_EVENT_MOUSEWHEEL wheel;
     struct FWL_EVENT_KEY key;
   } s;
 };
 
 #ifdef __cplusplus
-}
-#endif
+}  // extern "C"
+#endif  // __cplusplus
 
 #endif  // PUBLIC_FPDF_FWLEVENT_H_