These are the frequently asked questions about the boxes program and their answers.
These questions are actually “frequently asked”. For general information on the boxes program, installation instructions, and information on box design creation please refer to the boxes documentation.
There is a separate page explaining this. Boxes is mostly used as such a filter program.
Upgrade to version 1.0.1 or later. Versions prior to 1.0.1 gave this error message when the config file they were trying to read was in fact a directory. The global config file name is /usr/share/boxes on most systems. This is the name of the file, not the name of a directory into which a config file would be placed.
By default, all tab characters are replaced by spaces. However, you can change this behavior using the
(since version 1.1). The
-t option only affects leading tabs. Tabs which end up inside the box are always converted
Note that you can also set the tab stop distance (== how many spaces per tab) using the
On Windows, this error message may appear instead of a box when boxes is called from vim. This is not a problem of boxes. In fact, it’s a misleading message from the vim editor which is supposed to tell you that boxes is not in your PATH. Solution: Copy boxes.exe and boxes.cfg to a directory which is in your PATH. (thanks Jeff Lanzarotta, 05-Jul-00)
Detailed information on how to build boxes from source is collected on the build page.
In addition to that, the following issues have occurred:
Warnings from flex or bison:
If you get warnings from flex or bison, do a
make clean ; makefrom the top level directory. The following warning is harmless:
lexer.l:1309: warning: `yy_flex_realloc' defined but not used
It’s a known bug in flex, and has no impact on boxes. You can safely ignore this warning. Recent versions of flex no longer produce this warning, so today, you probably won’t see it anymore.
Bad addresson boxes execution after compiling on a 64bit system: This may happen when the system you are compiling on is 64bit. Boxes is only a 32bit program, so the compiler may have to be forced to 32bit by adding the
-m32option. (Thanks to @stefanow for supplying this information!) In order to do this, use the following command line (works with current sources):
make CFLAGS_ADDTL=-m32 LDFLAGS_ADDTL=-m32
Since v2.0.0, boxes supports different character encodings for input/output text. The config file, however, is
still ASCII (we are working on that). boxes normally picks up your system encoding, which on most systems, is simply
UTF-8. You can override this behavior with
-n. boxes shows what it thinks is the system encoding when you call
boxes -h - the displayed default value for
-n is the system encoding.