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