home *** CD-ROM | disk | FTP | other *** search
/ vim.ftp.fu-berlin.de / 2015-02-03.vim.ftp.fu-berlin.de.tar / vim.ftp.fu-berlin.de / patches / 7.3 / 7.3.1067 < prev    next >
Encoding:
Internet Message Format  |  2013-05-29  |  6.4 KB
  1. To: vim_dev@googlegroups.com
  2. Subject: Patch 7.3.1067
  3. Fcc: outbox
  4. From: Bram Moolenaar <Bram@moolenaar.net>
  5. Mime-Version: 1.0
  6. Content-Type: text/plain; charset=UTF-8
  7. Content-Transfer-Encoding: 8bit
  8. ------------
  9.  
  10. Patch 7.3.1067
  11. Problem:    Python: documentation lags behind.
  12. Solution:   Python patch 26. (ZyX)
  13. Files:      runtime/doc/if_pyth.txt
  14.  
  15.  
  16. *** ../vim-7.3.1066/runtime/doc/if_pyth.txt    2013-05-30 13:01:14.000000000 +0200
  17. --- runtime/doc/if_pyth.txt    2013-05-30 13:31:16.000000000 +0200
  18. ***************
  19. *** 480,496 ****
  20.                       vim.VAR_DEF_SCOPE  |g:| or |l:| dictionary
  21.                       vim.VAR_SCOPE      Other scope dictionary,
  22.                                          see |internal-variables|
  23. !     Methods:
  24.           Method      Description ~
  25.           keys()      Returns a list with dictionary keys.
  26.           values()    Returns a list with dictionary values.
  27.           items()     Returns a list of 2-tuples with dictionary contents.
  28. !         update(iterable)
  29. !         update(dictionary)
  30. !         update(**kwargs)
  31.                       Adds keys to dictionary.
  32.       Examples: >
  33. !         py d = vim.bindeval('{}')
  34.           d['a'] = 'b'                # Item assignment
  35.           print d['a']                # getting item
  36.           d.update({'c': 'd'})            # .update(dictionary)
  37. --- 480,515 ----
  38.                       vim.VAR_DEF_SCOPE  |g:| or |l:| dictionary
  39.                       vim.VAR_SCOPE      Other scope dictionary,
  40.                                          see |internal-variables|
  41. !     Methods (note: methods do not support keyword arguments):
  42.           Method      Description ~
  43.           keys()      Returns a list with dictionary keys.
  44.           values()    Returns a list with dictionary values.
  45.           items()     Returns a list of 2-tuples with dictionary contents.
  46. !         update(iterable), update(dictionary), update(**kwargs)
  47.                       Adds keys to dictionary.
  48. +         get(key[, default=None])
  49. +                     Obtain key from dictionary, returning the default if it is 
  50. +                     not present.
  51. +         pop(key[, default])
  52. +                     Remove specified key from dictionary and return 
  53. +                     corresponding value. If key is not found and default is 
  54. +                     given returns the default, otherwise raises KeyError.
  55. +         popitem(key)
  56. +                     Remove specified key from dictionary and return a pair 
  57. +                     with it and the corresponding value. Returned key is a new 
  58. +                     object.
  59. +         has_key(key)
  60. +                     Check whether dictionary contains specified key, similar 
  61. +                     to `key in dict`.
  62. + 
  63. +         __new__(), __new__(iterable), __new__(dictionary), __new__(update)
  64. +                     You can use `vim.Dictionary()` to create new vim 
  65. +                     dictionaries. `d=vim.Dictionary(arg)` is the same as 
  66. +                     `d=vim.bindeval('{}');d.update(arg)`. Without arguments 
  67. +                     constructs empty dictionary.
  68. + 
  69.       Examples: >
  70. !         d = vim.Dictionary(food="bar")        # Constructor
  71.           d['a'] = 'b'                # Item assignment
  72.           print d['a']                # getting item
  73.           d.update({'c': 'd'})            # .update(dictionary)
  74. ***************
  75. *** 501,506 ****
  76. --- 520,526 ----
  77.           for key, val in d.items():        # .items()
  78.           print isinstance(d, vim.Dictionary)    # True
  79.           for key in d:                # Iteration over keys
  80. +         class Dict(vim.Dictionary):        # Subclassing
  81.   <
  82.       Note: when iterating over keys you should not modify dictionary.
  83.   
  84. ***************
  85. *** 510,517 ****
  86.       following methods:
  87.           Method          Description ~
  88.           extend(item)    Add items to the list.
  89.       Examples: >
  90. !         l = vim.bindeval('[]')
  91.           l.extend(['abc', 'def'])    # .extend() method
  92.           print l[1:]            # slicing
  93.           l[:0] = ['ghi', 'jkl']        # slice assignment
  94. --- 530,543 ----
  95.       following methods:
  96.           Method          Description ~
  97.           extend(item)    Add items to the list.
  98. + 
  99. +         __new__(), __new__(iterable)
  100. +                         You can use `vim.List()` to create new vim lists. 
  101. +                         `l=vim.List(iterable)` is the same as 
  102. +                         `l=vim.bindeval('[]');l.extend(iterable)`. Without 
  103. +                         arguments constructs empty list.
  104.       Examples: >
  105. !         l = vim.List("abc")        # Constructor, result: ['a', 'b', 'c']
  106.           l.extend(['abc', 'def'])    # .extend() method
  107.           print l[1:]            # slicing
  108.           l[:0] = ['ghi', 'jkl']        # slice assignment
  109. ***************
  110. *** 519,531 ****
  111.           l[0] = 'mno'            # assignment
  112.           for i in l:            # iteration
  113.           print isinstance(l, vim.List)    # True
  114.   
  115.   vim.Function object                *python-Function*
  116.       Function-like object, acting like vim |Funcref| object. Supports `.name` 
  117.       attribute and is callable. Accepts special keyword argument `self`, see 
  118. !     |Dictionary-function|.
  119.       Examples: >
  120. !         f = vim.bindeval('function("tr")')
  121.           print f('abc', 'a', 'b')        # Calls tr('abc', 'a', 'b')
  122.           vim.command('''
  123.               function DictFun() dict
  124. --- 545,560 ----
  125.           l[0] = 'mno'            # assignment
  126.           for i in l:            # iteration
  127.           print isinstance(l, vim.List)    # True
  128. +         class List(vim.List):        # Subclassing
  129.   
  130.   vim.Function object                *python-Function*
  131.       Function-like object, acting like vim |Funcref| object. Supports `.name` 
  132.       attribute and is callable. Accepts special keyword argument `self`, see 
  133. !     |Dictionary-function|. You can also use `vim.Function(name)` constructor, 
  134. !     it is the same as `vim.bindeval('function(%s)'%json.dumps(name))`.
  135. ! 
  136.       Examples: >
  137. !         f = vim.Function('tr')            # Constructor
  138.           print f('abc', 'a', 'b')        # Calls tr('abc', 'a', 'b')
  139.           vim.command('''
  140.               function DictFun() dict
  141. *** ../vim-7.3.1066/src/version.c    2013-05-30 13:28:37.000000000 +0200
  142. --- src/version.c    2013-05-30 13:31:42.000000000 +0200
  143. ***************
  144. *** 730,731 ****
  145. --- 730,733 ----
  146.   {   /* Add new patch number below this line */
  147. + /**/
  148. +     1067,
  149.   /**/
  150.  
  151. -- 
  152. How To Keep A Healthy Level Of Insanity:
  153. 9. As often as possible, skip rather than walk.
  154.  
  155.  /// Bram Moolenaar -- Bram@Moolenaar.net -- http://www.Moolenaar.net   \\\
  156. ///        sponsor Vim, vote for features -- http://www.Vim.org/sponsor/ \\\
  157. \\\  an exciting new programming language -- http://www.Zimbu.org        ///
  158.  \\\            help me help AIDS victims -- http://ICCF-Holland.org    ///
  159.