Content-type: text/html Manpage of XBC

XBC

Section: X11-Basic Compiler Manager (1)
Updated: 21-Aug-2015
Index Return to Main Contents
 

NAME

xbc - X11-Basic compiler manager  

SYNOPSIS

xbc [ option ] <filename>

 

DESCRIPTION

X11-Basic is a dialect of the BASIC programming language with graphics capability that integrates features like shell scripting, cgi-Programming and full graphical visualisation into the easy to learn basic language on modern computers.

xbc can be used to make stand-alone-binaries out of *.bas script files.

For a desciption of the X11-Basic language and usage of the interpreter see xbasic(1).

 

Filenames

Xbc process input files through one or more of three stages: preprocessing, compilation, translation and linking. Source filename suffixes identify the source language.

Suffixes of source file names indicate the kind of processing to be done:


.bas   Basic source; preprocess, compile, link
.b     bytecode file; translate to C, then compile to native code
.o     Object file; link

Linking is always the last stage unless you use one of the -c , -b or -l options to avoid it (or unless compilation errors stop the whole process).  

OPTIONS

-b
Precompile the source files, but do not compile nor link it. The compiler output is a *.c file corresponding to the source file. These *.c files can be compiled with e.g. the GNU project C Compiler.

By default, xbc makes the *.c file name for a source file by replacing the suffix `.bas
 with .o'. Use -o to select another name.

-c
Precompile and compile the source files, but do not link. The compiler output is an object file corresponding to each source file.

By default, xbc makes the object file name for a source file by replacing the suffix `.bas
 with `.o'. Use -o to select another name.

-l
Precompile and compile the source files, but do not link. The compiler output is an object file corresponding to each source file. The source files are compiled in a way that they can (and will have to) be linked to other object files. With these object files it is possible to create a library from your basic routines, which can be executed from another program.

By default, xbc makes the object file name for a source file by replacing the suffix `.bas
 with `.o'. Use -o to select another name.

-o file
Place output in file file. This applies regardless to whatever sort of output xbc is producing, whether it be an executable file, a *.c file or an object file.

Since only one output file can be specified, it does not make sense to use `-o' when compiling more than one input file, unless you are producing an executable file as output.

If you do not specify `-o', the default is to put an executable file in `b.out', the object file for `source.suffix' in `source.o', and its *.c file in `source.c

 

-virtualm

 

--virtualm

this option tells the compiler to compile the code to bytecode and then translate it to C source and finally compile it with gcc. The code produced is really fast. On UNIX this option can always be used unless some compiler trouble occur.  

--static

this is the default. The X11-Basic library will be linked to the excecutable.  

--dynamic

The excecutable will be linked dynamically against the X11-Basic library.  

-shared

This option is passed to the linker and tells it, that it should produce a shared object file which can then be linked with other objects to form an executable. Not all systems support this option. Usually the extention should be .so
 This option only makes sense if it was used together with the -l
 option.

 

-C

Do not discard comments. All comments are passed through to the output file.

 

-s --strip

Remove all symbol table and relocation information from the executable.

 

-L path

Use path when looking for libraries to link (default is /usr/lib).

 

--version

shows version, program and other information and exits  

-h --help

print a short help

For detailed help and description of the implemented basic commands take a look at the README file.

 

EXAMPLES

xbc testme.bas
 produces an excecutable file b.out
xbc testme.bas -o testme --dynamic
 produces an excecutable file testme
xbc testme.bas -c 
 produces testme.o
xbc testme.bas -b
 produces testme.c or 11.c or b.b
xbc testme.bas -virtualm --dynamic -o b.out
 produces b.out, which excecutes really fast!

You can find many sample programs in /usr/share/doc/packages/X11Basic/examples.

 

The Compiler Manager

Actually xbc is a real compiler, if used with the -virtualm option. However, the default behaviour is such, that the source code is still interpreted on runtime. But the source code is linked to the X11-Basic library so there results one independant executable. Another advantage is that it is quite hard to extract a full running *.bas file from this binary since the code is compressd in a way.

Why is this the default? Well the compiler can pseudo-compile all BASIC programs, which run in the interpreter. The real compiler has some restrictions on the BASIC code, because it cannot compile every constructs (e.g. jumps/GOTO out of a procedure).

 

VERSION

Page was created for V.1.24

 

BUG REPORTS

If you find a bug in the X11-Basic compiler xbc, you should report it. But first, you should make sure that it really is a bug, and that it appears in the latest version of the X11-Basic package that you have.

Once you have determined that a bug actually exists, mail a bug report to kollo@users.sourceforge.net. If you have a fix, you are welcome to mail that as well! Suggestions may be mailed to the bug tracking system.

Comments and bug reports concerning this manual page should be directed to kollo@users.sourceforge.net.

 

AUTHOR

Markus Hoffmann <kollo@users.sourceforge.net>

 

COPYRIGHT

Copyright (C) 1997-2016 Markus Hoffmann <kollo@users.sourceforge.net>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

 

SEE ALSO

xbasic(1), gcc(1), ld(1), xbbc(1), xb2c(1), xbvm(1)


 

Index

NAME
SYNOPSIS
DESCRIPTION
Filenames
OPTIONS
-virtualm
--virtualm
--static
--dynamic
-shared
-C
-s --strip
-L path
--version
-h --help
EXAMPLES
The Compiler Manager
VERSION
BUG REPORTS
AUTHOR
COPYRIGHT
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 08:51:50 GMT, April 19, 2016