From: Michael Stapelberg <michael@stapelberg.de>
Date: Wed, 3 Oct 2012 21:59:33 +0000 (+0200)
Subject: docs/ipc: add a warning to use an existing library (Thanks slowpoke)
X-Git-Tag: 4.4~85
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=34bd8af634434e324514a7ee416b59c7b9974608;p=i3%2Fi3

docs/ipc: add a warning to use an existing library (Thanks slowpoke)
---

diff --git a/docs/ipc b/docs/ipc
index 0cfb0320..6bdccd0b 100644
--- a/docs/ipc
+++ b/docs/ipc
@@ -19,6 +19,13 @@ calling +i3 --get-socketpath+.
 All i3 utilities, like +i3-msg+ and +i3-input+ will read the +I3_SOCKET_PATH+
 X11 property, stored on the X11 root window.
 
+[WARNING]
+.Use an existing library!
+There are existing libraries for many languages. You can have a look at
+<<libraries>> or search the web if your language of choice is not mentioned.
+Usually, it is not necessary to implement low-level communication with i3
+directly.
+
 == Establishing a connection
 
 To establish a connection, simply open the IPC socket. The following code
@@ -667,7 +674,9 @@ mode is simply named default.
 { "change": "default" }
 ---------------------------
 
-== See also
+== See also (existing libraries)
+
+[[libraries]]
 
 For some languages, libraries are available (so you don’t have to implement
 all this on your own). This list names some (if you wrote one, please let me