summaryrefslogtreecommitdiffstats
path: root/README.rst
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2022-12-02 09:11:15 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2022-12-02 09:11:15 +0000
commit50dfafe3a01b634bfa80101fc199d3d451ff7d0f (patch)
tree944855d93ab99895019c54e66eba596c4a9e33ad /README.rst
parentAdding upstream version 3.0.20. (diff)
downloadptpython-50dfafe3a01b634bfa80101fc199d3d451ff7d0f.tar.xz
ptpython-50dfafe3a01b634bfa80101fc199d3d451ff7d0f.zip
Adding upstream version 3.0.21.upstream/3.0.21
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'README.rst')
-rw-r--r--README.rst41
1 files changed, 40 insertions, 1 deletions
diff --git a/README.rst b/README.rst
index ae12f4d..15464ba 100644
--- a/README.rst
+++ b/README.rst
@@ -50,6 +50,40 @@ Features
[2] If the terminal supports it (most terminals do), this allows pasting
without going into paste mode. It will keep the indentation.
+Command Line Options
+********************
+
+The help menu shows basic command-line options.
+
+::
+
+ $ ptpython --help
+ usage: ptpython [-h] [--vi] [-i] [--light-bg] [--dark-bg] [--config-file CONFIG_FILE]
+ [--history-file HISTORY_FILE] [-V]
+ [args ...]
+
+ ptpython: Interactive Python shell.
+
+ positional arguments:
+ args Script and arguments
+
+ optional arguments:
+ -h, --help show this help message and exit
+ --vi Enable Vi key bindings
+ -i, --interactive Start interactive shell after executing this file.
+ --light-bg Run on a light background (use dark colors for text).
+ --dark-bg Run on a dark background (use light colors for text).
+ --config-file CONFIG_FILE
+ Location of configuration file.
+ --history-file HISTORY_FILE
+ Location of history file.
+ -V, --version show program's version number and exit
+
+ environment variables:
+ PTPYTHON_CONFIG_HOME: a configuration directory to use
+ PYTHONSTARTUP: file executed on interactive startup (no default)
+
+
__pt_repr__: A nicer repr with colors
*************************************
@@ -109,6 +143,8 @@ like this:
else:
sys.exit(embed(globals(), locals()))
+Note config file support currently only works when invoking `ptpython` directly.
+That it, the config file will be ignored when embedding ptpython in an application.
Multiline editing
*****************
@@ -159,6 +195,9 @@ is looked for.
Have a look at this example to see what is possible:
`config.py <https://github.com/jonathanslenders/ptpython/blob/master/examples/ptpython_config/config.py>`_
+Note config file support currently only works when invoking `ptpython` directly.
+That it, the config file will be ignored when embedding ptpython in an application.
+
IPython support
***************
@@ -211,7 +250,7 @@ FAQ
**Q**: The ``Meta``-key doesn't work.
-**A**: For some terminals you have to enable the Alt-key to act as meta key, but you
+**A**: For some terminals you have to enable the Alt-key to act as meta key, but you
can also type ``Escape`` before any key instead.