.\"Text automatically generated by txt2man
.TH th 1 "25 August 2016" "" ""
.SH NAME
\fBth \fP- Read,Eval,Print-Loop for Torch Framework
.SH SYNOPSIS
.nf
.fam C
\fBth\fP [\fIoptions\fP] [script.lua [\fIarguments\fP]]
.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
A pure Lua REPL (Read,Eval,Print-Loop) for LuaJIT, with heavy
support for Torch types. It uses Readline for tab completion.
.
This package also installs command line frontend `\fBth\fP`, which
comes packed with all these features:
.
.RS
.IP \(bu 3
Tab-completion on nested namespaces
.IP \(bu 3
Tab-completion on disk files (when opening a string)
.IP \(bu 3
History
.IP \(bu 3
Pretty print (table introspection and coloring)
.IP \(bu 3
Auto-print after eval (can be stopped with ;)
.IP \(bu 3
Each command is profiled, timing is reported
.IP \(bu 3
No need for '=' to print
.IP \(bu 3
Easy help with: `? funcname`
.IP \(bu 3
Self help: `?`
.IP \(bu 3
Shell commands with: $ cmd (example: `$ ls`)
.IP \(bu 3
Print all user globals with `who()`
.IP \(bu 3
Import a package's symbols globally with `import(package)`
.IP \(bu 3
Require is overloaded to provide relative search paths:
`require('./mylocallib/')`
.IP \(bu 3
[Optional] strict global namespace monitoring
.IP \(bu 3
[Optional] async repl
.SH OPTIONS
.TP
.B
\fB-l\fP name
load library name
.TP
.B
\fB-e\fP statement
execute statement
.TP
.B
\fB-h\fP,\fB--help\fP
print this help
.TP
.B
\fB-a\fP,\fB--async\fP
preload async (libuv) and start async repl (BETA)
.TP
.B
\fB-g\fP,\fB--globals\fP
monitor global variables (print a warning on creation/access)
.TP
.B
\fB-gg\fP,\fB--gglobals\fP
monitor global variables (throw an error on creation/access)
.TP
.B
\fB-x\fP,\fB--gfx\fP
start gfx server and load gfx env
.TP
.B
\fB-i\fP,\fB--interactive\fP
enter the REPL after executing a script 
.SH HOMEPAGE
http://torch.ch/