Add documentation for workspace_get()

[i3/i3] / src / workspace.c

diff --git a/src/workspace.c b/src/workspace.c
index c4f1ead199028dc961c9ca3c157d83c36f4dafee..b88e213bbbb664acbb7da46a2d646acbccc2d20c 100644 (file)
--- a/src/workspace.c
+++ b/src/workspace.c
@@ -27,6 +27,12 @@
 #include "workspace.h"
 #include "client.h"
 
+/*
+ * Returns a pointer to the workspace with the given number (starting at 0),
+ * creating the workspace if necessary (by allocating the necessary amount of
+ * memory and initializing the data structures correctly).
+ *
+ */
 Workspace *workspace_get(int number) {
         if (number > (num_workspaces-1)) {
                 int old_num_workspaces = num_workspaces;