jeremy/callisto
1
Fork 0
Code Releases Activity

csto(1): use semantic newlines

Browse source 
See the "Use semantic newlines" section of man-pages(7)
on a Linux system for reasoning behind this.
This commit is contained in:
Jeremy Baxter 2024-04-02 20:20:22 +13:00
parent 50b6fa6cec
commit 03d321f4f1
1 changed files with 23 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

38
man/man1/csto.1
View file

@ -15,15 +15,20 @@
.Ek .Ek
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
is an interpreter for the Lua programming language, using the Callisto is an interpreter for the Lua programming language,
libraries. Callisto provides Lua libraries for operating systems following using the Callisto libraries.
the POSIX standard. These allow Lua programs to manipulate the file system, Callisto provides Lua libraries for operating systems
send signals to processes, parse command line arguments, following the POSIX standard.
These allow Lua programs to
manipulate the file system,
send signals to processes,
parse command line arguments,
and use other OS functionality not available to a regular Lua interpreter. and use other OS functionality not available to a regular Lua interpreter.
.Pp .Pp
All of these libraries are conveniently bundled directly into All of these libraries are conveniently bundled directly into
.Nm .Nm
and do not depend on any external libraries or files, unless your copy of and do not depend on any external libraries or files,
unless your copy of
.Nm .Nm
was built with support for was built with support for
.Lb libreadline . .Lb libreadline .
@ -33,8 +38,9 @@ For up-to-date information concerning Callisto, visit
in a web browser. in a web browser.
.Pp .Pp
.Nm .Nm
executes Lua programs in source form or in bytecode form. Lua programs in executes Lua programs in source form or in bytecode form.
source form can be compiled to bytecode form through the program Lua programs in source form can be compiled to bytecode form
through the program
.Xr luac 1 , .Xr luac 1 ,
included with the standard Lua distribution. included with the standard Lua distribution.
.Pp .Pp
@ -98,12 +104,14 @@ in that order. When
.Ev LUA_INIT_5_4 .Ev LUA_INIT_5_4
is set, is set,
.Ev LUA_INIT .Ev LUA_INIT
is ignored. If the contents are of the form is ignored.
If the contents are of the form
.Dq @filename , .Dq @filename ,
then the contents of the file then the contents of the file
.Em filename .Em filename
is executed as Lua code. Otherwise, the contents are assumed to be a Lua is executed as Lua code.
statement and is executed as Lua code. Otherwise, the contents are assumed to be a Lua statement
and is executed as Lua code.
.It Ev LUA_PATH , Ev LUA_PATH_5_4 .It Ev LUA_PATH , Ev LUA_PATH_5_4
Initial value of Initial value of
.Em package.path , .Em package.path ,
@ -121,12 +129,12 @@ to search for C loaders.
.An Jeremy Baxter Aq Mt jtbx@disroot.org .An Jeremy Baxter Aq Mt jtbx@disroot.org
authored and maintains the Callisto libraries. authored and maintains the Callisto libraries.
.Pp .Pp
R. Ierusalimschy, L. H. de Figueiredo, and W. Celes authored the Lua R. Ierusalimschy, L. H. de Figueiredo, and W. Celes
programming language and its standard libraries. authored the Lua programming language and its standard libraries.
.Sh BUGS .Sh BUGS
Known bugs can be found at the bug tracker Known bugs can be found at the bug tracker found at
.Lk https://todo.sr.ht/~jeremy/callisto . .Lk https://todo.sr.ht/~jeremy/callisto .
.Pp .Pp
If you have discovered a bug in Callisto, please report it to the bug If you have discovered a bug in Callisto,
tracker or send an email to please report it to the bug tracker or send an email to
.Aq Mt ~jeremy/callisto@todo.sr.ht . .Aq Mt ~jeremy/callisto@todo.sr.ht .