├── README
├── plugin
    └── twitvim.vim
└── doc
    └── twitvim.txt


/README:
--------------------------------------------------------------------------------
 1 | This is a mirror of http://www.vim.org/scripts/script.php?script_id=2204
 2 | 
 3 | Introduction
 4 | 
 5 | TwitVim is a Vim plugin that allows you to post to Twitter and view Twitter timelines. It is an enhancement of vimscript #2124 by Travis Jeffery. Credit goes to Travis for the original script concept and implementation.
 6 | 
 7 | TwitVim supports most of the features of a typical Twitter client, including: 
 8 | 
 9 | - Friends, User, Direct Message, Mentions, and Favorites timelines 
10 | - Twitter Search 
11 | - Replying and retweeting
12 | - Hashtags (jump to search timeline) 
13 | - In reply to (See which tweet an @-reply is for.) 
14 | - Opening links in a browser 
15 | - User profile display 
16 | - Twitter List viewing and managing 
17 | - Trending topics
18 | - Timeline filtering
19 | 
20 | *****
21 | 
22 | Usage
23 | 
24 | Plugin commands:
25 | 
26 | - :PosttoTwitter - This command will prompt you for a message to send to Twitter. 
27 | - :CPosttoTwitter - This command posts the current line in the current buffer to Twitter. 
28 | - :BPosttoTwitter - This command posts the current buffer to Twitter. 
29 | - :FriendsTwitter - View friends timeline. 
30 | - :UserTwitter - View your timeline. 
31 | - :MentionsTwitter - View @-mentions. 
32 | - :PublicTwitter - View public timeline. 
33 | - :DMTwitter - View direct messages. 
34 | - :SearchTwitter - Use Twitter Search. 
35 | 
36 | Global mappings:
37 | 
38 | - Alt-T - In Visual select mode, the Alt-T key posts the selected text to Twitter. Use this mapping if you compose your tweets in a separate scratch buffer.
39 | - Ctrl-T - Use this instead if the menu bar is enabled or if Alt-T is not available on your platform.
40 | 
41 | Timeline buffer mappings:
42 | 
43 | - Alt-R or <Leader>r - Starts a @-reply. (in timeline buffer) 
44 | - Alt-D or <Leader>d - Starts a direct message. (in timeline buffer) 
45 | 
46 | Many more commands and mappings are available. See TwitVim's help documentation for full details. 
47 | 
48 | *****
49 | 
50 | License
51 | 
52 | TwitVim is distributed under the same terms as Vim itself. See :help license.
53 | 
54 | *****
55 | 
56 | Contact
57 | 
58 | - @mortonfox (https://twitter.com/mortonfox) - The maintainer
59 | - @twitvim (https://twitter.com/twitvim) - TwitVim announcements
60 | 
61 | 


--------------------------------------------------------------------------------
/plugin/twitvim.vim:
--------------------------------------------------------------------------------
  1 | " ==============================================================
  2 | " TwitVim - Post to Twitter from Vim
  3 | " Based on Twitter Vim script by Travis Jeffery <eatsleepgolf@gmail.com>
  4 | "
  5 | " Version: 0.9.1
  6 | " License: Vim license. See :help license
  7 | " Language: Vim script
  8 | " Maintainer: Po Shan Cheah <morton@mortonfox.com>
  9 | " Created: March 28, 2008
 10 | " Last updated: August 19, 2015
 11 | "
 12 | " GetLatestVimScripts: 2204 1 twitvim.vim
 13 | " ==============================================================
 14 | 
 15 | " Load this module only once.
 16 | if exists('g:loaded_twitvim')
 17 |     finish
 18 | endif
 19 | let g:loaded_twitvim = '0.9.1 2015-08-19'
 20 | 
 21 | " Check Vim version.
 22 | if v:version < 703
 23 |     echohl ErrorMsg
 24 |     echomsg 'You need Vim 7.3 or later for this version of TwitVim'
 25 |     echohl None
 26 |     finish
 27 | endif
 28 | 
 29 | " Avoid side-effects from cpoptions setting.
 30 | let s:save_cpo = &cpo
 31 | set cpo&vim
 32 | 
 33 | " For debugging. Reset Hmac method.
 34 | if !exists(":TwitVimResetHmacMethod")
 35 |     command TwitVimResetHmacMethod :call twitvim#reset_hmac_method()
 36 | endif
 37 | 
 38 | " For debugging. Show current Hmac method.
 39 | if !exists(":TwitVimShowHmacMethod")
 40 |     command TwitVimShowHmacMethod :call twitvim#show_hmac_method()
 41 | endif
 42 | 
 43 | " For debugging. Reset networking method.
 44 | if !exists(":TwitVimResetMethod")
 45 |     command TwitVimResetMethod :call twitvim#reset_curl_method()
 46 | endif
 47 | 
 48 | " For debugging. Show current networking method.
 49 | if !exists(":TwitVimShowMethod")
 50 |     command TwitVimShowMethod :call twitvim#show_curl_method()
 51 | endif
 52 | 
 53 | if !exists(":BackTwitter")
 54 |     command BackTwitter :call twitvim#back_buffer(0)
 55 | endif
 56 | if !exists(":ForwardTwitter")
 57 |     command ForwardTwitter :call twitvim#fwd_buffer(0)
 58 | endif
 59 | if !exists(":BackInfoTwitter")
 60 |     command BackInfoTwitter :call twitvim#back_buffer(1)
 61 | endif
 62 | if !exists(":ForwardInfoTwitter")
 63 |     command ForwardInfoTwitter :call twitvim#fwd_buffer(1)
 64 | endif
 65 | 
 66 | if !exists(":TwitVimShowBufstack")
 67 |     command TwitVimShowBufstack :call twitvim#show_bufstack(0)
 68 | endif
 69 | if !exists(":TwitVimShowInfoBufstack")
 70 |     command TwitVimShowInfoBufstack :call twitvim#show_bufstack(1)
 71 | endif
 72 | 
 73 | " For debugging. Show curbuffer variable.
 74 | if !exists(":TwitVimShowCurbuffer")
 75 |     command TwitVimShowCurbuffer :call twitvim#show_bufvar(0)
 76 | endif
 77 | " For debugging. Show infobuffer variable.
 78 | if !exists(":TwitVimShowInfobuffer")
 79 |     command TwitVimShowInfobuffer :call twitvim#show_bufvar(1)
 80 | endif
 81 | 
 82 | " Prompt user for tweet.
 83 | if !exists(":PosttoTwitter")
 84 |     command PosttoTwitter :call twitvim#CmdLine_Twitter('', 0)
 85 | endif
 86 | 
 87 | nnoremenu Plugin.TwitVim.Post\ from\ cmdline :call twitvim#CmdLine_Twitter('', 0)<cr>
 88 | 
 89 | " Post current line to Twitter.
 90 | if !exists(":CPosttoTwitter")
 91 |     command CPosttoTwitter :call twitvim#post_twitter(getline('.'), 0)
 92 | endif
 93 | 
 94 | nnoremenu Plugin.TwitVim.Post\ current\ line :call twitvim#post_twitter(getline('.'), 0)<cr>
 95 | 
 96 | " Post entire buffer to Twitter.
 97 | if !exists(":BPosttoTwitter")
 98 |     command BPosttoTwitter :call twitvim#post_twitter(join(getline(1, "$")), 0)
 99 | endif
100 | 
101 | " Post visual selection to Twitter.
102 | noremap <SID>Visual y:call twitvim#post_twitter(@", 0)<cr>
103 | noremap <unique> <script> <Plug>TwitvimVisual <SID>Visual
104 | if !hasmapto('<Plug>TwitvimVisual')
105 |     vmap <unique> <A-t> <Plug>TwitvimVisual
106 | 
107 |     " Allow Ctrl-T as an alternative to Alt-T.
108 |     " Alt-T pulls down the Tools menu if the menu bar is enabled.
109 |     vmap <unique> <C-t> <Plug>TwitvimVisual
110 | endif
111 | 
112 | vmenu Plugin.TwitVim.Post\ selection <Plug>TwitvimVisual
113 | 
114 | if !exists(":SetTrendLocationTwitter")
115 |     command SetTrendLocationTwitter :call twitvim#pick_woeid()
116 | endif
117 | 
118 | if !exists(":TrendTwitter")
119 |     command TrendTwitter :call twitvim#Local_Trends()
120 | endif
121 | 
122 | if !exists(":FriendsTwitter")
123 |     command FriendsTwitter :call twitvim#get_timeline("friends", '', 1, 0)
124 | endif
125 | if !exists(":UserTwitter")
126 |     command -nargs=? UserTwitter :call twitvim#get_timeline("user", <q-args>, 1, 0)
127 | endif
128 | if !exists(":MentionsTwitter")
129 |     command MentionsTwitter :call twitvim#get_timeline("replies", '', 1, 0)
130 | endif
131 | if !exists(":RepliesTwitter")
132 |     command RepliesTwitter :call twitvim#get_timeline("replies", '', 1, 0)
133 | endif
134 | if !exists(":DMTwitter")
135 |     command DMTwitter :call twitvim#Direct_Messages("dmrecv", 1, 0)
136 | endif
137 | if !exists(":DMSentTwitter")
138 |     command DMSentTwitter :call twitvim#Direct_Messages("dmsent", 1, 0)
139 | endif
140 | if !exists(":ListTwitter")
141 |     command -nargs=+ ListTwitter :call twitvim#DoList(1, <f-args>)
142 | endif
143 | if !exists(":RetweetedByMeTwitter")
144 |     command RetweetedByMeTwitter :call twitvim#get_timeline("retweeted_by_me", '', 1, 0)
145 | endif
146 | if !exists(":RetweetedToMeTwitter")
147 |     command RetweetedToMeTwitter :call twitvim#get_timeline("retweeted_to_me", '', 1, 0)
148 | endif
149 | if !exists(":FavTwitter")
150 |     command FavTwitter :call twitvim#get_timeline('favorites', '', 1, 0)
151 | endif
152 | 
153 | nnoremenu Plugin.TwitVim.-Sep1- :
154 | nnoremenu Plugin.TwitVim.&Friends\ Timeline :call twitvim#get_timeline("friends", '', 1, 0)<cr>
155 | nnoremenu Plugin.TwitVim.&User\ Timeline :call twitvim#get_timeline("user", '', 1, 0)<cr>
156 | nnoremenu Plugin.TwitVim.&Mentions\ Timeline :call twitvim#get_timeline("replies", '', 1, 0)<cr>
157 | nnoremenu Plugin.TwitVim.&Direct\ Messages :call twitvim#Direct_Messages("dmrecv", 1, 0)<cr>
158 | nnoremenu Plugin.TwitVim.Direct\ Messages\ &Sent :call twitvim#Direct_Messages("dmsent", 1, 0)<cr>
159 | 
160 | nnoremenu Plugin.TwitVim.Retweeted\ &By\ Me :call twitvim#get_timeline("retweeted_by_me", '', 1, 0)<cr>
161 | nnoremenu Plugin.TwitVim.Retweeted\ &To\ Me :call twitvim#get_timeline("retweeted_to_me", '', 1, 0)<cr>
162 | nnoremenu Plugin.TwitVim.Fa&vorites :call twitvim#get_timeline("favorites", '', 1, 0)<cr>
163 | 
164 | if !exists(":RefreshTwitter")
165 |     command RefreshTwitter :call twitvim#RefreshTimeline()
166 | endif
167 | if !exists(":NextTwitter")
168 |     command NextTwitter :call twitvim#NextPageTimeline()
169 | endif
170 | if !exists(":PreviousTwitter")
171 |     command PreviousTwitter :call twitvim#PrevPageTimeline()
172 | endif
173 | 
174 | if !exists(":SetLoginTwitter")
175 |     command SetLoginTwitter :call twitvim#prompt_twitvim_login()
176 | endif
177 | if !exists(":ResetLoginTwitter")
178 |     command ResetLoginTwitter :call twitvim#reset_twitvim_login()
179 | endif
180 | if !exists(':SwitchLoginTwitter')
181 |     command -nargs=? -complete=custom,twitvim#name_list_tokens SwitchLoginTwitter :call twitvim#switch_twitvim_login(<q-args>)
182 | endif
183 | if !exists(':DeleteLoginTwitter')
184 |     command -nargs=? -complete=custom,twitvim#name_list_tokens_for_del DeleteLoginTwitter :call twitvim#delete_twitvim_login(<q-args>)
185 | endif
186 | 
187 | nnoremenu Plugin.TwitVim.-Sep2- :
188 | nnoremenu Plugin.TwitVim.Set\ Twitter\ Login :call twitvim#prompt_twitvim_login()<cr>
189 | nnoremenu Plugin.TwitVim.Reset\ Twitter\ Login :call twitvim#reset_twitvim_login()<cr>
190 | 
191 | if !exists(":SendDMTwitter")
192 |     command -nargs=1 SendDMTwitter :call twitvim#send_dm(<q-args>, '')
193 | endif
194 | 
195 | if !exists(":RateLimitTwitter")
196 |     command RateLimitTwitter :call twitvim#get_rate_limit()
197 | endif
198 | 
199 | " Show TwitVim version.
200 | if !exists(":TwitVimVersion")
201 |     command TwitVimVersion :call twitvim#show_user_agent()
202 | endif
203 | 
204 | if !exists(":LocationTwitter")
205 |     command -nargs=+ LocationTwitter :call twitvim#set_location(<q-args>)
206 | endif
207 | 
208 | if !exists(":FollowTwitter")
209 |     command -nargs=1 FollowTwitter :call twitvim#follow_user(<q-args>)
210 | endif
211 | 
212 | if !exists(":UnfollowTwitter")
213 |     command -nargs=1 UnfollowTwitter :call twitvim#unfollow_user(<q-args>)
214 | endif
215 | 
216 | if !exists(":BlockTwitter")
217 |     command -nargs=1 BlockTwitter :call twitvim#block_user(<q-args>, 0)
218 | endif
219 | if !exists(":UnblockTwitter")
220 |     command -nargs=1 UnblockTwitter :call twitvim#block_user(<q-args>, 1)
221 | endif
222 | 
223 | if !exists(":ReportSpamTwitter")
224 |     command -nargs=1 ReportSpamTwitter :call twitvim#report_spam(<q-args>)
225 | endif
226 | 
227 | if !exists(":EnableRetweetsTwitter")
228 |     command -nargs=1 EnableRetweetsTwitter :call twitvim#enable_retweets(<q-args>, 1)
229 | endif
230 | if !exists(":DisableRetweetsTwitter")
231 |     command -nargs=1 DisableRetweetsTwitter :call twitvim#enable_retweets(<q-args>, 0)
232 | endif
233 | 
234 | if !exists(":AddToListTwitter")
235 |     command -nargs=+ AddToListTwitter :call twitvim#do_add_to_list(<f-args>)
236 | endif
237 | 
238 | if !exists(":RemoveFromListTwitter")
239 |     command -nargs=+ RemoveFromListTwitter :call twitvim#do_remove_from_list(<f-args>)
240 | endif
241 | 
242 | if !exists(":ProfileTwitter")
243 |     command -nargs=? ProfileTwitter :call twitvim#get_user_info(<q-args>)
244 | endif
245 | 
246 | if !exists(":ListInfoTwitter")
247 |     command -nargs=+ ListInfoTwitter :call twitvim#DoListInfo(<f-args>)
248 | endif
249 | 
250 | if !exists(":RefreshInfoTwitter")
251 |     command RefreshInfoTwitter :call twitvim#RefreshInfo()
252 | endif
253 | if !exists(":NextInfoTwitter")
254 |     command NextInfoTwitter :call twitvim#NextPageInfo()
255 | endif
256 | if !exists(":PreviousInfoTwitter")
257 |     command PreviousInfoTwitter :call twitvim#PrevPageInfo()
258 | endif
259 | 
260 | if !exists(":FollowingTwitter")
261 |     command -nargs=? FollowingTwitter :call twitvim#do_get_friends(<q-args>, 0)
262 | endif
263 | if !exists(":FollowersTwitter")
264 |     command -nargs=? FollowersTwitter :call twitvim#do_get_friends(<q-args>, 1)
265 | endif
266 | if !exists(":MembersOfListTwitter")
267 |     command -nargs=+ MembersOfListTwitter :call twitvim#DoListMembers(0, <f-args>)
268 | endif
269 | if !exists(":SubsOfListTwitter")
270 |     command -nargs=+ SubsOfListTwitter :call twitvim#DoListMembers(1, <f-args>)
271 | endif
272 | if !exists(":OwnedListsTwitter")
273 |     command -nargs=? OwnedListsTwitter :call twitvim#get_user_lists(-1, <q-args>, "owned")
274 | endif
275 | if !exists(":MemberListsTwitter")
276 |     command -nargs=? MemberListsTwitter :call twitvim#get_user_lists(-1, <q-args>, "memberships")
277 | endif
278 | if !exists(":SubsListsTwitter")
279 |     command -nargs=? SubsListsTwitter :call twitvim#get_user_lists(-1, <q-args>, "subscriptions")
280 | endif
281 | 
282 | if !exists(":FollowListTwitter")
283 |     command -nargs=+ FollowListTwitter :call twitvim#follow_list(0, <f-args>)
284 | endif
285 | if !exists(":UnfollowListTwitter")
286 |     command -nargs=+ UnfollowListTwitter :call twitvim#follow_list(1, <f-args>)
287 | endif
288 | 
289 | if !exists(":BitLy")
290 |     command -nargs=? BitLy :call twitvim#GetShortURL("insert", <q-args>, "call_bitly")
291 | endif
292 | if !exists(":ABitLy")
293 |     command -nargs=? ABitLy :call twitvim#GetShortURL("append", <q-args>, "call_bitly")
294 | endif
295 | if !exists(":PBitLy")
296 |     command -nargs=? PBitLy :call twitvim#GetShortURL("cmdline", <q-args>, "call_bitly")
297 | endif
298 | 
299 | if !exists(":IsGd")
300 |     command -nargs=? IsGd :call twitvim#GetShortURL("insert", <q-args>, "call_isgd")
301 | endif
302 | if !exists(":AIsGd")
303 |     command -nargs=? AIsGd :call twitvim#GetShortURL("append", <q-args>, "call_isgd")
304 | endif
305 | if !exists(":PIsGd")
306 |     command -nargs=? PIsGd :call twitvim#GetShortURL("cmdline", <q-args>, "call_isgd")
307 | endif
308 | 
309 | if !exists(":Googl")
310 |     command -nargs=? Googl :call twitvim#GetShortURL("insert", <q-args>, "call_googl")
311 | endif
312 | if !exists(":AGoogl")
313 |     command -nargs=? AGoogl :call twitvim#GetShortURL("append", <q-args>, "call_googl")
314 | endif
315 | if !exists(":PGoogl")
316 |     command -nargs=? PGoogl :call twitvim#GetShortURL("cmdline", <q-args>, "call_googl")
317 | endif
318 | 
319 | if !exists(":Summize")
320 |     command -nargs=? Summize :call twitvim#Summize(<q-args>, 1)
321 | endif
322 | if !exists(":SearchTwitter")
323 |     command -nargs=? SearchTwitter :call twitvim#Summize(<q-args>, 1)
324 | endif
325 | 
326 | let &cpo = s:save_cpo
327 | finish
328 | 
329 | " vim:set tw=0 et:
330 | 


--------------------------------------------------------------------------------
/doc/twitvim.txt:
--------------------------------------------------------------------------------
   1 | *twitvim.txt*  Twitter client for Vim
   2 | 
   3 | 		      ---------------------------------
   4 | 		      TwitVim: A Twitter client for Vim
   5 | 		      ---------------------------------
   6 | 
   7 | Author: Po Shan Cheah <morton@mortonfox.com> 
   8 | 	http://twitter.com/mortonfox
   9 | 
  10 | License: The Vim License applies to twitvim.vim and twitvim.txt (see
  11 | 	|copyright|) except use "TwitVim" instead of "Vim". No warranty,
  12 | 	express or implied. Use at your own risk.
  13 | 
  14 | 
  15 | ==============================================================================
  16 | 1. Contents					*TwitVim* *TwitVim-contents*
  17 | 
  18 | 	1. Contents...............................: |TwitVim-contents|
  19 | 	2. Introduction...........................: |TwitVim-intro|
  20 | 	3. Installation...........................: |TwitVim-install|
  21 | 	   OpenSSL................................: |TwitVim-OpenSSL|
  22 | 	   cURL...................................: |TwitVim-cURL|
  23 | 	   twitvim_proxy..........................: |twitvim_proxy|
  24 | 	   twitvim_proxy_login....................: |twitvim_proxy_login|
  25 | 	3.1. TwitVim and OAuth....................: |TwitVim-OAuth|
  26 | 	     twitvim_token_file...................: |twitvim_token_file|
  27 | 	     twitvim_disable_token_file...........: |twitvim_disable_token_file|
  28 | 	3.1.1. OAuth Consumer Key.................: |TwitVim-OAuth-Consumer|
  29 | 	       twitvim_consumer_key...............: |twitvim_consumer_key|
  30 | 	       twitvim_consumer_secret............: |twitvim_consumer_secret|
  31 | 	3.2. Base64-Encoded Login.................: |TwitVim-login-base64|
  32 | 	     twitvim_proxy_login_b64..............: |twitvim_proxy_login_b64|
  33 | 	3.3. Alternatives to cURL.................: |TwitVim-non-cURL|
  34 | 	     twitvim_enable_perl..................: |twitvim_enable_perl|
  35 | 	     twitvim_enable_python................: |twitvim_enable_python|
  36 | 	     twitvim_enable_ruby..................: |twitvim_enable_ruby|
  37 | 	     twitvim_enable_tcl...................: |twitvim_enable_tcl|
  38 | 	3.4. Using Twitter SSL API................: |TwitVim-ssl|
  39 | 	     Twitter SSL via cURL.................: |TwitVim-ssl-curl|
  40 | 	     twitvim_cert_insecure................: |twitvim_cert_insecure|
  41 | 	     Twitter SSL via Perl interface.......: |TwitVim-ssl-perl|
  42 | 	     Twitter SSL via Ruby interface.......: |TwitVim-ssl-ruby|
  43 | 	     Twitter SSL via Python interface.....: |TwitVim-ssl-python|
  44 | 	     Twitter SSL via Tcl interface........: |TwitVim-ssl-tcl|
  45 | 	3.5. Hide the header in timeline buffer...: |TwitVim-hide-header|
  46 | 	     twitvim_show_header..................: |twitvim_show_header|
  47 | 	3.6. Timeline filtering...................: |TwitVim-filter|
  48 | 	     twitvim_filter_enable................: |twitvim_filter_enable|
  49 | 	     twitvim_filter_regex.................: |twitvim_filter_regex|
  50 | 	3.7. Preventing Loading...................: |TwitVim-noload|
  51 | 	4. Manual.................................: |TwitVim-manual|
  52 | 	4.1. TwitVim's Buffers....................: |TwitVim-buffers|
  53 | 	     twitvim_timestamp_format.............: |twitvim_timestamp_format|
  54 | 	4.2. Update Commands......................: |TwitVim-update-commands|
  55 | 	     :PosttoTwitter.......................: |:PosttoTwitter|
  56 | 	     :CPosttoTwitter......................: |:CPosttoTwitter|
  57 | 	     :BPosttoTwitter......................: |:BPosttoTwitter|
  58 | 	     :SendDMTwitter.......................: |:SendDMTwitter|
  59 | 	4.3. Timeline Commands....................: |TwitVim-timeline-commands|
  60 | 	     :UserTwitter.........................: |:UserTwitter|
  61 | 	     twitvim_count........................: |twitvim_count|
  62 | 	     :FriendsTwitter......................: |:FriendsTwitter|
  63 | 	     :MentionsTwitter.....................: |:MentionsTwitter|
  64 | 	     :RepliesTwitter......................: |:RepliesTwitter|
  65 | 	     :DMTwitter...........................: |:DMTwitter|
  66 | 	     :DMSentTwitter.......................: |:DMSentTwitter|
  67 | 	     :ListTwitter.........................: |:ListTwitter|
  68 | 	     :RetweetedToMeTwitter................: |:RetweetedToMeTwitter|
  69 | 	     :RetweetedByMeTwitter................: |:RetweetedByMeTwitter|
  70 | 	     :FavTwitter..........................: |:FavTwitter|
  71 | 	     :FollowingTwitter....................: |:FollowingTwitter|
  72 | 	     :FollowersTwitter....................: |:FollowersTwitter|
  73 | 	     :ListInfoTwitter.....................: |:ListInfoTwitter|
  74 | 	     :MembersOfListTwitter................: |:MembersOfListTwitter|
  75 | 	     :SubsOfListTwitter...................: |:SubsOfListTwitter|
  76 | 	     :OwnedListsTwitter...................: |:OwnedListsTwitter|
  77 | 	     :MemberListsTwitter..................: |:MemberListsTwitter|
  78 | 	     :SubsListsTwitter....................: |:SubsListsTwitter|
  79 | 	     :FollowListTwitter...................: |:FollowListTwitter|
  80 | 	     :UnfollowListTwitter.................: |:UnfollowListTwitter|
  81 | 	     :BackTwitter.........................: |:BackTwitter|
  82 | 	     :BackInfoTwitter.....................: |:BackInfoTwitter|
  83 | 	     :ForwardTwitter......................: |:ForwardTwitter|
  84 | 	     :ForwardInfoTwitter..................: |:ForwardInfoTwitter|
  85 | 	     :RefreshTwitter......................: |:RefreshTwitter|
  86 | 	     :RefreshInfoTwitter..................: |:RefreshInfoTwitter|
  87 | 	     :NextTwitter.........................: |:NextTwitter|
  88 | 	     :NextInfoTwitter.....................: |:NextInfoTwitter|
  89 | 	     :PreviousTwitter.....................: |:PreviousTwitter|
  90 | 	     :PreviousInfoTwitter.................: |:PreviousInfoTwitter|
  91 | 	     :SetLoginTwitter.....................: |:SetLoginTwitter|
  92 | 	     :SwitchLoginTwitter..................: |:SwitchLoginTwitter|
  93 | 	     :DeleteLoginTwitter..................: |:DeleteLoginTwitter|
  94 | 	     :ResetLoginTwitter...................: |:ResetLoginTwitter|
  95 | 	     :FollowTwitter.......................: |:FollowTwitter|
  96 | 	     :UnfollowTwitter.....................: |:UnfollowTwitter|
  97 | 	     :BlockTwitter........................: |:BlockTwitter|
  98 | 	     :UnblockTwitter......................: |:UnblockTwitter|
  99 | 	     :EnableRetweetsTwitter...............: |:EnableRetweetsTwitter|
 100 | 	     :DisableRetweetsTwitter..............: |:DisableRetweetsTwitter|
 101 | 	     :ReportSpamTwitter...................: |:ReportSpamTwitter|
 102 | 	     :AddToListTwitter....................: |:AddToListTwitter|
 103 | 	     :RemoveFromListTwitter...............: |:RemoveFromListTwitter|
 104 | 	4.4. Mappings.............................: |TwitVim-mappings|
 105 | 	     Alt-T................................: |TwitVim-A-t|
 106 | 	     Ctrl-T...............................: |TwitVim-C-t|
 107 | 	     Reply Feature........................: |TwitVim-reply|
 108 | 	     Alt-R................................: |TwitVim-A-r|
 109 | 	     <Leader>r............................: |TwitVim-Leader-r|
 110 | 	     Reply to all Feature.................: |TwitVim-reply-all|
 111 | 	     <Leader>Ctrl-R.......................: |TwitVim-Leader-C-r|
 112 | 	     Retweet Feature......................: |TwitVim-retweet|
 113 | 	     <Leader>R............................: |TwitVim-Leader-S-r|
 114 | 	     Old-style retweets...................: |twitvim_old_retweet|
 115 | 	     twitvim_retweet_format...............: |twitvim_retweet_format|
 116 | 	     Direct Message Feature...............: |TwitVim-direct-message|
 117 | 	     Alt-D................................: |TwitVim-A-d|
 118 | 	     <Leader>d............................: |TwitVim-Leader-d|
 119 | 	     Goto Feature.........................: |TwitVim-goto|
 120 | 	     Alt-G................................: |TwitVim-A-g|
 121 | 	     <Leader>g............................: |TwitVim-Leader-g|
 122 | 	     twitvim_browser_cmd..................: |twitvim_browser_cmd|
 123 | 	     LongURL Feature......................: |TwitVim-LongURL|
 124 | 	     <Leader>e............................: |TwitVim-Leader-e|
 125 | 	     User Profiles........................: |TwitVim-profile|
 126 | 	     <Leader>p............................: |TwitVim-Leader-p|
 127 | 	     In-reply-to..........................: |TwitVim-inreplyto|
 128 | 	     <Leader>@............................: |TwitVim-Leader-@|
 129 | 	     Delete...............................: |TwitVim-delete|
 130 | 	     <Leader>X............................: |TwitVim-Leader-X|
 131 | 	     <Leader>f............................: |TwitVim-Leader-f|
 132 | 	     <Leader>Ctrl-F.......................: |TwitVim-Leader-C-f|
 133 | 	     Ctrl-O...............................: |TwitVim-C-o|
 134 | 	     Ctrl-I...............................: |TwitVim-C-i|
 135 | 	     Refresh..............................: |TwitVim-refresh|
 136 | 	     <Leader><Leader>.....................: |TwitVim-Leader-Leader|
 137 | 	     Next page............................: |TwitVim-next|
 138 | 	     Ctrl-PageDown........................: |TwitVim-C-PageDown|
 139 | 	     Previous page........................: |TwitVim-previous|
 140 | 	     Ctrl-PageUp..........................: |TwitVim-C-PageUp|
 141 | 	4.5. Utility Commands.....................: |TwitVim-utility|
 142 | 	     :BitLy...............................: |:BitLy|
 143 | 	     twitvim_bitly_key....................: |twitvim_bitly_key|
 144 | 	     :ABitLy..............................: |:ABitLy|
 145 | 	     :PBitLy..............................: |:PBitLy|
 146 | 	     :IsGd................................: |:IsGd|
 147 | 	     :AIsGd...............................: |:AIsGd|
 148 | 	     :PIsGd...............................: |:PIsGd|
 149 | 	     :Googl...............................: |:Googl|
 150 | 	     :AGoogl..............................: |:AGoogl|
 151 | 	     :PGoogl..............................: |:PGoogl|
 152 | 	     :SearchTwitter.......................: |:SearchTwitter|
 153 | 	     :RateLimitTwitter....................: |:RateLimitTwitter|
 154 | 	     :ProfileTwitter......................: |:ProfileTwitter|
 155 | 	     :LocationTwitter.....................: |:LocationTwitter|
 156 | 	     :TrendTwitter........................: |:TrendTwitter|
 157 | 	     :SetTrendLocationTwitter.............: |:SetTrendLocationTwitter|
 158 | 	     twitvim_woeid........................: |twitvim_woeid|
 159 | 	5. Timeline Highlighting..................: |TwitVim-highlight|
 160 | 	   twitterUser............................: |hl-twitterUser|
 161 | 	   twitterTime............................: |hl-twitterTime|
 162 | 	   twitterTitle...........................: |hl-twitterTitle|
 163 | 	   twitterLink............................: |hl-twitterLink|
 164 | 	   twitterReply...........................: |hl-twitterReply|
 165 | 	6. Tips and Tricks........................: |TwitVim-tips|
 166 | 	6.1. Timeline Hotkeys.....................: |TwitVim-hotkeys|
 167 | 	6.2. Line length in status line...........: |TwitVim-line-length|
 168 | 	6.3. Network timeout......................: |TwitVim-network-timeout|
 169 | 	7. History................................: |TwitVim-history|
 170 | 	8. Credits................................: |TwitVim-credits|
 171 | 
 172 | 
 173 | ==============================================================================
 174 | 2. Introduction						*TwitVim-intro*
 175 | 
 176 | 	TwitVim is a plugin that allows you to post to Twitter, a
 177 | 	microblogging service at http://www.twitter.com.
 178 | 
 179 | 
 180 | ==============================================================================
 181 | 3. Installation						*TwitVim-install*
 182 | 
 183 | 	
 184 | 	1. Install OpenSSL or compile Vim with |Python|, |Perl|, |Ruby|, or |Tcl|.
 185 | 
 186 | 	In order to compute HMAC-SHA1 digests and sign Twitter OAuth requests,
 187 | 	TwitVim needs to either run the openssl command line tool from the
 188 | 	OpenSSL toolkit or call a HMAC-SHA1 digest function via one of the
 189 | 	above scripting interfaces.
 190 | 
 191 | 	
 192 | 							*TwitVim-OpenSSL*
 193 | 	If you are using a precompiled Vim executable and do not wish to
 194 | 	recompile Vim to add a scripting interface, then the OpenSSL approach
 195 | 	is the simplest.
 196 | 
 197 | 	If OpenSSL is not already on your system, you can download it from
 198 | 	http://openssl.org/  If you are using Windows, check the OpenSSL FAQ
 199 | 	for a link to a precompiled OpenSSL for Windows.
 200 | 
 201 | 	After installing OpenSSL, make sure that the directory where the
 202 | 	openssl executable resides is listed in your PATH environment
 203 | 	variable so that TwitVim can find it.
 204 | 
 205 | 	Note: TwitVim uses the openssl -hmac option, which is not available in
 206 | 	old versions of OpenSSL. I recommend updating to OpenSSL 0.9.8o,
 207 | 	1.0.0a, or later to get the -hmac option and the latest security
 208 | 	fixes.
 209 | 
 210 | 
 211 | 	Instead of using the openssl command line tool, you can also have
 212 | 	TwitVim compute HMAC-SHA1 digests via a Vim scripting interface. This
 213 | 	approach is significantly faster because it does not need to run an
 214 | 	external program. You can use Perl, Python, Python 3, Ruby, or Tcl.
 215 | 
 216 | 	Note: Additional setup may be needed on some systems to enable SSL,
 217 | 	which we now require for security during the OAuth handshake. See
 218 | 	|TwitVim-ssl|.
 219 | 
 220 | 
 221 | 	If you compiled Vim with Perl, add the following to your vimrc:
 222 | >
 223 | 		let twitvim_enable_perl = 1
 224 | <
 225 | 	Also, verify that your Perl installation has the Digest::HMAC_SHA1
 226 | 	module. This module comes standard in some Perl distributions, e.g.
 227 | 	ActivePerl. In other Perl setups, you'll need to download and install
 228 | 	Digest::HMAC_SHA1 from CPAN. The Perl Package Manager PPM may be
 229 | 	helpful here.
 230 | 
 231 | 
 232 | 	If you compiled Vim with Python, add the following to your vimrc:
 233 | >
 234 | 		let twitvim_enable_python = 1
 235 | <
 236 | 	Also, verify that your Python installation has the base64, hashlib,
 237 | 	and hmac modules. All of these are in the Python standard library as
 238 | 	of Python 2.5.
 239 | 
 240 | 	If you compiled Vim with Python 3, add the following to your vimrc
 241 | 	instead:
 242 | >
 243 | 		let twitvim_enable_python3 = 1
 244 | <
 245 | 
 246 | 
 247 | 	If you compiled Vim with Ruby, add the following to your vimrc:
 248 | >
 249 | 		let twitvim_enable_ruby = 1
 250 | <
 251 | 	TwitVim requires the openssl and base64 modules, both of which are
 252 | 	in the Ruby standard library. However, you may need to install the
 253 | 	OpenSSL library from http://www.openssl.org if it is not already on
 254 | 	your system.
 255 | 
 256 | 
 257 | 	If you compiled Vim with Tcl, add the following to your vimrc:
 258 | >
 259 | 		let twitvim_enable_tcl = 1
 260 | <
 261 | 	Also, verify that your Tcl installation has the base64 and sha1
 262 | 	packages. These packages are in the Tcllib library. See
 263 | 	|twitvim_enable_tcl| for help on obtaining and installing this
 264 | 	library.
 265 | 
 266 | 
 267 | 	2. Install cURL.				*TwitVim-cURL*
 268 | 
 269 | 	If you don't already have cURL on your system, download it from
 270 | 	http://curl.haxx.se/. Make sure that the curl executable is in a
 271 | 	directory listed in your PATH environment variable, or the equivalent
 272 | 	for your system.
 273 | 
 274 | 	If you have already compiled Vim with Perl, Python, Python 3, Ruby, or
 275 | 	Tcl for Step 1, I recommend that you use the scripting interface
 276 | 	instead of installing cURL. See |TwitVim-non-cURL| for setup details.
 277 | 	Using a scripting interface for network I/O is faster because it
 278 | 	avoids the overhead of running an external program.
 279 | 
 280 | 
 281 | 	3. twitvim_proxy				*twitvim_proxy*
 282 | 
 283 | 	This step is only needed if you access the web through a HTTP proxy.
 284 | 	If you use a HTTP proxy, add the following to your vimrc:
 285 | >
 286 | 		let twitvim_proxy = "proxyserver:proxyport"
 287 | <
 288 | 	Replace proxyserver with the address of the HTTP proxy and proxyport
 289 | 	with the port number of the HTTP proxy.
 290 | 
 291 | 
 292 | 	4. twitvim_proxy_login				*twitvim_proxy_login*
 293 | 
 294 | 	If the HTTP proxy requires authentication, add the following to your
 295 | 	vimrc:
 296 | >
 297 | 		let twitvim_proxy_login = "proxyuser:proxypassword"
 298 | <
 299 | 	Where proxyuser is your proxy user and proxypassword is your proxy
 300 | 	password.
 301 | 
 302 | 	It is possible to avoid having your proxy password in plaintext in
 303 | 	your vimrc. See |TwitVim-login-base64| for details.
 304 | 
 305 | 
 306 | 	5. Set twitvim_browser_cmd.
 307 | 
 308 | 	In order to log in with Twitter OAuth, TwitVim needs to launch your
 309 | 	web browser and bring up the Twitter authentication web page.
 310 | 
 311 | 	See |twitvim_browser_cmd| for details. For example, if you use Firefox
 312 | 	under Windows, add the following to your vimrc:
 313 | >
 314 | 		let twitvim_browser_cmd = 'firefox.exe'
 315 | <
 316 | 	Under Mac OS X, the following will use the default browser:
 317 | >
 318 | 		let twitvim_browser_cmd = 'open'
 319 | <
 320 | 	Note: If you do not set up twitvim_browser_cmd, TwitVim will display
 321 | 	the authentication URL and wait for you to visit it in your browser
 322 | 	manually and approve the application. If possible, this auth URL
 323 | 	will be shortened with is.gd or Bit.ly for ease of entry.
 324 | 
 325 | 
 326 | 	6. SSL prerequisites
 327 | 
 328 | 	The Twitter API requires SSL. On most system setups, this should
 329 | 	not be a problem but if you are having trouble connecting to
 330 | 	Twitter with TwitVim, see |TwitVim-ssl| for instructions and
 331 | 	prerequisites.
 332 | 
 333 | 
 334 | 	7. Sign into Twitter with OAuth.
 335 | 
 336 | 	Use any TwitVim command that requires authentication. For example,
 337 | 	run |:FriendsTwitter|. |:SetLoginTwitter| is the normal way to
 338 | 	initiate authentication without running a timeline command.
 339 | 
 340 | 	Since TwitVim does not yet have an OAuth access token, it will
 341 | 	initiate the Twitter OAuth handshake. Then it'll launch your web
 342 | 	browser to a special Twitter web page that asks you to authorize
 343 | 	TwitVim to use your account. On this page, sign in, if necessary,
 344 | 	and then click on "Authorize app" to allow TwitVim access to your
 345 | 	account.
 346 | 
 347 | 	Twitter will then report that you have granted access to TwitVim
 348 | 	and display a numeric PIN. Copy the PIN and paste it to the TwitVim
 349 | 	input prompt "Enter OAuth PIN:".
 350 | 
 351 | 	And now, you are ready to use TwitVim.
 352 | 
 353 | 
 354 | ------------------------------------------------------------------------------
 355 | 3.1. TwitVim and OAuth					*TwitVim-OAuth*
 356 | 
 357 | 	After you log into Twitter with OAuth, TwitVim stores the OAuth
 358 | 	access token in a file so that you won't have to log in again when
 359 | 	you restart TwitVim. By default, this file is $HOME/.twitvim.token
 360 | 
 361 | 						*twitvim_token_file*
 362 | 	You can change the name and location of this token file by setting
 363 | 	twitvim_token_file in your vimrc. For example:
 364 | >
 365 | 		let twitvim_token_file = "/etc/.twitvim.token"
 366 | <
 367 | 	Since the access token grants full access to your Twitter account,
 368 | 	it is recommended that you place the token file in a directory that
 369 | 	is not readable or accessible by other users.
 370 | 
 371 | 
 372 | 						*twitvim_disable_token_file*
 373 | 	If you are using TwitVim on an insecure system, you may prefer to 
 374 | 	not save access tokens at all. To turn off the token file, add
 375 | 	the following to your vimrc:
 376 | >
 377 | 		let twitvim_disable_token_file = 1
 378 | <
 379 | 	If the token file is disabled, TwitVim will initiate an OAuth
 380 | 	handshake every time you restart it.
 381 | 
 382 | 
 383 | 	If TwitVim is logged in and you need to log in as a different
 384 | 	Twitter user:
 385 | 	 - Visit the Twitter website in a web browser
 386 | 	 - Sign out and then sign in as the other user.
 387 | 	 - Then use |:SetLoginTwitter| to authenticate as that user.
 388 | 
 389 | 
 390 | ------------------------------------------------------------------------------
 391 | 3.1.1. OAuth Consumer Key			*TwitVim-OAuth-Consumer*
 392 | 
 393 | 						*twitvim_consumer_key*
 394 | 						*twitvim_consumer_secret*
 395 | 	TwitVim comes with a default consumer key and secret pair. If you wish
 396 | 	to use your own, add the following to your vimrc:
 397 | >
 398 | 		let twitvim_consumer_key = "key"
 399 | 		let twitvim_consumer_secret = "secret"
 400 | <
 401 | 	where "key" and "secret" are consumer key and secret strings from the
 402 | 	"My applications" section of the Twitter developers website after you
 403 | 	have registered a Twitter application.
 404 | 
 405 | 	The process of registering a Twitter application has changed from time
 406 | 	to time. Currently, the steps are as follows:
 407 | 
 408 | 	1. Go to https://dev.twitter.com/apps/new and fill in the details. Use
 409 | 	anything you like for name, description, and website. Read and agree
 410 | 	to the developer rules. No callback URL is needed.
 411 | 
 412 | 	2. The Consumer key and secret are on the next screen under "OAuth
 413 | 	settings". Add these strings to your vimrc.
 414 | 
 415 | 	3. Go to the Settings tab. Select "Read, Write and Access direct
 416 | 	messages" under Application Type / Access. Then click on "Update this
 417 | 	Twitter application's settings". These permissions are required by
 418 | 	TwitVim.
 419 | 
 420 | 
 421 | ------------------------------------------------------------------------------
 422 | 3.2. Base64-Encoded Login				*TwitVim-login-base64*
 423 | 
 424 | 	For safety purposes, TwitVim allows you to configure your proxy
 425 | 	login information preencoded in Base64. This is not truly secure as
 426 | 	it is not encryption but it can stop casual onlookers from reading
 427 | 	off your password when you edit your vimrc.
 428 | 
 429 | 						*twitvim_proxy_login_b64*
 430 | 	To configure the proxy login in base64, add the following to your
 431 | 	vimrc:
 432 | >
 433 | 		let twitvim_proxy_login_b64 = "base64string"
 434 | <
 435 | 	Where base64string is your username:password encoded in Base64.
 436 | 
 437 | 
 438 | 	An example:
 439 | 
 440 | 	Let's say your HTTP proxy requires a login user name of "proxyuser"
 441 | 	and a password of "proxypassword". So you need to encode
 442 | 	"proxyuser:proxypassword" in Base64. You can either use a
 443 | 	standalone utility or websites like the following:
 444 | 	http://www.motobit.com/util/base64-decoder-encoder.asp
 445 | 	http://www.opinionatedgeek.com/DotNet/Tools/Base64Encode/default.aspx
 446 | 	http://www.base64encode.org/
 447 | 
 448 | 	The result is: cHJveHl1c2VyOnByb3h5cGFzc3dvcmQ=
 449 | 
 450 | 	Then you can add the following to your vimrc:
 451 | >
 452 | 		let twitvim_login_b64 = "cHJveHl1c2VyOnByb3h5cGFzc3dvcmQ="
 453 | <
 454 | 	And your setup is ready.
 455 | 
 456 | 
 457 | ------------------------------------------------------------------------------
 458 | 3.3. Alternatives to cURL				*TwitVim-non-cURL*
 459 | 
 460 | 	TwitVim supports http networking through Vim's |Perl|, |Python|,
 461 | 	|Ruby|, and |Tcl| interfaces, so if you have any of those interfaces
 462 | 	compiled into your Vim program, you can use that instead of cURL.
 463 | 	
 464 | 	Generally, it is slightly faster to use one of those scripting
 465 | 	interfaces for networking because it avoids running an external
 466 | 	program. On Windows, it also avoids a brief taskbar flash when cURL
 467 | 	runs.
 468 | 
 469 | 	To find out if you have those interfaces, use the |:version| command
 470 | 	and check the |+feature-list|. Then to enable this special http
 471 | 	networking code in TwitVim, add one of the following lines to your
 472 | 	vimrc:
 473 | >
 474 | 		let twitvim_enable_perl = 1
 475 | 		let twitvim_enable_python = 1
 476 | 		let twitvim_enable_python3 = 1
 477 | 		let twitvim_enable_ruby = 1
 478 | 		let twitvim_enable_tcl = 1
 479 | <
 480 | 	You can enable more than one scripting language but TwitVim will only
 481 | 	use the first one it finds.
 482 | 
 483 | 
 484 | 	1. Perl interface				*twitvim_enable_perl*
 485 | 
 486 | 	To enable TwitVim's Perl networking code, add the following to your
 487 | 	vimrc:
 488 | >
 489 | 		let twitvim_enable_perl = 1
 490 | <
 491 | 	TwitVim requires the MIME::Base64 and LWP::UserAgent modules. If you
 492 | 	have ActivePerl, these modules are included in the default
 493 | 	installation.
 494 | 
 495 | 
 496 | 	2. Python interface				*twitvim_enable_python*
 497 | 							*twitvim_enable_python3*
 498 | 
 499 | 	To enable TwitVim's Python networking code, add the following to your
 500 | 	vimrc:
 501 | >
 502 | 		let twitvim_enable_python = 1
 503 | <
 504 | 	TwitVim requires the urllib, urllib2, and base64 modules. These
 505 | 	modules are in the Python standard library.
 506 | 
 507 | 	If Vim is using Python 3, add the following to your vimrc instead:
 508 | >
 509 | 		let twitvim_enable_python3 = 1
 510 | <
 511 | 	For Python 3, TwitVim requires the urllib, socket, and base64 modules.
 512 | 	These modules are in the Python 3 standard library.
 513 | 
 514 | 
 515 | 	3. Ruby interface				*twitvim_enable_ruby*
 516 | 
 517 | 	To enable TwitVim's Ruby networking code, add the following to your
 518 | 	vimrc:
 519 | >
 520 | 		let twitvim_enable_ruby = 1
 521 | <
 522 | 	TwitVim requires the net/http, uri, and Base64 modules. These modules
 523 | 	are in the Ruby standard library.
 524 | 
 525 | 	In addition, TwitVim requires Vim 7.2.360 or later to fix an if_ruby
 526 | 	problem with Windows sockets.
 527 | 
 528 | 	Alternatively, you can add the following patch to the Vim sources:
 529 | 
 530 | 	http://www.mail-archive.com/vim_dev@googlegroups.com/msg03693.html
 531 | 
 532 | 	See also Bram's correction to the patch:
 533 | 
 534 | 	http://www.mail-archive.com/vim_dev@googlegroups.com/msg03713.html
 535 | 
 536 | 
 537 | 	3. Tcl interface				*twitvim_enable_tcl*
 538 | 
 539 | 	To enable TwitVim's Tcl networking code, add the following to your
 540 | 	vimrc:
 541 | >
 542 | 		let twitvim_enable_tcl = 1
 543 | <
 544 | 	TwitVim requires the http, uri, and base64 packages. uri and base64
 545 | 	are in the Tcllib library so you may need to install that. See
 546 | 	http://tcllib.sourceforge.net/
 547 | 
 548 | 	If you have ActiveTcl 8.5, the default installation does not include
 549 | 	Tcllib. Run the following command from the shell to add Tcllib:
 550 | >
 551 | 		teacup install tcllib85
 552 | <
 553 | 
 554 | ------------------------------------------------------------------------------
 555 | 3.4. Using Twitter SSL API				*TwitVim-ssl*
 556 | 
 557 | 	On most up-to-date systems, you should be able to use SSL with no
 558 | 	problems. In case you do run into problems, I review the
 559 | 	prerequisites below.
 560 | 
 561 | 
 562 | 	1. SSL via cURL					*TwitVim-ssl-curl*
 563 | 
 564 | 	To use SSL via cURL, you need to install the SSL libraries and an
 565 | 	SSL-enabled build of cURL.
 566 | 
 567 | 							*twitvim_cert_insecure*
 568 | 	Even after you've done that, cURL may complain about certificates that
 569 | 	failed verification. If you need to override certificate checking, set
 570 | 	twitvim_cert_insecure:
 571 | >
 572 | 		let twitvim_cert_insecure = 1
 573 | <
 574 | 
 575 | 	2. SSL via Perl interface			*TwitVim-ssl-perl*
 576 | 
 577 | 	To use SSL via the TwitVim Perl interface (See |twitvim_enable_perl|),
 578 | 	you need to install the SSL libraries and the Crypt::SSLeay Perl
 579 | 	module.
 580 | 
 581 | 	If you are using SSL over a proxy, do not set twitvim_proxy and
 582 | 	twitvim_proxy_login. Crypt::SSLeay gets proxy information from the
 583 | 	environment, so add this to your vimrc instead:
 584 | >
 585 | 		let $HTTPS_PROXY="http://proxyserver:proxyport"
 586 | 		let $HTTPS_PROXY_USERNAME="user"
 587 | 		let $HTTPS_PROXY_PASSWORD="password"
 588 | <
 589 | 	Alternatively, you can set these environment variables before starting
 590 | 	Vim.
 591 | 
 592 | 
 593 | 	3. SSL via Ruby interface			*TwitVim-ssl-ruby*
 594 | 
 595 | 	To use SSL via Ruby, you need to install the SSL libraries and an
 596 | 	SSL-enabled build of Ruby.
 597 | 
 598 | 	If Ruby produces the error "`write': Bad file descriptor" in http.rb,
 599 | 	then you need to check your certificates or override certificate
 600 | 	checking. See |twitvim_cert_insecure|.
 601 | 
 602 | 	Set twitvim_proxy and twitvim_proxy_login as usual if using SSL over a
 603 | 	proxy.
 604 | 
 605 | 
 606 | 	4. SSL via Python interface			*TwitVim-ssl-python*
 607 | 
 608 | 	To use SSL via Python, you need to install the SSL libraries and an
 609 | 	SSL-enabled build of Python.
 610 | 
 611 | 	The Python interface does not yet support SSL over a proxy. This is
 612 | 	due to a missing feature in urllib2.
 613 | 
 614 | 
 615 | 	5. SSL via Tcl interface			*TwitVim-ssl-tcl*
 616 | 
 617 | 	To use SSL via Tcl, you need to install the SSL libraries and Tcllib.
 618 | 	To be more specific, TwitVim needs the tls package from Tcllib.
 619 | 
 620 | 	Versions of Vim up to 7.3.450 have a bug that prevents the tls package
 621 | 	from being loaded if you compile Vim with Tcl 8.5. This discussion
 622 | 	thread explains the problem:
 623 | >
 624 | 	http://objectmix.com/tcl/15892-tcl-interp-inside-vim-throws-error-w-clock-format.html
 625 | <
 626 | 	If you need to use Twitter SSL with the Tcl interface, you can try one
 627 | 	of the following workarounds:
 628 | 
 629 | 	a. Upgrade Vim to version 7.3.451 or later.
 630 | 	b. Downgrade Tcl to Tcl 8.4.
 631 | 	c. Edit if_tcl.c in the Vim source code to remove the redefinition of
 632 | 	catch. Then rebuild Vim.
 633 | 
 634 | 
 635 | ------------------------------------------------------------------------------
 636 | 3.5. Hide the header in timeline and info buffers	*TwitVim-hide-header*
 637 | 
 638 | 	In the timeline and info buffers, the first two lines are header
 639 | 	lines. The first line tells you the type of buffer it is (e.g.
 640 | 	friends, user, replies, direct messages, search in the timeline
 641 | 	buffer; friends, followers, user profile in the info buffer) and other
 642 | 	relevant buffer information. (e.g. user name, search terms, page
 643 | 	number) The second line is a separator line.
 644 | 
 645 | 	If you wish to suppress the header display, set twitvim_show_header
 646 | 	to 0:
 647 | 
 648 | 							*twitvim_show_header*
 649 | >
 650 | 		let twitvim_show_header = 0
 651 | <
 652 | 	If twitvim_show_header is unset, it defaults to 1, i.e. show the
 653 | 	header.
 654 | 
 655 | 	Note: Setting twitvim_show_header does not change the timeline buffer
 656 | 	immediately. Use |:RefreshTwitter| to refresh the timeline (or
 657 | 	|:RefreshInfoTwitter| to refresh the info buffer) to see the
 658 | 	effect. Also, twitvim_show_header does not retroactively alter
 659 | 	previous timelines in the timeline stack.
 660 | 
 661 | 
 662 | ------------------------------------------------------------------------------
 663 | 3.6. Timeline filtering					*TwitVim-filter*
 664 | 
 665 | 	TwitVim allows you to filter your timeline buffer to hide tweets
 666 | 	containing a pattern.
 667 | 
 668 | 	To enable timeline filtering, set twitvim_filter_enable to 1:
 669 | 
 670 | 							*twitvim_filter_enable*
 671 | >
 672 | 		let twitvim_filter_enable = 1
 673 | <
 674 | 	Then set twitvim_filter_regex to the pattern you wish to filter out of
 675 | 	the timeline. For example, to hide GetGlue tweets and tweets
 676 | 	containing Youtube URLs, use the following:
 677 | 
 678 | 							*twitvim_filter_regex*
 679 | >
 680 | 		let twitvim_filter_regex = '@GetGlue\|/youtu\.be/'
 681 | <
 682 | 	The filter is a regular expression. See |pattern| for patterns that
 683 | 	are accepted. The |'ignorecase'| option sets the ignore-caseness of
 684 | 	the pattern. |'smartcase'| is not used. The matching is always done
 685 | 	like 'magic' is set and 'cpoptions' is empty. (Essentially, this is
 686 | 	the same as |match()| because that is what it uses.)
 687 | 
 688 | 	Be as specific as possible when setting the filter. For example, if
 689 | 	you filter on "youtube", you are potentially also filtering out
 690 | 	conversations about Youtube in addition to Youtube status updates.
 691 | 
 692 | 	Timeline filtering removes tweets from your timeline, so the timeline
 693 | 	display may be shorter than usual. Increase |twitvim_count| to
 694 | 	compensate, if necessary.
 695 | 
 696 | 
 697 | ------------------------------------------------------------------------------
 698 | 3.7. Preventing Loading					*TwitVim-noload*
 699 | 
 700 | 	If you have TwitVim installed but for some reason don't wish to run
 701 | 	it, then you can avoid loading the plugin by adding the following
 702 | 	to your vimrc:
 703 | >
 704 | 		let loaded_twitvim = 1
 705 | <
 706 | 
 707 | ==============================================================================
 708 | 4. TwitVim Manual					*TwitVim-manual*
 709 | 
 710 | ------------------------------------------------------------------------------
 711 | 4.1. TwitVim's Buffers					*TwitVim-buffers*
 712 | 
 713 | 	TwitVim has 2 buffers, a timeline buffer and an info buffer.
 714 | 
 715 | 	Commands such as |:FriendsTwitter|, |:MentionsTwitter|, |:DMTwitter|,
 716 | 	and |:ListTwitter| bring up a timeline buffer. This buffer consists of
 717 | 	a list of tweets or messages. See |TwitVim-mappings| for a list of
 718 | 	mappings that are local to this buffer.
 719 | 
 720 | 	Commands such as |:ProfileTwitter|, |:FollowingTwitter|,
 721 | 	|:FollowersTwitter|, and |:OwnedListsTwitter| bring up an info buffer.
 722 | 	This buffer may consist of a list of users or a list of Twitter lists.
 723 | 	In the case of |:ProfileTwitter|, it is a list of fields from one user
 724 | 	profile. Only a subset of the mappings in |:TwitVim-mappings| will
 725 | 	work in the info buffer.
 726 | 
 727 | 	TwitVim splits the window and opens a new timeline buffer only if one
 728 | 	does not already exist. Otherwise, it reuses the existing timeline
 729 | 	buffer. The same behavior applies to the info buffer.
 730 | 
 731 | 						*twitvim_timestamp_format*
 732 | 	You can customize the timestamp format in a timeline buffer by setting
 733 | 	twitvim_timestamp_format. For example, to show only the time, add this
 734 | 	to your vimrc:
 735 | >
 736 | 		let twitvim_timestamp_format = '%I:%M %p'
 737 | <
 738 | 	TwitVim uses |strftime()| to format timestamps, so you will need to
 739 | 	check the manual page of the C function strftime() to see what
 740 | 	formatting codes you can use here.
 741 | 
 742 | 
 743 | ------------------------------------------------------------------------------
 744 | 4.2. Update Commands				*TwitVim-update-commands*
 745 | 
 746 | 	These commands post an update to your Twitter account. If the friends,
 747 | 	user, or public timeline is visible, TwitVim will insert the update
 748 | 	into the timeline view after posting it.
 749 | 
 750 | 	Note: If you are replying to a tweet, use the <Leader>r mapping in the
 751 | 	timeline buffer instead. See |TwitVim-reply|. That mapping will set
 752 | 	the in-reply-to field, which :PosttoTwitter can't handle.
 753 | 
 754 | 	:PosttoTwitter					*:PosttoTwitter*
 755 | 
 756 | 	This command will prompt you for a message and post it to Twitter.
 757 | 
 758 | 	Note: Since this command uses input(), command-line editing and
 759 | 	history features are available here. In particular, you can use
 760 | 	<Up> and <Down> to recall previous tweets. See |history|.
 761 | 
 762 | 	:CPosttoTwitter					*:CPosttoTwitter*
 763 | 
 764 | 	This command posts the current line in the current buffer to Twitter.
 765 | 
 766 | 	:BPosttoTwitter					*:BPosttoTwitter*
 767 | 
 768 | 	This command posts the contents of the current buffer to Twitter.
 769 | 
 770 | 	:SendDMTwitter {username}			*:SendDMTwitter*
 771 | 
 772 | 	This command will prompt you for a direct message to send to user
 773 | 	{username}.
 774 | 
 775 |         Note: As of mid-August, 2015, Twitter raised the character limit for
 776 |         direct messages to 10,000. However, the 140-character limit still
 777 |         applies to the regular tweets.
 778 | 
 779 | 	Note: If you get a "403 Forbidden" error when you try to send a direct
 780 | 	message, check if the user you're messaging is following you. That is
 781 | 	the most common reason for this error when sending a direct message.
 782 | 
 783 | ------------------------------------------------------------------------------
 784 | 4.3. Timeline Commands				*TwitVim-timeline-commands*
 785 | 
 786 | 	These commands retrieve a Twitter timeline and display it in a special
 787 | 	Twitter buffer. TwitVim applies syntax highlighting to highlight
 788 | 	certain elements in the timeline view. See |TwitVim-highlight| for a
 789 | 	list of highlighting groups it uses.
 790 | 
 791 | 
 792 | 	:UserTwitter					*:UserTwitter*
 793 | 	:UserTwitter {username}
 794 | 
 795 | 	This command displays your Twitter timeline.
 796 | 
 797 | 	If you specify a {username}, this command displays the timeline for
 798 | 	that user.
 799 | 
 800 | 							*twitvim_count*
 801 | 	You can configure the number of tweets returned by :UserTwitter by
 802 | 	setting twitvim_count. For example,
 803 | >
 804 | 		let twitvim_count = 50
 805 | <
 806 | 	will make :UserTwitter return 50 tweets instead of the default of 20.
 807 | 	You can set twitvim_count to any integer from 1 to 200.
 808 | 
 809 | 
 810 | 	:FriendsTwitter					*:FriendsTwitter*
 811 | 
 812 | 	This command displays your Twitter timeline with updates from friends
 813 | 	merged in.
 814 | 
 815 | 	You can configure the number of tweets returned by :FriendsTwitter by
 816 | 	setting |twitvim_count|.
 817 | 
 818 | 
 819 | 	:MentionsTwitter				*:MentionsTwitter*
 820 | 	:RepliesTwitter					*:RepliesTwitter*
 821 | 
 822 | 	This command displays a timeline of mentions (updates containing
 823 | 	@username) that you've received from other Twitter users.
 824 | 
 825 | 	:RepliesTwitter is the old name for :MentionsTwitter.
 826 | 
 827 | 	You can configure the number of tweets returned by :MentionsTwitter by
 828 | 	setting |twitvim_count|.
 829 | 
 830 | 
 831 | 	:DMTwitter					*:DMTwitter*
 832 | 
 833 | 	This command displays direct messages that you've received.
 834 | 
 835 | 
 836 | 	:DMSentTwitter					*:DMSentTwitter*
 837 | 
 838 | 	This command displays direct messages that you've sent.
 839 | 
 840 | 
 841 | 	:ListTwitter {list}				*:ListTwitter*
 842 | 	:ListTwitter {user} {list}
 843 | 
 844 | 	This command displays a Twitter list timeline.
 845 | 
 846 | 	In the first form, {user} is assumed to be you so the command will
 847 | 	display a list of yours named {list}.
 848 | 
 849 | 	In the second form, the command displays list {list} from user
 850 | 	{user}.
 851 | 
 852 | 
 853 | 	:RetweetedToMeTwitter				*:RetweetedToMeTwitter*
 854 | 
 855 | 	This command displays a timeline of retweets by others to you.
 856 | 
 857 | 
 858 | 	:RetweetedByMeTwitter				*:RetweetedByMeTwitter*
 859 | 
 860 | 	This command displays a timeline of retweets by you.
 861 | 
 862 | 
 863 | 	:FavTwitter					*:FavTwitter*
 864 | 
 865 | 	This command displays a timeline of your favorites.
 866 | 
 867 | 
 868 | 	:FollowingTwitter				*:FollowingTwitter*
 869 | 	:FollowingTwitter {user}
 870 | 
 871 | 	This command displays a list of people you're following.
 872 | 
 873 | 	If {user} is specified, this command displays a list of people that
 874 | 	user is following.
 875 | 
 876 | 	You can use Ctrl-PageUp and Ctrl-PageDown to page back and forth in
 877 | 	this list. See |TwitVim-previous| and |TwitVim-next|.
 878 | 
 879 | 
 880 | 	:FollowersTwitter				*:FollowersTwitter*
 881 | 	:FollowersTwitter {user}
 882 | 
 883 | 	This command displays a list of people who follow you.
 884 | 
 885 | 	If {user} is specified, this command displays a list of people
 886 | 	following that user.
 887 | 
 888 | 	You can use Ctrl-PageUp and Ctrl-PageDown to page back and forth in
 889 | 	this list. See |TwitVim-previous| and |TwitVim-next|.
 890 | 
 891 | 
 892 | 	:ListInfoTwitter {list}				*:ListInfoTwitter*
 893 | 	:ListInfoTwitter {user} {list}
 894 | 
 895 | 	This command displays summary information on the Twitter list {list}
 896 | 	owned by user {user}. If not specified, {user} is the currently
 897 | 	logged-in user.
 898 | 
 899 | 
 900 | 	:MembersOfListTwitter {list}			*:MembersOfListTwitter*
 901 | 	:MembersOfListTwitter {user} {list}
 902 | 
 903 | 	This command displays members of the Twitter list {list} owned by 
 904 | 	user {user}. If not specified, {user} is the currently logged-in user.
 905 | 
 906 | 
 907 | 	:SubsOfListTwitter {list}			*:SubsOfListTwitter*
 908 | 	:SubsOfListTwitter {user} {list}
 909 | 
 910 | 	This command displays subscribers to the Twitter list {list} owned by 
 911 | 	user {user}. If not specified, {user} is the currently logged-in user.
 912 | 
 913 | 
 914 | 	:OwnedListsTwitter				*:OwnedListsTwitter*
 915 | 	:OwnedListsTwitter {user}
 916 | 
 917 | 	This command displays the lists owned by {user}. If not specified,
 918 | 	{user} is the currently logged-in user.
 919 | 
 920 | 
 921 | 	:MemberListsTwitter				*:MemberListsTwitter*
 922 | 	:MemberListsTwitter {user}
 923 | 
 924 | 	This command displays the lists following {user}. If not specified,
 925 | 	{user} is the currently logged-in user.
 926 | 
 927 | 
 928 | 	:SubsListsTwitter				*:SubsListsTwitter*
 929 | 	:SubsListsTwitter {user}
 930 | 
 931 | 	This command displays the lists followed by {user}. If not specified,
 932 | 	{user} is the currently logged-in user.
 933 | 
 934 | 
 935 | 	:FollowListTwitter {user} {list}		*:FollowListTwitter*
 936 | 
 937 | 	Start following the list {list} owned by {user}.
 938 | 
 939 | 
 940 | 	:UnfollowListTwitter {user} {list}		*:UnfollowListTwitter*
 941 | 
 942 | 	Stop following the list {list} owned by {user}.
 943 | 
 944 | 
 945 | 	:BackTwitter					*:BackTwitter*
 946 | 
 947 | 	This command takes you back to the previous timeline in the timeline
 948 | 	stack. TwitVim saves a limited number of timelines. This command
 949 | 	will display a warning if you attempt to go beyond the oldest saved
 950 | 	timeline. See |TwitVim-C-o|.
 951 | 
 952 | 
 953 | 	:BackInfoTwitter				*:BackInfoTwitter*
 954 | 
 955 | 	This command is similar to |:BackTwitter| but takes you to the
 956 | 	previous display in the info buffer stack instead. See |TwitVim-C-o|.
 957 | 
 958 | 
 959 | 	:ForwardTwitter					*:ForwardTwitter*
 960 | 
 961 | 	This command takes you to the next timeline in the timeline stack.
 962 | 	It will display a warning if you attempt to go past the newest saved
 963 | 	timeline so this command can only be used after :BackTwitter.
 964 | 	See |TwitVim-C-i|.
 965 | 	
 966 | 
 967 | 	:ForwardInfoTwitter				*:ForwardInfoTwitter*
 968 | 
 969 | 	This command is similar to |:ForwardTwitter| but takes you to the
 970 | 	next display in the info buffer stack instead. See |TwitVim-C-o|.
 971 | 
 972 | 
 973 | 	:RefreshTwitter					*:RefreshTwitter*
 974 | 
 975 | 	This command refreshes the timeline. See |TwitVim-Leader-Leader|.
 976 | 
 977 | 
 978 | 	:RefreshInfoTwitter				*:RefreshInfoTwitter*
 979 | 
 980 | 	This command refreshes the info buffer. See |TwitVim-Leader-Leader|.
 981 | 
 982 | 
 983 | 	:NextTwitter					*:NextTwitter*
 984 | 
 985 | 	This command loads the next (older) page in the timeline.
 986 | 	See |TwitVim-C-PageDown|.
 987 | 
 988 | 
 989 | 	:NextInfoTwitter				*:NextInfoTwitter*
 990 | 
 991 | 	This command loads the next page in the info buffer.
 992 | 	See |TwitVim-C-PageDown|.
 993 | 
 994 | 
 995 | 	:PreviousTwitter				*:PreviousTwitter*
 996 | 
 997 | 	This command returns to the first (newest) page in the timeline. If
 998 | 	the timeline is already on the first page, this command issues a
 999 | 	warning and doesn't do anything. See |TwitVim-C-PageUp|.
1000 | 
1001 | 
1002 | 	:PreviousInfoTwitter				*:PreviousInfoTwitter*
1003 | 
1004 | 	This command loads the previous page in the info buffer. If the info
1005 | 	buffer is on the first page, this command issues a warning and doesn't
1006 | 	do anything. See |TwitVim-C-PageUp|.
1007 | 
1008 | 
1009 | 	:SetLoginTwitter				*:SetLoginTwitter*
1010 | 
1011 | 	This command initiates an OAuth login handshake. 
1012 | 
1013 | 	Use this command if you need to log in as another Twitter user.
1014 | 	When the authentication web page comes up, use the "Sign Out" link
1015 | 	to log in as a different user and grant TwitVim access to that
1016 | 	user.
1017 | 	
1018 | 	When you use SetLoginTwitter, TwitVim does not discard the previous
1019 | 	access token. So you can switch back to the previous user using
1020 | 	|:SwitchLoginTwitter|.
1021 | 
1022 | 
1023 | 	:SwitchLoginTwitter				*:SwitchLoginTwitter*
1024 | 	:SwitchLoginTwitter {username},{service}
1025 | 
1026 | 	Switch to another user from the list of saved logins. If
1027 | 	{username},{service} is not specified, SwitchLoginTwitter will display
1028 | 	a list of logins and prompt you to select one of those.
1029 | 
1030 | 	Tab completion is available for this command, so you can enter
1031 | 	:SwitchLoginTwitter, the space key, and then the tab key to pick from
1032 | 	a list of saved logins.
1033 | 
1034 | 	SwitchLoginTwitter knows only about user accounts to which you have
1035 | 	logged in previously. To switch to a new user account, use
1036 | 	|:SetLoginTwitter| instead.
1037 | 
1038 | 
1039 | 	:DeleteLoginTwitter				*:DeleteLoginTwitter*
1040 | 	:DeleteLoginTwitter {username},{service}
1041 | 
1042 | 	Deletes a user from the list of saved logins. If {username},{service}
1043 | 	is not specified, DeleteLoginTwitter will display a list of logins and
1044 | 	prompt you to select one of those.
1045 | 
1046 | 	Tab completion is available for this command, so you can enter
1047 | 	:DeleteLoginTwitter, the space key, and then the tab key to pick from
1048 | 	a list of saved logins.
1049 | 
1050 | 	DeleteLoginTwitter knows only about user accounts to which you have
1051 | 	logged in previously.
1052 | 	
1053 | 	Note: You cannot delete the currently active user. If you need to do
1054 | 	so, use :SwitchLoginTwitter to switch to another user first.
1055 | 
1056 | 
1057 | 	:ResetLoginTwitter				*:ResetLoginTwitter*
1058 | 
1059 | 	This command discards the current OAuth access token and all saved
1060 | 	tokens. The next TwitVim command that needs authentication will
1061 | 	initiate an OAuth handshake.
1062 | 
1063 | 	After using ResetLoginTwitter, you won't be able to switch to any
1064 | 	users using |:SwitchLoginTwitter| because ResetLoginTwitter discards
1065 | 	all saved access tokens. Use |:DeleteLoginTwitter| instead if you only
1066 | 	wish to discard one saved token.
1067 | 
1068 | 
1069 | 	:FollowTwitter {username}			*:FollowTwitter*
1070 | 
1071 | 	Start following user {username}'s timeline. If the user's timeline is
1072 | 	protected, this command makes a request to follow that user.
1073 | 
1074 | 	Note: This command does not enable notifications for the target user.
1075 | 	If you need that, you'll have to do that separately through the web
1076 | 	interface.
1077 | 
1078 | 
1079 | 	:UnfollowTwitter {username}			*:UnfollowTwitter*
1080 | 
1081 | 	Stop following user {username}'s timeline.
1082 | 
1083 | 
1084 | 	:BlockTwitter {username}			*:BlockTwitter*
1085 | 
1086 | 	Block user {username}.
1087 | 
1088 | 
1089 | 	:UnblockTwitter {username}			*:UnblockTwitter*
1090 | 
1091 | 	Unblock user {username}.
1092 | 
1093 | 
1094 | 	:ReportSpamTwitter {username}			*:ReportSpamTwitter*
1095 | 
1096 | 	Reports user {username} for spam. This command will also block the
1097 | 	user.
1098 | 
1099 | 
1100 | 	:EnableRetweetsTwitter {username}	*:EnableRetweetsTwitter*
1101 | 
1102 | 	Start showing retweets from user {username} in friends timeline.
1103 | 	
1104 | 	Note: This option may not take effect immediately since Twitter uses
1105 | 	cached data to construct the timeline.
1106 | 
1107 | 
1108 | 	:DisableRetweetsTwitter {username}	*:DisableRetweetsTwitter*
1109 | 
1110 | 	Stop showing retweets from user {username} in friends timeline.
1111 | 	
1112 | 	Note: This option may not take effect immediately since Twitter uses
1113 | 	cached data to construct the timeline.
1114 | 
1115 | 
1116 | 	:AddToListTwitter {listname} {username}		*:AddToListTwitter*
1117 | 
1118 | 	Adds user {username} to list {listname}.
1119 | 
1120 | 
1121 | 	:RemoveFromListTwitter {listname} {username}	*:RemoveFromListTwitter*
1122 | 
1123 | 	Removes user {username} from list {listname}.
1124 | 
1125 | 
1126 | ------------------------------------------------------------------------------
1127 | 4.4. Mappings						*TwitVim-mappings*
1128 | 
1129 | 	Alt-T						*TwitVim-A-t*
1130 | 	Ctrl-T						*TwitVim-C-t*
1131 | 
1132 | 	In visual mode, Alt-T posts the highlighted text to Twitter.
1133 | 
1134 | 	Ctrl-T is an alternative to the Alt-T mapping. In GUI Vim on
1135 | 	certain platforms like Windows, if the menu bar is enabled, Alt-T
1136 | 	pulls down the Tools menu. So use Ctrl-T instead.
1137 | 
1138 | 
1139 | 							*TwitVim-reply*
1140 | 	Alt-R						*TwitVim-A-r*
1141 | 	<Leader>r					*TwitVim-Leader-r*
1142 | 
1143 | 	This mapping is local to the timeline buffer. In the timeline buffer,
1144 | 	it starts composing an @-reply on the command line to the author of
1145 | 	the tweet on the current line.
1146 | 
1147 | 	Under Cygwin, Alt-R is not recognized so you can use <Leader>r as an
1148 | 	alternative. The <Leader> character defaults to \ (backslash) but see
1149 | 	|mapleader| for information on customizing that.
1150 | 
1151 | 	Note: Since this command uses input(), command-line editing and
1152 | 	history features are available here. In particular, you can use
1153 | 	<Up> and <Down> to recall previous tweets. See |history|.
1154 | 
1155 | 
1156 | 							*TwitVim-reply-all*
1157 | 	<Leader>Ctrl-R					*TwitVim-Leader-C-r*
1158 | 
1159 | 	This mapping is local to the timeline buffer. It starts composing a
1160 | 	reply to all, i.e. a reply to the tweet author and also to everyone
1161 | 	mentioned in @-replies on the current line.
1162 | 
1163 | 
1164 | 							*TwitVim-retweet*
1165 | 	<Leader>R					*TwitVim-Leader-S-r*
1166 | 
1167 | 	This mapping (Note: uppercase 'R' instead of 'r'.) is local to the
1168 | 	timeline buffer. It is similar to the retweet feature in popular
1169 | 	Twitter clients. In the timeline buffer, it retweets the current line.
1170 | 
1171 | 
1172 | 							*twitvim_old_retweet*
1173 | 	If you prefer old-style retweets, add this to your vimrc:
1174 | >
1175 | 		let twitvim_old_retweet = 1
1176 | <	
1177 | 	The difference is an old-style retweet does not use the retweet API.
1178 | 	Instead, it copies the current line to the command line so that you
1179 | 	can repost it as a new tweet and optionally edit it or add your own
1180 | 	comments. Note that an old-style retweet may end up longer than 140
1181 | 	characters. If you have problems posting a retweet, try editing it to
1182 | 	make it shorter.
1183 | 
1184 | 						    *twitvim_retweet_format*
1185 | 	If you use old-style retweets, you can configure the retweet format.
1186 | 	By default, TwitVim retweets tweets in the following format:
1187 | 
1188 | 		RT @user: text of the tweet
1189 | 
1190 | 	You can customize the retweet format by adding the following to your
1191 | 	vimrc, for example:
1192 | >
1193 | 		let twitvim_retweet_format = 'Retweet from %s: %t'
1194 | 
1195 | 		let twitvim_retweet_format = '%t (retweeted from %s)'
1196 | <
1197 | 	When you retweet a tweet, TwitVim will replace "%s" in
1198 | 	twitvim_retweet_format with the user name of the original poster and
1199 | 	"%t" with the text of the tweet.
1200 | 
1201 | 	The default setting of twitvim_retweet_format is "RT %s: %t"
1202 | 
1203 | 
1204 | 							*TwitVim-direct-message*
1205 | 	Alt-D						*TwitVim-A-d*
1206 | 	<Leader>d					*TwitVim-Leader-d*
1207 | 
1208 | 	This mapping is local to the timeline buffer. In the timeline buffer,
1209 | 	it starts composing a direct message on the command line to the author
1210 | 	of the tweet on the current line.
1211 | 
1212 | 	Under Cygwin, Alt-D is not recognized so you can use <Leader>d as an
1213 | 	alternative. The <Leader> character defaults to \ (backslash) but see
1214 | 	|mapleader| for information on customizing that.
1215 | 
1216 | 	Note: If you get a "403 Forbidden" error when you try to send a direct
1217 | 	message, check if the user you're messaging is following you. That is
1218 | 	the most common reason for this error when sending a direct message.
1219 | 
1220 | 
1221 | 							*TwitVim-goto*
1222 | 	Alt-G						*TwitVim-A-g*
1223 | 	<Leader>g					*TwitVim-Leader-g*
1224 | 
1225 | 	This mapping is local to the timeline and info buffers. It
1226 | 	launches the web browser with the URL at the cursor position. If you
1227 | 	visually select text before invoking this mapping, it launches the web
1228 | 	browser with the selected text as is.
1229 | 
1230 | 	Special cases:
1231 | 
1232 | 	- If the cursor is on a word of the form @user or in the user: portion
1233 | 	  at the beginning of a line, TwitVim displays that user's
1234 | 	  timeline.
1235 | 
1236 | 	- If the cursor is on a Name: line in the info buffer, TwitVim
1237 | 	  displays that user's timeline.
1238 | 
1239 | 	- If the cursor is on a word of the form #hashtag, TwitVim does a
1240 | 	  Twitter Search for that #hashtag.
1241 | 
1242 | 	- In a trending topics buffer, TwitVim does a Twitter Search for the
1243 | 	  phrase on the cursor line.
1244 | 
1245 | 
1246 | 							*twitvim_browser_cmd*
1247 | 	Before using this command, you need to tell TwitVim how to launch your
1248 | 	browser. For example, you can add the following to your vimrc:
1249 | >
1250 | 		let twitvim_browser_cmd = 'firefox.exe'
1251 | <
1252 | 	Of course, replace firefox.exe with the browser of your choice.
1253 | 
1254 | 	Under Mac OS X, the following will use the default browser:
1255 | >
1256 | 		let twitvim_browser_cmd = 'open'
1257 | <
1258 | 
1259 | 							*TwitVim-LongURL*
1260 | 	<Leader>e					*TwitVim-Leader-e*
1261 | 
1262 | 	This mapping is local to the timeline and info buffers. It
1263 | 	calls the LongURL API (see http://longurl.org/) to expand the short
1264 | 	URL at the cursor position. A short URL is a URL from a URL shortening
1265 | 	service such as TinyURL, SnipURL, etc. Use this feature if you wish to
1266 | 	preview a URL before browsing to it with |TwitVim-goto|.
1267 | 
1268 | 	If you visually select text before invoking this mapping, it calls the
1269 | 	LongURL API with the selected text as is.
1270 | 
1271 | 	If successful, TwitVim will display the result from LongURL in the
1272 | 	message area.
1273 | 
1274 | 
1275 | 							*TwitVim-profile*
1276 | 	<Leader>p					*TwitVim-Leader-p*
1277 | 
1278 | 	This mapping is local to the timeline and info buffers. It retrieves
1279 | 	user profile information (e.g. name, location, bio, update count) for
1280 | 	the user name at the cursor position. It displays the profile
1281 | 	information in an info buffer.
1282 | 
1283 | 	If you visually select text before invoking this mapping, it uses the
1284 | 	selected text for the user name.
1285 | 
1286 | 	See also |:ProfileTwitter|.
1287 | 
1288 | 
1289 | 							*TwitVim-inreplyto*
1290 | 	<Leader>@					*TwitVim-Leader-@*
1291 | 
1292 | 	This mapping is local to the timeline buffer. If the current line is
1293 | 	an @-reply tweet, it retrieves the tweet to which this one is
1294 | 	replying. Then it will display that predecessor tweet below the
1295 | 	current one.
1296 | 	
1297 | 	If there is no in-reply-to information, it will show a warning and do
1298 | 	nothing.
1299 | 
1300 | 	This mapping is useful in the replies timeline. See |:RepliesTwitter|.
1301 | 
1302 | 
1303 | 							*TwitVim-delete*
1304 | 	<Leader>X					*TwitVim-Leader-X*
1305 | 
1306 | 	This mapping is local to the timeline buffer. The 'X' in the mapping
1307 | 	is uppercase. It deletes the tweet or direct message on the current
1308 | 	line.
1309 | 
1310 | 	Note: You have to be the author of the tweet in order to delete it.
1311 | 	However, you can delete direct messages that you sent or received.
1312 | 
1313 | 
1314 | 							*TwitVim-fave*
1315 | 							*TwitVim-Leader-f*
1316 | 	<Leader>f
1317 | 
1318 | 	This mapping is local to the timeline buffer. It adds the tweet on the
1319 | 	current line to your favorites.
1320 | 
1321 | 
1322 | 							*TwitVim-unfave*
1323 | 							*TwitVim-Leader-C-f*
1324 | 	<Leader>Ctrl-F
1325 | 
1326 | 	This mapping is local to the timeline buffer. It removes the tweet on
1327 | 	the current line from your favorites.
1328 | 
1329 | 
1330 | 	Ctrl-O						*TwitVim-C-o*
1331 | 
1332 | 	This mapping takes you to the previous timeline in the timeline stack.
1333 | 	See |:BackTwitter|.
1334 | 
1335 | 	This mapping also works in the info buffer but uses a separate history
1336 | 	stack. See |:BackInfoTwitter|.
1337 | 
1338 | 
1339 | 	Ctrl-I						*TwitVim-C-i*
1340 | 
1341 | 	This mapping takes you to the next timeline in the timeline stack.
1342 | 	See |:ForwardTwitter|.
1343 | 
1344 | 	This mapping also works in the info buffer but uses a separate history
1345 | 	stack. See |:ForwardInfoTwitter|.
1346 | 
1347 | 
1348 | 							*TwitVim-refresh*
1349 | 	<Leader><Leader> 				*TwitVim-Leader-Leader*
1350 | 
1351 | 	This mapping refreshes the timeline. See |:RefreshTwitter|.
1352 | 
1353 | 	This mapping also works in the info buffer but is of limited utility
1354 | 	there because that info shouldn't change as often as a timeline.
1355 | 	See |:RefreshInfoTwitter|.
1356 | 
1357 | 
1358 | 							*TwitVim-next*
1359 | 	Ctrl-PageDown					*TwitVim-C-PageDown*
1360 | 
1361 | 	This mapping loads the next (older) page in the timeline.
1362 | 	See |:NextTwitter|.
1363 | 
1364 | 	This mapping also works in the info buffer but only if the list is
1365 | 	long enough to use more than one page. It does nothing in the user
1366 | 	profile display. See |:NextInfoTwitter|.
1367 | 
1368 | 	
1369 | 							*TwitVim-previous*
1370 | 	Ctrl-PageUp					*TwitVim-C-PageUp*
1371 | 
1372 | 	This mapping returns to the first (newest) page in the timeline. If
1373 | 	the timeline is already on the first page, it issues a warning and
1374 | 	doesn't do anything. See |:PreviousTwitter|.
1375 | 
1376 | 	This mapping also works in the info buffer but only if the list is
1377 | 	long enough to use more than one page. It does nothing in the user
1378 | 	profile display. See |:PreviousInfoTwitter|.
1379 | 
1380 | 
1381 | ------------------------------------------------------------------------------
1382 | 4.5. Utility Commands					*TwitVim-utility*
1383 | 
1384 | 	Note: You do not need these URL shortening services to post to
1385 | 	Twitter. Simply add the full URL to your tweet and Twitter will use
1386 | 	its own URL wrapper.
1387 | 
1388 | 
1389 | 	:BitLy						*:BitLy*
1390 | 	:BitLy {url}
1391 | 
1392 | 	bit.ly is a URL forwarding and shortening service. See
1393 | 	https://bitly.com/
1394 | 
1395 | 	This command calls the bit.ly API to get a short URL in place of
1396 | 	{url}. If {url} is not provided on the command line, the command will
1397 | 	prompt you to enter a URL. The short URL is then inserted into the
1398 | 	current buffer at the current position.
1399 | 
1400 | 	The bit.ly API requires bit.ly access token. A default
1401 | 	access token is provided with TwitVim and no configuration is
1402 | 	needed.
1403 | 	
1404 | 	However, if you wish to supply your own access token to track
1405 | 	your bit.ly history and stats:
1406 | 	- Go to https://bitly.com/a/oauth_apps
1407 | 	- Enter your password and click on "Generate Token".
1408 | 	- Copy the string below "Generic Access Token" and then add the
1409 | 	  following to your vimrc:
1410 | 
1411 | 							*twitvim_bitly_key*
1412 | >
1413 | 		let twitvim_bitly_key = "accesstoken"
1414 | <
1415 | 	Where accesstoken is the string you obtained from bit.ly.
1416 | 
1417 | 	Note: The bit.ly access token is not the same as the bit.ly API key
1418 | 	used in TwitVim 0.8 and earlier. If you are upgrading TwitVim and
1419 | 	have a bit.ly API key in your vimrc, you'll need to replace it with
1420 | 	a bit.ly access token.
1421 | 
1422 | 	:ABitLy						*:ABitLy*
1423 | 	:ABitLy {url}
1424 | 
1425 | 	Same as :BitLy but appends, i.e. inserts after the current
1426 | 	position instead of at the current position, the short URL instead.
1427 | 
1428 | 	:PBitLy						*:PBitLy*
1429 | 	:PBitLy {url}
1430 | 	
1431 | 	Same as :BitLy but prompts for a tweet on the command line with
1432 | 	the short URL already inserted.
1433 | 
1434 | 
1435 | 	:IsGd						*:IsGd*
1436 | 	:IsGd {url}
1437 | 
1438 | 	is.gd is a URL forwarding and shortening service. See
1439 | 	http://is.gd
1440 | 
1441 | 	This command calls the is.gd API to get a short URL in place of <url>.
1442 | 	If {url} is not provided on the command line, the command will prompt
1443 | 	you to enter a URL. The short URL is then inserted into the current
1444 | 	buffer at the current position.
1445 | 
1446 | 	:AIsGd						*:AIsGd*
1447 | 	:AIsGd {url}
1448 | 
1449 | 	Same as :IsGd but appends, i.e. inserts after the current position
1450 | 	instead of at the current position, the short URL instead.
1451 | 
1452 | 	:PIsGd						*:PIsGd*
1453 | 	:PIsGd {url}
1454 | 	
1455 | 	Same as :IsGd but prompts for a tweet on the command line with the
1456 | 	short URL already inserted.
1457 | 
1458 | 
1459 | 	:Googl						*:Googl*
1460 | 	:Googl {url}
1461 | 
1462 | 	Goo.gl is Google's URL forwarding and shortening service.
1463 | 	See http://goo.gl/
1464 | 
1465 | 	This command calls the goo.gl API to get a short URL in place of
1466 | 	<url>. If {url} is not provided on the command line, the command will
1467 | 	prompt you to enter a URL. The short URL is then inserted into the
1468 | 	current buffer at the current position.
1469 | 
1470 | 	:AGoogl						*:AGoogl*
1471 | 	:AGoogl {url}
1472 | 
1473 | 	Same as :Googl but appends, i.e. inserts after the current position
1474 | 	instead of at the current position, the short URL instead.
1475 | 
1476 | 	:PGoogl						*:PGoogl*
1477 | 	:PGoogl {url}
1478 | 	
1479 | 	Same as :Googl but prompts for a tweet on the command line with the
1480 | 	short URL already inserted.
1481 | 
1482 | 
1483 | 	:SearchTwitter					*:SearchTwitter*
1484 | 	:SearchTwitter {query}
1485 | 	
1486 | 	This command calls the Search API to search for {query}. If {query} is
1487 | 	not provided on the command line, the command will prompt you for it.
1488 | 	Search results are then displayed in the timeline buffer.
1489 | 
1490 | 	All of the Twitter Search operators are supported implicitly. For a
1491 | 	list of search operators, see:
1492 | 	https://support.twitter.com/groups/31-twitter-basics/topics/110-search/articles/71577-how-to-use-advanced-twitter-search
1493 | 
1494 | 	You can configure the number of tweets returned by :SearchTwitter by
1495 | 	setting |twitvim_count|.
1496 | 
1497 | 
1498 | 	:RateLimitTwitter				*:RateLimitTwitter*
1499 | 
1500 | 	This command retrieves rate limit information. It shows the current
1501 | 	limit, how many API calls you have remaining, and when your quota will
1502 | 	be reset. You can use it to check if you have been temporarily locked
1503 | 	out of Twitter for hitting the rate limit.
1504 | 
1505 | 	As of Twitter API 1.1, rate limits are per API endpoint. This
1506 | 	command displays one line per API endpoint and is very verbose.
1507 | 
1508 | 
1509 | 	:ProfileTwitter					*:ProfileTwitter*
1510 | 	:ProfileTwitter {username}
1511 | 
1512 | 	This command retrieves user profile information (e.g. name, location,
1513 | 	bio, update count) for the specified user {username}. It displays the
1514 | 	information in an info buffer.
1515 | 
1516 | 	If {username} is not specified, this command will retrieve
1517 | 	information for the currently logged-in user.
1518 | 
1519 | 	See also |TwitVim-Leader-p|.
1520 | 
1521 | 
1522 | 	:LocationTwitter {location}			*:LocationTwitter*
1523 | 
1524 | 	This command sets the location field in your profile. There is no
1525 | 	mandatory format for the location. It could be a zip code, a town,
1526 | 	coordinates, or pretty much anything.
1527 | 
1528 | 	For example:
1529 | >
1530 | 	:LocationTwitter 10027
1531 | 	:LocationTwitter New York, NY, USA
1532 | 	:LocationTwitter 40.811583, -73.954486
1533 | <
1534 | 
1535 | 	:TrendTwitter					*:TrendTwitter*
1536 | 
1537 | 	This command retrieves a list of Twitter trending topics and displays
1538 | 	them in the timeline buffer.
1539 | 
1540 | 	In trending topics, |TwitVim-Leader-g| does a Twitter search for the
1541 | 	phrase on the cursor line.
1542 | 
1543 | 	By default, this command shows worldwide trends. To show regional
1544 | 	trends, use |:SetTrendLocationTwitter| or set |twitvim_woeid|.
1545 | 
1546 | 
1547 | 	:SetTrendLocationTwitter		 *:SetTrendLocationTwitter*
1548 | 
1549 | 	This command displays a menu of trend locations by country and by
1550 | 	town. It sets the region for |:TrendTwitter|.
1551 | 	
1552 | 
1553 | 							*twitvim_woeid*
1554 | 	If you wish to set the default location for |:TrendTwitter| to
1555 | 	something other than worldwide, set twitvim_woeid in your vimrc.
1556 | 	
1557 | 	For example:
1558 | >
1559 | 		let twitvim_woeid = 2357024
1560 | <
1561 | 	sets the location to Atlanta.
1562 | 	
1563 | 	You can find out what number to use for a location by checking the
1564 | 	message displayed after |:SetTrendLocationTwitter| or by checking
1565 | 	twitvim_woeid after |:SetTrendLocationTwitter|.
1566 | 
1567 | 
1568 | ==============================================================================
1569 | 5. Timeline Highlighting				*TwitVim-highlight*
1570 | 
1571 | 	TwitVim uses a number of highlighting groups to highlight certain
1572 | 	elements in the Twitter timeline views. See |:highlight| for details
1573 | 	on how to customize these highlighting groups.
1574 | 
1575 | 	twitterUser					*hl-twitterUser*
1576 | 	
1577 | 	The Twitter user name at the beginning of each line.
1578 | 
1579 | 	twitterTime					*hl-twitterTime*
1580 | 
1581 | 	The time a Twitter update was posted.
1582 | 
1583 | 	twitterTitle					*hl-twitterTitle*
1584 | 
1585 | 	The header at the top of the timeline view.
1586 | 
1587 | 	twitterLink					*hl-twitterLink*
1588 | 
1589 | 	Link URLs and #hashtags in a Twitter status.
1590 | 
1591 | 	twitterReply					*hl-twitterReply*
1592 | 
1593 | 	@-reply in a Twitter status.
1594 | 
1595 | 
1596 | ==============================================================================
1597 | 6. Tips and Tricks					*TwitVim-tips*
1598 | 
1599 | 	Here are a few tips for using TwitVim more efficiently.
1600 | 
1601 | 
1602 | ------------------------------------------------------------------------------
1603 | 6.1. Timeline Hotkeys					*TwitVim-hotkeys*
1604 | 
1605 | 	TwitVim does not autorefresh. However, you can make refreshing your
1606 | 	timeline easier by mapping keys to the timeline commands. For example,
1607 | 	I use the <F8> key for that:
1608 | >
1609 | 		nnoremap <F8> :FriendsTwitter<cr>
1610 | 		nnoremap <S-F8> :UserTwitter<cr>
1611 | 		nnoremap <A-F8> :RepliesTwitter<cr>
1612 | 		nnoremap <C-F8> :DMTwitter<cr>
1613 | <
1614 | 
1615 | ------------------------------------------------------------------------------
1616 | 6.2. Line length in status line				*TwitVim-line-length*
1617 | 
1618 | 	Add the following to your |'statusline'| to display the length of the
1619 | 	current line:
1620 | >
1621 | 		%{strlen(getline('.'))}
1622 | <	
1623 | 	This is useful if you compose tweets in a separate buffer and post
1624 | 	them with |:CPosttoTwitter|. With the line length in your status line,
1625 | 	you will know when you've reached the 140-character boundary.
1626 | 
1627 | 
1628 | ------------------------------------------------------------------------------
1629 | 6.3. Network timeout				*TwitVim-network-timeout*
1630 | 
1631 | 	TwitVim may have problems connecting to Twitter sometimes. The system
1632 | 	default for socket timeouts may be as long as a few minutes, so
1633 | 	TwitVim will appear to hang for that length of time before displaying
1634 | 	an error message.
1635 | 
1636 | 							*twitvim_net_timeout*
1637 | 	You can set twitvim_net_timeout to reduce this timeout interval. For
1638 | 	example, add the following to your vimrc:
1639 | >
1640 | 		let twitvim_net_timeout = 30
1641 | <
1642 | 	to set the network timeout to 30 seconds.
1643 | 
1644 | 	Note: This option does not seem to work correctly if you are using
1645 | 	|twitvim_enable_perl|. It may take longer than that number of seconds
1646 | 	to time out.
1647 | 
1648 | 
1649 | ==============================================================================
1650 | 7. TwitVim History					*TwitVim-history*
1651 | 
1652 |         0.9.1 : 2015-08-19 * Support higher char limit for DMs.
1653 | 	0.9.0 : 2015-04-10 * Removed identi.ca support and legacy code.
1654 |                            * Removed support for old token file formats.
1655 |                            * Removed old Twitter search code.
1656 |                            * Removed some obscure URL shortening services.
1657 |                            * Updated to bit.ly v3 API.
1658 |                            * Removed old goo.gl URL shortening code.
1659 |                            * Removed services menu because we only have
1660 |                              Twitter now.
1661 |                            * Removed public timeline command.
1662 |                            * Moved most of the plugin code to an autoload
1663 |                              file.
1664 |                            * Search header fix in UTF-8 encoding. (@mattn_jp)
1665 |                            * Don't use curl -p for HTTP. (@mattn_jp)
1666 |                            * Handle surrogate pairs. (@mattn_jp)
1667 | 	0.8.2 : 2014-03-26 * Change Twitter API URLs to https. Twitter no
1668 | 			     longer supports non-SSL.
1669 | 			   * Added support for highlighting $stocksymbol
1670 | 		             and jumping to searches for $stocksymbol.
1671 | 			   * Perform zero-length message check before
1672 | 			     get_cur_service() so a non-logged-in user can
1673 | 			     cancel.
1674 | 			   * Made a proper folder structure and added a
1675 | 			     vimball packing script.
1676 | 	0.8.1 : 2013-08-12 * Fix for suspended users in followers list.
1677 | 			   * Rewrote URL regex for new regex engine in Vim 7.4.
1678 | 	0.8.0 : 2013-01-02 * Support for Twitter API 1.1.
1679 | 			   * Support for identi.ca OAuth and switching between
1680 | 			     Twitter OAuth and identi.ca OAuth logins.
1681 | 			   * Added |twitvim_force_ssl|.
1682 | 			   * Added |:DeleteLoginTwitter|.
1683 | 			   * Add in-reply-to status to old-style retweets.
1684 | 			     (@mattn_jp)
1685 | 			   * Fix for old-style retweets with '&' characters.
1686 | 			   * Some fixes for https proxy support.
1687 | 	0.7.5 : 2012-08-10 * Partial support for identi.ca search.
1688 | 			   * Tightened up |TwitVim-Leader-g| URL matching to
1689 | 			     omit extraneous trailing characters.
1690 | 	0.7.4 : 2012-05-04 * Allow users to customize timestamp format in
1691 | 			     timeline displays. |twitvim_timestamp_format|
1692 | 			   * Take Twitter's URL-wrapping into account when
1693 | 			     counting characters in tweets. You do not have to
1694 | 			     shorten URLs manually any more. Just post to
1695 | 			     Twitter with the original URLs and TwitVim will
1696 | 			     ensure that the tweet fits the 140-character
1697 | 			     limit after Twitter's t.co link-wrapping.
1698 | 			   * Added network timeout option.
1699 | 			     |twitvim_net_timeout|
1700 | 			   * Added Python 3 networking and OAuth code.
1701 | 			     |twitvim_enable_python3|
1702 | 			   * Switched from page-style pagination to
1703 | 			     max_id-style pagination because page-style
1704 | 			     pagination has been deprecated. As a result, all
1705 | 			     timeline commands will cease to accept [count]
1706 | 			     parameters and |:PreviousTwitter| will return to
1707 | 			     the top page regardless of current page number.
1708 | 			   * Switched to new API for |:FollowingTwitter| and
1709 | 			     |:FollowersTwitter| because the old API was
1710 | 			     deprecated.
1711 | 			   * |:FollowTwitter| now stops you from following a
1712 | 			     user that you are already following. This is to
1713 | 			     avoid triggering a Twitter bug where the
1714 | 			     following flag reverts to 'follow request sent'
1715 | 			     if the subject's timeline is protected.
1716 | 	0.7.3 : 2012-01-17 * Switched to JSON API for Twitter Search so that
1717 | 			     TwitVim can support t.co URL expansion and
1718 | 			     in-reply-to in search results.
1719 | 			   * Made the URL-matching pattern more accurate.
1720 | 	0.7.2 : 2011-11-16 * Allow users to use their own consumer key and
1721 | 			     secret. |twitvim_consumer_key|
1722 | 			     |twitvim_consumer_secret|
1723 | 			   * Added t.co URL expansion for media URLs too.
1724 | 			   * Added confirmation prompt before new-style
1725 | 			     retweet.
1726 | 			   * Request trends in JSON format. XML format no
1727 | 			     longer works.
1728 | 			   * Read token file before |:SwitchLoginTwitter|
1729 | 			     (@mattn_jp)
1730 | 	0.7.1 : 2011-09-21 * Added trending topics. |:TrendTwitter| and
1731 | 			     |:SetTrendLocationTwitter|
1732 | 			   * Some fixes for browser-launching issues.
1733 | 			   * Fix for quoting issue when doing goo.gl URL
1734 | 			     shortening with cURL network interface under
1735 | 			     Windows.
1736 | 			   * Support for HTML hex entities.
1737 | 			   * Show 'follow request sent' in user profile
1738 | 			     display if that is the case.
1739 | 	0.7.0 : 2011-07-06 * Replaced many deprecated Twitter API calls with
1740 | 			     updated versions.
1741 | 			   * Improved XML parsing speed for high
1742 | 			     |twitvim_count|.
1743 | 			   * Added |:SwitchLoginTwitter| and other code to
1744 | 			     support multiple saved OAuth logins.
1745 | 	0.6.3 : 2011-05-13 * Expand t.co URLs in timeline displays.
1746 | 			   * Added timeline filtering. |TwitVim-filter|
1747 | 	0.6.2 : 2011-02-21 * Added more user relationship info to
1748 | 			     |:ProfileTwitter|.
1749 | 			   * Added |:EnableRetweetsTwitter| and
1750 | 			     |:DisableRetweetsTwitter|.
1751 | 			   * Switch to new (documented) goo.gl API.
1752 | 			   * Added |:ListInfoTwitter|.
1753 | 	0.6.1 : 2011-01-06 * Fix for buffer stack bug if user closes
1754 | 			     a window manually.
1755 | 			   * Use https OAuth endpoints if user has set up
1756 | 			     https API root.
1757 | 			   * Match a URL even if prefix is in mixed case.
1758 | 	0.6.0 : 2010-10-27 * Added |:FollowingTwitter|, |:FollowersTwitter|.
1759 | 			   * Added |:MembersOfListTwitter|,
1760 | 			     |:SubsOfListTwitter|, |:OwnedListsTwitter|,
1761 | 			     |:MemberListsTwitter|, |:SubsListsTwitter|,
1762 | 			     |:FollowListTwitter|, |:UnfollowListTwitter|.
1763 | 			   * Added support for goo.gl |:Googl| and Rga.la.
1764 | 			     |:Rgala|
1765 | 			   * Extended |TwitVim-Leader-g| to support Name: lines
1766 | 			     in user profile and following/followers lists.
1767 | 			   * Added history stack for info buffer.
1768 | 			   * Added |:BackInfoTwitter|, |:ForwardInfoTwitter|,
1769 | 			     |:RefreshInfoTwitter|, |:NextInfoTwitter|,
1770 | 			     |:PreviousInfoTwitter| for the info buffer. Also
1771 | 			     added support for |TwitVim-C-PageDown| and
1772 | 			     |TwitVim-C-PageUp| in info buffer.
1773 | 			   * Added twitvim filetype for user customization
1774 | 			     via autocommands.
1775 | 			   * Changed display of retweets to show the full
1776 | 			     version instead of the truncated version
1777 | 			     when the retweeted status is near the 
1778 | 			     character limit.
1779 | 			   * |:ProfileTwitter| with no argument now shows
1780 | 			     info on logged-in user.
1781 | 			   * Make |TwitVim-Leader-@| work on new-style
1782 | 			     retweets by showing the retweeted status
1783 | 			     as the parent.
1784 | 	0.5.6 : 2010-09-19 * Exception handling for Python net interface.
1785 | 			   * Added converter functions for non-UTF8 encoding
1786 | 			     by @mattn_jp.
1787 | 			   * Convert entities in profile name, bio, and
1788 | 			     location. (Suggested by code933k)
1789 | 			   * Fix for posting foreign chars when encoding is
1790 | 			     not UTF8 and net method is not Curl.
1791 | 			   * Support |twitvim_count| in |:DMTwitter| and
1792 | 			     |:DMSentTwitter|.
1793 | 			   * Added |:FavTwitter|.
1794 | 			   * Added mappings to favorite and unfavorite tweets.
1795 | 			     |TwitVim-Leader-f| |TwitVim-Leader-C-f|
1796 | 	0.5.5 : 2010-08-16 * Added support for computing HMAC-SHA1 digests
1797 | 			     using the openssl command line tool from the
1798 | 			     OpenSSL toolkit. |TwitVim-OpenSSL|
1799 | 	0.5.4 : 2010-08-11 * Added Ruby and Tcl versions of HMAC-SHA1 digest
1800 | 			     code.
1801 | 			   * Improved error messages for cURL users.
1802 | 			   * Fix to keep |'nomodifiable'| setting from leaking
1803 | 			     out into other buffers.
1804 | 			   * Support Twitter SSL via Tcl interface.
1805 | 			     |TwitVim-ssl-tcl|
1806 | 	0.5.3 : 2010-06-23 * Improved error messages for most commands if 
1807 | 			     using Perl, Python, Ruby, or Tcl interfaces.
1808 | 			   * Added |:FollowTwitter|, |:UnfollowTwitter|,
1809 | 			     |:BlockTwitter|, |:UnblockTwitter|,
1810 | 			     |:ReportSpamTwitter|, |:AddToListTwitter|,
1811 | 			     |:RemoveFromListTwitter|.
1812 | 	0.5.2 : 2010-06-22 * More fixes for Twitter OAuth.
1813 | 	0.5.1 : 2010-06-19 * Shorten auth URL with is.gd/Bitly if we need
1814 | 			     to ask the user to visit it manually.
1815 | 			   * Fixed the |:PublicTwitter| invalid request error.
1816 | 			   * Include new-style retweets in user timeline.
1817 | 	0.5.0 : 2010-06-16 * Switched to OAuth for user authentication on 
1818 | 			     Twitter. |TwitVim-OAuth|
1819 | 			   * Improved |:ProfileTwitter|.
1820 | 	0.4.7 : 2010-03-13 * Added |:MentionsTwitter| as an alias for
1821 | 			     |:RepliesTwitter|.
1822 | 			   * Support |twitvim_count| in |:MentionsTwitter|.
1823 | 			   * Fixed |twitvim_count| bug in |:ListTwitter|.
1824 | 			   * Fixed Ruby interface problem with
1825 | 			     Vim patch 7.2.374.
1826 | 			   * Fixed |:BackTwitter| behavior when timeline
1827 | 			     window is hidden by user.
1828 | 			   * Handle SocketError exception in Ruby code.
1829 | 	0.4.6 : 2010-02-05 * Added option to hide header in timeline buffer.
1830 | 			     |TwitVim-hide-header|
1831 | 	0.4.5 : 2009-12-20 * Prompt for login info if not configured.
1832 | 			     |:SetLoginTwitter| |:ResetLoginTwitter|
1833 | 			   * Reintroduced old-style retweet via
1834 | 			     |twitvim_old_retweet|.
1835 | 	0.4.4 : 2009-12-13 * Upgraded bit.ly API support to version 2.0.1
1836 | 			     with configurable user login and key.
1837 | 			   * Added support for Zima. |:Zima|
1838 | 			   * Fixed :BackTwitter behavior when browsing
1839 | 			     multiple lists.
1840 | 			   * Added support for displaying retweets in
1841 | 			     friends timeline.
1842 | 			   * Use Twitter Retweet API to retweet.
1843 | 			   * Added commands to display retweets to you or
1844 | 			     by you. |:RetweetedToMeTwitter|
1845 | 			     |:RetweetedByMeTwitter|
1846 | 	0.4.3 : 2009-11-27 * Fixed some minor breakage in LongURL support.
1847 | 			   * Added |:ListTwitter|
1848 | 			   * Omit author's name from the list when doing a
1849 | 			     reply to all. |TwitVim-reply-all|
1850 | 	0.4.2 : 2009-06-22 * Bugfix: Reset syntax items in Twitter window.
1851 | 			   * Bugfix: Show progress message before querying
1852 | 			     for in-reply-to tweet.
1853 | 			   * Added reply to all feature. |TwitVim-reply-all|
1854 | 	0.4.1 : 2009-03-30 * Fixed a problem with usernames and search terms
1855 | 			     that begin with digits.
1856 | 	0.4.0 : 2009-03-09 * Added |:SendDMTwitter| to send direct messages
1857 | 			     through API without relying on the "d user ..."
1858 | 			     syntax.
1859 | 			   * Modified Alt-D mapping in timeline to use
1860 | 			     the :SendDMTwitter code.
1861 | 			   * Added |:BackTwitter| and |:ForwardTwitter|
1862 | 			     commands, Ctrl-O and Ctrl-I mappings to move back
1863 | 			     and forth in the timeline stack.
1864 | 			   * Improvements in window handling. TwitVim commands
1865 | 			     will restore the cursor to the original window
1866 | 			     when possible.
1867 | 			   * Wrote some notes on using TwitVim with Twitter
1868 | 			     SSL API.
1869 | 			   * Added mapping to show predecessor tweet for an
1870 | 			     @-reply. |TwitVim-inreplyto|
1871 | 			   * Added mapping to delete a tweet or message.
1872 | 			     |TwitVim-delete|
1873 | 			   * Added commands and mappings to refresh the
1874 | 			     timeline and load the next or previous page.
1875 | 			     |TwitVim-refresh|, |TwitVim-next|,
1876 | 			     |TwitVim-previous|.
1877 | 	0.3.5 : 2009-01-30 * Added support for pagination and page length to
1878 | 			     :SearchTwitter.
1879 | 			   * Shortened default retweet prefix to "RT".
1880 | 	0.3.4 : 2008-11-11 * Added |twitvim_count| option to allow user to
1881 | 			     configure the number of tweets returned by
1882 | 			     :FriendsTwitter and :UserTwitter.
1883 | 	0.3.3 : 2008-10-06 * Added support for Cligs. |:Cligs|
1884 | 	                   * Fixed a problem with not being able to unset
1885 | 			     the proxy if using Tcl http.
1886 | 	0.3.2 : 2008-09-30 * Added command to display rate limit info.
1887 | 			     |:RateLimitTwitter|
1888 | 			   * Improved error reporting for :UserTwitter.
1889 | 			   * Added command and mapping to display user
1890 | 			     profile information. |:ProfileTwitter|
1891 | 			     |TwitVim-Leader-p|
1892 | 			   * Added command for updating location.
1893 | 			     |:LocationTwitter|
1894 | 			   * Added support for tr.im. |:Trim|
1895 | 			   * Fixed error reporting in Tcl http code.
1896 | 	0.3.1 : 2008-09-18 * Added support for LongURL. |TwitVim-LongURL|
1897 | 			   * Added support for posting multibyte/Unicode
1898 | 			     tweets in cURL mode.
1899 | 			   * Remove newlines from text before retweeting.
1900 | 	0.3.0 : 2008-09-12 * Added support for http networking through Vim's
1901 | 			     Perl, Python, Ruby, and Tcl interfaces, as
1902 | 			     alternatives to cURL. |TwitVim-non-cURL|
1903 | 			   * Removed UrlTea support.
1904 | 	0.2.24 : 2008-08-28 * Added retweet feature. See |TwitVim-retweet|
1905 | 	0.2.23 : 2008-08-25 * Support in_reply_to_status_id parameter.
1906 | 			    * Added tip on line length in statusline.
1907 | 			    * Report browser launch errors.
1908 | 			    * Set syntax highlighting on every timeline refresh.
1909 | 	0.2.22 : 2008-08-13 * Rewrote time conversion code in Vim script
1910 | 			      so we don't need Perl or Python any more.
1911 | 			    * Do not URL-encode digits 0 to 9.
1912 | 	0.2.21 : 2008-08-12 * Added tips section to documentation.
1913 | 			    * Use create_or_reuse instead of create in UrlBorg
1914 | 			      API so that it will always generate the same
1915 | 			      short URL for the same long URL.
1916 | 			    * Added support for highlighting #hashtags and
1917 | 			      jumping to Twitter Searches for #hashtags.
1918 | 			    * Added Python code to convert Twitter timestamps
1919 | 			      to local time and simplify them.
1920 | 	0.2.20 : 2008-07-24 * Switched from Summize to Twitter Search.
1921 | 			      |:SearchTwitter|
1922 | 	0.2.19 : 2008-07-23 * Added support for non-Twitter servers
1923 | 			      implementing the Twitter API. This is for
1924 | 			      identi.ca support. See |twitvim-identi.ca|.
1925 | 	0.2.18 : 2008-07-14 * Added support for urlBorg API. |:UrlBorg|
1926 | 	0.2.17 : 2008-07-11 * Added command to show DM Sent Timeline.
1927 | 	                      |:DMSentTwitter|
1928 | 			    * Added support for pagination in Friends, User,
1929 | 			      Replies, DM, and DM Sent timelines.
1930 | 			    * Added support for bit.ly API and is.gd API.
1931 | 			      |:BitLy| |:IsGd|
1932 | 	0.2.16 : 2008-05-16 * Removed quotes around browser launch URL.
1933 | 			    * Escape ! character in browser launch URL.
1934 | 	0.2.15 : 2008-05-13 * Extend :UserTwitter and :FriendsTwitter to show
1935 | 			      another user's timeline if argument supplied.
1936 | 			    * Extend Alt-G mapping to jump to another user's
1937 | 			      timeline if invoked over @user or user:
1938 | 			    * Escape special Vim shell characters in URL when
1939 | 			      launching web browser.
1940 | 	0.2.14 : 2008-05-12 * Added support for Summize search API.
1941 | 	0.2.13 : 2008-05-07 * Added mappings to launch web browser on URLs in
1942 | 			      timeline.
1943 | 	0.2.12 : 2008-05-05 * Allow user to specify Twitter login info and
1944 | 			      proxy login info preencoded in base64.
1945 | 			      |twitvim_login_b64| |twitvim_proxy_login_b64|
1946 | 	0.2.11 : 2008-05-02 * Scroll to top in timeline window after adding
1947 | 			      an update line.
1948 | 			    * Add <Leader>r and <Leader>d mappings as
1949 | 			      alternative to Alt-R and Alt-D because the
1950 | 			      latter are not valid key combos under Cygwin.
1951 | 	0.2.10 : 2008-04-25 * Shortened snipurl.com to snipr.com
1952 | 			    * Added support for proxy authentication.
1953 | 			      |twitvim_proxy_login|
1954 | 			    * Handle Perl module load failure. Not that I
1955 | 			      expect those modules to ever be missing.
1956 | 	0.2.9 : 2008-04-23 * Added some status messages.
1957 | 			   * Added menu items under Plugin menu.
1958 | 			   * Allow Ctrl-T as an alternative to Alt-T to avoid
1959 | 			     conflict with the menu bar.
1960 | 			   * Added support for UrlTea API.
1961 | 			   * Generalize URL encoding to all non-alpha chars.
1962 | 	0.2.8 : 2008-04-22 * Encode URLs sent to URL-shortening services.
1963 | 	0.2.7 : 2008-04-21 * Add support for TinyURL API. |:TinyURL|
1964 | 			   * Add quick direct message feature.
1965 | 			     |TwitVim-direct-message|
1966 | 	0.2.6 : 2008-04-15 * Delete Twitter buffer to the blackhole register
1967 | 			     to avoid stepping on registers unnecessarily.
1968 | 			   * Quote login and proxy arguments before sending to
1969 | 			     cURL.
1970 | 			   * Added support for SnipURL API and Metamark API.
1971 | 			     |:Snipurl| |:Metamark|
1972 | 	0.2.5 : 2008-04-14 * Escape the "+" character in sent tweets.
1973 | 			   * Added Perl code to convert Twitter timestamps to
1974 | 			     local time and simplify them.
1975 | 			   * Fix for timestamp highlight when the "|"
1976 | 			     character appears in a tweet.
1977 | 	0.2.4 : 2008-04-13 * Use <q-args> in Tweetburner commands.
1978 | 			   * Improve XML parsing so that order of elements
1979 | 			     does not matter.
1980 | 			   * Changed T mapping to Alt-T to avoid overriding
1981 | 			     the |T| command.
1982 | 	0.2.3 : 2008-04-12 * Added more Tweetburner commands.
1983 | 	0.2.2 : 2008-04-11 * Added quick reply feature.
1984 | 			   * Added Tweetburner support. |:Tweetburner|
1985 | 			   * Changed client ident to "from twitvim".
1986 | 	0.2.1 : 2008-04-10 * Bug fix for Chinese characters in timeline.
1987 | 			     Thanks to Leiyue.
1988 | 			   * Scroll up to newest tweet after refreshing
1989 | 			     timeline.
1990 | 			   * Changed Twitter window name to avoid unsafe
1991 | 			     special characters and clashes with file names.
1992 | 	0.2.0 : 2008-04-09 * Added views for public, friends, user timelines,
1993 | 			     replies, and direct messages. 
1994 | 			   * Automatically insert user's posts into
1995 | 			     public, friends, or user timeline, if visible.
1996 | 			   * Added syntax highlighting for timeline view.
1997 | 	0.1.2 : 2008-04-03 * Make plugin conform to guidelines in
1998 |     			    |write-plugin|.
1999 | 			   * Add help documentation.
2000 | 	0.1.1 : 2008-04-01 * Add error reporting for cURL problems.
2001 | 	0.1   : 2008-03-28 * Initial release.
2002 | 
2003 | 
2004 | ==============================================================================
2005 | 8. TwitVim Credits					*TwitVim-credits*
2006 | 
2007 | 	Thanks to Travis Jeffery, the author of the original VimTwitter script
2008 | 	(vimscript #2124), who came up with the idea of running cURL from Vim
2009 | 	to access the Twitter API.
2010 | 
2011 | 	Techniques for managing the Twitter buffer were adapted from the NERD
2012 | 	Tree plugin (vimscript #1658) by Marty Grenfell.
2013 | 
2014 | 
2015 | ==============================================================================
2016 | vim:tw=78:ts=8:ft=help:norl:
2017 | 


--------------------------------------------------------------------------------