From 834f4d7bc29cc2e0b4b151c62c8bc468943fa2d7 Mon Sep 17 00:00:00 2001
From: Michael Stapelberg <michael@stapelberg.de>
Date: Mon, 14 Feb 2011 23:17:30 +0100
Subject: [PATCH] add missing function documentation

---
 include/con.h       |  6 +++++-
 include/workspace.h |  6 ++++++
 src/con.c           | 11 +++++++++++
 src/workspace.c     |  6 ++++++
 4 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/include/con.h b/include/con.h
index d5dc74e7..0d4df204 100644
--- 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 b902f490..d903ea82 100644
--- 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 d36a0da4..92b05fd7 100644
--- 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 c17eb7ed..4fcdd747 100644
--- 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);