gnusocial and emacs

doc/EN/usage.org

@@ -169,6 +169,7 @@ If you have an Android device then go to F-Droid (if you don't already have it i
 The DLNA service will only work within your local home network, and isn't remotely accessible from other locations via the internet. That can be both a good and a bad thing. Another consideration is that there are no access controls on DLNA services, so any music or videos on the USB drive will be playable by anyone within your home network.
 
 * Microblogging (GNU Social)
+** Initial setup
 To log into your GNU Social site first obtain your username and password from the "microblogging" section of the readme file.
 
 #+BEGIN_SRC bash
@@ -183,6 +184,37 @@ GNU Social has a clutter-free mobile user interface which can be accessed via a
 
 [[file:images/gnusocial_mobile.jpg]]
 
+** Direct Messages (DMs) and privacy
+One important point about GNU Social is that although direct messages (DMs) are treated as being private their security is quite poor. If you want real communications privacy then use other systems such as XMPP+OMEMO/OTR, Tox or email with GPG. GNU Social is primarily about /fully public communications/.
+** Using with Emacs
+If you are an Emacs user it's also possible to set up GNU Social mode as follows:
+
+#+begin_src bash :tangle no
+mkdir ~/elisp
+git clone git://git.savannah.nongnu.org/gnu-social-mode ~/elisp/gnu-social-mode
+sed -i 's|"http"|"https"|g' ~/elisp/gnu-social-mode/gnu-social-mode.el
+sed -i 's|http:|https:|g' ~/elisp/gnu-social-mode/gnu-social-mode.el
+sed -i 's|http?|https?|g' ~/elisp/gnu-social-mode/gnu-social-mode.el
+echo "(add-to-list 'load-path \"~/elisp/gnu-social-mode\")" >> ~/.emacs
+echo "(require 'gnu-social-mode)" >> ~/.emacs
+echo "(setq gnu-social-server-textlimit 2000" >> ~/.emacs
+echo "      gnu-social-server \"yourgnusocialdomain\"" >> ~/.emacs
+echo "	  gnu-social-username \"yourusername\"" >> ~/.emacs
+echo "	  gnu-social-password \"gnusocialpassword\")" >> ~/.emacs
+#+end_src
+
+And as a quick reference the main keys are:
+
+| Key           | Function              |
+|---------------+-----------------------|
+| i             | Show profile icons    |
+| CTRL-c CTRL-s | Post status update    |
+| r             | Repeat                |
+| F             | Favourite             |
+| CTRL-c CTRL-h | Highlight             |
+| R             | Reply to user         |
+| g             | Show current timeline |
+
 * Sharing things
 If you have the GNU Social microblogging system installed then it's also possible to share things or services between groups or with particular users. This can be useful for sharing items within a family, club or in a local sharing economy. Sharing things freely, without money, reveals the social basis at the root of all economics which money normally conceals or obscures.