X-Git-Url: https://vcs.fsf.org/?p=rainbowstream.git;a=blobdiff_plain;f=docs%2Findex.rst;h=004f3aa7d83ba26f87c41f5ab6b6ffaf180e3e9d;hp=d8a6927d3d1a9041b3e14dad2b8aca427fb91242;hb=49c9d9b43d4f09242e86ec48806ea9ff73519e1c;hpb=46c9fb816604f4c604e24a923770f8bf12e0adac

diff --git a/docs/index.rst b/docs/index.rst
index d8a6927..004f3aa 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -42,16 +42,29 @@ Use `virtualenv`_
 Troubleshooting
 ^^^^^^^^^^^^^^^
 
-If you use Linux, you might need to install the python-dev package if you haven't already. 
+If you use Linux, you might need to install some packages if you haven't already. 
 For debian-based distros, these can be installed with
 
 .. code:: bash
 
-    sudo apt-get install python-dev
+    sudo apt-get install python-dev libjpeg libjpeg-dev libfreetype6 libfreetype6-dev zlib1g-dev
 
 Besides, Mac OSX Maverick with Xcode 5.1 has a well-known `clang unknown argument`_ problem with
 the ``Pillow`` package installation - a dependency of this app.
-If you are in this case, I recommend take a look at `Issue #10`_ and let me know if the workaround doesn't work for you.
+If you are in this case, I recommend taking a look at `Issue #10`_ and let me know if this workaround doesn't work for you.
+
+.. code:: bash
+
+    export ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future
+
+If installation in *the quick way* doesn't work:
+
+-  `sudo pip uninstall rainbowstream`
+-  use the *virtualenv way* above
+-  `create an issue`_ and provide:
+
+  + Your OS
+  + Your Python version
 
 Usage
 -----
@@ -74,8 +87,11 @@ You can try it with:
 
     rainbowstream -iot # Or rainbowstream --image-on-term
 
-You also can change the config key ``IMAGE_ON_TERM`` to ``True`` inside the app
-to enable above feature (see `config management`_ section).
+You also can change the config key ``IMAGE_ON_TERM`` to ``True`` inside the app 
+to enable above feature, 
+change ``IMAGE_SHIFT`` to set image's margin (relative to your terminal's width) 
+or ``IMAGE_MAX_HEIGHT`` to control max height of every image.
+(see `config management`_ section).
 
 In the first time you will be asked for authorization of Rainbow Stream
 app at Twitter. Just click the “Authorize access” button and paste PIN
@@ -254,8 +270,6 @@ Here is full list of supported command:
 
 -  ``q`` will quit.
 
-Available commands are listed in `Read The Docs`_.
-
 Theme customization
 ^^^^^^^^^^^^^^^^^^^
 
@@ -292,16 +306,30 @@ Config explanation
 Rainbow Stream has a config file located at ``~/.rainbow_config.json``.
 You can view or set a new value of every config key by ``config`` command (See **Interactive mode** section above).
 
+-  ``HEARTBEAT_TIMEOUT``: after this timeout (count by minutes), the stream will automatically hangup.
+
+-  ``IMAGE_ON_TERM``: display tweet's image directly on terminal.
+
 -  ``THEME``: current theme.
 
 -  ``ASCII_ART``: diplay your twitter name by ascii art at stream begin or not.
 
+-  ``HIDE_PROMPT``: hide prompt after receiving a tweet or not.
+
+-  ``PREFIX``: display string of prompt.
+
 -  ``SEARCH_MAX_RECORD``: max tweets can display on 'search' command.
 
 -  ``HOME_TWEET_NUM``: default tweets to display on 'home' command.
 
 -  ``RETWEETS_SHOW_NUM``: default tweets to display on 'allrt' command.
 
+-  ``QUOTE_FORMAT``: format when quote a tweet
+
+    + ``#comment``: Your own comment about the tweet
+    + ``#owner``: owner's username with '@'
+    + ``#tweet``: original tweet
+
 -  ``MESSAGES_DISPLAY``: default messages to display on 'inbox' or 'sent' command.
 
 -  ``TREND_MAX``: default trends to display on 'trend' command.
@@ -332,8 +360,11 @@ You can view or set a new value of every config key by ``config`` command (See *
     + ``#name``: Twitter's name
     + ``#nick``: Twitter's screen name
     + ``#clock``: Datetime
+    + ``#rt_count``: retweets count
+    + ``#fa_count``: favorites count
     + ``#id``: ID
     + ``#fav``: favorited symbol
+    + ``#fav``: favorited symbol
     + ``#tweet``: Tweet's content
     + ``#sender_name``: Message's sender name
     + ``#sender_nick``: Message's sender screen name
@@ -379,7 +410,7 @@ steps
 .. _Twitter API: https://dev.twitter.com/docs/api/1.1
 .. _theme usage and customization: https://github.com/DTVD/rainbowstream/blob/master/theme.md
 .. _virtualenv: http://docs.python-guide.org/en/latest/dev/virtualenvs/
-.. _config management: http://rainbowstream.readthedocs.org/en/latest/#the-interactive-mode
+.. _config management: http://rainbowstream.readthedocs.org/en/latest/#config-explanation
 .. _Python's strftime format: https://docs.python.org/2/library/time.html#time.strftime
 .. _clang unknown argument: http://kaspermunck.github.io/2014/03/fixing-clang-error/
 .. _Issue #10: https://github.com/DTVD/rainbowstream/issues/10