ipc: tree reply: document focus, nodes and floating_nodes (#2955)

[i3/i3] / docs / ipc

diff --git a/docs/ipc b/docs/ipc
index 0fc5774a27f6739ab2d9b7d1c845028bee63277f..ab2997fd4f72292b0a683740bc82aa9bd142f5a6 100644 (file)
--- a/docs/ipc
+++ b/docs/ipc
@@ -338,6 +338,16 @@ urgent (bool)::
        Whether this container (window or workspace) has the urgency hint set.
 focused (bool)::
        Whether this container is currently focused.
+focus (array of integer)::
+       List of child node IDs (see +nodes+, +floating_nodes+ and +id+) in focus
+       order. Traversing the tree by following the first entry in this array
+       will result in eventually reaching the one node with +focused+ set to
+       true.
+nodes (array of node)::
+       The tiling (i.e. non-floating) child containers of this node.
+floating_nodes (array of node)::
+       The floating child containers of this node. Only non-empty on nodes with
+       type +workspace+.
 
 Please note that in the following example, I have left out some keys/values
 which are not relevant for the type of the node. Otherwise, the example would
@@ -698,9 +708,9 @@ if ($is_event) {
 
 This event consists of a single serialized map containing a property
 +change (string)+ which indicates the type of the change ("focus", "init",
-"empty", "urgent", "reload", "rename", "restored"). A +current (object)+
-property will be present with the affected workspace whenever the type of event
-affects a workspace (otherwise, it will be +null).
+"empty", "urgent", "reload", "rename", "restored", "move"). A
++current (object)+ property will be present with the affected workspace
+whenever the type of event affects a workspace (otherwise, it will be +null).
 
 When the change is "focus", an +old (object)+ property will be present with the
 previous workspace.  When the first switch occurs (when i3 focuses the
@@ -878,4 +888,4 @@ Ruby::
 Rust::
        * https://github.com/tmerr/i3ipc-rs
 OCaml::
-       * https://github.com/Armael/ocaml-i3ipc
\ No newline at end of file
+       * https://github.com/Armael/ocaml-i3ipc