diff -r e0540079940c Doc/library/curses.rst --- a/Doc/library/curses.rst Sun May 13 22:45:57 2012 -0500 +++ b/Doc/library/curses.rst Mon May 14 13:21:27 2012 +0200 @@ -1120,7 +1120,7 @@ rendition (as set by :meth:`bkgdset`) merged into them. -.. method:: window.scroll([lines=1]) +.. method:: window.scroll(lines=1) Scroll the screen or scrolling region upward by *lines* lines. diff -r e0540079940c Doc/library/email.generator.rst --- a/Doc/library/email.generator.rst Sun May 13 22:45:57 2012 -0500 +++ b/Doc/library/email.generator.rst Mon May 14 13:21:27 2012 +0200 @@ -197,7 +197,7 @@ representing the part. -.. class:: DecodedGenerator(outfp[, mangle_from_=True, maxheaderlen=78, fmt=None) +.. class:: DecodedGenerator(outfp, mangle_from_=True, maxheaderlen=78, fmt=None) This class, derived from :class:`Generator` walks through all the subparts of a message. If the subpart is of main type :mimetype:`text`, then it prints the diff -r e0540079940c Doc/library/http.cookiejar.rst --- a/Doc/library/http.cookiejar.rst Sun May 13 22:45:57 2012 -0500 +++ b/Doc/library/http.cookiejar.rst Mon May 14 13:21:27 2012 +0200 @@ -707,7 +707,7 @@ The :class:`Cookie` class also defines the following method: -.. method:: Cookie.is_expired([now=None]) +.. method:: Cookie.is_expired(now=None) True if cookie has passed the time at which the server requested it should expire. If *now* is given (in seconds since the epoch), return whether the diff -r e0540079940c Doc/library/nis.rst --- a/Doc/library/nis.rst Sun May 13 22:45:57 2012 -0500 +++ b/Doc/library/nis.rst Mon May 14 13:21:27 2012 +0200 @@ -17,7 +17,7 @@ The :mod:`nis` module defines the following functions: -.. function:: match(key, mapname[, domain=default_domain]) +.. function:: match(key, mapname, domain=default_domain) Return the match for *key* in map *mapname*, or raise an error (:exc:`nis.error`) if there is none. Both should be strings, *key* is 8-bit @@ -30,7 +30,7 @@ unspecified, lookup is in the default NIS domain. -.. function:: cat(mapname[, domain=default_domain]) +.. function:: cat(mapname, domain=default_domain) Return a dictionary mapping *key* to *value* such that ``match(key, mapname)==value``. Note that both keys and values of the dictionary are @@ -42,7 +42,7 @@ unspecified, lookup is in the default NIS domain. -.. function:: maps([domain=default_domain]) +.. function:: maps(domain=default_domain) Return a list of all valid maps. diff -r e0540079940c Doc/library/os.rst --- a/Doc/library/os.rst Sun May 13 22:45:57 2012 -0500 +++ b/Doc/library/os.rst Mon May 14 13:21:27 2012 +0200 @@ -1309,7 +1309,7 @@ .. versionadded:: 3.3 -.. function:: utimensat(dirfd, path[, atime=(atime_sec, atime_nsec), mtime=(mtime_sec, mtime_nsec), flags=0]) +.. function:: utimensat(dirfd, path, atime=(atime_sec, atime_nsec), mtime=(mtime_sec, mtime_nsec), flags=0) Updates the timestamps of a file with nanosecond precision. The *atime* and *mtime* tuples default to ``None``, which sets those @@ -1786,7 +1786,7 @@ Availability: Unix. -.. function:: mknod(filename[, mode=0o600[, device]]) +.. function:: mknod(filename, mode=0o600, device=0) Create a filesystem node (file, device special file or named pipe) named *filename*. *mode* specifies both the permissions to use and the type of node diff -r e0540079940c Doc/library/ossaudiodev.rst --- a/Doc/library/ossaudiodev.rst Sun May 13 22:45:57 2012 -0500 +++ b/Doc/library/ossaudiodev.rst Mon May 14 13:21:27 2012 +0200 @@ -281,7 +281,7 @@ simple calculations. -.. method:: oss_audio_device.setparameters(format, nchannels, samplerate [, strict=False]) +.. method:: oss_audio_device.setparameters(format, nchannels, samplerate, strict=False) Set the key audio sampling parameters---sample format, number of channels, and sampling rate---in one method call. *format*, *nchannels*, and *samplerate* diff -r e0540079940c Doc/library/packaging.compiler.rst --- a/Doc/library/packaging.compiler.rst Sun May 13 22:45:57 2012 -0500 +++ b/Doc/library/packaging.compiler.rst Mon May 14 13:21:27 2012 +0200 @@ -255,7 +255,7 @@ that the runtime linker may search by default. - .. method:: CCompiler.define_macro(name[, value=None]) + .. method:: CCompiler.define_macro(name, value=None) Define a preprocessor macro for all compilations driven by this compiler object. The optional parameter *value* should be a string; if it is not @@ -298,7 +298,7 @@ (a list) to do the job. - .. method:: CCompiler.find_library_file(dirs, lib[, debug=0]) + .. method:: CCompiler.find_library_file(dirs, lib, debug=0) Search the specified list of directories for a static or shared library file *lib* and return the full path to that file. If *debug* is true, look for a @@ -306,7 +306,7 @@ ``None`` if *lib* wasn't found in any of the specified directories. - .. method:: CCompiler.has_function(funcname [, includes=None, include_dirs=None, libraries=None, library_dirs=None]) + .. method:: CCompiler.has_function(funcname, includes=None, include_dirs=None, libraries=None, library_dirs=None) Return a boolean indicating whether *funcname* is supported on the current platform. The optional arguments can be used to augment the compilation @@ -361,7 +361,7 @@ The following methods invoke stages in the build process. - .. method:: CCompiler.compile(sources[, output_dir=None, macros=None, include_dirs=None, debug=0, extra_preargs=None, extra_postargs=None, depends=None]) + .. method:: CCompiler.compile(sources, output_dir=None, macros=None, include_dirs=None, debug=0, extra_preargs=None, extra_postargs=None, depends=None) Compile one or more source files. Generates object files (e.g. transforms a :file:`.c` file to a :file:`.o` file.) @@ -405,7 +405,7 @@ Raises :exc:`CompileError` on failure. - .. method:: CCompiler.create_static_lib(objects, output_libname[, output_dir=None, debug=0, target_lang=None]) + .. method:: CCompiler.create_static_lib(objects, output_libname, output_dir=None, debug=0, target_lang=None) Link a bunch of stuff together to create a static library file. The "bunch of stuff" consists of the list of object files supplied as *objects*, the extra @@ -427,7 +427,7 @@ Raises :exc:`LibError` on failure. - .. method:: CCompiler.link(target_desc, objects, output_filename[, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None]) + .. method:: CCompiler.link(target_desc, objects, output_filename, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None) Link a bunch of stuff together to create an executable or shared library file. @@ -469,28 +469,28 @@ Raises :exc:`LinkError` on failure. - .. method:: CCompiler.link_executable(objects, output_progname[, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, debug=0, extra_preargs=None, extra_postargs=None, target_lang=None]) + .. method:: CCompiler.link_executable(objects, output_progname, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, debug=0, extra_preargs=None, extra_postargs=None, target_lang=None) Link an executable. *output_progname* is the name of the file executable, while *objects* are a list of object filenames to link in. Other arguments are as for the :meth:`link` method. - .. method:: CCompiler.link_shared_lib(objects, output_libname[, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None]) + .. method:: CCompiler.link_shared_lib(objects, output_libname, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None) Link a shared library. *output_libname* is the name of the output library, while *objects* is a list of object filenames to link in. Other arguments are as for the :meth:`link` method. - .. method:: CCompiler.link_shared_object(objects, output_filename[, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None]) + .. method:: CCompiler.link_shared_object(objects, output_filename, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None) Link a shared object. *output_filename* is the name of the shared object that will be created, while *objects* is a list of object filenames to link in. Other arguments are as for the :meth:`link` method. - .. method:: CCompiler.preprocess(source[, output_file=None, macros=None, include_dirs=None, extra_preargs=None, extra_postargs=None]) + .. method:: CCompiler.preprocess(source, output_file=None, macros=None, include_dirs=None, extra_preargs=None, extra_postargs=None) Preprocess a single C/C++ source file, named in *source*. Output will be written to file named *output_file*, or *stdout* if *output_file* not supplied. @@ -505,14 +505,14 @@ use by the various concrete subclasses. - .. method:: CCompiler.executable_filename(basename[, strip_dir=0, output_dir='']) + .. method:: CCompiler.executable_filename(basename, strip_dir=0, output_dir='') Returns the filename of the executable for the given *basename*. Typically for non-Windows platforms this is the same as the basename, while Windows will get a :file:`.exe` added. - .. method:: CCompiler.library_filename(libname[, lib_type='static', strip_dir=0, output_dir='']) + .. method:: CCompiler.library_filename(libname, lib_type='static', strip_dir=0, output_dir='') Returns the filename for the given library name on the current platform. On Unix a library with *lib_type* of ``'static'`` will typically be of the form @@ -520,18 +520,18 @@ :file:`liblibname.so`. - .. method:: CCompiler.object_filenames(source_filenames[, strip_dir=0, output_dir='']) + .. method:: CCompiler.object_filenames(source_filenames, strip_dir=0, output_dir='') Returns the name of the object files for the given source files. *source_filenames* should be a list of filenames. - .. method:: CCompiler.shared_object_filename(basename[, strip_dir=0, output_dir='']) + .. method:: CCompiler.shared_object_filename(basename, strip_dir=0, output_dir='') Returns the name of a shared object file for the given file name *basename*. - .. method:: CCompiler.execute(func, args[, msg=None, level=1]) + .. method:: CCompiler.execute(func, args, msg=None, level=1) Invokes :func:`packaging.util.execute` This method invokes a Python function *func* with the given arguments *args*, after logging and taking into account @@ -544,7 +544,7 @@ the given command. XXX see also. - .. method:: CCompiler.mkpath(name[, mode=511]) + .. method:: CCompiler.mkpath(name, mode=511) Invokes :func:`packaging.dir_util.mkpath`. This creates a directory and any missing ancestor directories. XXX see also. diff -r e0540079940c Doc/library/packaging.fancy_getopt.rst --- a/Doc/library/packaging.fancy_getopt.rst Sun May 13 22:45:57 2012 -0500 +++ b/Doc/library/packaging.fancy_getopt.rst Mon May 14 13:21:27 2012 +0200 @@ -33,7 +33,7 @@ ``sys.argv[1:]`` if you pass ``None`` as *args*. -.. class:: FancyGetopt([option_table=None]) +.. class:: FancyGetopt(option_table=None) The option_table is a list of 3-tuples: ``(long_option, short_option, help_string)`` @@ -46,7 +46,7 @@ The :class:`FancyGetopt` class provides the following methods: -.. method:: FancyGetopt.getopt([args=None, object=None]) +.. method:: FancyGetopt.getopt(args=None, object=None) Parse command-line options in args. Store as attributes on *object*. @@ -67,7 +67,7 @@ yet. -.. method:: FancyGetopt.generate_help([header=None]) +.. method:: FancyGetopt.generate_help(header=None) Generate help text (a list of strings, one per suggested line of output) from the option table for this :class:`FancyGetopt` object. diff -r e0540079940c Doc/library/select.rst --- a/Doc/library/select.rst Sun May 13 22:45:57 2012 -0500 +++ b/Doc/library/select.rst Mon May 14 13:21:27 2012 +0200 @@ -267,7 +267,7 @@ Remove a registered file descriptor from the epoll object. -.. method:: epoll.poll([timeout=-1[, maxevents=-1]]) +.. method:: epoll.poll(timeout=-1, maxevents=-1) Wait for events. timeout in seconds (float) @@ -371,7 +371,7 @@ Create a kqueue object from a given file descriptor. -.. method:: kqueue.control(changelist, max_events[, timeout=None]) -> eventlist +.. method:: kqueue.control(changelist, max_events, timeout=None) -> eventlist Low level interface to kevent diff -r e0540079940c Doc/library/shutil.rst --- a/Doc/library/shutil.rst Sun May 13 22:45:57 2012 -0500 +++ b/Doc/library/shutil.rst Mon May 14 13:21:27 2012 +0200 @@ -47,7 +47,7 @@ be copied. -.. function:: copyfile(src, dst[, symlinks=False]) +.. function:: copyfile(src, dst, symlinks=False) Copy the contents (no metadata) of the file named *src* to a file named *dst*. *dst* must be the complete target file name; look at @@ -67,7 +67,7 @@ Added *symlinks* argument. -.. function:: copymode(src, dst[, symlinks=False]) +.. function:: copymode(src, dst, symlinks=False) Copy the permission bits from *src* to *dst*. The file contents, owner, and group are unaffected. *src* and *dst* are path names given as strings. If @@ -78,7 +78,7 @@ .. versionchanged:: 3.3 Added *symlinks* argument. -.. function:: copystat(src, dst[, symlinks=False]) +.. function:: copystat(src, dst, symlinks=False) Copy the permission bits, last access time, last modification time, and flags from *src* to *dst*. The file contents, owner, and group are unaffected. *src* @@ -89,7 +89,7 @@ .. versionchanged:: 3.3 Added *symlinks* argument. -.. function:: copy(src, dst[, symlinks=False])) +.. function:: copy(src, dst, symlinks=False)) Copy the file *src* to the file or directory *dst*. If *dst* is a directory, a file with the same basename as *src* is created (or overwritten) in the @@ -100,7 +100,7 @@ .. versionchanged:: 3.3 Added *symlinks* argument. -.. function:: copy2(src, dst[, symlinks=False]) +.. function:: copy2(src, dst, symlinks=False) Similar to :func:`shutil.copy`, but metadata is copied as well. This is similar to the Unix command :program:`cp -p`. If *symlinks* is true, diff -r e0540079940c Doc/library/sqlite3.rst --- a/Doc/library/sqlite3.rst Sun May 13 22:45:57 2012 -0500 +++ b/Doc/library/sqlite3.rst Mon May 14 13:21:27 2012 +0200 @@ -526,7 +526,7 @@ or :const:`None` when no more data is available. -.. method:: Cursor.fetchmany([size=cursor.arraysize]) +.. method:: Cursor.fetchmany(size=cursor.arraysize) Fetches the next set of rows of a query result, returning a list. An empty list is returned when no more rows are available.