forked from AFPy/python-docs-fr
322 lines
11 KiB
Plaintext
322 lines
11 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2001-2016, Python Software Foundation
|
|
# This file is distributed under the same license as the Python package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3.6\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2016-10-30 10:40+0100\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../Doc/library/readline.rst:2
|
|
msgid ":mod:`readline` --- GNU readline interface"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:12
|
|
msgid ""
|
|
"The :mod:`readline` module defines a number of functions to facilitate "
|
|
"completion and reading/writing of history files from the Python interpreter. "
|
|
"This module can be used directly, or via the :mod:`rlcompleter` module, "
|
|
"which supports completion of Python identifiers at the interactive prompt. "
|
|
"Settings made using this module affect the behaviour of both the "
|
|
"interpreter's interactive prompt and the prompts offered by the built-in :"
|
|
"func:`input` function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:22
|
|
msgid ""
|
|
"The underlying Readline library API may be implemented by the ``libedit`` "
|
|
"library instead of GNU readline. On MacOS X the :mod:`readline` module "
|
|
"detects which library is being used at run time."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:27
|
|
msgid ""
|
|
"The configuration file for ``libedit`` is different from that of GNU "
|
|
"readline. If you programmatically load configuration strings you can check "
|
|
"for the text \"libedit\" in :const:`readline.__doc__` to differentiate "
|
|
"between GNU readline and libedit."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:32
|
|
msgid ""
|
|
"Readline keybindings may be configured via an initialization file, typically "
|
|
"``.inputrc`` in your home directory. See `Readline Init File <https://"
|
|
"cnswww.cns.cwru.edu/php/chet/readline/rluserman.html#SEC9>`_ in the GNU "
|
|
"Readline manual for information about the format and allowable constructs of "
|
|
"that file, and the capabilities of the Readline library in general."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:41
|
|
msgid "Init file"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:43
|
|
msgid "The following functions relate to the init file and user configuration:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:48
|
|
msgid ""
|
|
"Execute the init line provided in the *string* argument. This calls :c:func:"
|
|
"`rl_parse_and_bind` in the underlying library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:54
|
|
msgid ""
|
|
"Execute a readline initialization file. The default filename is the last "
|
|
"filename used. This calls :c:func:`rl_read_init_file` in the underlying "
|
|
"library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:59
|
|
msgid "Line buffer"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:61
|
|
msgid "The following functions operate on the line buffer:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:66
|
|
msgid ""
|
|
"Return the current contents of the line buffer (:c:data:`rl_line_buffer` in "
|
|
"the underlying library)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:72
|
|
msgid ""
|
|
"Insert text into the line buffer at the cursor position. This calls :c:func:"
|
|
"`rl_insert_text` in the underlying library, but ignores the return value."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:79
|
|
msgid ""
|
|
"Change what's displayed on the screen to reflect the current contents of the "
|
|
"line buffer. This calls :c:func:`rl_redisplay` in the underlying library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:84
|
|
msgid "History file"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:86
|
|
msgid "The following functions operate on a history file:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:91
|
|
msgid ""
|
|
"Load a readline history file, and append it to the history list. The default "
|
|
"filename is :file:`~/.history`. This calls :c:func:`read_history` in the "
|
|
"underlying library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:98
|
|
msgid ""
|
|
"Save the history list to a readline history file, overwriting any existing "
|
|
"file. The default filename is :file:`~/.history`. This calls :c:func:"
|
|
"`write_history` in the underlying library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:105
|
|
msgid ""
|
|
"Append the last *nelements* items of history to a file. The default "
|
|
"filename is :file:`~/.history`. The file must already exist. This calls :c:"
|
|
"func:`append_history` in the underlying library. This function only exists "
|
|
"if Python was compiled for a version of the library that supports it."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:117
|
|
msgid ""
|
|
"Set or return the desired number of lines to save in the history file. The :"
|
|
"func:`write_history_file` function uses this value to truncate the history "
|
|
"file, by calling :c:func:`history_truncate_file` in the underlying library. "
|
|
"Negative values imply unlimited history file size."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:125
|
|
msgid "History list"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:127
|
|
msgid "The following functions operate on a global history list:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:132
|
|
msgid ""
|
|
"Clear the current history. This calls :c:func:`clear_history` in the "
|
|
"underlying library. The Python function only exists if Python was compiled "
|
|
"for a version of the library that supports it."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:139
|
|
msgid ""
|
|
"Return the number of items currently in the history. (This is different "
|
|
"from :func:`get_history_length`, which returns the maximum number of lines "
|
|
"that will be written to a history file.)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:146
|
|
msgid ""
|
|
"Return the current contents of history item at *index*. The item index is "
|
|
"one-based. This calls :c:func:`history_get` in the underlying library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:152
|
|
msgid ""
|
|
"Remove history item specified by its position from the history. The position "
|
|
"is zero-based. This calls :c:func:`remove_history` in the underlying "
|
|
"library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:159
|
|
msgid ""
|
|
"Replace history item specified by its position with *line*. The position is "
|
|
"zero-based. This calls :c:func:`replace_history_entry` in the underlying "
|
|
"library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:166
|
|
msgid ""
|
|
"Append *line* to the history buffer, as if it was the last line typed. This "
|
|
"calls :c:func:`add_history` in the underlying library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:172
|
|
msgid ""
|
|
"Enable or disable automatic calls to :c:func:`add_history` when reading "
|
|
"input via readline. The *enabled* argument should be a Boolean value that "
|
|
"when true, enables auto history, and that when false, disables auto history."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:185
|
|
msgid "Startup hooks"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:190
|
|
msgid ""
|
|
"Set or remove the function invoked by the :c:data:`rl_startup_hook` callback "
|
|
"of the underlying library. If *function* is specified, it will be used as "
|
|
"the new hook function; if omitted or ``None``, any function already "
|
|
"installed is removed. The hook is called with no arguments just before "
|
|
"readline prints the first prompt."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:199
|
|
msgid ""
|
|
"Set or remove the function invoked by the :c:data:`rl_pre_input_hook` "
|
|
"callback of the underlying library. If *function* is specified, it will be "
|
|
"used as the new hook function; if omitted or ``None``, any function already "
|
|
"installed is removed. The hook is called with no arguments after the first "
|
|
"prompt has been printed and just before readline starts reading input "
|
|
"characters. This function only exists if Python was compiled for a version "
|
|
"of the library that supports it."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:209
|
|
msgid "Completion"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:211
|
|
msgid ""
|
|
"The following functions relate to implementing a custom word completion "
|
|
"function. This is typically operated by the Tab key, and can suggest and "
|
|
"automatically complete a word being typed. By default, Readline is set up "
|
|
"to be used by :mod:`rlcompleter` to complete Python identifiers for the "
|
|
"interactive interpreter. If the :mod:`readline` module is to be used with a "
|
|
"custom completer, a different set of word delimiters should be set."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:221
|
|
msgid ""
|
|
"Set or remove the completer function. If *function* is specified, it will "
|
|
"be used as the new completer function; if omitted or ``None``, any completer "
|
|
"function already installed is removed. The completer function is called as "
|
|
"``function(text, state)``, for *state* in ``0``, ``1``, ``2``, ..., until it "
|
|
"returns a non-string value. It should return the next possible completion "
|
|
"starting with *text*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:228
|
|
msgid ""
|
|
"The installed completer function is invoked by the *entry_func* callback "
|
|
"passed to :c:func:`rl_completion_matches` in the underlying library. The "
|
|
"*text* string comes from the first parameter to the :c:data:"
|
|
"`rl_attempted_completion_function` callback of the underlying library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:237
|
|
msgid ""
|
|
"Get the completer function, or ``None`` if no completer function has been "
|
|
"set."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:242
|
|
msgid ""
|
|
"Get the type of completion being attempted. This returns the :c:data:"
|
|
"`rl_completion_type` variable in the underlying library as an integer."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:250
|
|
msgid ""
|
|
"Get the beginning or ending index of the completion scope. These indexes are "
|
|
"the *start* and *end* arguments passed to the :c:data:"
|
|
"`rl_attempted_completion_function` callback of the underlying library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:259
|
|
msgid ""
|
|
"Set or get the word delimiters for completion. These determine the start of "
|
|
"the word to be considered for completion (the completion scope). These "
|
|
"functions access the :c:data:`rl_completer_word_break_characters` variable "
|
|
"in the underlying library."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:267
|
|
msgid ""
|
|
"Set or remove the completion display function. If *function* is specified, "
|
|
"it will be used as the new completion display function; if omitted or "
|
|
"``None``, any completion display function already installed is removed. "
|
|
"This sets or clears the :c:data:`rl_completion_display_matches_hook` "
|
|
"callback in the underlying library. The completion display function is "
|
|
"called as ``function(substitution, [matches], longest_match_length)`` once "
|
|
"each time matches need to be displayed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:280
|
|
msgid "Example"
|
|
msgstr "Exemple"
|
|
|
|
#: ../Doc/library/readline.rst:282
|
|
msgid ""
|
|
"The following example demonstrates how to use the :mod:`readline` module's "
|
|
"history reading and writing functions to automatically load and save a "
|
|
"history file named :file:`.python_history` from the user's home directory. "
|
|
"The code below would normally be executed automatically during interactive "
|
|
"sessions from the user's :envvar:`PYTHONSTARTUP` file. ::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:302
|
|
msgid ""
|
|
"This code is actually automatically run when Python is run in :ref:"
|
|
"`interactive mode <tut-interactive>` (see :ref:`rlcompleter-config`)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:305
|
|
msgid ""
|
|
"The following example achieves the same goal but supports concurrent "
|
|
"interactive sessions, by only appending the new history. ::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:326
|
|
msgid ""
|
|
"The following example extends the :class:`code.InteractiveConsole` class to "
|
|
"support history save/restore. ::"
|
|
msgstr ""
|