Some comments in the examples

examples/events.cpp

@@ -1,18 +1,30 @@
+/**
+ * This programs handle events and dump them to console
+ */
+
 #include <iostream>
 
 #include <i3ipc++/ipc.hpp>
 
 
 int  main() {
+	// First of all we need to connect to an i3 process
 	i3ipc::connection  conn;
+
+	// Then we subscribing on events (see i3ipc::EVENT_TYPE)
 	conn.subscribe(i3ipc::ET_WORKSPACE | i3ipc::ET_WINDOW | i3ipc::ET_BINDING);
 
+	// Handler of workspace_event
 	conn.signal_workspace_event.connect([](const i3ipc::workspace_event_t&  ev) {
 		std::cout << "workspace_event: " << (char)ev.type << std::endl;
 	});
+
+	// Handler of window_event
 	conn.signal_window_event.connect([](const i3ipc::window_event_t&  ev) {
 		std::cout << "window_event: " << (char)ev.type << std::endl;
 	});
+
+	// Handler of binding event
 	conn.signal_binding_event.connect([](const i3ipc::binding_t&  b) {
 		std::cout << "binding_event:" << std::endl
 			<< "\tcommand = \"" << b.command << '"' << std::endl
@@ -25,6 +37,7 @@ int  main() {
 		}
 	});
 
+	// And starting an event-handling loop
 	while (true) {
 		conn.handle_event();
 	}