mirror of
https://github.com/python/cpython.git
synced 2024-11-28 12:31:14 +08:00
Fix old-style octal literals in the docs.
This commit is contained in:
parent
95f5686e4d
commit
f4a41231b2
@ -961,7 +961,7 @@ This module provides functions for operating on directories and trees of
|
||||
directories.
|
||||
|
||||
|
||||
.. function:: mkpath(name[, mode=0777, verbose=0, dry_run=0])
|
||||
.. function:: mkpath(name[, mode=0o777, verbose=0, dry_run=0])
|
||||
|
||||
Create a directory and any missing ancestor directories. If the directory
|
||||
already exists (or if *name* is the empty string, which means the current
|
||||
@ -972,7 +972,7 @@ directories.
|
||||
directories actually created.
|
||||
|
||||
|
||||
.. function:: create_tree(base_dir, files[, mode=0777, verbose=0, dry_run=0])
|
||||
.. function:: create_tree(base_dir, files[, mode=0o777, verbose=0, dry_run=0])
|
||||
|
||||
Create all the empty directories under *base_dir* needed to put *files* there.
|
||||
*base_dir* is just the a name of a directory which doesn't necessarily exist
|
||||
|
@ -385,7 +385,7 @@ administrator to find the directory where CGI scripts should be installed;
|
||||
usually this is in a directory :file:`cgi-bin` in the server tree.
|
||||
|
||||
Make sure that your script is readable and executable by "others"; the Unix file
|
||||
mode should be ``0755`` octal (use ``chmod 0755 filename``). Make sure that the
|
||||
mode should be ``0o755`` octal (use ``chmod 0755 filename``). Make sure that the
|
||||
first line of the script contains ``#!`` starting in column 1 followed by the
|
||||
pathname of the Python interpreter, for instance::
|
||||
|
||||
@ -394,8 +394,8 @@ pathname of the Python interpreter, for instance::
|
||||
Make sure the Python interpreter exists and is executable by "others".
|
||||
|
||||
Make sure that any files your script needs to read or write are readable or
|
||||
writable, respectively, by "others" --- their mode should be ``0644`` for
|
||||
readable and ``0666`` for writable. This is because, for security reasons, the
|
||||
writable, respectively, by "others" --- their mode should be ``0o644`` for
|
||||
readable and ``0o666`` for writable. This is because, for security reasons, the
|
||||
HTTP server executes your script as user "nobody", without any special
|
||||
privileges. It can only read (write, execute) files that everybody can read
|
||||
(write, execute). The current directory at execution time is also different (it
|
||||
|
@ -242,7 +242,7 @@ supported.
|
||||
:exc:`error` is raised if an invalid flag is specified.
|
||||
|
||||
The optional *mode* argument is the Unix mode of the file, used only when the
|
||||
database has to be created. It defaults to octal ``0666``.
|
||||
database has to be created. It defaults to octal ``0o666``.
|
||||
|
||||
In addition to the dictionary-like methods, ``gdbm`` objects have the
|
||||
following methods:
|
||||
@ -334,7 +334,7 @@ to simplify building this module.
|
||||
+---------+-------------------------------------------+
|
||||
|
||||
The optional *mode* argument is the Unix mode of the file, used only when the
|
||||
database has to be created. It defaults to octal ``0666`` (and will be
|
||||
database has to be created. It defaults to octal ``0o666`` (and will be
|
||||
modified by the prevailing umask).
|
||||
|
||||
|
||||
|
@ -490,10 +490,10 @@ by file descriptors.
|
||||
|
||||
.. function:: open(file, flags[, mode])
|
||||
|
||||
Open the file *file* and set various flags according to *flags* and possibly its
|
||||
mode according to *mode*. The default *mode* is ``0777`` (octal), and the
|
||||
current umask value is first masked out. Return the file descriptor for the
|
||||
newly opened file. Availability: Macintosh, Unix, Windows.
|
||||
Open the file *file* and set various flags according to *flags* and possibly
|
||||
its mode according to *mode*. The default *mode* is ``0o777`` (octal), and
|
||||
the current umask value is first masked out. Return the file descriptor for
|
||||
the newly opened file. Availability: Macintosh, Unix, Windows.
|
||||
|
||||
For a description of the flag and mode values, see the C run-time documentation;
|
||||
flag constants (like :const:`O_RDONLY` and :const:`O_WRONLY`) are defined in
|
||||
@ -823,9 +823,9 @@ Files and Directories
|
||||
|
||||
.. function:: mkfifo(path[, mode])
|
||||
|
||||
Create a FIFO (a named pipe) named *path* with numeric mode *mode*. The default
|
||||
*mode* is ``0666`` (octal). The current umask value is first masked out from
|
||||
the mode. Availability: Macintosh, Unix.
|
||||
Create a FIFO (a named pipe) named *path* with numeric mode *mode*. The
|
||||
default *mode* is ``0o666`` (octal). The current umask value is first masked
|
||||
out from the mode. Availability: Macintosh, Unix.
|
||||
|
||||
FIFOs are pipes that can be accessed like regular files. FIFOs exist until they
|
||||
are deleted (for example with :func:`os.unlink`). Generally, FIFOs are used as
|
||||
@ -834,7 +834,7 @@ Files and Directories
|
||||
doesn't open the FIFO --- it just creates the rendezvous point.
|
||||
|
||||
|
||||
.. function:: mknod(filename[, mode=0600, device])
|
||||
.. function:: mknod(filename[, mode=0o600, device])
|
||||
|
||||
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 to
|
||||
@ -865,9 +865,10 @@ Files and Directories
|
||||
|
||||
.. function:: mkdir(path[, mode])
|
||||
|
||||
Create a directory named *path* with numeric mode *mode*. The default *mode* is
|
||||
``0777`` (octal). On some systems, *mode* is ignored. Where it is used, the
|
||||
current umask value is first masked out. Availability: Macintosh, Unix, Windows.
|
||||
Create a directory named *path* with numeric mode *mode*. The default *mode*
|
||||
is ``0o777`` (octal). On some systems, *mode* is ignored. Where it is used,
|
||||
the current umask value is first masked out. Availability: Macintosh, Unix,
|
||||
Windows.
|
||||
|
||||
It is also possible to create temporary directories; see the
|
||||
:mod:`tempfile` module's :func:`tempfile.mkdtemp` function.
|
||||
@ -880,10 +881,10 @@ Files and Directories
|
||||
single: UNC paths; and os.makedirs()
|
||||
|
||||
Recursive directory creation function. Like :func:`mkdir`, but makes all
|
||||
intermediate-level directories needed to contain the leaf directory. Throws an
|
||||
:exc:`error` exception if the leaf directory already exists or cannot be
|
||||
created. The default *mode* is ``0777`` (octal). On some systems, *mode* is
|
||||
ignored. Where it is used, the current umask value is first masked out.
|
||||
intermediate-level directories needed to contain the leaf directory. Throws
|
||||
an :exc:`error` exception if the leaf directory already exists or cannot be
|
||||
created. The default *mode* is ``0o777`` (octal). On some systems, *mode*
|
||||
is ignored. Where it is used, the current umask value is first masked out.
|
||||
|
||||
.. note::
|
||||
|
||||
|
@ -27,10 +27,10 @@ The :mod:`uu` module defines the following functions:
|
||||
|
||||
.. function:: encode(in_file, out_file[, name[, mode]])
|
||||
|
||||
Uuencode file *in_file* into file *out_file*. The uuencoded file will have the
|
||||
header specifying *name* and *mode* as the defaults for the results of decoding
|
||||
the file. The default defaults are taken from *in_file*, or ``'-'`` and ``0666``
|
||||
respectively.
|
||||
Uuencode file *in_file* into file *out_file*. The uuencoded file will have
|
||||
the header specifying *name* and *mode* as the defaults for the results of
|
||||
decoding the file. The default defaults are taken from *in_file*, or ``'-'``
|
||||
and ``0o666`` respectively.
|
||||
|
||||
|
||||
.. function:: decode(in_file[, out_file[, mode[, quiet]]])
|
||||
|
Loading…
Reference in New Issue
Block a user