add missing function documentation

diff --git a/include/con.h b/include/con.h
index d5dc74e79d7cc6d2d6f1241a61c98940c809525d..0d4df204d33c5d41c40864fc250fefd17c415d5c 100644 (file)
--- a/include/con.h
+++ b/include/con.h
@@ -42,7 +42,11 @@ Con *con_get_output(Con *con);
  */
 Con *con_get_workspace(Con *con);
 
-
+/**
+ * Searches parenst of the given 'con' until it reaches one with the specified
+ * 'orientation'. Aborts when it comes across a floating_con.
+ *
+ */
 Con *con_parent_with_orientation(Con *con, orientation_t orientation);
 
 /**

diff --git a/include/workspace.h b/include/workspace.h
index b902f4903f988cbd5392e7bde257c05f213ee8d6..d903ea82338f677935f343ab36076ace74f85921 100644 (file)
--- a/include/workspace.h
+++ b/include/workspace.h
@@ -99,6 +99,12 @@ void workspace_map_clients(xcb_connection_t *conn, Workspace *ws);
  */
 void workspace_update_urgent_flag(Con *ws);
 
+/**
+ * 'Forces' workspace orientation by moving all cons into a new split-con with
+ * the same orientation as the workspace and then changing the workspace
+ * orientation.
+ *
+ */
 void ws_force_orientation(Con *ws, orientation_t orientation);
 
 #endif

diff --git a/src/con.c b/src/con.c
index d36a0da4063c19a94e87b5105e685114caac2869..92b05fd7430f6dbc0a7f5a9093ee6000c76617b8 100644 (file)
--- a/src/con.c
+++ b/src/con.c
@@ -230,6 +230,11 @@ Con *con_get_workspace(Con *con) {
     return result;
 }
 
+/*
+ * Searches parenst of the given 'con' until it reaches one with the specified
+ * 'orientation'. Aborts when it comes across a floating_con.
+ *
+ */
 Con *con_parent_with_orientation(Con *con, orientation_t orientation) {
     DLOG("Searching for parent of Con %p with orientation %d\n", con, orientation);
     Con *parent = con->parent;
@@ -759,6 +764,12 @@ void con_set_layout(Con *con, int layout) {
     con->layout = layout;
 }
 
+/*
+ * Callback which will be called when removing a child from the given con.
+ * Kills the container if it is empty and replaces it with the child if there
+ * is exactly one child.
+ *
+ */
 static void con_on_remove_child(Con *con) {
     DLOG("on_remove_child\n");
 

diff --git a/src/workspace.c b/src/workspace.c
index c17eb7ed65583f11e58318093d654d73f16c67c3..4fcdd7473ec46958a74287bc393867b749d222e8 100644 (file)
--- a/src/workspace.c
+++ b/src/workspace.c
@@ -488,6 +488,12 @@ void workspace_update_urgent_flag(Con *ws) {
         ipc_send_event("workspace", I3_IPC_EVENT_WORKSPACE, "{\"change\":\"urgent\"}");
 }
 
+/*
+ * 'Forces' workspace orientation by moving all cons into a new split-con with
+ * the same orientation as the workspace and then changing the workspace
+ * orientation.
+ *
+ */
 void ws_force_orientation(Con *ws, orientation_t orientation) {
     /* 1: create a new split container */
     Con *split = con_new(NULL);