BOX(1) General Commands Manual BOX(1)
fnch@users.sourceforge.net
Matteo Franchin 2003Matteo FranchinJuly 22, 2008;
NAME
box -- A language to create figures and graphics.
SYNOPSIS
box [-l library ] {-st | source.box }
This is the typical minimal syntax; see below for a list
and explanation of the other options.
DESCRIPTION
box compiles a box source file
(to bytecode) and executes it. It can read the source from the stan-
dard
input (with -st) or from the specified file.
OPTIONS
A summary of options is included below:
-h Show summary of options.
-st | source.box
The user MUST provide either a source file or the option
-st. In the latter case the source is read
from the standard input.
-l libraryLink against the provided C library, before trying to execute
the compiled code. When specifying ``-l g'',
the library ``libg.so'' (or ``libg.dylib'') is
searched, instead.
-L path Add an additional path to be considered when searching for
the libraries specified with the -l option.
The option can be used more than once to specify more
than one
path. The last occurrence has the precedence on the
formers and
has precedence on the paths specified in the environ-
mental
variable ``BOX_LIBRARY_PATH''.
-I path Add an additional path to be considered when searching for
the file included with ``include "file"''. This op-
tion can be used
more than once to specity more than one path. The
last occurrence
has the precedence on the formers and on the paths
specified with
the ``BOX_INCLUDE_PATH'' environmental variable.
When using ``include "file"'' in your programs, the
files
``file.bxh`` and ``file`` are searched (in this pre-
cise order).
-o outfile, -w outfile
Write to outfile a human readable
representation of the bytecode produced from the
given box
source (useful for debugging). Use -w if you want
to overwrite existing files, otherwise use -o.
-se setupfile
Include automatically the file
setupfile before processing any
other line of source.
-t Compile only. The compiled code will not be linked
and executed.
-f Force execution, even when warning messages
were displayed.
-v Verbose message reports.
-e Only error messages are reported (no warnings).
-si Make the Box compiler totally silent.
ENVIRONMENT
These are the environmental variables used by Box:
BOX_LIBRARY_PATH
Add additional search paths for Box libraries.
The format is the same as the shell's $PATH: one or
more directory
pathnames separated by colons. See option -L.
BOX_INCLUDE_PATH
Add additional search paths for Box header files.
The format is the same as the shell's $PATH: one or
more directory
pathnames separated by colons. See option -I.
BOX_DEFAULT_LIBS
A list of libraries which should be always used for linking.
The format is the same as the shell's $PATH: one or
more library
names separated by colons.
SEE ALSO
More documentation, with a description of the Box language
and its graphic library, can be found on the web:
http://boxc.sourceforge.net
AUTHOR
This manual page was written by Matteo Franchin fnch@users.sourceforge.net.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License, Version 2 any
later version published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public
License can be found in /usr/share/common-licenses/GPL.
BOX(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | SEE ALSO | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=box&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>