blob: 6cdd83d316366c6960ef5dce7dd56b92e180119e [file] [log] [blame]
Samuel Dionne-Riele69e1f12022-08-18 15:44:04 -04001.. SPDX-License-Identifier: GPL-2.0-or-later:
2
Heinrich Schuchardt1b0c3162024-01-14 14:53:13 +01003.. index::
4 single: pause (command)
5
Samuel Dionne-Riele69e1f12022-08-18 15:44:04 -04006pause command
7=============
8
9Synopsis
10--------
11
12::
13
14 pause [prompt]
15
16
17Description
18-----------
19
20The pause command delays execution waiting for any user input.
21
22It can accept a single parameter to change the prompt message.
23
24Examples
25--------
26
27Using with the default prompt:
28
29::
30
31 => pause
32 Press any key to continue...
33
34
35Using with a custom prompt:
36
37::
38
39 => pause 'Prompt for pause...'
40 Prompt for pause...
41
42Note that complex prompts require proper quoting:
43
44::
45
46 => pause Prompt for pause...
47 pause - delay until user input
48
49 Usage:
50 pause [prompt] - Wait until users presses any key. [prompt] can be used to customize the message.
51
52Return value
53------------
54
55The return value $? is always set to 0 (true), unless invoked in an invalid
56manner.