--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/primitivus/index.rst	Sun Jul 21 22:14:30 2019 +0200
@@ -0,0 +1,150 @@
+.. _primitivus-documentation:
+
+==========
+Primitivus
+==========
+
+``Primitivus`` is the TUI (Terminal User Interface) frontend of Salut à Toi
+
+Overview
+========
+
+``Primitivus`` is a text based frontend. It is specially adapted for systems without
+graphical environments (e.g. servers), for low bandwidth remote shells (e.g. ssh) or for
+people who like straightforward interfaces without distracting images or animations.
+
+For the moment, Primitivus implements one 2 one chat, group chat (also called *MUC* for
+Multi-Users Chat), and some related features (end 2 end encryption, bookmarks, gateways
+interaction, file sending, etc.).
+
+Usage
+=====
+
+Primitivus is modal (vi-like), one can switch from one mode to another
+in the same way as in vi/vim:
+
+-  From any mode, press ``[Esc]`` to switch to normal mode.
+-  From normal mode, press ``:`` to switch to command mode.
+-  From normal mode, press ``i`` to switch to insert mode – the one you
+   use to write messages to your contacts.
+
+Primitivus can be handled either with the mouse, in a very intuitive way, or with the
+keyboard. Below, the keyboard shortcuts are explained.
+
+Keyboard handling
+-----------------
+
+-  ``C`` stands for ``Ctrl``
+-  ``M`` means *Meta*, on a PC it is usually the ``Alt`` key
+-  ``S`` stands for ``Shift``
+
+Main keys
+~~~~~~~~~
+
+``[tab]`` and/or ``C-up/down arrows``
+  change focus
+``C-x``
+  quit Primitivus
+``C-f 1`` or ``C-f m``
+  focus on the menu
+``C-f 2`` or ``C-f b``
+  focus on the roster or the chat window
+``C-f 3`` or ``C-f e``
+  focus on the edition line
+``M-m``
+  display/hide the menu
+``C-n``
+  show the next notification
+``C-s``
+  hide/redisplay a pop-up window temporarily
+``C-d``
+  enter debug mode (development versions only)
+``F2``
+  hide/display the roster
+``C-l``
+  refresh the screen
+
+Chat rooms
+~~~~~~~~~~
+
+To use those keyboard shortcuts, your cursor must be in a chat room.
+
+``M-j``
+  join a chat room
+``M-p``
+  hide/display the list of participants
+``M-t``
+  hide/display timestamps
+``M-n``
+  use/don't use short nicks
+``M-l``
+  hide/display frame decorations
+``M-s``
+  change the room's topic appearance by switching between:
+    - one single line (the topic is cut if it's too long)
+    - the full topic
+    - topic hidden
+``G``
+  go to the end (bottom) of your history (note that this is UPPERCASE ``G``)
+
+
+Edition line
+~~~~~~~~~~~~
+
+``C-a`` or ``[home]``
+  move the cursor at the beginning of the line
+``C-e`` or ``[end]``
+  move the cursor at the end of the line
+``C-k``
+  erase the line, starting at the cursor's position
+``C-w``
+  erase the last word
+``S-[tab]``
+  invoke completion (dependent on the context)
+``up/down arrows``
+  browse sent messages history
+
+Contacts
+~~~~~~~~
+
+``M-d``
+  hide/display offline contacts
+``M-s``
+  hide/display contacts' status messages
+
+Card game
+~~~~~~~~~
+
+``space``
+  select a card
+
+Commands
+~~~~~~~~
+
+The following commands must be typed in command mode (type ``[Esc]`` to switch to normal
+mode, then the ``:`` at the beginning of the command will switch to command mode).
+
+``:quit``
+  quit Primitivus
+``:messages``
+  display log messages (see also the logging configuration)
+
+..
+  FIXME: :presence and :status are currently disabled in Primitivus
+  ``:presence [status]``
+    set your presence status. Invoked without argument, a pop-up will allow you to choose your presence status; otherwise, you can use the following arguments:
+    - ``online``
+    - ``chat`` (free to chat)
+    - ``away`` (away from keyboard)
+    - ``dnd`` (do not disturb)
+    - ``xa`` (extended away)
+  ``:status [message]``
+    set your status message. Invoked without argument, a pop-up will allow you to enter a message.
+
+``:history <size>``
+  set the number of lines of history to display in the chat window (``:history 0`` to clear the window)
+``:search <filter>``
+  do a full text search in this conversation/room. The room will be cleared an only
+  messages corresponding to ``<filter>`` will be show. Use ``:history <size>`` to
+  restore normal history
+