From 317dddc096deb7af7839facf3cbe35bc8acf721c Mon Sep 17 00:00:00 2001
From: Meng Zhuo <mengzhuo1203@gmail.com>
Date: Thu, 20 Jun 2013 15:40:12 +0800
Subject: [PATCH] add docstring

---
 UltiSnips/rst.snippets | 34 +++++++++++++++++++++++++++-------
 1 file changed, 27 insertions(+), 7 deletions(-)

diff --git a/UltiSnips/rst.snippets b/UltiSnips/rst.snippets
index 126f59b..0490c31 100644
--- a/UltiSnips/rst.snippets
+++ b/UltiSnips/rst.snippets
@@ -1,4 +1,4 @@
-
+# -*- coding: utf-8 -*-
 
 ###########################################################################
 #                              General Stuff                              #
@@ -7,12 +7,23 @@ global !p
 import re
 from collections import Counter
 
-
 def rst_char_len(char):
-	return len(re.findall(r'[^\u4e00-\u9fff\s]', char))+len(char)
+    """ 
+    return len of string which fit in rst
+    For instance:chinese "我" decode as only one character, 
+    However, the rst interpreter needs 2 "=" instead of 1.
 
+    :param: char needs to be count
+    """
+    return len(re.findall(r'[^\u4e00-\u9fff\s]', char))+len(char)
 
 def	make_items(times, leading='+'):
+    """
+    make lines with leading char multitimes
+    
+    :param: times, how many times you need
+    :param: leading, leading character
+    """
     times = int(times)
     if leading == 1:
         msg = ""
@@ -24,6 +35,11 @@ def	make_items(times, leading='+'):
 
 
 def get_popular_code_type(path):
+    """
+    As function name, it will get most popular code type in given file
+
+    :param: path, to path to rst file
+    """
     with open(path) as source:
         types = re.findall(r'[:|\.\.\s]code::?\s(\w+)', source.read())
     try:
@@ -33,6 +49,7 @@ def get_popular_code_type(path):
 
     return popular_type
 endglobal
+
 snippet part "Part" b
 `!p snip.rv = rst_char_len(t[1])*'#'`
 ${1:Part name}
@@ -78,19 +95,22 @@ $0
 endsnippet
 
 snippet em "Emphasize string" i
-*${1:Em}* $0
+*${1:${VISUAL:Em}}* $0
 endsnippet
 
+# the CJK characters doesn't had space to sperate them, like "我强调"
+# should be "我\ *强调*\ "
+# Therefor we need special snippet
 snippet ec "Emphasize string (CJK)" w
-\ *${1:Em}*\ $0
+\ *${1:${VISUAL:Em}}*\ $0
 endsnippet
 
 snippet st "Strong string" i
-**${1:Strong}** $0
+**${1:${VISUAL:Strong}}** $0
 endsnippet
 
 snippet sc "Strong string (CJK)" w
-\ **${1:Strong}**\ $0
+\ **${1:${VISUAL:Strong}}**\ $0
 endsnippet
 
 snippet "li(st)? (?P<num>\d+)" "List" br