diff --git a/src/x11/x11_enable.c b/src/x11/x11_enable.c
index 3bd84a9f..507fc856 100644
--- a/src/x11/x11_enable.c
+++ b/src/x11/x11_enable.c
@@ -31,9 +31,9 @@
 #include "internal.h"
 
 
-//************************************************************************
-//****               Platform implementation functions                ****
-//************************************************************************
+//////////////////////////////////////////////////////////////////////////
+//////                       GLFW platform API                      //////
+//////////////////////////////////////////////////////////////////////////
 
 //========================================================================
 // Enable system keys
diff --git a/src/x11/x11_fullscreen.c b/src/x11/x11_fullscreen.c
index dbad9801..5a584636 100644
--- a/src/x11/x11_fullscreen.c
+++ b/src/x11/x11_fullscreen.c
@@ -34,15 +34,11 @@
 #include <stdlib.h>
 
 
-//************************************************************************
-//****                  GLFW internal functions                       ****
-//************************************************************************
-
 //========================================================================
 // Convert BPP to RGB bits (based on "best guess")
 //========================================================================
 
-static void BPP2RGB(int bpp, int* r, int* g, int* b)
+static void bpp2rgb(int bpp, int* r, int* g, int* b)
 {
     int delta;
 
@@ -61,6 +57,10 @@ static void BPP2RGB(int bpp, int* r, int* g, int* b)
 }
 
 
+//////////////////////////////////////////////////////////////////////////
+//////                       GLFW internal API                      //////
+//////////////////////////////////////////////////////////////////////////
+
 //========================================================================
 // Finds the video mode closest in size to the specified desired size
 //========================================================================
@@ -331,10 +331,9 @@ void _glfwRestoreVideoMode(int screen)
 }
 
 
-
-//************************************************************************
-//****               Platform implementation functions                ****
-//************************************************************************
+//////////////////////////////////////////////////////////////////////////
+//////                       GLFW platform API                      //////
+//////////////////////////////////////////////////////////////////////////
 
 struct _glfwResolution
 {
@@ -392,7 +391,7 @@ int _glfwPlatformGetVideoModes(GLFWvidmode* list, int maxcount)
             depth = vislist[k].depth;
 
             // Convert to RGB
-            BPP2RGB(depth, &r, &g, &b);
+            bpp2rgb(depth, &r, &g, &b);
             depth = (r << 16) | (g << 8) | b;
 
             // Is this mode unique?
@@ -467,8 +466,8 @@ int _glfwPlatformGetVideoModes(GLFWvidmode* list, int maxcount)
         rescount = 1;
         resarray = (struct _glfwResolution*) malloc(sizeof(struct _glfwResolution) * rescount);
 
-        resarray[ 0 ].width = DisplayWidth(dpy, screen);
-        resarray[ 0 ].height = DisplayHeight(dpy, screen);
+        resarray[0].width = DisplayWidth(dpy, screen);
+        resarray[0].height = DisplayHeight(dpy, screen);
     }
 
     // Build permutations of colors and resolutions
@@ -517,7 +516,7 @@ void _glfwPlatformGetDesktopMode(GLFWvidmode* mode)
     bpp = DefaultDepth(dpy, screen);
 
     // Convert BPP to RGB bits
-    BPP2RGB(bpp, &mode->redBits, &mode->greenBits, &mode->blueBits);
+    bpp2rgb(bpp, &mode->redBits, &mode->greenBits, &mode->blueBits);
 
 #if defined(_GLFW_HAS_XRANDR)
     if (_glfwLibrary.X11.XRandR.available)
diff --git a/src/x11/x11_glext.c b/src/x11/x11_glext.c
index aaef1583..d3bac333 100644
--- a/src/x11/x11_glext.c
+++ b/src/x11/x11_glext.c
@@ -52,9 +52,9 @@ void (*glXGetProcAddressEXT(const GLubyte* procName))();
 #endif
 
 
-//************************************************************************
-//****               Platform implementation functions                ****
-//************************************************************************
+//////////////////////////////////////////////////////////////////////////
+//////                       GLFW internal API                      //////
+//////////////////////////////////////////////////////////////////////////
 
 //========================================================================
 // Check if an OpenGL extension is available at runtime
@@ -65,7 +65,6 @@ int _glfwPlatformExtensionSupported(const char* extension)
     const GLubyte* extensions;
 
     // Get list of GLX extensions
-    // Yuck
     extensions = (const GLubyte*) glXQueryExtensionsString(_glfwLibrary.X11.display,
                                                            _glfwLibrary.X11.screen);
     if (extensions != NULL)
diff --git a/src/x11/x11_init.c b/src/x11/x11_init.c
index aaf90a5d..1d566bf0 100644
--- a/src/x11/x11_init.c
+++ b/src/x11/x11_init.c
@@ -33,10 +33,6 @@
 #include <stdio.h>
 
 
-//************************************************************************
-//****                  GLFW internal functions                       ****
-//************************************************************************
-
 //========================================================================
 // Dynamically load libraries
 //========================================================================
@@ -183,9 +179,9 @@ static void terminateDisplay(void)
 }
 
 
-//************************************************************************
-//****               Platform implementation functions                ****
-//************************************************************************
+//////////////////////////////////////////////////////////////////////////
+//////                       GLFW platform API                      //////
+//////////////////////////////////////////////////////////////////////////
 
 //========================================================================
 // Initialize various GLFW state
@@ -244,6 +240,7 @@ int _glfwPlatformTerminate(void)
     return GL_TRUE;
 }
 
+
 //========================================================================
 // Get the GLFW version string
 //========================================================================
diff --git a/src/x11/x11_joystick.c b/src/x11/x11_joystick.c
index 3a2f3dc1..5bbe3f9c 100644
--- a/src/x11/x11_joystick.c
+++ b/src/x11/x11_joystick.c
@@ -37,10 +37,6 @@
 //========================================================================
 
 
-//************************************************************************
-//****                  GLFW internal functions                       ****
-//************************************************************************
-
 #ifdef _GLFW_USE_LINUX_JOYSTICKS
 
 //------------------------------------------------------------------------
@@ -73,6 +69,10 @@ struct js_event {
 #endif // _GLFW_USE_LINUX_JOYSTICKS
 
 
+//////////////////////////////////////////////////////////////////////////
+//////                       GLFW internal API                      //////
+//////////////////////////////////////////////////////////////////////////
+
 //========================================================================
 // Initialize joystick interface
 //========================================================================
@@ -255,9 +255,9 @@ static void pollJoystickEvents(void)
 }
 
 
-//************************************************************************
-//****               Platform implementation functions                ****
-//************************************************************************
+//////////////////////////////////////////////////////////////////////////
+//////                       GLFW platform API                      //////
+//////////////////////////////////////////////////////////////////////////
 
 //========================================================================
 // Determine joystick capabilities
diff --git a/src/x11/x11_time.c b/src/x11/x11_time.c
index 62b574b3..414793b7 100644
--- a/src/x11/x11_time.c
+++ b/src/x11/x11_time.c
@@ -49,9 +49,9 @@ void _glfwInitTimer(void)
 }
 
 
-//************************************************************************
-//****               Platform implementation functions                ****
-//************************************************************************
+//////////////////////////////////////////////////////////////////////////
+//////                       GLFW platform API                      //////
+//////////////////////////////////////////////////////////////////////////
 
 //========================================================================
 // Return timer value in seconds
diff --git a/src/x11/x11_window.c b/src/x11/x11_window.c
index 2825d853..e178fabf 100644
--- a/src/x11/x11_window.c
+++ b/src/x11/x11_window.c
@@ -50,9 +50,9 @@
 #define _NET_WM_STATE_TOGGLE        2
 
 
-//************************************************************************
-//****                  GLFW internal functions                       ****
-//************************************************************************
+//////////////////////////////////////////////////////////////////////////
+//////                       GLFW internal API                      //////
+//////////////////////////////////////////////////////////////////////////
 
 //========================================================================
 // Checks whether the event is a MapNotify for the specified window
@@ -1366,10 +1366,9 @@ static void processSingleEvent(void)
 }
 
 
-
-//************************************************************************
-//****               Platform implementation functions                ****
-//************************************************************************
+//////////////////////////////////////////////////////////////////////////
+//////                       GLFW platform API                      //////
+//////////////////////////////////////////////////////////////////////////
 
 //========================================================================
 // Here is where the window is created, and