To: vim_dev@googlegroups.com
Subject: Patch 7.3.1067
Fcc: outbox
From: Bram Moolenaar <Bram@moolenaar.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
------------

Patch 7.3.1067
Problem:    Python: documentation lags behind.
Solution:   Python patch 26. (ZyX)
Files:      runtime/doc/if_pyth.txt


*** ../vim-7.3.1066/runtime/doc/if_pyth.txt	2013-05-30 13:01:14.000000000 +0200
--- runtime/doc/if_pyth.txt	2013-05-30 13:31:16.000000000 +0200
***************
*** 480,496 ****
                      vim.VAR_DEF_SCOPE  |g:| or |l:| dictionary
                      vim.VAR_SCOPE      Other scope dictionary,
                                         see |internal-variables|
!     Methods:
          Method      Description ~
          keys()      Returns a list with dictionary keys.
          values()    Returns a list with dictionary values.
          items()     Returns a list of 2-tuples with dictionary contents.
!         update(iterable)
!         update(dictionary)
!         update(**kwargs)
                      Adds keys to dictionary.
      Examples: >
!         py d = vim.bindeval('{}')
          d['a'] = 'b'				# Item assignment
          print d['a']				# getting item
          d.update({'c': 'd'})			# .update(dictionary)
--- 480,515 ----
                      vim.VAR_DEF_SCOPE  |g:| or |l:| dictionary
                      vim.VAR_SCOPE      Other scope dictionary,
                                         see |internal-variables|
!     Methods (note: methods do not support keyword arguments):
          Method      Description ~
          keys()      Returns a list with dictionary keys.
          values()    Returns a list with dictionary values.
          items()     Returns a list of 2-tuples with dictionary contents.
!         update(iterable), update(dictionary), update(**kwargs)
                      Adds keys to dictionary.
+         get(key[, default=None])
+                     Obtain key from dictionary, returning the default if it is 
+                     not present.
+         pop(key[, default])
+                     Remove specified key from dictionary and return 
+                     corresponding value. If key is not found and default is 
+                     given returns the default, otherwise raises KeyError.
+         popitem(key)
+                     Remove specified key from dictionary and return a pair 
+                     with it and the corresponding value. Returned key is a new 
+                     object.
+         has_key(key)
+                     Check whether dictionary contains specified key, similar 
+                     to `key in dict`.
+ 
+         __new__(), __new__(iterable), __new__(dictionary), __new__(update)
+                     You can use `vim.Dictionary()` to create new vim 
+                     dictionaries. `d=vim.Dictionary(arg)` is the same as 
+                     `d=vim.bindeval('{}');d.update(arg)`. Without arguments 
+                     constructs empty dictionary.
+ 
      Examples: >
!         d = vim.Dictionary(food="bar")		# Constructor
          d['a'] = 'b'				# Item assignment
          print d['a']				# getting item
          d.update({'c': 'd'})			# .update(dictionary)
***************
*** 501,506 ****
--- 520,526 ----
          for key, val in d.items():		# .items()
          print isinstance(d, vim.Dictionary)	# True
          for key in d:				# Iteration over keys
+         class Dict(vim.Dictionary):		# Subclassing
  <
      Note: when iterating over keys you should not modify dictionary.
  
***************
*** 510,517 ****
      following methods:
          Method          Description ~
          extend(item)    Add items to the list.
      Examples: >
!         l = vim.bindeval('[]')
          l.extend(['abc', 'def'])	# .extend() method
          print l[1:]			# slicing
          l[:0] = ['ghi', 'jkl']		# slice assignment
--- 530,543 ----
      following methods:
          Method          Description ~
          extend(item)    Add items to the list.
+ 
+         __new__(), __new__(iterable)
+                         You can use `vim.List()` to create new vim lists. 
+                         `l=vim.List(iterable)` is the same as 
+                         `l=vim.bindeval('[]');l.extend(iterable)`. Without 
+                         arguments constructs empty list.
      Examples: >
!         l = vim.List("abc")		# Constructor, result: ['a', 'b', 'c']
          l.extend(['abc', 'def'])	# .extend() method
          print l[1:]			# slicing
          l[:0] = ['ghi', 'jkl']		# slice assignment
***************
*** 519,531 ****
          l[0] = 'mno'			# assignment
          for i in l:			# iteration
          print isinstance(l, vim.List)	# True
  
  vim.Function object				*python-Function*
      Function-like object, acting like vim |Funcref| object. Supports `.name` 
      attribute and is callable. Accepts special keyword argument `self`, see 
!     |Dictionary-function|.
      Examples: >
!         f = vim.bindeval('function("tr")')
          print f('abc', 'a', 'b')		# Calls tr('abc', 'a', 'b')
          vim.command('''
              function DictFun() dict
--- 545,560 ----
          l[0] = 'mno'			# assignment
          for i in l:			# iteration
          print isinstance(l, vim.List)	# True
+         class List(vim.List):		# Subclassing
  
  vim.Function object				*python-Function*
      Function-like object, acting like vim |Funcref| object. Supports `.name` 
      attribute and is callable. Accepts special keyword argument `self`, see 
!     |Dictionary-function|. You can also use `vim.Function(name)` constructor, 
!     it is the same as `vim.bindeval('function(%s)'%json.dumps(name))`.
! 
      Examples: >
!         f = vim.Function('tr')			# Constructor
          print f('abc', 'a', 'b')		# Calls tr('abc', 'a', 'b')
          vim.command('''
              function DictFun() dict
*** ../vim-7.3.1066/src/version.c	2013-05-30 13:28:37.000000000 +0200
--- src/version.c	2013-05-30 13:31:42.000000000 +0200
***************
*** 730,731 ****
--- 730,733 ----
  {   /* Add new patch number below this line */
+ /**/
+     1067,
  /**/

-- 
How To Keep A Healthy Level Of Insanity:
9. As often as possible, skip rather than walk.

 /// Bram Moolenaar -- Bram@Moolenaar.net -- http://www.Moolenaar.net   \\\
///        sponsor Vim, vote for features -- http://www.Vim.org/sponsor/ \\\
\\\  an exciting new programming language -- http://www.Zimbu.org        ///
 \\\            help me help AIDS victims -- http://ICCF-Holland.org    ///