Commit 7a17d37e authored by kollo's avatar kollo

adaptions to global README and x11basic-ideas

parent 8d44da6d
......@@ -24,9 +24,7 @@ Summary : A Basic interpreter and compiler with graphics capabilities
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.
capability.
The structure of the language is similar to the ATARI-ST GFA-BASIC.
......@@ -45,14 +43,14 @@ Description :
with the bas2x11basic program (see the man page bas2x11basic(1) ).
You will find the compiler sourcecode and some other sample programs in
/usr/share/doc/packages/X11Basic/examples. A variety of other sample programs
can be found in an X11-Basic examples repository on gitlab
(https://gitlab.com/kollo/X11-Basic_examples/tree/master) or in a package
X11-Basic-examples-1.24.zip, which you can download from the homepage
/usr/share/doc/packages/X11Basic/examples. However, a much bigger variety of
other sample programs can be found in an X11-Basic examples repository on
gitlab (https://gitlab.com/kollo/X11-Basic_examples/tree/master) or in a
package X11-Basic-examples-1.24.zip, which you can download from the homepage
(http://x11-basic.sourceforge.net/). Also an up-to-date pdf-version of the
manual can be found there.
Please read the file ./doc/X11-Basic-manual.txt for further information.
Please read the file X11-Basic-manual.txt for further information.
X11BASIC is free software and comes with NO WARRANTY - read the file
COPYING for details
......@@ -61,75 +59,120 @@ Description :
incorporate it into non-free software, no warranty of any sort, don't blame me
if it doesn't work.)
Please read the file INSTALL for compiling instructions.
Please read the file INSTALL for compiling instructions.
ADDITIONAL CONFIGURATION OPTIONS
================================
Standard Installation
=====================
After generating the Makefile, look at the file `options.h' (sparsely
commented) and see if there is anything you want to change. The only option
that you might need to change is GERMAN, which should be defined if you
like to have a german version of X11-Basic. The default language is English.
Starting from the src/ directory you should do a
./configure
make
COMPILING a standalone excecutable
==================================
And for a system wide installation
To compile the X11-Basic interpreter (called xbasic), simply type
sudo make install
To remove the installation a
sudo make uninstall
will do.
For further details of the installation process and different install options
please read the file INSTALL.
ADDITIONAL CONFIGURATION OPTIONS
================================
(only if you have special needs or if the standard installation fails)
1. Language
-----------
After generating (with ./configure) the Makefile, look at the file
`options.h' (sparsely commented) and see if there is anything you want to
change. The only option that you might need to change is GERMAN, which
should be defined if you like to have a german version of X11-Basic.
The default language is English.
2. standalone excecutables (statically linked)
----------------------------------------------
a) the interpreter
To compile the X11-Basic interpreter (called xbasic), simply type
make static
at the shell prompt. The produced file is independant of the x11basic
library and does not need the x11basic framework to be installed.
at the shell prompt. The produced file is independant of the x11basic
library and does not need the x11basic framework to be installed.
After X11Basic has been compiled and linked successfully, you can start it
by typing
After X11Basic has been compiled and linked successfully, you can start it
by typing
./xbasic.static
The command-line options can be listed with the `-h' option (`./xbasic -h').
The command-line options can be listed with the `-h' option (`./xbasic -h').
INSTALLING the standalone excecutable:
Put the executable wherever you like. I have mine in ${HOME}/bin/.
b) compiler and libraries
If you want to use the compilers, you have to make both the static and dynamic
libraries.
cd ./src
make lib will generate libx11basic.so
make x11basic.a will generate x11basic.a
-- now you have to be root to install the libraries at a place where the
compiler can use them --
mv libx11basic.so /usr/lib/
mv x11basic.a /usr/lib/
-- please also check the permissions of the files:
chmod 755 /usr/lib/x11basic.a
chmod 755 /usr/lib/libx11basic.so
rehash
make xbbc.static xbvm.static xb2c.static xbc
will produce the statically linkd versions of the compilers.
3. The framebuffer version
It is possible to compile a version of X11-Basic and its libraries, which
does not need the X.org framework, but instead uses the systems framebuffer
and direct mouse device for graphics in and output. This might be useful on
e.g. the Raspberry Pi or for other handheld devices with low resources.
make clean fb
INSTALLING the standalone excecutable
=====================================
will produce the framebuffer version of the interpreter called
xbasic.framebuffer
Put the executable wherever you like. I have mine in ${HOME}/bin/.
4. Crosscompiling for other platforms
A system wide installation can be done with
sudo make install
remove the installation with
sudo make uninstall
a) ATARI ST (with m68k-atari-mint)
make tos
make the compiler work, libraries:
===================================
b) TomTom (with the ARM linux toolchain)
If you want to use the compilers included in this package, you have to
make both the static and dynamic libraries.
make TomTom
cd ./src
make lib will generate libx11basic.so
make x11basic.a will generate x11basic.a
c) MS WINDOWS (with i586-mingw32msvc-gcc)
-- now you have to be root --
make windows
mv libx11basic.so /usr/lib/
mv x11basic.a /usr/lib/
-- please also check the permissions of the files:
chmod 755 /usr/lib/x11basic.a
chmod 755 /usr/lib/libx11basic.so
rehash
For details you may want to look into the Makefile. Improvements are welcome.
make installroot
will generate a dynamic linked binary of the interpreter,
copy it to /bin/, install the libraries in /usr/local/lib/,
install the man-page
-----------------------------
make xbc
will make the X11-basic compiler
You can then (beeing root) do a
make xbcinstall
to install the compiler in /usr/local/bin/ and the compiler
man-page
regards and have fun
best regards and have fun
Markus Hoffmann
......@@ -8,7 +8,7 @@ Systemvariablen:
DATAPOINTER oder _DATA mit Restoremoeglichkeit
ISDIR(d$) --> STAT ?
ISDIR(d$) --> STAT ? --> geht mit user-funktion...
-------------SDL Graphics -------------------
......@@ -32,11 +32,11 @@ ISDIR(d$) --> STAT ?
-------encryption---------------
LIBGCRYPT:
hash$=HASH$(data$[,typ%])
sdata$=SIGN$(data$,privkey$)
verify%=VERIFY$(sdata$,pubkey$)
cdata$=ENCRYPT$(data$,key$[,typ%])
data$=DECRYPT$(cdata$,key$[,typ%])
hash$=HASH$(data$[,typ%]) (ok)
sdata$=SIGN$(data$,privkey$) (ok)
verify%=VERIFY$(sdata$,pubkey$) (ok)
cdata$=ENCRYPT$(data$,key$[,typ%]) (ok)
data$=DECRYPT$(cdata$,key$[,typ%]) (ok)
err=KEYGEN(typ%,pubkey$,privkey$)
......@@ -46,4 +46,8 @@ LIBGCRYPT:
--------incompatible aenderungen:---------------------
* xbasic und xbasic.exe umbenennen in x11basic und x11basic.exe
(vielleicht mit einem link von xbasic)
oder:
x11basic als wrapper script:
xbbc -o /tmp/$1.b $1
xbasic /tmp/$1.b
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment