1.3 Invoking poke

Synopsis:

poke [option…] [file]

The following options are available.

‘-l’

‘--load=file’

Load the given file as a Poke program. Any number of ‘-l’ options can be specified, and they are loaded in the given order.

‘-L file’

Load the given file as a Poke program and exit. The rest of the command-line is not processed by poke, and is available to the Poke script in the argv variable. This is commonly used along with a shebang (see Scripts) to implement Poke scripts.

Commanding poke from the command line:

‘-c’

‘--command=cmd’

Execute the given command. Any number of ‘-c’ options can be specified, and they are executed in the given order.

‘-s’

‘--source=file’

Load file as a command file. Any number of ‘-s’ options may be specified, and they are loaded in the given order. See Command Files.

Styling text output:

‘--color=how’ ¶

Whether to use styled output, and how. Valid options for how are ‘yes’, ‘no’, ‘auto’, ‘html’ and ‘test’.

‘--style-dark’

Use the default style that works better for dark backgrounds. This is the default.

‘--style-bright’

Use the default style that works better for bright backgrounds.

‘--style=file’

Use file as the CSS to use for styling poke, instead of the default style.

Other options:

-q

--no-init-file

Do not load the ~/.pokerc init file.

--no-auto-map

Do not load map-files automatically when poke opens IO spaces.

--no-hserver

Do not run the terminal hyperlinks server.

--quiet

Be as terse as possible.

--help

Print a help message and exit.

--version

Show version and exit.

The following environment variables, if set, are used by poke:

POKE_LOAD_PATH

List of file paths separated by the colon characters (:) which is prepended to the load_path when poke starts.