minor: fix/improve doc comments

awesomerc.lua

@@ -395,13 +395,13 @@ client.connect_signal("manage", function (c)
         -- i.e. put it at the end of others instead of setting it master.
         -- awful.client.setslave(c)
 
-        -- Put windows in a smart way, only if they does not set an initial position.
+        -- Put windows in a smart way, only if they do not set an initial position.
         if not c.size_hints.user_position and not c.size_hints.program_position then
             awful.placement.no_overlap(c)
             awful.placement.no_offscreen(c)
         end
     elseif not c.size_hints.user_position and not c.size_hints.program_position then
-        -- Prevent clients from being unreachable after screen count change
+        -- Prevent clients from being unreachable after screen count changes.
         awful.placement.no_offscreen(c)
     end
 

common/lualib.h

@@ -26,7 +26,7 @@
 
 #include "common/util.h"
 
-/** Lua function to call on dofuction() error */
+/** Lua function to call on dofunction() error */
 lua_CFunction lualib_dofunction_on_error;
 
 void luaA_checkfunction(lua_State *, int);

keygrabber.c

@@ -75,7 +75,7 @@ is_control(char *buf)
 /** Handle keypress event.
  * \param L Lua stack to push the key pressed.
  * \param e Received XKeyEvent.
- * \return True if a key was successfully get, false otherwise.
+ * \return True if a key was successfully retrieved, false otherwise.
  */
 bool
 keygrabber_handlekpress(lua_State *L, xcb_key_press_event_t *e)

lib/awful/keygrabber.lua

@@ -80,11 +80,11 @@ end
 --   end)
 -- end
 function keygrabber.run(g)
-    -- Remove the grabber if its in stack
+    -- Remove the grabber if it is in the stack.
     keygrabber.stop(g)
-    -- Record the grabber has latest added
+    -- Record the grabber that has been added most recently.
     table.insert(grabbers, 1, g)
-    -- start the keygrabber if its not running already
+    -- Start the keygrabber if it is not running already.
     if not keygrabbing then
         keygrabbing = true
         capi.keygrabber.run(grabber)

lib/awful/rules.lua

@@ -214,8 +214,7 @@ function rules.execute(c, props, callbacks)
         end
     end
 
-    -- Do this at last so we do not erase things done by the focus
+    -- Do this at last so we do not erase things done by the focus signal.
-    -- signal.
     if props.focus and (type(props.focus) ~= "function" or props.focus(c)) then
         c:emit_signal('request::activate', "rules", {raise=true})
     end

xrdb.c

@@ -39,7 +39,7 @@ static void xrdb_init(void) {
     /**/
 
     if (!(globalconf.xrmdb = XrmGetDatabase(globalconf.display)))
-      warn("Can't open xrdb\n");
+      warn("Cannot open xrdb.");
   }
 }