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

diff --git a/docs/index.rst b/docs/index.rst
index 377d21f..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
@@ -290,11 +306,17 @@ 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.
+-  ``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.
 
@@ -302,6 +324,12 @@ You can view or set a new value of every config key by ``config`` command (See *
 
 -  ``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.
@@ -382,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