region.rb in unidom-geo-china-0.5.9

- old
+ new

@@ -70,25 +70,38 @@
   # 判断行政区划代码的中间 2 位数字是否为 00 。
   def numeric_code_middle_empty?
     '00'==numeric_code_middle
   end
 
+  ##
+  # 判断行政区划代码的后 2 位数字是否为 00 。
   def numeric_code_suffix_empty?
     '00'==numeric_code_suffix
   end
 
+  ##
+  # 判断一个区县级的行政区划是否是区。
   def district?
     numeric_code_suffix.to_i<20
   end
 
+  ##
+  # 判断一个行政区划是否是或者属于直辖市。
   def under_mducg?
     self.class::MDUCG_CODES.include? numeric_code_prefix
   end
 
+  ##
+  # 判断一个行政区划是否是直辖市。
   def mducg?
     under_mducg? && numeric_code_middle_empty? && numeric_code_suffix_empty?
   end
 
+  ##
+  # 拼写当前行政区划的全称，用指定的分隔符区分。如：
+  # region.full_name
+  # # or
+  # region.full_name ' '
   def full_name(separator = ' ')
     final_name     = self.name
     current_region = self
     count          = 0
     while current_region = current_region.super_regions.first