aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 7736718bc3c3e11b8f4e8b835a0ca9ff585d1c45 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
`repl.c` creates a read-eval-print loop out of any command.  It is
a simple and readable C program that requires GNU readline.

### Installation

The following commands install `repl` in `/usr/local/bin` and
`repl.1`, its man page, in `/usr/local/man`:

    $ make
    $ make install

If you want to install it somewhere different from `/usr/local`,
edit the Makefile and modify the `PREFIX` variable.

To uninstall both binary and man page, run `make uninstall`.

***

REPL(1) - General Commands Manual

### NAME

**repl** - create a REPL out of any command

### SYNPOSIS

**repl**
*command*

### DESCRIPTION

When invoked, the
**repl**
utility puts the user in a read-eval-print loop, in which it reads
input from the user, appends it to the
*command*
provided by the single argument, and lets the shell evaluate the
full string.

Built on GNU readline, it supports history and Emacs key bindings.

**repl**
is useful for command-line interfaces built on a
"prefix command"
that has to be typed over and over preceding the actual command, like
git(1).

### EXAMPLES

	$ repl git
	git > status
	On branch master
	Your branch is up to date with 'origin/master'.
	git >

### AUTHORS

**repl**
is written by
John Ankarström,
available {on the web|by e-mail} at john{.|@}ankarstrom.se.

OpenBSD 6.4 - January 10, 2019