Menu
▾
▴
Tree [b84aab] master 0_11_5 / documentation / History
Read Me
SmallBASIC
http://smallbasic.sourceforge.net
README.DEV --- Information for developers
README.PALM --- Notes for PalmOS
README.UNIX --- Notes for Unices
README.W32 --- Notes for Win32
LICENSE --- GNU GENERAL PUBLIC LICENSE
-----------------------------------------------------------------------
Unix version requirements
-----------------------------------------------------------------------
gcc 2.x.x
Graphics:
---------
kernel 2.4.x framebuffer device (/dev/fb0 must exists)
OR
SVGALib 1.9.6 (www.svgalib.org)
OR
SDL library (SDL works under X or framebuffer) (www.libsdl.org)
Sound:
------
OSS compatible card/driver (/dev/dsp must exists)
Mice:
-----
Mouse is supported on SDL and SVGALIB drivers
-----------------------------------------------------------------------
PalmOS version requirements
-----------------------------------------------------------------------
pilrc version 2.7+
MathLib.prc version 1.1+
A Palm with PalmOS 3.1 or newer
Recommended: PalmOS 3.3 with 4MB RAM
For developers:
prc-tools version 2.0.90-1 (GNU)
PalmOS v3.5 SDK
-----------------------------------------------------------------------
DOS version requirements
-----------------------------------------------------------------------
MSDOS 5.0+ with DJGPP memory manager (www.delorie.com)
For developers:
Linux PC, with msdos-djgpp cross compiler
-----------------------------------------------------------------------
Win32 version requirements
-----------------------------------------------------------------------
Windows 9x/ME or NT
Sound Card
For developers:
GUI version: Borland C++ Builder 6+
console version: Linux PC, with mingw32 cross compiler
-----------------------------------------------------------------------
Easy installation for Unix: Default configuration
-----------------------------------------------------------------------
Driver: framebuffer (graphics), OSS sound, no-mouse
Go to sync/ directory and type the following commands
make fb
make install
-----------------------------------------------------------------------
Easy installation for Unix: Other configurations
-----------------------------------------------------------------------
-----------------------------------------------------------------
svgalib (graphics), OSS sound, svgalib's mouse
-----------------------------------------------------------------
make svga
make install
ln -svf /usr/local/bin/svgasbasic /usr/local/bin/sbasic
-----------------------------------------------------------------
SDL (graphics), SDL sound, SDL's mouse
-----------------------------------------------------------------
make sdl
make install
ln -svf /usr/local/bin/sdlsbasic /usr/local/bin/sbasic
-----------------------------------------------------------------
* Not suggested * : X (graphics), OSS sound, X's mouse
-----------------------------------------------------------------
make x
make install
ln -svf /usr/local/bin/xsbasic /usr/local/bin/sbasic
-----------------------------------------------------------------
* Not suggested * : X (graphics), OSS sound, X's mouse
-----------------------------------------------------------------
make xf
make install
ln -svf /usr/local/bin/xsbasic /usr/local/bin/sbasic
-----------------------------------------------------------------
* Not suggested * : OFBIS (graphics), OSS sound, OFBIS mouse
-----------------------------------------------------------------
make ofb
make install
ln -svf /usr/local/bin/ofbsbasic /usr/local/bin/sbasic
-----------------------------------------------------------------------
Compilation for PalmOS
-----------------------------------------------------------------------
* SmallBASIC for PalmOS
make palm
* Install SmallBASIC to Palm
make send
Note: pilot-link required
-----------------------------------------------------------------------
Utilities
-----------------------------------------------------------------------
Unix:
u2d --- convert unix text files (like the sources) to
win/dos
d2u --- convert dos text files to unix
mksmall --- convert all filenames to lowercase
Unix & PalmOS:
bas2pdb --- convert .bas text files to .pdb
pdb2bas --- convert .pdb files to .bas text
mkpdb --- creates a pdb from BINs
Win32:
u2d --- convert unix text files (like the sources) to
win/dos
d2u --- convert dos text files to unix
mksmall --- convert all filenames to lowercase
win32/sb --- under development (SB/PalmOS EMU IDE)
Win32 & PalmOS:
bas2pdb --- convert .bas text files to .pdb
pdb2bas --- convert .pdb files to .bas text
win32/bas2pdb --- GUI convertor (PDB to BAS and BAS to PDB)
PalmOS:
palm/ --- a few fonts
-----------------------------------------------------------------------
Notes:
-----------------------------------------------------------------------
About Manual:
------------
a) The original manual is the doc/ref.txt (source-code version)
b) There is a copy of the manual inside the code.
Try sbasic -h for more information (PC)
Or the help-menu (PalmOS)
c) Almost, the same text is on the SmallBASIC's site (which it is
converted to html)
About Speed:
------------
The drivers dev_xf, dev_w32, dev_w32f, dev_ndcfb, dev_dos
are using double-buffer technique.
This technique updates the video RAM every 50ms (20fps); that means its
needs fast machines or small video resolutions.
Do not use these drivers on 200MHz CPUs.
PC version can speed-up a lot of times if the SB is compiled with
the MALLOC_LIMITED. Also, that method uses less memory but unfortunately
cannot protected you from memory-leaks or other memory problems.
-----------------------------------------------------------------------
Bug reports
-----------------------------------------------------------------------
Try the webboard (I prefer it).
Or send mail to inachus@freemail.gr
