summaryrefslogtreecommitdiff
path: root/docutils/docs/dev
diff options
context:
space:
mode:
authormilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2022-03-11 12:09:16 +0000
committermilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2022-03-11 12:09:16 +0000
commitf9e0d2338d3cf40aa3387ba08459ce20471b1722 (patch)
tree546eeaaa3b28c11f3b86d71791684d7896bdd6de /docutils/docs/dev
parent3344cedf7a3b1ced38dc71aceb0f388c561a4cb7 (diff)
downloaddocutils-f9e0d2338d3cf40aa3387ba08459ce20471b1722.tar.gz
core.Publisher.publish(): Prompt when waiting for input from a terminal.
When front-end tools are used without arguments, Docutils reads from stdin. Currently, when a user calls a front-end without arguments, there is no response until the user presses Ctrl-D (Ctrl-Z on Windows) or aborts with Ctrl-C. This commit changes the behaviour to tell the user what the front-end expects and where to get more help. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@9043 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docutils/docs/dev')
-rw-r--r--docutils/docs/dev/todo.txt10
1 files changed, 10 insertions, 0 deletions
diff --git a/docutils/docs/dev/todo.txt b/docutils/docs/dev/todo.txt
index 5f175d2fe..eda93a41e 100644
--- a/docutils/docs/dev/todo.txt
+++ b/docutils/docs/dev/todo.txt
@@ -2866,6 +2866,16 @@ Front-End Tools
directive should override the ``--no-section-numbering`` command
line option then.
+* Implement the following suggestions from clig.dev?
+
+ Display output on success, but keep it brief.
+ provide a --quiet option to suppress all non-essential output.
+
+ Consider chaining several args as input and use --output
+ (or redirection) for output.
+
+ -- https://clig.dev/#help
+
.. _partial parsing:
https://docs.python.org/3/library/argparse.html#partial-parsing