Commit Graph

41642 Commits

Author SHA1 Message Date
Éric Araujo
4e8e7aef5a Merged revisions 87489 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87489 | eric.araujo | 2010-12-26 03:38:05 +0100 (dim., 26 déc. 2010) | 2 lines

  Remove unexistent parameter (#3216)
........
2010-12-26 02:39:07 +00:00
Éric Araujo
75cb8f5104 Merged revisions 87486 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87486 | eric.araujo | 2010-12-26 03:18:49 +0100 (dim., 26 déc. 2010) | 2 lines

  Fix typo spotted by Rodrigo Bernardo Pimentel (#9891)
........
2010-12-26 02:21:30 +00:00
R. David Murray
5fff1479a7 Blocked revisions 87479 via svnmerge
........
  r87479 | r.david.murray | 2010-12-24 17:36:49 -0500 (Fri, 24 Dec 2010) | 8 lines

  #1693546: don't add quotes around RFC 2231 encoded values.

  The RFC is bit hard to understand on this point, but the examples
  clearly show that parameter values that are encoded according
  to its charset/language rules don't have surrounding quotes, and
  the ABNF does not allow for quotes.  So when we produce such
  encoded values, we no longer add quotes.
........
2010-12-24 22:41:22 +00:00
Alexander Belopolsky
5512f32d91 Merged revisions 87463 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87463 | alexander.belopolsky | 2010-12-23 19:24:11 -0500 (Thu, 23 Dec 2010) | 1 line

  Issue #9063: Corrected the tzinfo example.
........
2010-12-24 00:29:04 +00:00
Benjamin Peterson
9e335fb3c5 Merged revisions 87455 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87455 | benjamin.peterson | 2010-12-23 16:17:42 -0600 (Thu, 23 Dec 2010) | 1 line

  fix docstring
........
2010-12-23 22:20:16 +00:00
R. David Murray
42d983f487 Blocked revisions 87451 via svnmerge
........
  r87451 | r.david.murray | 2010-12-23 15:35:46 -0500 (Thu, 23 Dec 2010) | 4 lines

  #1155362: allow hh:mm:ss-uuuu like we allow hh:mm:ss+uuuu in parsedate_tz

  Original patch by Thomas Herve.
........
2010-12-23 20:37:28 +00:00
R. David Murray
46c6fd605e Merged revisions 87448 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87448 | r.david.murray | 2010-12-23 14:44:49 -0500 (Thu, 23 Dec 2010) | 4 lines

  #4496: remove misleading comment and note that self.handlers is obsolete.

  self.handlers is still used in one urllib2 test, but not by the code iteslf.
........
2010-12-23 19:47:37 +00:00
Alexander Belopolsky
c10abb42fb Merged revisions 87443 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87443 | alexander.belopolsky | 2010-12-22 21:58:25 -0500 (Wed, 22 Dec 2010) | 1 line

  Issue #10587: Document the meaning of str methods.
........
2010-12-23 03:00:58 +00:00
Alexander Belopolsky
a79a6765ce Merged revisions 87433 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87433 | alexander.belopolsky | 2010-12-21 20:37:36 -0500 (Tue, 21 Dec 2010) | 3 lines

  Both PEP 3131 and the current implementation use NFKC normalization
  for identifiers.  Fixed the documentation to agree.
........
2010-12-22 01:55:15 +00:00
R. David Murray
30f9c8c684 Merged revisions 87430 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87430 | r.david.murray | 2010-12-21 16:53:37 -0500 (Tue, 21 Dec 2010) | 9 lines

  #4871: check that zipfile password is bytes, and give useful error message.

  Previously passing a string in as the password would fail either with
  an assertion error or a TypeError with a confusing error message.
  Note that a string can't be accepted since zipfile has no way to
  guess what encoding should be used to turn it into bytes.

  Patch by Victor Stinner.
........
2010-12-21 21:57:54 +00:00
Antoine Pitrou
6cfc5124f2 Merged revisions 87427 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87427 | antoine.pitrou | 2010-12-21 22:20:59 +0100 (mar., 21 déc. 2010) | 3 lines

  Issue #10750: The `raw` attribute of buffered IO objects is now read-only.
........
2010-12-21 21:26:09 +00:00
Antoine Pitrou
9fc6b6c453 Merged revisions 87421 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87421 | antoine.pitrou | 2010-12-21 19:49:01 +0100 (mar., 21 déc. 2010) | 4 lines

  Suggest sys.maxsize as a reliable way to know whether the interpreter is 64-bit.
  (part of #10735)
........
2010-12-21 18:56:38 +00:00
R. David Murray
c7611d1126 Blocked revisions 87418 via svnmerge
........
  r87418 | r.david.murray | 2010-12-21 13:24:33 -0500 (Tue, 21 Dec 2010) | 10 lines

  Make test_compileall more robust by using -S to keep sys.path minimized.

  Try this again, hopefully the right way this time.

  Arfrever Taifersar Arahesis reported that test_compileall failed during Gentoo
  install because it was tyring to write .pyc files to a read-only system
  directory during test_no_args_compiles_path.  Having the tests call python
  with -S should eliminate the system directories from the path.
........
2010-12-21 18:26:10 +00:00
R. David Murray
27c1914c1b Merged revisions 87415 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87415 | r.david.murray | 2010-12-21 13:07:59 -0500 (Tue, 21 Dec 2010) | 4 lines

  Fix the change made for issue 1243654.

  Surprisingly, it turns out there was no test that exercised this code path.
........
2010-12-21 18:11:01 +00:00
R. David Murray
08d3c1e713 Blocked revisions 87411 via svnmerge
........
  r87411 | r.david.murray | 2010-12-20 14:04:51 -0500 (Mon, 20 Dec 2010) | 2 lines

  Revert incorrect patch made at the wrong time.
........
2010-12-20 19:05:57 +00:00
R. David Murray
2c2085bdf8 Blocked revisions 87408 via svnmerge
........
  r87408 | r.david.murray | 2010-12-20 13:08:59 -0500 (Mon, 20 Dec 2010) | 8 lines

  Make test_compileall more robust by using -S to keep sys.path minimized.

  Arfrever Taifersar Arahesis reported that test_compileall failed during Gentoo
  install because it was tyring to write .pyc files to a read-only system
  directory during test_no_args_compiles_path.  Having subprocess call python
  with -S should eliminate the system directories from the path.
........
2010-12-20 18:10:51 +00:00
R. David Murray
63cd7b6fb3 Merged revisions 87027 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87027 | gregory.p.smith | 2010-12-04 06:36:58 -0500 (Sat, 04 Dec 2010) | 3 lines

  issue10622: fix superflous scrollbar on the right side of <pre> boxes in the
  generated html docs.  visible in chrome, possibly other webkit browsers.
........
2010-12-18 19:41:50 +00:00
R. David Murray
af05f18aff Blocked revisions 87384 via svnmerge
........
  r87384 | r.david.murray | 2010-12-18 13:25:38 -0500 (Sat, 18 Dec 2010) | 12 lines

  #9286: Fix the rfc822 parser to preserve whitespace in address local part.

  Such addresses are not RFC compliant except under the 'obsolete syntax'
  rules, but before this fix the whitespace was dropped from the input,
  concatenating the pieces.  That breaks one of the principles of the
  email package, that of preserving the input as much as possible.
  It also denies the application program the opportunity to apply its
  own heuristics to interpretation of such non-compliant addresses.

  It is possible users of the email package were depending on the local
  part always being a single token, so this fix will not be backported.
........
2010-12-18 18:32:19 +00:00
Antoine Pitrou
ff1bbba92a Merged revisions 87373,87381 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87373 | senthil.kumaran | 2010-12-18 17:55:23 +0100 (sam., 18 déc. 2010) | 3 lines

  Fix Issue6791 - Limit the HTTP header readline with _MAXLENGTH. Patch by Antoine Pitrou
........
  r87381 | antoine.pitrou | 2010-12-18 18:59:18 +0100 (sam., 18 déc. 2010) | 3 lines

  NEWS entry for r87373
........
2010-12-18 18:04:38 +00:00
Ezio Melotti
a2eb94b1cf Merged revisions 87377 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87377 | ezio.melotti | 2010-12-18 18:31:58 +0100 (Sat, 18 Dec 2010) | 1 line

  Use lowercase true/false in assertTrue/assertFalse messages.
........
2010-12-18 17:55:43 +00:00
R. David Murray
28b77ece82 Merged revisions 87374 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87374 | r.david.murray | 2010-12-18 12:19:10 -0500 (Sat, 18 Dec 2010) | 8 lines

  #10404: Use ctl-button-1 for context menus on OSX Idle.

  This provides access to the context menus where they previously could
  not be accessed due to the way OSX Tk binds buttons.  It also
  improves platform consistency.

  Patch by Ned Deily.
........
2010-12-18 17:21:30 +00:00
Ezio Melotti
9d254f7092 Merged revisions 87368 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87368 | ezio.melotti | 2010-12-18 15:59:43 +0100 (Sat, 18 Dec 2010) | 1 line

  #5587: add a repr to dict_proxy objects.  Patch by David Stanek and Daniel Urban.
........
2010-12-18 15:06:45 +00:00
R. David Murray
c79cf04250 Blocked revisions 87356 via svnmerge
........
  r87356 | r.david.murray | 2010-12-17 22:48:32 -0500 (Fri, 17 Dec 2010) | 11 lines

  #9907: call rl_initialize early when using editline on OSX

  editline rl_initialize apparently discards any mappings done before it
  is called, which makes tab revert to file completion instead of inserting
  a tab.  So now on OSX we call rl_initialize first if we are using
  readline, and then re-read the users .editrc (if any) afterward so they
  can still override our defaults.

  Patch by Ned Deily, modified by Ronald Oussoren.
........
2010-12-18 03:50:46 +00:00
Antoine Pitrou
bc7f20cea4 Merged revisions 87341 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87341 | antoine.pitrou | 2010-12-17 18:42:16 +0100 (ven., 17 déc. 2010) | 4 lines

  Issue #4188: Avoid creating dummy thread objects when logging operations
  from the threading module (with the internal verbose flag activated).
........
2010-12-17 17:44:45 +00:00
Senthil Kumaran
3396e8671d Merged revisions 87329 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87329 | senthil.kumaran | 2010-12-17 12:48:45 +0800 (Fri, 17 Dec 2010) | 3 lines

  Fix Issue9721 - urljoin behavior when the relative url starts with ';'
........
2010-12-17 04:54:43 +00:00
R. David Murray
115a3170c4 Blocked revisions 87324 via svnmerge
........
  r87324 | r.david.murray | 2010-12-16 14:08:51 -0500 (Thu, 16 Dec 2010) | 9 lines

  #10719: restore messages generated on invalid compileall args

  Before the introduction of filename arguments to compileall it gave semi useful
  messages about not being able to 'list' names that weren't valid directories.
  This fix restores that behavior.  In addition to the test for this case, the
  patch also adds a test for the default behavior of compileall when no arguments
  are provided, and fixes a bug in one of the previously added tests.
........
2010-12-16 19:10:16 +00:00
Antoine Pitrou
db848f1276 svnmerge fooled me. That test class already existed. 2010-12-16 17:17:40 +00:00
Antoine Pitrou
c5e548f6a5 Forgot to enable this test 2010-12-16 17:05:26 +00:00
Antoine Pitrou
3022ce1a14 Merged revisions 87317 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87317 | antoine.pitrou | 2010-12-16 17:48:36 +0100 (jeu., 16 déc. 2010) | 4 lines

  Issue #10714: Limit length of incoming request in http.server to 65536 bytes
  for security reasons.  Initial patch by Ross Lagerwall.
........

(also backport some tests)
2010-12-16 17:03:16 +00:00
Éric Araujo
0da0c48e23 Blocked revisions 87312 via svnmerge
........
  r87312 | eric.araujo | 2010-12-16 07:28:48 +0100 (jeu., 16 déc. 2010) | 2 lines

  Add missing docs and directives related to PEP 3147 and byte-compilation
........
2010-12-16 06:30:42 +00:00
Brian Curtin
1c76044ea0 Merged revisions 87306 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87306 | brian.curtin | 2010-12-15 21:24:49 -0600 (Wed, 15 Dec 2010) | 2 lines

  EasyDialogs was removed in 3.x. fallback_getpass will always be the answer here.
........
2010-12-16 03:27:11 +00:00
Éric Araujo
3efdf0630b Merged revisions 86521,86632,86823-86824,87294,87296,87300,87302 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r86521 | eric.araujo | 2010-11-18 17:38:46 +0100 (jeu., 18 nov. 2010) | 17 lines

  Fix usage of :option: in the docs (#9312).

  :option: is used to create a link to an option of python, not to mark
  up any instance of any arbitrary command-line option.  These were
  changed to ````.

  For modules which do have a command-line interface, lists of options
  have been properly marked up with the program/cmdoption directives
  combo.  Options defined in such blocks can be linked to with :option:
  later in the same file, they won’t link to an option of python.

  Finally, the markup of command-line fragments in optparse.rst has
  been cleaned to use ``x`` instead of ``"x"``, keeping that latter
  form for actual Python strings.

  Patch by Eli Bendersky and Éric Araujo.
........
  r86632 | eric.araujo | 2010-11-21 04:09:17 +0100 (dim., 21 nov. 2010) | 2 lines

  Style edits in followup to r86521 (#9312)
........
  r86823 | eric.araujo | 2010-11-27 00:31:07 +0100 (sam., 27 nov. 2010) | 2 lines

  Use link-generating markup (see #9312)
........
  r86824 | eric.araujo | 2010-11-27 00:46:18 +0100 (sam., 27 nov. 2010) | 2 lines

  Rewrap long lines + minor edits
........
  r87294 | eric.araujo | 2010-12-16 01:07:01 +0100 (jeu., 16 déc. 2010) | 2 lines

  No need to generate a link for something that’s just above.
........
  r87296 | eric.araujo | 2010-12-16 01:23:30 +0100 (jeu., 16 déc. 2010) | 2 lines

  Advertise “python -m” instead of direct filename.
........
  r87300 | eric.araujo | 2010-12-16 02:40:26 +0100 (jeu., 16 déc. 2010) | 2 lines

  Advertise “python -m test” over test.regrtest (r87296 followup)
........
  r87302 | eric.araujo | 2010-12-16 03:10:11 +0100 (jeu., 16 déc. 2010) | 2 lines

  Add versionadded directive missing from r78983.
........
2010-12-16 03:16:29 +00:00
Éric Araujo
b7ae2095d0 Merged revisions 87289 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87289 | eric.araujo | 2010-12-15 23:37:27 +0100 (mer., 15 déc. 2010) | 2 lines

  Mark up one missed None in pkgutil.rst (#8851)
........
2010-12-15 22:38:50 +00:00
Éric Araujo
c1e14dffeb Merged revisions 87283 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87283 | eric.araujo | 2010-12-15 23:06:35 +0100 (mer., 15 déc. 2010) | 2 lines

  Add disclaimer about MinGW compat in distutils docs (#6007).  Patch by Chris Lambacher.
........
2010-12-15 22:07:54 +00:00
Éric Araujo
5d899dddb2 Merged revisions 87280 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87280 | eric.araujo | 2010-12-15 22:07:22 +0100 (mer., 15 déc. 2010) | 2 lines

  Fix build_ext with VS 8.0.  Patch by Hirokazu Yamamoto (#9558).
........
2010-12-15 21:12:12 +00:00
Éric Araujo
7e2e321da3 Merged revisions 87277 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87277 | eric.araujo | 2010-12-15 21:26:30 +0100 (mer., 15 déc. 2010) | 2 lines

  Fix wrong name in docstring and doc (#10693).  Original patch by Eli Bendersky.
........
2010-12-15 20:30:51 +00:00
R. David Murray
800dfee91a Merged revisions 87251 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87251 | r.david.murray | 2010-12-14 18:06:25 -0500 (Tue, 14 Dec 2010) | 4 lines

  #4236: avoid possible Fatal Error when import is called from __del__

  Patch by Simon Cross, crasher test code by Martin von Löwis.
........
2010-12-14 23:30:42 +00:00
R. David Murray
6ed3244557 Blocked revisions 87248 via svnmerge
........
  r87248 | r.david.murray | 2010-12-14 17:32:50 -0500 (Tue, 14 Dec 2010) | 2 lines

  More comprehensive compileall cli tests, and fixes.
........
2010-12-14 22:34:12 +00:00
Gregory P. Smith
c6637a507a SIGCHLD is a more portable name than SIGCLD (OSX has no SIGCLD). 2010-12-14 18:20:45 +00:00
R. David Murray
d8fec5ff08 Merged revisions 87238 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87238 | r.david.murray | 2010-12-14 11:20:53 -0500 (Tue, 14 Dec 2010) | 7 lines

  #775964: skip YP/NIS entries instead of failing the test

  Also includes doc updates mentioning that these entries may not
  be retrievable via getgrnam and getgrgid.

  Patch by Bobby Impollonia.
........
2010-12-14 16:24:18 +00:00
Gregory P. Smith
773d7dffb1 fix "BytesWarning: str() on a bytes instance" 2010-12-14 15:25:20 +00:00
Gregory P. Smith
b740e76af0 Merged revisions 87233 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87233 | gregory.p.smith | 2010-12-14 06:38:00 -0800 (Tue, 14 Dec 2010) | 4 lines

  Issue #1731717: Fixed the problem where subprocess.wait() could cause an
  OSError exception when The OS had been told to ignore SIGCLD in our process
  or otherwise not wait for exiting child processes.
........
2010-12-14 15:16:24 +00:00
R. David Murray
6b2af997d4 Merged revisions 87230 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87230 | r.david.murray | 2010-12-14 09:16:20 -0500 (Tue, 14 Dec 2010) | 7 lines

  #10695: use %s not %d so that a string 'port' does not cause a debug traceback

  Passing the port as a string value works fine in regular mode, but
  if you turned debug on it would throw an error trying to print the
  port number, which is surprising and confusing.
........
2010-12-14 14:27:27 +00:00
R. David Murray
d382066d2c Merged revisions 87225 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87225 | r.david.murray | 2010-12-13 20:38:16 -0500 (Mon, 13 Dec 2010) | 2 lines

  9162: fix license in multiprocessing files
........
2010-12-14 01:41:07 +00:00
R. David Murray
f3d082c960 Merged revisions 87222 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87222 | r.david.murray | 2010-12-13 20:22:50 -0500 (Mon, 13 Dec 2010) | 2 lines

  Use skipIf instead of a return when attribute doesn't exist.
........
2010-12-14 01:25:30 +00:00
R. David Murray
ccb9d05b6c Merged revisions 87217 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87217 | r.david.murray | 2010-12-13 18:51:19 -0500 (Mon, 13 Dec 2010) | 5 lines

  #1078919: make add_header automatically do RFC2231 encoding when needed.

  Also document the use of three-tuples if control of the charset
  and language is desired.
........
2010-12-13 23:57:01 +00:00
Antoine Pitrou
fa66d583f6 Merged revisions 87197-87198 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87197 | antoine.pitrou | 2010-12-12 21:34:49 +0100 (dim., 12 déc. 2010) | 3 lines

  Homogenize the "optional OS services" menu
........
  r87198 | antoine.pitrou | 2010-12-12 21:57:12 +0100 (dim., 12 déc. 2010) | 3 lines

  Improve readability of the socket docs
........
2010-12-12 21:08:54 +00:00
Antoine Pitrou
a92d1f5041 Merged revisions 87188-87190,87192-87194 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87188 | antoine.pitrou | 2010-12-12 19:25:25 +0100 (dim., 12 déc. 2010) | 3 lines

  Make this a warning and fix indentation
........
  r87189 | antoine.pitrou | 2010-12-12 20:59:47 +0100 (dim., 12 déc. 2010) | 3 lines

  Better explain the buffer interface (hopefully)
........
  r87190 | antoine.pitrou | 2010-12-12 21:01:43 +0100 (dim., 12 déc. 2010) | 3 lines

  Add link to the buffer protocol description from the memory description.
........
  r87192 | antoine.pitrou | 2010-12-12 21:09:18 +0100 (dim., 12 déc. 2010) | 3 lines

  Remove redundant sentence, and fix markup
........
  r87193 | antoine.pitrou | 2010-12-12 21:13:31 +0100 (dim., 12 déc. 2010) | 3 lines

  Fix heading level
........
  r87194 | antoine.pitrou | 2010-12-12 21:17:29 +0100 (dim., 12 déc. 2010) | 3 lines

  Consistent ordering of availability statements
........
2010-12-12 21:07:49 +00:00
R. David Murray
0101a3a827 Merged revisions 87191 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87191 | r.david.murray | 2010-12-12 15:06:19 -0500 (Sun, 12 Dec 2010) | 6 lines

  #243654: only create a new MIME boundary if we don't already have one.

  The rearranged code should do exactly what the old code did, but
  the new code avoids a potentially costly re computation in the case
  where a boundary already exists.
........
2010-12-12 20:28:13 +00:00
Antoine Pitrou
e6e5ea5f2a Merged revisions 87184-87186 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87184 | antoine.pitrou | 2010-12-12 19:09:53 +0100 (dim., 12 déc. 2010) | 3 lines

  SET_LINENO was removed in 2.3
........
  r87185 | antoine.pitrou | 2010-12-12 19:12:40 +0100 (dim., 12 déc. 2010) | 3 lines

  Remove reference to stuff which is already obsolete in 2.x.
........
  r87186 | antoine.pitrou | 2010-12-12 19:14:34 +0100 (dim., 12 déc. 2010) | 3 lines

  Obsolete aliases needn't be documented
........
2010-12-12 18:17:32 +00:00