mirror of
https://github.com/python/cpython.git
synced 2025-12-04 08:34:25 +00:00
Fix old-style octal literals in the docs.
This commit is contained in:
parent
95f5686e4d
commit
f4a41231b2
5 changed files with 27 additions and 26 deletions
|
|
@ -961,7 +961,7 @@ This module provides functions for operating on directories and trees of
|
||||||
directories.
|
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
|
Create a directory and any missing ancestor directories. If the directory
|
||||||
already exists (or if *name* is the empty string, which means the current
|
already exists (or if *name* is the empty string, which means the current
|
||||||
|
|
@ -972,7 +972,7 @@ directories.
|
||||||
directories actually created.
|
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.
|
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
|
*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.
|
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
|
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
|
first line of the script contains ``#!`` starting in column 1 followed by the
|
||||||
pathname of the Python interpreter, for instance::
|
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 the Python interpreter exists and is executable by "others".
|
||||||
|
|
||||||
Make sure that any files your script needs to read or write are readable or
|
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
|
writable, respectively, by "others" --- their mode should be ``0o644`` for
|
||||||
readable and ``0666`` for writable. This is because, for security reasons, the
|
readable and ``0o666`` for writable. This is because, for security reasons, the
|
||||||
HTTP server executes your script as user "nobody", without any special
|
HTTP server executes your script as user "nobody", without any special
|
||||||
privileges. It can only read (write, execute) files that everybody can read
|
privileges. It can only read (write, execute) files that everybody can read
|
||||||
(write, execute). The current directory at execution time is also different (it
|
(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.
|
: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
|
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
|
In addition to the dictionary-like methods, ``gdbm`` objects have the
|
||||||
following methods:
|
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
|
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).
|
modified by the prevailing umask).
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -490,10 +490,10 @@ by file descriptors.
|
||||||
|
|
||||||
.. function:: open(file, flags[, mode])
|
.. function:: open(file, flags[, mode])
|
||||||
|
|
||||||
Open the file *file* and set various flags according to *flags* and possibly its
|
Open the file *file* and set various flags according to *flags* and possibly
|
||||||
mode according to *mode*. The default *mode* is ``0777`` (octal), and the
|
its mode according to *mode*. The default *mode* is ``0o777`` (octal), and
|
||||||
current umask value is first masked out. Return the file descriptor for the
|
the current umask value is first masked out. Return the file descriptor for
|
||||||
newly opened file. Availability: Macintosh, Unix, Windows.
|
the newly opened file. Availability: Macintosh, Unix, Windows.
|
||||||
|
|
||||||
For a description of the flag and mode values, see the C run-time documentation;
|
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
|
flag constants (like :const:`O_RDONLY` and :const:`O_WRONLY`) are defined in
|
||||||
|
|
@ -823,9 +823,9 @@ Files and Directories
|
||||||
|
|
||||||
.. function:: mkfifo(path[, mode])
|
.. function:: mkfifo(path[, mode])
|
||||||
|
|
||||||
Create a FIFO (a named pipe) named *path* with numeric mode *mode*. The default
|
Create a FIFO (a named pipe) named *path* with numeric mode *mode*. The
|
||||||
*mode* is ``0666`` (octal). The current umask value is first masked out from
|
default *mode* is ``0o666`` (octal). The current umask value is first masked
|
||||||
the mode. Availability: Macintosh, Unix.
|
out from the mode. Availability: Macintosh, Unix.
|
||||||
|
|
||||||
FIFOs are pipes that can be accessed like regular files. FIFOs exist until they
|
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
|
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.
|
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
|
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
|
*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])
|
.. function:: mkdir(path[, mode])
|
||||||
|
|
||||||
Create a directory named *path* with numeric mode *mode*. The default *mode* is
|
Create a directory named *path* with numeric mode *mode*. The default *mode*
|
||||||
``0777`` (octal). On some systems, *mode* is ignored. Where it is used, the
|
is ``0o777`` (octal). On some systems, *mode* is ignored. Where it is used,
|
||||||
current umask value is first masked out. Availability: Macintosh, Unix, Windows.
|
the current umask value is first masked out. Availability: Macintosh, Unix,
|
||||||
|
Windows.
|
||||||
|
|
||||||
It is also possible to create temporary directories; see the
|
It is also possible to create temporary directories; see the
|
||||||
:mod:`tempfile` module's :func:`tempfile.mkdtemp` function.
|
:mod:`tempfile` module's :func:`tempfile.mkdtemp` function.
|
||||||
|
|
@ -880,10 +881,10 @@ Files and Directories
|
||||||
single: UNC paths; and os.makedirs()
|
single: UNC paths; and os.makedirs()
|
||||||
|
|
||||||
Recursive directory creation function. Like :func:`mkdir`, but makes all
|
Recursive directory creation function. Like :func:`mkdir`, but makes all
|
||||||
intermediate-level directories needed to contain the leaf directory. Throws an
|
intermediate-level directories needed to contain the leaf directory. Throws
|
||||||
:exc:`error` exception if the leaf directory already exists or cannot be
|
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
|
created. The default *mode* is ``0o777`` (octal). On some systems, *mode*
|
||||||
ignored. Where it is used, the current umask value is first masked out.
|
is ignored. Where it is used, the current umask value is first masked out.
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -27,10 +27,10 @@ The :mod:`uu` module defines the following functions:
|
||||||
|
|
||||||
.. function:: encode(in_file, out_file[, name[, mode]])
|
.. function:: encode(in_file, out_file[, name[, mode]])
|
||||||
|
|
||||||
Uuencode file *in_file* into file *out_file*. The uuencoded file will have the
|
Uuencode file *in_file* into file *out_file*. The uuencoded file will have
|
||||||
header specifying *name* and *mode* as the defaults for the results of decoding
|
the header specifying *name* and *mode* as the defaults for the results of
|
||||||
the file. The default defaults are taken from *in_file*, or ``'-'`` and ``0666``
|
decoding the file. The default defaults are taken from *in_file*, or ``'-'``
|
||||||
respectively.
|
and ``0o666`` respectively.
|
||||||
|
|
||||||
|
|
||||||
.. function:: decode(in_file[, out_file[, mode[, quiet]]])
|
.. function:: decode(in_file[, out_file[, mode[, quiet]]])
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue