From fd6e53be7ab0cfd7d54bbaa7c79b7f3274940161 Mon Sep 17 00:00:00 2001
From: Foivos Zakkak <foivos@zakkak.net>
Date: Fri, 11 Oct 2019 03:04:08 +0300
Subject: [PATCH] Adds README for app:twitter

---
 modules/app/twitter/README.org | 91 ++++++++++++++++++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 modules/app/twitter/README.org

diff --git a/modules/app/twitter/README.org b/modules/app/twitter/README.org
new file mode 100644
index 000000000..3c1a9f412
--- /dev/null
+++ b/modules/app/twitter/README.org
@@ -0,0 +1,91 @@
+#+TITLE:   app/twitter
+#+DATE:    October 11, 2019
+#+SINCE:   v2.0
+#+STARTUP: inlineimages
+
+* Table of Contents :TOC_3:noexport:
+- [[#description][Description]]
+  - [[#module-flags][Module Flags]]
+  - [[#plugins][Plugins]]
+  - [[#hacks][Hacks]]
+- [[#prerequisites][Prerequisites]]
+- [[#features][Features]]
+- [[#configuration][Configuration]]
+- [[#troubleshooting][Troubleshooting]]
+- [[#appendix][Appendix]]
+  - [[#commands--keybindings][Commands & Keybindings]]
+
+* Description
+Enjoy twitter from emacs.
+
++ View various timelines side by side, e.g. user's timeline, home, etc.
++ Post new tweets
++ Send direct messages
++ Retweet
++ Follow and un-follow users
++ Favorite tweets
+
+** Module Flags
+This module provides no flags.
+
+** Plugins
++ [[https://github.com/hayamiz/twittering-mode][twittering-mode]]
++ [[https://github.com/abo-abo/avy][avy]]
+
+** TODO Hacks
+{A list of internal modifications to included packages}
+
+* Prerequisites
+
++ For SSL connection (required by Twitter's API), one of the followings is required:
+  + [[http://curl.haxx.se/][cURL]]
+  + [[http://www.gnu.org/software/wget/][GNU Wget]]
+  + [[http://www.openssl.org/][OpenSSL]]
+  + [[http://www.gnu.org/software/gnutls/][GnuTLS]]
++ [[http://www.gnupg.org/][GnuPG]] is required for keeping the OAuth token encrypted in local storage.
++ ~twittering-icon-mode~ converts retrieved icons into XPM by default. To
+  achieve this and for displaying icons in formats that are not supported by
+  Emacs as well as for resizing icon images, [[http://www.imagemagick.org/][ImageMagick]] is required.
++ For keeping retrieved icons in local storage, [[http://www.gzip.org/][gzip]] is required.
+
+* TODO Features
+An in-depth list of features, how to use them, and their dependencies.
+
+* TODO Configuration
+How to configure this module, including common problems and how to address them.
+
+* Troubleshooting
+Currently ~twittering-mode~ binds =SPC=, breaking its functionality as a leader
+key. To work around this issue you may use =M-SPC= instead when in
+~twittering-mode~.
+
+* Appendix
+** Commands & Keybindings
+Here is a list of available commands and their default keybindings (defined in
+[[./config.el][config.el]]).
+
+| command             | key / ex command | description                                                 |
+|---------------------+------------------+-------------------------------------------------------------|
+| ~+twitter/quit~     | =q=              | Close current window                                        |
+| ~+twitter/quit-all~ | =Q=              | Close all twitter windows and buffers, and delete workspace |
+
+And when ~:editor evil +everywhere~ is active:
+
+| command                                          | key / ex command | description                                                      |
+|--------------------------------------------------+------------------+------------------------------------------------------------------|
+| ~twittering-favorite~                            | =f=              | Favorite/Like a tweet                                            |
+| ~twittering-unfavorite~                          | =F=              | Un-favorite/Un-like a tweet                                      |
+| ~twittering-follow~                              | =C-f=            | Follow user                                                      |
+| ~twittering-unfollow~                            | =C-F=            | Un-follow user                                                   |
+| ~twittering-delete-status~                       | =d=              | Delete a tweet                                                   |
+| ~twittering-retweet~                             | =r=              | Retweet                                                          |
+| ~twittering-toggle-or-retrieve-replied-statuses~ | =R=              | Toggle or retrieve replies                                       |
+| ~twittering-update-status-interactive~           | =o=              | Update tweets                                                    |
+| ~+twitter/ace-link~                              | =O=              | Open some visible link from a ~twittering-mode~ buffer using ace |
+| ~twittering-search~                              | =/=              | Search                                                           |
+| ~twittering-goto-next-status~                    | =J=              | Go to next tweet                                                 |
+| ~twittering-goto-previous-status~                | =K=              | Go to previous tweet                                             |
+| ~twittering-goto-first-status~                   | =gg=             | Go to first tweet                                                |
+| ~twittering-goto-last-status~                    | =G=              | Go to last tweet                                                 |
+| ~twittering-goto-next-status-of-user~            | =gj=             | Go to next tweet of user                                         |
+| ~twittering-goto-previous-status-of-user)))~     | =gk=             | Go to previous tweet of user                                     |