summaryrefslogtreecommitdiff
path: root/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
commite792aa98d868891ca36e4f9501ec4a9345d56ea5 (patch)
tree0b4e27d85f5174b2ae17d16737d0ce97044044ba /docs/dev
parent51b730d56f1deaf035aff5b83fdd8a0cf376764c (diff)
downloaddocutils-e792aa98d868891ca36e4f9501ec4a9345d56ea5.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/docutils@9043 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docs/dev')
-rw-r--r--docs/dev/todo.txt10
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/dev/todo.txt b/docs/dev/todo.txt
index 5f175d2fe..eda93a41e 100644
--- a/docs/dev/todo.txt
+++ b/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