Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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
       standard
	     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 library
		 Link 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 en-
		 vironmental
			     variable ``BOX_LIBRARY_PATH''.

       -I path	 Add an	additional path	to be considered when searching	for
			     the file included with ``include  "file"''.  This
		 option	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
		 precise 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.source-
       forge.net.
	     Permission	is granted to copy, distribute and/or modify this doc-
       ument
	     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://www.freebsd.org/cgi/man.cgi?query=box&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help